Warning

This document is for Red's development version, which can be significantly different from previous releases. If you're a regular user, you should read the Red documentation for the current stable release.

Redbot 3.4.14 (2021-09-23)

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

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)

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:

    https://user-images.githubusercontent.com/6032823/132610057-d6c65d67-c244-4f0b-9458-adfbe0c68cab.png
  • 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

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:

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:

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)

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:

    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)

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)

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:

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

Redbot 3.4.6 (2021-02-16)

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

Dev Cog

Documentation changes

Miscellaneous

Redbot 3.4.5 (2020-12-24)

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

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:

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

Redbot 3.4.3 (2020-11-16)

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

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)

Redbot 3.4.2 (2020-10-28)

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

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

Redbot 3.4.1 (2020-10-27)

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

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

Utility

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:

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

Core Bot

Vendored packages

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

Utility Functions

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)