aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGravatar wookie184 <[email protected]>2022-11-12 20:01:01 +0000
committerGravatar GitHub <[email protected]>2022-11-12 20:01:01 +0000
commitdb00ac1363daf2ee4c1d59bfbdfb6b3222394357 (patch)
tree9ece9a0616e2971e591831fadafec34f37f9718b
parentMerge pull request #2321 from thegamecracks/discordpy-stable-docs (diff)
parentMerge branch 'main' into intents-tag (diff)
Merge pull request #2320 from thegamecracks/intents-tag
Update intents tag to better reflect discord.py's API changes
-rw-r--r--bot/resources/tags/intents.md14
1 files changed, 7 insertions, 7 deletions
diff --git a/bot/resources/tags/intents.md b/bot/resources/tags/intents.md
index f91f52194..9e3ed560b 100644
--- a/bot/resources/tags/intents.md
+++ b/bot/resources/tags/intents.md
@@ -1,19 +1,19 @@
**Using intents in discord.py**
-Intents are a feature of Discord that tells the gateway exactly which events to send your bot. By default discord.py has all intents enabled except for `Members`, `Message Content`, and `Presences`. These are needed for features such as `on_member` events, to get access to message content, and to get members' statuses.
+Intents are a feature of Discord that tells the gateway exactly which events to send your bot. Various features of discord.py rely on having particular intents enabled, further detailed [in its documentation](https://discordpy.readthedocs.io/en/stable/api.html#intents). Since discord.py v2.0.0, it has become **mandatory** for developers to explicitly define the values of these intents in their code.
-To enable one of these intents, you need to first go to the [Discord developer portal](https://discord.com/developers/applications), then to the bot page of your bot's application. Scroll down to the `Privileged Gateway Intents` section, then enable the intents that you need.
-
-Next, in your bot you need to set the intents you want to connect with in the bot's constructor using the `intents` keyword argument, like this:
+There are *standard* and *privileged* intents. To use privileged intents like `Presences`, `Server Members`, and `Message Content`, you have to first enable them in the [Discord Developer Portal](https://discord.com/developers/applications). In there, go to the `Bot` page of your application, scroll down to the `Privileged Gateway Intents` section, and enable the privileged intents that you need. Standard intents can be used without any changes in the developer portal.
+Afterwards in your code, you need to set the intents you want to connect with in the bot's constructor using the `intents` keyword argument, like this:
```py
from discord import Intents
from discord.ext import commands
+# Enable all standard intents and message content
+# (prefix commands generally require message content)
intents = Intents.default()
-intents.members = True
+intents.message_content = True
bot = commands.Bot(command_prefix="!", intents=intents)
```
-
-For more info about using intents, see the [discord.py docs on intents](https://discordpy.readthedocs.io/en/stable/intents.html), and for general information about them, see the [Discord developer documentation on intents](https://discord.com/developers/docs/topics/gateway#gateway-intents).
+For more info about using intents, see [discord.py's related guide](https://discordpy.readthedocs.io/en/stable/intents.html), and for general information about them, see the [Discord developer documentation on intents](https://discord.com/developers/docs/topics/gateway#gateway-intents).