diff --git a/.gitignore b/.gitignore index fd48edf5b..c9bae27f3 100644 --- a/.gitignore +++ b/.gitignore @@ -1,303 +1,304 @@ # Created by https://www.gitignore.io/api/visualstudio ### VisualStudio ### ## Ignore Visual Studio temporary files, build results, and ## files generated by popular Visual Studio add-ons. ## ## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore # User-specific files *.suo *.user *.userosscache *.sln.docstates *.vcxproj.filters # User-specific files (MonoDevelop/Xamarin Studio) *.userprefs # Build results [Dd]ebug/ [Dd]ebugPublic/ [Rr]elease/ [Rr]eleases/ x64/ x86/ bld/ [Bb]in/ [Oo]bj/ [Ll]og/ # NuGET [Nn]uget/ # Visual Studio 2015 cache/options directory .vs/ # Uncomment if you have tasks that create the project's static files in wwwroot #wwwroot/ # MSTest test Results [Tt]est[Rr]esult*/ [Bb]uild[Ll]og.* # NUNIT *.VisualState.xml TestResult.xml # Build Results of an ATL Project [Dd]ebugPS/ [Rr]eleasePS/ dlldata.c # DNX project.lock.json project.fragment.lock.json artifacts/ **/Properties/launchSettings.json *_i.c *_p.c *_i.h *.ilk *.meta *.obj *.pch *.pdb *.pgc *.pgd *.rsp *.sbr *.tlb *.tli *.tlh *.tmp *.tmp_proj *.log *.vspscc *.vssscc .builds *.pidb *.svclog *.scc # Chutzpah Test files _Chutzpah* # Visual C++ cache files ipch/ *.aps *.ncb *.opendb *.opensdf *.sdf *.cachefile *.VC.db *.VC.VC.opendb # Visual Studio profiler *.psess *.vsp *.vspx *.sap # TFS 2012 Local Workspace $tf/ # Guidance Automation Toolkit *.gpState # ReSharper is a .NET coding add-in _ReSharper*/ *.[Rr]e[Ss]harper *.DotSettings.user # JustCode is a .NET coding add-in .JustCode # TeamCity is a build add-in _TeamCity* # DotCover is a Code Coverage Tool *.dotCover # Visual Studio code coverage results *.coverage *.coveragexml # NCrunch _NCrunch_* .*crunch*.local.xml nCrunchTemp_* # MightyMoose *.mm.* AutoTest.Net/ # Web workbench (sass) .sass-cache/ # Installshield output folder [Ee]xpress/ # DocProject is a documentation generator add-in DocProject/buildhelp/ DocProject/Help/*.HxT DocProject/Help/*.HxC DocProject/Help/*.hhc DocProject/Help/*.hhk DocProject/Help/*.hhp DocProject/Help/Html2 DocProject/Help/html # Click-Once directory publish/ # Publish Web Output *.[Pp]ublish.xml *.azurePubxml # TODO: Comment the next line if you want to checkin your web deploy settings # but database connection strings (with potential passwords) will be unencrypted *.pubxml *.publishproj # Microsoft Azure Web App publish settings. Comment the next line if you want to # checkin your Azure Web App publish settings, but sensitive information contained # in these scripts will be unencrypted PublishScripts/ # NuGet Packages *.nupkg # The packages folder can be ignored because of Package Restore **/packages/* # except build/, which is used as an MSBuild target. !**/packages/build/ # Uncomment if necessary however generally it will be regenerated when needed #!**/packages/repositories.config # NuGet v3's project.json files produces more ignoreable files *.nuget.props *.nuget.targets # Microsoft Azure Build Output csx/ *.build.csdef # Microsoft Azure Emulator ecf/ rcf/ # Windows Store app package directories and files AppPackages/ BundleArtifacts/ Package.StoreAssociation.xml _pkginfo.txt # Visual Studio cache files # files ending in .cache can be ignored *.[Cc]ache # but keep track of directories ending in .cache !*.[Cc]ache/ # Others ClientBin/ ~$* *~ *.dbmdl *.dbproj.schemaview *.jfm *.pfx *.publishsettings node_modules/ orleans.codegen.cs # Since there are multiple workflows, uncomment next line to ignore bower_components # (https://github.com/github/gitignore/pull/1529#issuecomment-104372622) #bower_components/ # RIA/Silverlight projects Generated_Code/ # Backup & report files from converting an old project file # to a newer Visual Studio version. Backup files are not needed, # because we have git ;-) _UpgradeReport_Files/ Backup*/ UpgradeLog*.XML UpgradeLog*.htm # SQL Server files *.mdf *.ldf # Business Intelligence projects *.rdl.data *.bim.layout *.bim_*.settings # Microsoft Fakes FakesAssemblies/ # GhostDoc plugin setting file *.GhostDoc.xml # Node.js Tools for Visual Studio .ntvs_analysis.dat # Visual Studio 6 build log *.plg # Visual Studio 6 workspace options file *.opt # Visual Studio 6 auto-generated workspace file (contains which files were open etc.) *.vbw # Visual Studio LightSwitch build output **/*.HTMLClient/GeneratedArtifacts **/*.DesktopClient/GeneratedArtifacts **/*.DesktopClient/ModelManifest.xml **/*.Server/GeneratedArtifacts **/*.Server/ModelManifest.xml _Pvt_Extensions # Paket dependency manager .paket/paket.exe paket-files/ # FAKE - F# Make .fake/ # JetBrains Rider .idea/ *.sln.iml # CodeRush .cr/ # Python Tools for Visual Studio (PTVS) __pycache__/ *.pyc # Cake - Uncomment if you are using it # tools/ ### VisualStudio Patch ### build/ ### Built docs docs/_site/ # Docs build artifacts docfx/ 7zip/ # Build artifacts artifacts/ ### Test files config.json ffmpeg.exe *.pcm appveyor-test.ps1 *.diff CodeMap1.dgml +.vscode/launch.json diff --git a/DisCatSharp.Docs/articles/beyond_basics/intents.md b/DisCatSharp.Docs/articles/beyond_basics/intents.md index 84b9bd2d7..b065c06f3 100644 --- a/DisCatSharp.Docs/articles/beyond_basics/intents.md +++ b/DisCatSharp.Docs/articles/beyond_basics/intents.md @@ -1,62 +1,62 @@ --- uid: beyond_basics_intents title: Intents --- ## Intents -Intents were added to Discord to help the service not have to push so many events to the bots that were not using them. If you are going to be needing -to subscribe to any type of event, they are going to have to be defined **BOTH** within the +Intents were added to Discord to help the service not have to push so many events to the bots that were not using them. If you are going to be needing to subscribe to any type of event, they are going to have to be defined **BOTH** within the [Discord Application under the Bot Page](https://discord.com/developers/applications) on Discords Site and also within the @DisCatSharp.DiscordConfiguration. ### Discord Application On the [Discord Application under the Bot Page](https://discord.com/developers/applications) you will have to specify if your bot requires Privileged Intents. We recommend having these all enabled at first to ensure the most stability when building your first bot, otherwise you may run into issues when retrieving entities from the library's cache. ![Bot Page](/images/Intents.png) >[!WARNING] > These privileged intents may not be available for you to toggle on immediately. > > Due to their nature of sensitive data, Discord requires you to go through a verification process once your bot is in a certain amount of servers. > Please read this [blog post](https://support.discord.com/hc/en-us/articles/360040720412-Bot-Verification-and-Data-Whitelisting) for more information and how to apply. + > Please read [this](https://support-dev.discord.com/hc/en-us/articles/4404772028055-Message-Content-Access-Deprecation-for-Verified-Bots) and [this](https://support.discord.com/hc/en-us/articles/4410940809111) blog post for informations about the upcoming message intent in April 2022. ### Discord Configuration Within your `DiscordConfiguration` you will have to specify all the intents you will need. Here is a list of all the [Intents](xref:DisCatSharp.DiscordIntents) DisCatSharp Supports. By default, the configuration will use `DiscordIntents.AllUnprivileged` as the default value. Like above however, we recommend having all intents enabled at first, so you should specify `DiscordIntents.All` in your configuration which will include the privleged intents you enabled in your application: ```csharp var config = new DiscordConfiguration() { Intents = DiscordIntents.All }; ``` When you become more advanced, you can try experimenting with turning off intents you do not need in order to save resources. In your `DiscordConfiguration` you can specify one or many. Here is an example of just specifying one: ```csharp var config = new DiscordConfiguration() { - Intents = DiscordIntents.GuildMessages + Intents = DiscordIntents.GuildBans }; ``` Here is an example of specifying many: ```csharp var config = new DiscordConfiguration() { Intents = DiscordIntents.DirectMessageReactions | DiscordIntents.DirectMessages | DiscordIntents.GuildBans | DiscordIntents.GuildEmojis | DiscordIntents.GuildInvites | DiscordIntents.GuildMembers | DiscordIntents.GuildMessages | DiscordIntents.Guilds | DiscordIntents.GuildVoiceStates | DiscordIntents.GuildWebhooks, }; ``` Please Note, if you specify a privileged intent within your `DiscordConfiguration` that you have not signed up for on the Discord Application page, an error will be thrown on the connection. diff --git a/DisCatSharp.Docs/articles/important_changes/9_9_0.md b/DisCatSharp.Docs/articles/important_changes/9_9_0.md new file mode 100644 index 000000000..af6407126 --- /dev/null +++ b/DisCatSharp.Docs/articles/important_changes/9_9_0.md @@ -0,0 +1,13 @@ +--- +uid: important_changes_9_9_0 +title: Version 9.9.0 +--- + +# What changed? + +As of April 2022, `DiscordIntents.GuildMessages` became a privileged intent. +You can read more about this [here](https://support.discord.com/hc/en-us/articles/4410940809111) and [here](https://support-dev.discord.com/hc/en-us/articles/4404772028055-Message-Content-Access-Deprecation-for-Verified-Bots). + +## Upgrade from **9.8.X** to **9.9.0** + +- Insert intent change here diff --git a/DisCatSharp.Docs/images/Intents.png b/DisCatSharp.Docs/images/Intents.png index 02c4c1bd5..415875e7f 100644 Binary files a/DisCatSharp.Docs/images/Intents.png and b/DisCatSharp.Docs/images/Intents.png differ