Redbot 3.4.18 (2022-08-15)

Thanks to all these amazing people that contributed to this release:

@aikaterna, @Flame442, @jack1142, @Kowlin, @RheingoldRiver

Read before updating

1. openSUSE Leap 15.2 is no longer supported as it has already reached its end of life.

2. Information for Audio users that are using an external Lavalink instance (if you don’t know what that is, you should skip this point):

   • Red 3.4.18 uses a new Lavalink jar that you will need to manually update from our GitHub.

   • We’ve updated our application.yml file and you should update your instance’s application.yml appropriately.

End-user changelog

Core Bot

• openSUSE Leap 15.2 is no longer supported as it has already reached its end of life (#5777)

Audio

• Addressed a cipher change that made it impossible to find tracks (#5822)

• Fixed an issue with [p]llset external making the bot completely unresponsive when switching to an external Lavalink server (#5804, #5828)

Documentation changes

• Updated the screenshot in Creating a bot account to include the message content intent (#5798)

• Unpinned Temurin version on Windows as a fixed version is now available (#5815)

Redbot 3.4.17 (2022-06-07)

Thanks to all these amazing people that contributed to this release:

@aikaterna, @Drapersniper, @Flame442, @jack1142, @Kowlin, @Kreusada, @ltzmax, @matcha19, @mina9999, @ponte-vecchio, @PredaaA, @TrustyJAID, @untir-l, @Vexed01

Read before updating

1. Fedora 34 is no longer supported as it has already reached its end of life.

2. Information for Audio users that are using an external Lavalink instance (if you don’t know what that is, you should skip this point):

   Red 3.4.17 uses a new Lavalink jar that you will need to manually update from our GitHub.

End-user changelog

Core Bot

• Fedora 33 is no longer supported as it has already reached its end of life (#5701)

• Added instructions on how to respond to the message received from [p]contact in the embed footer of the message sent to the bot owner (#5528, #5529)

• Updated [p]servers command to escape Discord markdown in server names (#5696, #5744)

• Fixed a bug that prevented users from changing the name and data location with redbot --edit command (#5545, #5540, #5541)

• Fixed grammar in the [p]uptime command (#5596)

Audio

• Added timestamps to all embeds sent by Audio cog (#5632)

• Improved handling of voice connection close codes received from Discord (#5712)

• Fixed plain word YT searching with [p]play and [p]search commands (#5712)

• Fixed YT age-restricted track playback (#5712)

• Fixed the cog not sending any Track Error message on track decoding errors (#5716)

• Fixed the UnboundLocalError exception happening when using [p]playlist list with an empty playlist (#5378, #5394)

Downloader

• Added information about the commit hash at which the cog is pinned in the output of [p]cog listpinned command (#5551, #5563)

Filter

• Fixed a potential memory leak in Filter cog (#5578)

General

• Updated features list in [p]serverinfo with the latest changes from Discord (#5655)

Mod

• Updated Red’s ban commands to address the breaking change that Discord made in their ban list API endpoint (#5656)

Modlog

• Modlog’s automated case creation for bans now properly checks that the guild is available before further processing (#5647)

Mutes

• Added proper error handling for VERY long durations in mute commands (#5605)

Permissions

• Updated [p]permissions acl setglobal and [p]permissions acl setserver to allow sending the file in a follow-up message (#5473, #5685)

• [p]permissions canrun now prepends an emoji to the response to better differentiate between the positive and negative results (#5711)

Trivia

• Allowed passing use_spoilers setting in the CONFIG section of the trivia list file (#5566)

Trivia Lists

• Added a trivia list for the FIFA World Cup with questions based on hosts, placements, venues, continental confederations, number of participants, top goal scorers, qualification shocks, and more (#5639)

• Updated geography trivia list with up-to-date answers and removed questions that lack sources for their claimed answers (#5638)

• Updated Kazakhstan’s capital city in the worldcapitals trivia list (#5598, #5599)

• Fixed spelling error in the answer to one of the questions in computers trivia list (#5587, #5588)

Developer changelog

• Updated discord.ext.menus vendor (#5579)

Documentation changes

• Added CentOS Stream 9, RHEL 9, Alma Linux 9, Oracle Linux 9, and Rocky Linux 9 install guides (#5537, #5721)

• Added Ubuntu 22.04 install guide (#5720)

• Changed the recommended operating system for hosting Red from Ubuntu 20.04 LTS to Ubuntu 22.04 LTS (#5720)

• Updated Python version in pyenv and Windows instructions (#5719)

• Replaced install instructions for discontinued AdoptOpenJDK package with Temurin 11 package in the macOS install guide (#5718)

• Updated Visual Studio Build Tools version in Windows install guide (#5702)

• Updated systemd guide to use the absolute path to which command to avoid triggering shell aliases on some OSes (#5547)

• Emphasized lines that contain text that needs to be replaced by the user (#5548)

• Prevented Google and other search engines from indexing versioned documentation (#5549)

• Pinned Temurin version on Windows until a fixed version becomes available (#5717)

• Fixed git installation instructions in CentOS 7 install guide (#5700)

Redbot 3.4.16 (2021-12-31)

Thanks to all these amazing people that contributed to this release:

@jack1142, @PredaaA

This is a hotfix release fixing issues with invite URL API that caused [p]invite command and CORE__INVITE_URL RPC method to not work.

End-user changelog

• Core Bot - Fixed [p]invite command (#5517)

Developer changelog

• Fixed CORE__INVITE_URL RPC method (#5517)

Documentation changes

• Changed Arch install guide to temporarily use python39 AUR package instead of python package as Red does not currently support Python 3.10 (#5518)

Redbot 3.4.15 (2021-12-31)

Thanks to all these amazing people that contributed to this release:

@aikaterna, @aleclol, @Arman0334, @Crossedfall, @Dav-Git, @fixator10, @Flame442, @jack1142, @Jan200101, @Just-Jojo, @Kowlin, @Kreusada, @laggron42, @ltzmax, @Parnassius, @PredaaA, @Predeactor, @RasmusWL, @sravan1946, @Stonedestroyer, @the-krak3n, @Tobotimus, @vertyco, @Vexed01, @WreckRox, @yamikaitou

Read before updating

1. Fedora 33 and CentOS 8 are no longer supported as they have already reached end of life.

2. Information for Audio users that are using an external Lavalink instance (if you don’t know what that is, you should skip this point):

   Red 3.4.15 uses a new Lavalink jar that you MUST manually update from our GitHub to be able to continue using Audio.

End-user changelog

Core Bot

• Added new CLI options for non-interactive usage of redbot-setup (#2396, #5448)

  See output of redbot-setup --help for more information.

• JSON is now more strongly recommended and is used by default for new instances in redbot-setup (#5448)

• The embed setting for [p]help command set with [p]embedset command will now affect all help messages, not just the ones sent when invoking [p]help command directly (#5452)

• [p]traceback command now indicates that it DMed the command caller with a tick reaction (#5353)

• Improved [p]helpset showaliases responses (#5376)

• Added plural forms to the responses of [p]leave command (#5391)

• Fedora 33 and CentOS 8 are no longer supported as they have already reached end of life (#5440)

• Corrected usage examples in help of [p]set api and [p]set api remove (#5444)

• Updated prefix length limit to 25 to allow setting bot mention as a prefix (#5476)

• Confirmation prompts (accepting “yes/no” or “I agree” as the answer) no longer wrongfully translate the answer that needs to be sent when only English answers are accepted by the bot (#5363, #5364, #5404)

• Fixed short help for some of the commands in Core Red (#5502)

• Fixed issues with rendering of modlog cases with usernames written in a right-to-left language (#5422)

• Fixed an issue with instance backup failing for non-JSON storage backends (#5315)

• Running Red with --no-instance CLI flag no longer fails when no instance was ever created by the user (#5415, #5416)

• [p]command enable guild and [p]command disable guild commands no longer error out for commands that only check for user permissions, not caller’s roles (#5477)

Admin

• Added [p]selfroleset clear command which can be used to clear the list of available selfroles in the server (#5387)

Audio

• Added native Mac M1 support for Java runtimes supporting Mac M1 (#5474)

• Enabled JDA-NAS on all system architectures which should limit stuttering/buffering issues on some machines (#5474)

• The bot will now disconnect from the voice channel when all members are bots if the auto-disconnect setting is enabled (#5421)

• Fixed an issue with resuming playback after changing voice channels (#5170)

• Fixed issues with Soundcloud private playlists and mobile links (#5474)

• Fixed searching music with some of the queries containing quotes or backslashes (#5474)

• Fixed an exception caused by unavailable YT tracks in Mix playlists (#5474)

• Fixed IndexError in [p]queue command which occurred when the user provides negative integer as the page number (#5429)

Cleanup

• Restricted [p]cleanupset notify to only be invokable in server channels (#5466)

Custom Commands

• Added 2000 character limit for custom command responses to prevent Nitro users from adding longer responses than a Discord bot can send (#5499)

Dev Cog

• [p]mockmsg now allows mocking attachment-only messages (#5446)

Downloader

• Added repo name to the response of [p]findcog command (#5382, #5383)

Economy

• [p]economyset showsettings now includes configured role payday amounts (#5455, #5457)

General

• Removed voice region field from [p]serverinfo command as Discord no longer provides this setting for servers (#5449)

Mod

• [p]voicekick now sends a response when the action succeeds (#5367)

• Fixed an error with [p]tempban failing to send an invite link when a server has an unset vanity URL (#5472)

• Fixed explanations of example usage for [p]ban, [p]kick, and [p]tempban commands (#5372)

• Fixed a typo in one of [p]unban’s error messages (#5470)

Modlog

• Added the new native Discord timestamps in [p]case, [p]casesfor, and [p]listcases commands (#5395)

Warnings

• Warning actions no longer error out when the action is set to use a command that only checks for user permissions, not caller’s roles (#5477)

Developer changelog

• Added optional message argument to Context.tick() and Context.react_quietly() which is used if adding the reaction doesn’t succeed (#3359, #4092)

• Added optional check_permissions keyword-only argument to RedBase.embed_requested() which, if True, will make the method also check whether the bot can send embeds in the given channel (#5452)

• Added RedBase.get_invite_url() and RedBase.is_invite_url_public() that expose the functionality of [p]invite programmatically (#5152, #5424)

• Changed the output of CORE__LOAD, CORE__RELOAD, and CORE__UNLOAD RPC methods to a dictionary (#5451, #5453)

Documentation changes

• Added install guide for Alma Linux 8.4-8.x and Raspberry Pi OS 11 Bullseye (#5440)

• Updated the Java distribution used in the Windows install guide to Temurin - rebranded AdoptOpenJDK (#5403)

• Improved Mac and pyenv instructions to address common issues with load path configuration (#5356)

• Updated the server locations for Hetzner and Contabo in Hosting Information document (#5475)

• Updated Python version in pyenv and Windows instructions (#5447)

• Removed inaccurate note from Unix install guides about install commands also being used for updating Red (#5439)

• Removed LXC from unsupported hosting platforms as many VPS providers utilize that technology (#5351)

• Specified that Red currently requires Python 3.8.1 - 3.9.x (#5403)

Redbot 3.4.14 (2021-09-23)

Thanks to all these amazing people that contributed to this release:

@aikaterna, @jack1142, @Kowlin, @L33Tech, @maxbooiii, @RheingoldRiver

Read before updating

1. Versions of RHEL older than 8.4 (including 7) and versions of CentOS older than 8.4 (excluding 7) are no longer supported.

2. Information for Audio users that are using an external Lavalink instance (if you don’t know what that is, you should skip this point):

   Red 3.4.14 uses a new Lavalink jar that you will need to manually update from our GitHub.

End-user changelog

• Core Bot - Added the new native Discord timestamp in the [p]uptime command (#5323)

• Core Bot - redbot-setup delete command no longer requires database connection if the data deletion was not requested (#5312, #5313)

• Audio - Fixed intermittent 403 Forbidden errors (#5329)

• Modlog - Fixed formatting of Last modified at field in Modlog cases (#5317)

Documentation changes

• Each operating system now has a dedicated install guide (#5328)

• Fixed Raspberry Pi OS install guide (#5314, #5328)

• Added install guide for CentOS Stream 8, Oracle Linux 8.4-8.x, and Rocky Linux 8 (#5328)

• Install guides for RHEL derivatives no longer require the use of pyenv (#5328)

Redbot 3.4.13 (2021-09-09)

Thanks to all these amazing people that contributed to this release:

@aikaterna, @Arman0334, @Flame442, @flaree, @fredster33, @Injabie3, @jack1142, @Just-Jojo, @Kowlin, @Kreusada, @leblancg, @maxbooiii, @npc203, @palmtree5, @phenom4n4n, @PredaaA, @qenu, @TheDataLeek, @Twentysix26, @TwinDragon, @Vexed01

Read before updating

1. If you’re hosting a public/big bot (>75 servers) or strive to scale your bot at that level, you should read our stance on (privileged) intents and public bots.

2. Fedora 32 is no longer supported as it has already reached end of life.

3. Information for Audio users that are using an external Lavalink instance (if you don’t know what that is, you should skip this point):

   Red 3.4.13 uses a new Lavalink jar that you will need to manually update from our GitHub.

End-user changelog

Core Bot

• Added a new [p]diagnoseissues command to allow the bot owners to diagnose issues with various command checks with ease (#4717, #5243)

  Since some of us are pretty excited about this feature, here’s a very small teaser showing a part of what it can do:

  

• Revamped the [p]debuginfo to make it more useful for… You guessed it, debugging! (#4997, #5156)

  More specifically, added information about CPU and RAM, bot’s instance name and owners

• The formatting of Red’s console logs has been updated to make it more copy-paste friendly (#4868, #5181)

• Added the new native Discord timestamps in Modlog cases, [p]userinfo, [p]serverinfo, and [p]tempban (#5155, #5241)

• Added a setting for [p]help’s reaction timeout (#5205)

  This can be changed with [p]helpset reacttimeout command

• Red 3.4.13 is the first release to (finally) support Python 3.9! (#4655, #5121)

• Upgraded all Red’s dependencies (#5121)

• Fedora 32 is no longer supported as it has already reached end of life (#5121)

• Fixed a bunch of errors related to the missing permissions and channels/messages no longer existing (#5109, #5163, #5172, #5191)

Admin

• The [p]selfroleset add and [p]selfroleset remove commands can now be used to add multiple selfroles at once (#5237, #5238)

Alias

• Added commands for editing existing aliases (#5108)

Audio

• Added a per-guild max volume setting (#5165)

  This can be changed with the [p]audioset maxvolume command

• Fixed an issue with short clips being cutoff when auto-disconnect on queue end is enabled (#5158, #5188)

• Fixed fetching of age-restricted tracks (#5233)

• Fixed searching of YT Music (#5233)

• Fixed playback from SoundCloud (#5233)

• [p]summon will now indicate that it has succeeded or failed to summon the bot (#5186)

Cleanup

• The [p]cleanup user command can now be used to clean messages of a user that is no longer in the server (#5169)

• All [p]cleanup commands will now send a notification with the number of deleted messages. The notification is deleted automatically after 5 seconds (#5218)

  This can be disabled with the [p]cleanupset notify command

Downloader

• The dot character (.) can now be used in repo names. No more issues with adding repositories using the commands provided by the Cog Index! (#5214)

Filter

• Added [p]filter clear and [p]filter channel clear commands for clearing the server’s/channel’s filter list (#4841, #4981)

Mod

• Fixed an error with handling of temporary ban expirations while the guild is unavailable due to Discord outage (#5173)

• The DM message from the [p]tempban command will now include the ban reason if [p]modset dm setting is enabled (#4836, #4837)

• The [p]rename command will no longer permit changing nicknames of members that are not lower in the role hierarchy than the command caller (#5187, #5211)

Streams

• Fixed an issue with some YouTube streamers getting removed from stream alerts after a while (#5195, #5223)

• Made small optimizations in regards to stream alerts (#4968)

Trivia

• Added schema validation of the custom trivia files (#4571, #4659)

Warnings

• 0 point warnings are, once again, allowed. (#5177, #5178)

Developer changelog

• Added RelativedeltaConverter and parse_relativedelta to the redbot.core.commands package (#5000)

  This converter and function return dateutil.relativedelta.relativedelta object that represents a relative delta. In addition to regular timedelta arguments, it also accepts months and years!

• Added more APIs for allowlists and blocklists (#5206)

  Here’s the list of the methods that were added to the bot object:

  • Red.add_to_blacklist()

  • Red.remove_from_blacklist()

  • Red.get_blacklist()

  • Red.clear_blacklist()

  • Red.add_to_whitelist()

  • Red.remove_from_whitelist()

  • Red.get_whitelist()

  • Red.clear_whitelist()

• Added CommandConverter and CogConverter to the redbot.core.commands package (#5037)

Documentation changes

• Added a document about (privileged) intents and our stance regarding “public bots” (#5216, #5221)

• Added install instructions for Debian 11 Bullseye (#5213, #5217)

• Added Oracle Cloud’s Always Free offering to the Hosting Information (#5225)

• Updated the commands in the install guide for Mac OS to work properly on Apple Silicon devices (#5234)

• Fixed the examples of commands that are only available to people with the mod role (#5180)

• Fixed few other small issues with the documentation :) (#5048, #5092, #5149, #5207, #5209, #5215, #5219, #5220)

Miscellaneous

• Core Bot - The console error about missing Privileged Intents stands out more now (#5184)

• Core Bot - The [p]invite command will now add a tick reaction after it DMs an invite link to the user (#5184)

• Downloader - Added a few missing line breaks (#5185, #5187)

Redbot 3.4.12 (2021-06-17)

Thanks to all these amazing people that contributed to this release:

@aikaterna, @Flame442, @jack1142, @Just-Jojo, @Kowlin, @Kreusada, @npc203, @PredaaA, @retke, @Stonedestroyer

This is a hotfix release related to Red ceasing to use the Audio Global API service.

Full changelog

• Audio - Updated URL of the curated playlist (#5135)

• Audio - All local caches are now enabled by default (#5140)

• Audio - Global API service will no longer be used in Audio and as such support for it has been removed from the cog (#5143)

• Core Bot - [p]set serverprefix command will now prevent the user from setting a prefix with length greater than 20 characters (#5091, #5117)

• Core Bot - [p]set prefix command will now warn the user when trying to set a prefix with length greater than 20 characters (#5091, #5117)

• Core Bot - applications.commands scope can now be included in the invite URL returned from [p]invite by enabling it with``[p]inviteset commandscope``

• Dev Cog - [p]debug command will now confirm the code finished running with a tick reaction (#5107)

• Filter - Fixed an edge case that caused the cog to sometimes check contents of DM messages (#5125)

• Warnings - Prevented users from applying 0 or less points in custom warning reasons (#5119, #5120)

Redbot 3.4.11 (2021-06-12)

Thanks to all these amazing people that contributed to this release:

@jack1142, @Kowlin, @Onii-Chan-Discord

This is a hotfix release fixing a crash involving guild uploaded stickers.

Full changelog

• discord.py version has been bumped to 1.7.3 (#5129)

• Links to the CogBoard in Red’s documentation have been updated to use the new domain (#5124)

Redbot 3.4.10 (2021-05-28)

Thanks to all these amazing people that contributed to this release:

@aikaterna, @aleclol, @benno1237, @bobloy, @BoyDownTown, @Danstr5544, @DeltaXWizard, @Drapersniper, @Fabian-Evolved, @fixator10, @Flame442, @flaree, @jack1142, @Kowlin, @Kreusada, @Lifeismana, @Obi-Wan3, @OofChair, @palmtree5, @plofts, @PredaaA, @Predeactor, @TrustyJAID, @Vexed01

Read before updating

1. PM2 process manager is no longer supported as it is not a viable solution due to certain parts of its behavior.

   We highly recommend you to switch to one of the other supported solutions:

   • Setting up auto-restart using systemd on Linux

   • Setting up auto-restart on Mac

   If you experience any issues when trying to configure it, you can join our discord server and ask in the support channel for help.

2. Information for Audio users that are using an external Lavalink instance (if you don’t know what that is, you should skip this point):

   • Red 3.4.10 uses a new Lavalink jar that you will need to manually update from our GitHub.

   • We’ve updated our application.yml file and you should update your instance’s application.yml appropriately.

End-user changelog

Core Bot

• Fixed terminal colors on Windows (#5063)

• Fixed the --rich-traceback-extra-lines flag (#5028)

• Added missing information about the showaliases setting in [p]helpset showsettings (#4971)

• The help command no longer errors when it doesn’t have permission to read message history and menus are enabled (#4959, #5030)

• Fixed a bug in [p]embedset user that made it impossible to reset the user’s embed setting (#4962)

• [p]embedset command and its subcommands now properly check whether any of the passed command’s parents require Embed Links permission (#4962)

• Fixed an issue with Red reloading unrelated modules when using [p]load and [p]reload (#4956, #4958)

Admin

• The cog will now log when it leaves a guild due to the serverlock (#5008, #5073)

Audio

• Fixed an issue that made it possible to remove Aikaterna’s curated tracks playlist (#5018)

• Fixed auto-resume of auto play after Lavalink restart (#5051)

• The [p]audiostats command can now only be used by bot owners (#5017)

• Fixed an error with [p]audiostats caused by players not always having their connection time stored (#5046)

• Fixed track resuming in a certain edge case (#4996)

• Fixed an error in [p]audioset restart (#4987)

• The cog will now check whether it has speak permissions in the channel before performing any actions (#5012)

• Fixed an issue with Audio failing when it’s missing permissions to send a message in the notification channel (#4960)

• Fixed fetching of age-restricted tracks (#5085)

• Fixed an issue with Soundcloud URLs that ended with a slash (/) character (#5085)

Custom Commands

• [p]customcom create simple no longer errors for a few specific names (#5026, #5027)

Downloader

• [p]repo remove can now remove multiple repos at the same time (#4765, #5082)

• [p]cog install now properly shows the repo name rather than {repo.name} (#4954)

Mod

• [p]mute no longer errors on muting a bot user if the senddm option is enabled (#5071)

Mutes

• Forbidden errors during the channel mute are now handled properly in a rare edge case (#4994)

Modlog

• [p]modlogset resetcases will now ask for confirmation before proceeding (#4976)

• Modlog will no longer try editing the case’s Discord message once it knows that it no longer exists (#4975)

Streams

• Fixed Picarto support (#4969, #4970)

• [p]twitchstream, [p]youtubestream, and [p]picarto commands can no longer be run in DMs (#5036, #5035)

• Smashcast service has been closed and for that reason we have removed support for it from the cog (#5039, #5040)

• Fixed Twitch stream alerts for streams that use localized display names (#5050, #5066)

• The cog no longer errors when trying to delete a cached message from a channel that no longer exists (#5032, #5031)

• In message template, {stream.display_name} can now be used to refer to streamer’s display name (#5050, #5066)

  • This is not always the same as {stream} which refers to the streamer’s channel or username

Warnings

• The warn action is now taken after sending the warn message to the member (#4713, #5004)

Developer changelog

• Bumped discord.py to 1.7.2 (#5066)

• The log messages shown by the global error handler will now show the trace properly for task done callbacks (#4980)

• Dev - [p]eval, [p]repl, and [p]debug commands no longer fail to send very long syntax errors (#5041)

• Dev - [p]eval, [p]repl, and [p]debug commands now, in addition to py, support code blocks with python syntax (#5083)

Documentation changes

• Added a guide for making auto-restart service on Mac (#4082, #5020)

• Added cog guide for core commands (#1734, #4597)

• Added cog guide for Mod cog (#1734, #4886)

• Added cog guide for Modlog cog (#1734, #4919)

• Added cog guide for Mutes cog (#1734, #4875)

• Added cog guide for Permissions cog (#1734, #4985)

• Added cog guide for Reports cog (#1734, #4882)

• Added cog guide for Warnings cog (#1734, #4920)

• Added a guide about Trivia list creation (#4595, #5023)

• Added the documentation for redbot.core.modlog.Case (#4979)

• Removed PM2 guide (#4991)

Miscellaneous

• Clarified that [p]cleanup commands only delete the messages from the current channel (#5070)

• Updated Python version in pyenv and Windows instructions (#5025)

• Added information on how to set the bot not to start on boot anymore to auto-restart docs (#5020)

• Improved logging in Audio cog (#5044)

• Improved logging of API errors in Streams cog (#4995)

• The command [p]urban from the General cog will now use the default embed color of the bot (#5014)

• Cog creation guide now includes the bot as an argument to the cog class (#4988)

• Rephrased a few strings and fixed maaaaany grammar issues and typos (#4793, #4832, #4955, #4966, #5015, #5019, #5029, #5038, #5055, #5080, #5081)

Redbot 3.4.9 (2021-04-06)

This is a hotfix release fixing an issue with command error handling.

discord.py version has been bumped to 1.7.1.

Thanks again to @Rapptz for quick response on this issue.

Redbot 3.4.8 (2021-04-06)

Thanks to all these amazing people that contributed to this release:

@6days9weeks, @aikaterna, @Drapersniper, @fixator10, @Flame442, @flaree, @jack1142, @kingslayer268, @Kowlin, @Kreusada, @Obi-Wan3, @OofChair, @palmtree5, @phenom4n4n, @PredaaA, @Predeactor, @rijusougata13, @TheDiscordHistorian, @Tobotimus, @TrustyJAID, @Twentysix26, @Vexed01

Read before updating

1. Information for Audio users that are using an external Lavalink instance (if you don’t know what that is, you should skip this point):

   Red 3.4.8 uses a new Lavalink jar that you will need to manually update from our GitHub.

2. Fedora 31 and OpenSUSE Leap 15.1 are no longer supported as they have already reached end of life.

End-user changelog

Core Bot

• Added per-command embed settings (#4049)

  • See help of [p]embedset and [p]embedset command command group for more information

• The [p]servers command uses menus now (#4720, #4831)

• [p]leave accepts server IDs now (#4831)

• Commands for listing global and local allowlists and blocklists will now, in addition to IDs, contain user/role names (#4839)

• Messages sent interactively in DM channels no longer fail (#4876)

• An error message will now be shown when a command that is only available in NSFW channels is used in a non-NSFW channel (#4933)

• Added more singular and plural forms in a bunch of commands in the bot (#4004, #4898)

• Removed the option to drop the entire PostgreSQL database in redbot-setup delete due to limitations of PostgreSQL (#3699, #3833)

• Added a progress bar to redbot-setup convert (#2952)

• Fixed how the command signature is shown in help for subcommands that have group args (#4928)

Alias

• Fixed issues with command aliases for commands that take an arbitrary, but non-zero, number of arguments (e.g. [p]load) (#4766, #4871)

Audio

• Fixed stuttering (#4565)

• Fixed random disconnects (#4565)

• Fixed the issues causing the player to be stuck on 00:00 (#4565)

• Fixed ghost players (#4565)

• Audio will no longer stop playing after a while (#4565)

• Fixed playlist loading for playlists with over 100 songs (#4932)

• Fixed an issue with alerts causing errors in playlists being loaded (#4932)

• Improved playlist extraction (#4932)

• Fixed an issue with consent pages appearing while trying to load songs or playlists (#4932)

Cleanup

• [p]cleanup before and [p]cleanup after commands can now be used without a message ID if the invocation message replies to some message (#4790)

Downloader

• Improved compatibility with Git 2.31 and newer (#4897)

Filter

• Added meaningful error messages for incorrect arguments in the [p]bank set command (#4789, #4801)

Mod

• Improved performance of checking tempban expirations (#4907)

• Fixed tracking of nicknames that were set just before nick reset (#4830)

Mutes

• Vastly improved performance of automatic unmute handling (#4906)

Streams

• Streams cog should now load faster on bots that have many stream alerts set up (#4731, #4742)

• Fixed possible memory leak related to automatic message deletion (#4731, #4742)

• Streamer accounts that no longer exist are now properly handled (#4735, #4746)

• Fixed stream alerts being sent even after unloading Streams cog (#4940)

• Checking Twitch streams will now make less API calls (#4938)

• Ratelimits from Twitch API are now properly handled (#4808, #4883)

Trivia

• Added a new option for hiding the answer to the Trivia answer in a spoiler (#4700, #4877)

  • [p]triviaset usespoilers command can be used to enable/disable this option

Warnings

• Fixed output of [p]warnings command for members that are no longer in the server (#4900, #4904)

• Embeds now use the default embed color of the bot (#4878)

Developer changelog

• Bumped discord.py version to 1.7.0 (#4928)

• Deprecated importing GuildConverter from redbot.core.commands.converter namespace (#4928)

  • discord.Guild or GuildConverter from redbot.core.commands should be used instead

• Added guild parameter to bot.allowed_by_whitelist_blacklist() which is meant to replace the deprecated guild_id parameter (#4905, #4914)

  • Read the method’s documentation for more information

• Fixed on_red_api_tokens_update not being dispatched when the tokens were removed with [p]set api remove (#4916, #4917)

Documentation changes

• Added a note about updating cogs in update message and documentation (#4910)

• Added cog guide for Image cog (#4821)

• Updated Mac install guide with new brew commands (#4865)

• Getting started now contains an explanation of parameters that can take an arbitrary number of arguments (#4888, #4889)

• Added a warning to Arch Linux install guide about the instructions being out-of-date (#4866)

• All shell commands in the documentation are now prefixed with an unselectable prompt (#4908)

• Setting up auto-restart using systemd on Linux now asks the user to create the new service file using nano text editor (#4869, #4870)

  • Instructions for all Linux-based operating systems now recommend to install nano

• Updated Python version in pyenv and Windows instructions (#4864, #4942)

Redbot 3.4.7 (2021-02-26)

Thanks to all these amazing people that contributed to this release:

@elijabesu, @Flame442, @flaree, @jack1142, @Kowlin, @kreusada, @palmtree5, @TrustyJAID

End-user changelog

• Added proper permission checks to [p]muteset senddm and [p]muteset showmoderator (#4849)

• Updated the [p]lmgtfy command to use the new domain (#4840)

• Updated the [p]info command to more clearly indicate that the instance is owned by a team (#4851)

• Fixed minor issues with error messages in Mutes cog (#4847, #4850, #4853)

Documentation changes

• Added cog guide for General cog (#4797)

• Added cog guide for Trivia cog (#4566)

Redbot 3.4.6 (2021-02-16)

Thanks to all these amazing people that contributed to this release:

@aikaterna, @aleclol, @Andeeeee, @bobloy, @BreezeQS, @Danstr5544, @Dav-Git, @Elysweyr, @Fabian-Evolved, @fixator10, @Flame442, @Injabie3, @jack1142, @Kowlin, @kreusada, @leblancg, @maxbooiii, @NeuroAssassin, @phenom4n4n, @PredaaA, @Predeactor, @retke, @siu3334, @Strafee, @TheWyn, @TrustyJAID, @Vexed01, @yamikaitou

Read before updating

1. Information for Audio users that are using an external Lavalink instance (if you don’t know what that is, you should skip this point):

   Red 3.4.6 uses a new Lavalink jar that you will need to manually update from our GitHub.

End-user changelog

Core Bot

• Fixed the rotation of Red’s logs that could before result in big disk usage (#4405, #4738)

• Fixed command usage in the help messages for few commands in Red (#4599, #4733)

• Fixed errors in [p]command defaultdisablecog and [p]command defaultenablecog commands (#4767, #4768)

• [p]command listdisabled guild can no longer be run in DMs (#4771, #4772)

• Improvements and fixes for our new (colorful) logging (#4702, #4726)

  • The colors used have been adjusted to be readable on many more terminal applications

  • The NO_COLOR environment variable can now be set to forcefully disable all colors in the console output

  • Tracebacks will now use the full width of the terminal again

  • Tracebacks no longer contain multiple lines per stack level (this can now be changed with the flag --rich-traceback-extra-lines)

  • Disabled syntax highlighting on the log messages

  • Dev cog no longer captures logging output

  • Added some cool features for developers

    • Added the flag --rich-traceback-extra-lines which can be used to set the number of additional lines in tracebacks

    • Added the flag --rich-traceback-show-locals which enables showing local variables in tracebacks

  • Improved and fixed a few other minor things

• Added a friendly error message to [p]load that is shown when trying to load a cog with a command name that is already taken by a different cog (#3870)

• Help now includes command aliases in the command help (#3040)

  • This can be disabled with [p]helpset showaliases command

• Fixed errors appearing when using Ctrl+C to interrupt redbot --edit (#3777, #4572)

Admin

• [p]selfrole can now be used without a subcommand and passed with a selfrole directly to add/remove it from the user running the command (#4826)

Audio

• Improved detection of embed players for fallback on age-restricted YT tracks (#4818, #4819)

• Improved MP4/AAC decoding (#4818, #4819)

• Requests for YT tracks are now retried if the initial request causes a connection reset (#4818, #4819)

Cleanup

• Renamed the [p]cleanup spam command to [p]cleanup duplicates, with the old name kept as an alias for the time being (#4814)

• Fixed an error from passing an overly large integer as a message ID to [p]cleanup after and [p]cleanup before (#4791)

Dev Cog

• Help descriptions of the cog and its commands now get translated properly (#4815)

Economy

• [p]economyset rolepaydayamount can now remove the previously set payday amount (#4661, #4758)

Filter

• Added a case type filterhit which is used to log filter hits (#4676, #4739)

Mod

• The [p]tempban command no longer errors out when trying to ban a user in a guild with the vanity url feature that doesn’t have a vanity url set (#4714)

• Fixed an edge case in role hierarchy checks (#4740)

• Added two new settings for disabling username and nickname tracking (#4799)

  • Added a command [p]modset trackallnames that disables username tracking and overrides the nickname tracking setting for all guilds

  • Added a command [p]modset tracknicknames that disables nickname tracking in a specific guild

• Added a command [p]modset deletenames that deletes all stored usernames and nicknames (#4827)

• Added usage examples to [p]kick, [p]ban, [p]massban, and [p]tempban (#4712, #4715)

• Updated DM on kick/ban to use bot’s default embed color (#4822)

Modlog

• Added a command [p]listcases that allows you to see multiple cases for a user at once (#4426)

• Added typing indicator to [p]casesfor command (#4426)

Mutes

• Fixed an edge case in role hierarchy checks (#4740)

• The modlog reason no longer contains leading whitespace when it’s passed after the mute time (#4749)

• A DM can now be sent to the (un)muted user on mute and unmute (#3752, #4563)

  • Added [p]muteset senddm to set whether the DM should be sent (function disabled by default)

  • Added [p]muteset showmoderator to set whether the DM sent to the user should include the name of the moderator that muted the user (function disabled by default)

• Added more role hierarchy checks to ensure permission escalations cannot occur on servers with a careless configuration (#4741)

• Help descriptions of the cog and its commands now get translated properly (#4815)

Reports

• Reports now use the default embed color of the bot (#4800)

Streams

• Fixed incorrect timezone offsets for some YouTube stream schedules (#4693, #4694)

• Fixed meaningless errors happening when the YouTube API key becomes invalid or when the YouTube quota is exceeded (#4745)

Trivia

• Payout for trivia sessions ending in a tie now gets split between all the players with the highest score (#3931, #4649)

Trivia Lists

• Added new Who’s That Pokémon - Gen. VI trivia list (#4785)

• Updated answers regarding some of the hero’s health and abilities in the overwatch trivia list (#4805)

Developer changelog

Core Bot

• Updated versions of the libraries used in Red: discord.py to 1.6.0, aiohttp to 3.7.3 (#4728)

• Added an event on_red_before_identify that is dispatched before IDENTIFYing a session (#4647)

Utility Functions

• Added a function redbot.core.utils.chat_formatting.spoiler() that wraps the given text in a spoiler (#4754)

Dev Cog

• Cogs can now add their own variables to the environment of [p]debug, [p]eval, and [p]repl commands (#4667)

  • Variables can be added and removed from the environment of Dev cog using two new methods:

    • bot.add_dev_env_value()

    • bot.remove_dev_env_value()

Documentation changes

• Added cog guide for Filter cog (#4579)

• Added information about the Red Index to Publishing cogs for Red V3 (#4778)

• Restructured the host list (#4710)

• Clarified how to use pm2 with pyenv virtualenv (#4709)

• Updated the pip command for Red with the postgres extra in Linux/macOS install guide to work on zsh shell (#4697)

• Updated Python version in pyenv and Windows instructions (#4770)

Miscellaneous

• Various grammar fixes (#4705, #4748, #4750, #4763, #4788, #4792, #4810)

• Red’s dependencies have been bumped (#4572)

Redbot 3.4.5 (2020-12-24)

Thanks to all these amazing people that contributed to this release:

@Injabie3, @NeuroAssassin

End-user changelog

Streams

• Fixed Streams failing to load and work properly (#4687, #4688)

Redbot 3.4.4 (2020-12-24)

Thanks to all these amazing people that contributed to this release:

@aikaterna, @bobloy, @Flame442, @flaree, @jack1142, @Kowlin, @kreus7, @NeuroAssassin, @npc203, @palmtree5, @phenom4n4n, @Predeactor, @retke, @siu3334, @Vexed01, @yamikaitou

Read before updating

1. Information for Audio users that are using an external Lavalink instance (if you don’t know what that is, you should skip this point):

   Red 3.4.4 uses a new Lavalink jar that you will need to manually update from our GitHub.

2. Ubuntu 16.04 is no longer supported as it will soon reach its end of life and it is no longer viable for us to maintain support for it.

   While you might still be able to run Red on it, we will no longer put any resources into supporting it. If you’re using Ubuntu 16.04, we highly recommend that you upgrade to the latest LTS version of Ubuntu.

End-user changelog

Core Bot

• Red’s logging will now shine in your terminal more than ever (#4577)

• Improved consistency of command usage in the help messages within all commands in Core Red (#4589)

• Added a friendly error when the duration provided to commands that use the commands.TimedeltaConverter converter is out of the maximum bounds allowed by Python interpreter (#4019, #4628, #4630)

• Fixed an error when removing path from a different operating system than the bot is currently running on with [p]removepath (#2609, #4662, #4466)

Audio

• Fixed [p]llset java failing to set the Java executable path (#4621, #4624)

• Fixed Soundcloud playback (#4683)

• Fixed YouTube age-restricted track playback (#4683)

• Added more friendly messages for 429 errors to let users know they have been temporarily banned from accessing the service instead of a generic Lavalink error (#4683)

• Environment information will now be appended to Lavalink tracebacks in the spring.log (#4683)

Cleanup

• [p]cleanup self will now delete the command message when the bot has permissions to do so (#4640)

Dev

• Added new [p]bypasscooldown command that allows owners to bypass command cooldowns (#4440)

Economy

• [p]economyset slotmin and [p]economyset slotmax now warn when the new value will cause the slots command to not work (#4583)

General

• Updated features list in [p]serverinfo with the latest changes from Discord (#4678)

Mod

• [p]ban command will no longer error out when the given reason is too long (#4187, #4189)

Streams

• Scheduled YouTube streams now work properly with the cog (#3691, #4615)

• YouTube stream schedules are now announced before the stream (#4615)

  • Alerts about YouTube stream schedules can be disabled with a new [p]streamset ignoreschedule command (#4615)

• Improved error logging (#4680)

Trivia Lists

• Added whosthatpokemon5 trivia list containing Pokémon from the 5th generation (#4646)

• Added geography trivia list (#4618)

Developer changelog

• get_audit_reason() can now be passed a shorten keyword argument which will automatically shorten the returned audit reason to fit the max length allowed by Discord audit logs (#4189)

• bot.remove_command() now returns the command object of the removed command as does the equivalent method from discord.ext.commands.Bot class (#4636)

Documentation changes

• Added cog guide for Downloader cog (#4511)

• Added cog guide for Economy cog (#4519)

• Added cog guide for Streams cog (#4521)

• Added Becoming an Approved Cog Creator document (#4637)

• Removed install instructions for Ubuntu 16.04 (#4650)

Redbot 3.4.3 (2020-11-16)

Thanks to all these amazing people that contributed to this release:

@aikaterna, @bobloy, @Flame442, @jack1142, @KianBral, @maxbooiii, @phenom4n4n, @Predeactor, @retke

Read before updating

1. Information for Audio users that are using an external Lavalink instance (if you don’t know what that is, you should skip this point):

   Red 3.4.3 uses a new Lavalink jar that you will need to manually update from our GitHub.

End-user changelog

Core Bot

• Added [p]set competing command that allows users to set the bot’s competing status (#4607, #4609)

Audio

• Volume changes on ARM systems running a 64 bit OS will now work again (#4608)

• Fixed only 100 results being returned on a Youtube playlist (#4608)

• Fixed YouTube VOD duration being set to unknown (#3885, #4608)

• Fixed some YouTube livestreams getting stuck (#4608)

• Fixed internal Lavalink manager failing for Java with untypical version formats (#4608)

• Improved AAC audio handling (#4608)

• Added support for SoundCloud HLS streams (#4608)

Economy

• The [p]leaderboard command no longer fails in DMs when a global bank is used (#4569)

Mod

• The ban reason is now properly set in the audit log and modlog when using the [p]massban command (#4575)

• The [p]userinfo command now shows the new Competing activity (#4610, #4611)

Modlog

• The [p]case and [p]casesfor commands no longer fail when the bot doesn’t have Read Message History permission in the modlog channel (#4587, #4588)

Mutes

• Fixed automatic remuting on member join for indefinite mutes (#4568)

Trivia

• [p]triviaset custom upload now ensures that the filename is lowercase when uploading (#4594)

Developer changelog

• modlog.get_case() and methods using it no longer raise when the bot doesn’t have Read Message History permission in the modlog channel (#4587, #4588)

Documentation changes

• Added guide for Cog Manager UI (#4152)

• Added cog guide for CustomCommands cog (#4490)

Redbot 3.4.2 (2020-10-28)

Thanks to all these amazing people that contributed to this release:

@aikaterna, @Drapersniper, @jack1142, @Kowlin, @PredaaA, @Stonedestroyer

Read before updating

1. Information for Audio users that are using an external Lavalink instance (if you don’t know what that is, you should skip this point):

   Red 3.4.2 uses a new Lavalink jar that you will need to manually update from our GitHub.

End-user changelog

• Core Bot - Added info about the metadata file to redbot --debuginfo (#4557)

• Audio - Fixed the [p]local search command (#4553)

• Audio - Fixed random “Something broke when playing the track.” errors for YouTube tracks (#4559)

• Audio - Commands in [p]llset group can now be used in DMs (#4562)

• Mod - Fixed [p]massban not working for banning members that are in the server (#4556, #4555)

• Streams - Added error messages when exceeding the YouTube quota in the Streams cog (#4552)

• Streams - Improved logging for unexpected errors in the Streams cog (#4552)

Documentation changes

• Added cog guide for Cleanup cog (#4488)

• Removed multi-line commands from Linux install guides to avoid confusing readers (#4550)

Redbot 3.4.1 (2020-10-27)

Thanks to all these amazing people that contributed to this release:

@absj30, @aikaterna, @bobloy, @chloecormier, @Dav-Git, @Drapersniper, @fixator10, @Flame442, @flaree, @Generaleoley, @hisztendahl, @jack1142, @KaiGucci, @Kowlin, @maxbooiii, @MeatyChunks, @NeuroAssassin, @nfitzen, @palmtree5, @phenom4n4n, @PredaaA, @Predeactor, @PythonTryHard, @SharkyTheKing, @Stonedestroyer, @thisisjvgrace, @TrustyJAID, @TurnrDev, @Vexed01, @Vuks69, @xBlynd, @zephyrkul

Read before updating

1. This release fixes a security issue in Mod cog. See Security changelog below for more information.

2. This Red update bumps discord.py to version 1.5.1, which explicitly requests Discord intents. Red requires all Privileged Intents to be enabled. More information can be found at Enabling Privileged Intents.

3. Mutes functionality has been moved from the Mod cog to a new separate cog (Mutes) featuring timed and role-based mutes. If you were using it (or want to start now), you can load the new cog with [p]load mutes. You can see the full Mutes changelog below.

4. Information for Audio users that are using an external Lavalink instance (if you don’t know what that is, you should skip this point):

   We’ve updated our application.yml file and you should update your instance’s application.yml appropriately. Please ensure that the WS port in Audio’s settings ([p]llset wsport) is set to the port from the application.yml.

End-user changelog

Security

NOTE: If you can’t update immediately, we recommend globally disabling the affected command until you can.

• Mod - Fixed unauthorized privilege escalation exploit in [p]massban (also called [p]hackban) command. Full security advisory can be found on our GitHub.

Core Bot

• Fixed an incorrect error being reported on [p]set name when the passed name was longer than 32 characters (#4364, #4363)

• Fixed [p]set nickname erroring when the passed name was longer than 32 characters (#4364, #4363)

• Fixed an ungraceful error being raised when running [p]traceback with closed DMs (#4329)

• Fixed errors that could arise from invalid URLs in [p]set avatar (#4437)

• Fixed an error being raised with [p]set nickname when no nickname was provided (#4451)

• Fixed and clarified errors being raised with [p]set username (#4463)

• Fixed an ungraceful error being raised when the output of [p]unload is larger than 2k characters (#4469)

• Fixed an ungraceful error being raised when running [p]choose with empty options (#4499)

• Fixed an ungraceful error being raised when a bot left a guild while a menu was open (#3902)

• Fixed info missing on the non-embed version of [p]debuginfo (#4524)

• Added [p]set api list to list all currently set API services, without tokens (#4370)

• Added [p]set api remove to remove API services, including tokens (#4370)

• Added [p]helpset usetick, toggling command message being ticked when help is sent to DM (#4467, #4075)

• Added a default color field to [p]set showsettings (#4498, #4497)

• Added the datapath and metadata file to [p]debuginfo (#4524)

• Added a list of disabled intents to [p]debuginfo (#4423)

• Bumped discord.py dependency to version 1.5.1 (#4423)

• Locales and regional formats can now be set in individual guilds using [p]set locale and [p]set regionalformat (#3896, #1970)

  • Global locale and regional format setters have been renamed to [p]set globallocale and [p]set globalregionalformat

Audio

• Scattered grammar and typo fixes (#4446)

• Fixed Bandcamp playback (#4504)

• Fixed YouTube playlist playback (#4504)

• Fixed YouTube searching issues (#4504)

• Fixed YouTube age restricted track playback (#4504)

• Fixed the Audio cog not being translated when setting locale (#4492, #4495)

• Fixed tracks getting stuck at 0:00 after long player sessions (#4529)

• Removed lavalink logs from being added to backup (#4453, #4452)

• Removed stream durations from being in queue duration (#4513)

• Added the Global Audio API, to cut down on Youtube 429 errors and allow Spotify playback past user’s quota. (#4446)

• Added persistent queues, allowing for queues to be restored on a bot restart or cog reload (#4446)

• Added [p]audioset restart, allowing for Lavalink connection to be restarted (#4446)

• Added [p]audioset autodeafen, allowing for bot to auto-deafen itself when entering voice channel (#4446)

• Added [p]audioset mycountrycode, allowing Spotify search locale per user (#4446)

• Added [p]llsetup java, allowing for a custom Java executable path (#4446)

• Added [p]llset info to show Lavalink settings (#4527)

• Added [p]audioset logs to download Lavalink logs if the Lavalink server is set to internal (#4527)

Cleanup

• Allowed [p]cleanup self to work in DMs for all users (#4481)

Custom Commands

• Fixed an ungraceful error being thrown on [p]cc edit (#4325)

Dev

• Added [p]repl pause to pause/resume the REPL session in the current channel (#4366)

Economy

• Added an embed option for [p]leaderboard (#4184, #4104)

General

• Fixed issues with text not being properly URL encoded (#4024)

• Fixed an ungraceful error occurring when a title is longer than 256 characters in [p]urban (#4474)

• Changed “boosters” to “boosts” in [p]serverinfo to clarify what the number represents (#4507)

Mod

• Added [p]modset mentionspam strict allowing for duplicated mentions to count towards the mention spam cap (#4359)

• Added an option to ban users not in the guild to [p]ban (#4422, #4419)

• Added a default tempban duration for [p]tempban (#4473, #3992)

• Fixed nicknames not being properly stored and logged (#4131)

• Fixed plural typos in [p]userinfo (#4397, #4379)

• Renamed [p]hackban to [p]massban, keeping [p]hackban as an alias, allowing for multiple users to be banned at once (#4422, #4419)

• Moved mutes to a separate, individual cog (#3634)

Mutes

• Added [p]muteset forcerole to make mutes role based, instead of permission based (#3634)

• Added an optional time argument to all mutes, to specify when the user should be unmuted (#3634)

• Changed [p]mute to only handle serverwide muting, [p]mute voice and [p]mute channel have been moved to separate commands called [p]mutechannel and [p]mutevoice (#3634)

• Mute commands can now take multiple user arguments, to mute multiple users at a time (#3634)

Modlog

• Fixed an error being raised when running [p]casesfor and [p]case (#4415)

• Long reasons in Modlog are now properly shortened in message content (#4541)

Trivia Lists

• Fixed incorrect order of Machamp and Machoke questions (#4424)

• Added new MLB trivia list (#4455)

• Added new Who’s That Pokémon - Gen. IV trivia list (#4434)

• Added new Hockey trivia list (#4384)

Warnings

• Fixed users being able to warn users above them in hierarchy (#4100)

• Added bool arguments to toggle commands to improve consistency (#4409)

Developer changelog

Important:

1. Red now allows users to set locale per guild, which requires 3rd-party cogs to set contextual locale manually in code ran outside of command’s context. See the Core Bot changelog below for more information.

Core Bot

• Added API for setting contextual locales (#3896, #1970)

  • New function added: redbot.core.i18n.set_contextual_locales_from_guild()

  • Contextual locale is automatically set for commands and only needs to be done manually for things like event listeners; see Recommendations for Cog Creators for more information

• Added bot.remove_shared_api_services() to remove all keys and tokens associated with an API service (#4370)

• Added an option to return all tokens for an API service if service_name is not specified in bot.get_shared_api_tokens() (#4370)

• Added bot.get_or_fetch_user() and bot.get_or_fetch_member() methods (#4403, #4402)

• Moved redbot.core.checks.bot_in_a_guild() to redbot.core.commands.bot_in_a_guild() (old name has been left as an alias) (#4515, #4510)

Bank

• Bank API methods now consistently throw TypeError if a non-integer amount is supplied (#4376)

Mod

• Deprecated redbot.core.utils.mod.is_allowed_by_hierarchy (#4435)

Modlog

• Added an option to accept a discord.Object in case creation (#4326)

• Added last_known_username parameter to modlog.create_case() function (#4326)

• Fixed an error being raised with a deleted channel in Case.message_content() (#4415)

Utility

• Added redbot.core.utils.get_end_user_data_statement() and redbot.core.utils.get_end_user_data_statement_or_raise() to attempt to fetch a cog’s End User Data Statement (#4404)

• Added redbot.core.utils.chat_formatting.quote() to quote text in a message (#4425)

Documentation changes

Config

• Added custom group documentation and tutorial (#4416, #2896)

Modlog

• Clarified that naive datetime objects will be treated as local times for parameters created_at and until in modlog.create_case() (#4389)

Other

• Added guide to creating a Bot Application in Discord Developer Portal, with enabling intents (#4502)

Miscellaneous

• Added JSON schema files for info.json files (#4375)

• Added [all] and [dev] bundled install extras (#4443)

• Replaced the link to the approved repository list on CogBoard and references to cogs.red with a link to new Red Index (#4439)

• Improved documentation about arguments in command syntax (#4058)

• Replaced a few instances of Red with the bot name in command docstrings (#4470)

• Fixed grammar in places scattered throughout bot (#4500)

• Properly define supported Python versions to be lower than 3.9 (#4538)

Redbot 3.4.0 (2020-08-17)

Thanks to all these amazing people that contributed to this release:

@Dav-Git, @DevilXD, @douglas-cpp, @Drapersniper, @flaree, @jack1142, @kablekompany, @Kowlin, @maxbooiii, @MeatyChunks, @mikeshardmind, @NeuroAssassin, @PredaaA, @Predeactor, @retke, @SharkyTheKing, @thisisjvgrace, @Tinonb, @TrustyJAID, @Twentysix26, @Vexed01, @zephyrkul

Read before updating:

1. Red 3.4 comes with support for data deletion requests. Bot owners should read Red and End User Data to ensure they know what information about their users is stored by the bot.

2. Debian Stretch, Fedora 30 and lower, and OpenSUSE Leap 15.0 and lower are no longer supported as they have already reached end of life.

3. There’s been a change in behavior of [p]tempban. Look at Mod changelog for full details.

4. There’s been a change in behavior of announcements in Admin cog. Look at Admin changelog for full details.

5. Red 3.4 comes with breaking changes for cog developers. Look at Developer changelog for full details.

End-user changelog

Core Bot

• Added per-guild cog disabling (#4043, #3945)

  • Bot owners can set the default state for a cog using [p]command defaultdisablecog and [p]command defaultenablecog commands

  • Guild owners can enable/disable cogs for their guild using [p]command disablecog and [p]command enablecog commands

  • Cogs disabled in the guild can be listed with [p]command listdisabledcogs

• Added support for data deletion requests; see Red and End User Data for more information (#4045)

• Red now logs clearer error if it can’t find package to load in any cog path during bot startup (#4079)

• [p]licenseinfo now has a 3 minute cooldown to prevent a single user from spamming channel by using it (#4110)

• Added [p]helpset showsettings command (#4013, #4022)

• Updated Red’s emoji usage to ensure consistent rendering accross different devices (#4106, #4105, #4127)

• Whitelist and blacklist are now called allowlist and blocklist. Old names have been left as aliases (#4138)

Admin

• [p]announce will now only send announcements to guilds that have explicitly configured text channel to send announcements to using [p]announceset channel command (#4088, #4089)

Downloader

• [p]cog info command now shows end user data statement made by the cog creator (#4169)

• [p]cog update command will now notify the user if cog’s end user data statement has changed since last update (#4169)

Mod

• [p]tempban now respects default days setting ([p]modset defaultdays) (#3993)

• Users can now set mention spam triggers which will warn or kick the user. See [p]modset mentionspam for more information (#3786, #4038)

• [p]mute voice and [p]unmute voice now take action instantly if bot has Move Members permission (#4064)

• Added typing to [p](un)mute guild to indicate that mute is being processed (#4066, #4172)

ModLog

• Added timestamp to text version of [p]casesfor and [p]case commands (#4118, #4137)

Streams

• Stream alerts will no longer make roles temporarily mentionable if bot has “Mention @everyone, @here, and All Roles” permission in the channel (#4182)

• Mixer service has been closed and for that reason we’ve removed support for it from the cog (#4072)

• Hitbox commands have been renamed to smashcast (#4161)

• Improve error messages for invalid channel names/IDs (#4147, #4148)

Trivia Lists

• Added whosthatpokemon2 trivia containing Pokémons from 2nd generation (#4102)

• Added whosthatpokemon3 trivia containing Pokémons from 3rd generation (#4141)

Developer changelog

Important:

1. Red now offers cog disabling API, which should be respected by 3rd-party cogs in guild-related actions happening outside of command’s context. See the Core Bot changelog below for more information.

2. Red now provides data request API, which should be supported by all 3rd-party cogs. See the changelog entries in the Core Bot changelog below for more information.

Breaking changes

• By default, none of the .send() methods mention roles or @everyone/@here (#3845)

  • see discord.AllowedMentions and allowed_mentions kwarg of .send() methods, if your cog requires to mention roles or @everyone/@here

• Context.maybe_send_embed() now supresses all mentions, including user mentions (#4192)

• The default value of the filter keyword argument has been changed to None (#3845)

• Cog package names (i.e. name of the folder the cog is in and the name used when loading the cog) now have to be valid Python identifiers (#3605, #3679)

• Method/attribute names starting with red_ or being in the form of __red_*__ are now reserved. See Versioning for more information (#4085)

• humanize_list() no longer raises IndexError for empty sequences (#2982)

• Removed things past deprecation time: (#4163)

  • redbot.core.commands.APIToken

  • loop kwarg from bounded_gather_iter(), bounded_gather(), and start_adding_reactions()

Core Bot

• Added cog disabling API (#4043, #3945)

  • New methods added: bot.cog_disabled_in_guild(), bot.cog_disabled_in_guild_raw()

  • Cog disabling is automatically applied for commands and only needs to be done manually for things like event listeners; see Recommendations for Cog Creators for more information

• Added data request API (#4045, #4169)

  • New special methods added to redbot.core.commands.Cog: red_get_data_for_user() (documented provisionally), red_delete_data_for_user()

  • New special module level variable added: __red_end_user_data_statement__

  • These methods and variables should be added by all cogs according to their documentation; see Recommendations for Cog Creators for more information

  • New info.json key added: end_user_data_statement; see Info.json format documentation for more information

• Added bot.message_eligible_as_command() utility method which can be used to determine if a message may be responded to as a command (#4077)

• Added a provisional API for replacing the help formatter. See documentation for more details (#4011)

• bot.ignored_channel_or_guild() now accepts discord.Message objects (#4077)

• commands.NoParseOptional is no longer provisional and is now fully supported part of API (#4142)

• Red no longer fails to run subcommands of a command group allowed or denied by permission hook (#3956)

• Autohelp in group commands is now sent after invoking the group, which allows before invoke hooks to prevent autohelp from getting triggered (#4129)

• RPC functionality no longer makes Red hang for a minute on shutdown (#4134, #4143)

Vendored packages

• Updated discord.ext.menus vendor (#4167)

Utility Functions

• humanize_list() now accepts locale and style keyword arguments. See its documentation for more information (#2982)

• humanize_list() is now properly localized (#2906, #2982)

• humanize_list() now accepts empty sequences (#2982)

Documentation changes

• Removed install instructions for Debian Stretch (#4099)

• Added admin user guide (#3081)

• Added alias user guide (#3084)

• Added bank user guide (#4149)

Miscellaneous

• Updated features list in [p]serverinfo with the latest changes from Discord (#4116)

• Simple version of [p]serverinfo now shows info about more detailed [p]serverinfo 1 (#4121)

• [p]set nickname, [p]set serverprefix, [p]streamalert, and [p]streamset commands now can be run by users with permissions related to the actions they’re making (#4109)

• bordered() now uses + for corners if keyword argument ascii_border is set to True (#4097)

• Fixed timestamp storage in few places in Red (#4017)