* Update v2->v3 guide and index * Fix format on save fail * Update index.md * Update discord widget id * Fix formattingpull/1967/merge
@@ -31,15 +31,15 @@ var config = new DiscordSocketConfig() | |||
_client = new DiscordSocketClient(config); | |||
``` | |||
#### Common intents: | |||
- AllUnprivileged: This is a group of most common intents, that do NOT require any [developer portal] intents to be enabled. | |||
This includes intents that receive messages such as: `GatewayIntents.GuildMessages, GatewayIntents.DirectMessages` | |||
This includes intents that receive messages such as: `GatewayIntents.GuildMessages, GatewayIntents.DirectMessages` | |||
- GuildMembers: An intent disabled by default, as you need to enable it in the [developer portal]. | |||
- GuildPresences: Also disabled by default, this intent together with `GuildMembers` are the only intents not included in `AllUnprivileged`. | |||
- All: All intents, it is ill adviced to use this without care, as it *can* cause a memory leak from presence. | |||
The library will give responsive warnings if you specify unnecessary intents. | |||
- All: All intents, it is ill adviced to use this without care, as it _can_ cause a memory leak from presence. | |||
The library will give responsive warnings if you specify unnecessary intents. | |||
> [!NOTE] | |||
> All gateway intents, their Discord API counterpart and their enum value are listed | |||
@@ -62,7 +62,12 @@ GatewayIntents = GatewayIntents.AllUnprivileged | GatewayIntents.GuildMembers | | |||
[developer portal]: https://discord.com/developers/ | |||
### ReactionAdded Event | |||
### UserLeft event | |||
UserLeft has been changed to have the `SocketUser` and `SocketGuild` parameters instead of a `SocketGuildUser` parameter. | |||
Because of this, guild-only user data cannot be retrieved from this user anymore, as this user is not part of the guild. | |||
### ReactionAdded event | |||
The reaction added event has been changed to have both parameters cacheable. | |||
This allows you to download the channel and message if they aren't cached instead of them being null. | |||
@@ -78,8 +83,8 @@ There is a new event called `PresenceUpdated` that is called when a user's prese | |||
instead of `GuildMemberUpdated` or `UserUpdated`. | |||
If your code relied on these events to get presence data then you need to update it to work with the new event. | |||
## Migrating your commands to slash command | |||
## Migrating your commands to application commands | |||
The new InteractionService was designed to act like the previous service for text-based commands. | |||
The new interaction service was designed to act like the previous service for text-based commands. | |||
Your pre-existing code will continue to work, but you will need to migrate your modules and response functions to use the new | |||
InteractionService methods. Docs on this can be found in the Guides section. | |||
interaction service methods. Documentation on this can be found in the [Guides](xref:Guides.IntFw.Intro). |
@@ -11,7 +11,7 @@ title: Home | |||
[](https://www.nuget.org/packages/Discord.Net) | |||
[](https://www.myget.org/feed/Packages/discord-net) | |||
[](https://dev.azure.com/discord-net/Discord.Net/_build/latest?definitionId=1&branchName=dev) | |||
[](https://discord.gg/dnet) | |||
[](https://discord.gg/dnet) | |||
## What is Discord.NET? | |||
@@ -23,6 +23,8 @@ interface with the [Discord API](https://discord.com/). | |||
If this is your first time using Discord.Net, you should refer to the | |||
[Intro](xref:Guides.Introduction) for tutorials. | |||
If you're coming from Discord.Net V2, you should refer to the [V2 -> V3](xref:Guides.V2V3Guide) guides. | |||
More experienced users might want to refer to the | |||
[API Documentation](xref:API.Docs) for a breakdown of the individual | |||
objects in the library. | |||
@@ -37,22 +39,22 @@ for testing and development to eventually get merged into Discord.NET. | |||
[Installing Discord.NET Labs](xref:Guides.GettingStarted.Installation.Labs) | |||
[Discord.NET Labs]: https://github.com/Discord-Net-Labs/Discord.Net-Labs | |||
[Discord.Net Labs]: https://github.com/Discord-Net-Labs/Discord.Net-Labs | |||
## Questions? | |||
Frequently asked questions are covered in the | |||
FAQ. Read it thoroughly because most common questions are already answered there. | |||
Frequently asked questions are covered in the | |||
FAQ. Read it thoroughly because most common questions are already answered there. | |||
If you still have unanswered questions after reading the [FAQ](xref:FAQ.Basics.GetStarted), further support is available on | |||
If you still have unanswered questions after reading the [FAQ](xref:FAQ.Basics.GetStarted), further support is available on | |||
[Discord](https://discord.gg/dnet). | |||
## Commonly used features | |||
## New in V3 | |||
#### Interaction Framework | |||
A counterpart to staple command service of Discord.NET, the Interaction Framework implements the same | |||
feature-rich structure to register & handle interactions like Slash commands & buttons. | |||
A counterpart to the well-known command service of Discord.Net, the Interaction Framework implements the same | |||
feature-rich structure to register & handle interactions like application commands & buttons. | |||
- Read about the Interaction Framework | |||
[here](xref:Guides.IntFw.Intro) | |||