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.3.6 (2020-04-27)

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

End-user changelog

Core Bot

  • Converting from and to Postgres driver with redbot-setup convert have been fixed (#3714, #3115)
  • Fixed big delays in commands that happened when the bot was owner-less (or if it only used co-owners feature) and command caller wasn’t the owner (#3782)
  • Various optimizations
    • Reduced calls to data backend when loading bot’s commands (#3764)
    • Reduced calls to data backend when showing help for cogs/commands (#3766)
    • Improved performance for bots with big amount of guilds (#3767)
    • Mod cog no longer fetches guild’s bans every 60 seconds when handling unbanning for tempbans (#3783)
    • Reduced the bot load for messages starting with a prefix when fuzzy search is disabled (#3718)
    • Aliases in Alias cog are now cached for better performance (#3788)

Core Commands

  • [p]set avatar now supports setting avatar using attachment (#3747)
  • Added [p]set avatar remove subcommand for removing bot’s avatar (#3757)
  • Fixed list of ignored channels that is shown in [p]ignore/[p]unignore (#3746)

Audio

  • Age-restricted tracks, live streams, and mix playlists from YouTube should work in Audio again (#3791)
  • Soundcloud’s sets and playlists with more than 50 tracks should work in Audio again (#3791)

CustomCommands

  • Added [p]cc raw command that gives you the raw response of a custom command for ease of copy pasting (#3795)

Modlog

  • Fixed AttributeError for cases whose moderator doesn’t share the server with the bot (#3784, #3778)

Streams

  • Fixed incorrect stream URLs for Twitch channels that have localised display name (#3773, #3772)

Trivia

  • Fixed the error in [p]trivia stop that happened when there was no ongoing trivia session in the channel (#3774)

Trivia Lists

  • Updated leagueoflegends list with new changes to League of Legends (b8ac70e)

Developer changelog

Utility Functions

Documentation changes

Miscellaneous

  • Config - JSON driver will now properly have only one lock per cog name (#3780)
  • Core Commands - [p]debuginfo now shows used storage type (#3794)
  • Trivia - Corrected spelling of Compact Disc in games list (#3759, #3758)

Redbot 3.3.5 (2020-04-09)

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

End-user changelog

Core Bot

  • “Outdated” field no longer shows in [p]info when Red is up-to-date (#3730)

Alias

  • Fixed regression in [p]alias add that caused it to reject commands containing arguments (#3734)

Redbot 3.3.4 (2020-04-05)

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

End-user changelog

Core Bot

  • Fixed checks related to bank’s global state that were used in commands in Bank, Economy and Trivia cogs (#3707)

Alias

  • [p]alias add now sends an error when command user tries to alias doesn’t exist (#3710, #3545)

Developer changelog

Core Bot

  • Bump dependencies, including update to discord.py 1.3.3 (#3723)

Utility Functions

Documentation changes

  • Versions of pre-requirements are now included in Windows install guide (#3708)

Redbot 3.3.3 (2020-03-28)

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

End-user changelog

Core Bot

  • Delete delay for command messages has been moved from Mod cog to Core (#3638, #3636)
  • Fixed various bugs with blacklist and whitelist (#3643, #3642)
  • Added [p]set regionalformat command that allows users to set regional formatting that is different from bot’s locale (#3677, #3588)
  • [p]set locale allows any valid locale now, not just locales for which Red has translations (#3676, #3596)
  • Permissions for commands in Bank, Economy and Trivia cogs can now be overriden by Permissions cog (#3672, #3233)
  • Outages of pypi.org no longer prevent the bot from starting (#3663)
  • Fixed formatting of help strings in fuzzy search results (#3673, #3507)
  • Fixed few deprecation warnings related to menus and uvloop (#3644, #3700)

Core Commands

  • [p]set game no longer errors when trying to clear the status (#3630, #3628)
  • All owner notifcations in Core now use proper prefixes in messages (#3632)
  • Added [p]set playing and [p]set streaming aliases for respectively [p]set game and [p]set stream (#3646, #3590)

ModLog

  • Modlog’s cases now keep last known username to prevent losing that information from case’s message on edit (#3674, #3443)

CustomCom

  • Added [p]cc search command that allows users to search through created custom commands (#2573)

Cleanup

  • Added [p]cleanup spam command that deletes duplicate messages from the last X messages and keeps only one copy (#3688)
  • Removed regex support in [p]cleanup self (#3704)

Downloader

  • [p]cog checkforupdates now includes information about cogs that can’t be installed due to Red/Python version requirements (#3678, #3448)

General

  • Added more detailed mode to [p]serverinfo command that can be accessed with [p]serverinfo 1 (#2382, #3659)

Image

  • Users can now specify how many images should be returned in [p]imgur search and [p]imgur subreddit using [count] argument (#3667, #3044)
  • [p]imgur search and [p]imgur subreddit now return one image by default (#3667, #3044)

Mod

  • [p]userinfo now shows user’s activities (#3669)
  • [p]userinfo now shows status icon near the username (#3669)
  • Muting no longer fails if user leaves while applying overwrite (#3627)
  • Fixed error that happened when Mod cog was loaded for the first time during bot startup (#3632, #3626)

Permissions

  • Commands for setting default rules now error when user tries to deny access to command designated as being always available (#3504, #3465)

Streams

  • Fixed an error that happened when no game was set on Twitch stream (#3631)
  • Preview picture for YouTube stream alerts is now bigger (#3689, #3685)
  • YouTube channels with a livestream that doesn’t have any current viewer are now properly showing as streaming (#3690)
  • Failures in Twitch API authentication are now logged (#3657)

Trivia

  • Added [p]triviaset custom upload/delete/list commands for managing custom trivia lists from Discord (#3420, #3307)
  • Trivia sessions no longer error on payout when winner’s balance would exceed max balance (#3666, #3584)

Warnings

  • Sending warnings to warned user can now be disabled with [p]warnset toggledm command (#2929, #2800)
  • Added [p]warnset warnchannel command that allows to set a channel where warnings should be sent to instead of the channel command was called in (#2929, #2800)
  • Added [p]warnset togglechannel command that allows to disable sending warn message in guild channel (#2929, #2800)
  • [p]warn now tells the moderator when bot wasn’t able to send the warning to the user (#3653, #3633)

Developer changelog

Core Bot

  • Deprecation warnings issued by Red now use correct stack level so that the cog developers can find the cause of them (#3644)

Dev Cog

  • Add __name__ to environment’s globals (#3649, #3648)

Documentation changes

Miscellaneous

  • Core Bot - Command errors (i.e. command on cooldown, dm-only and guild-only commands, etc) can now be translated (#3665, #2988)
  • Core Bot - redbot-setup now prints link to Getting started guide at the end of the setup (#3027)
  • Core Bot - Whitelist and blacklist commands now properly require passing at least one user (or role in case of local whitelist/blacklist) (#3652, #3645)
  • Downloader - Fix misleading error appearing when repo name is already taken in [p]repo add (#3695)
  • Downloader - Improved error messages for unexpected errors in [p]repo add (#3656)
  • Downloader - Prevent encoding errors from crashing [p]cog update (#3639, #3637)
  • Trivia - Non-finite numbers can no longer be passed to [p]triviaset timelimit, [p]triviaset stopafter and [p]triviaset payout (#3668, #3583)
  • Utility Functions - redbot.core.utils.menus.menu() now checks permissions before trying to clear reactions (#3589, #3145)

Redbot 3.3.2 (2020-02-28)

End-user changelog

Core Bot

  • Ignored guilds/channels and whitelist/blacklist are now cached for performance (#3472)
  • Ignored guilds/channels have been moved from Mod cog to Core (#3472)
  • [p]ignore channel command can now also ignore channel categories (#3472)

Core Commands

  • Core cogs will now send bot mention prefix properly in places where discord doesn’t render mentions (#3579, #3591, #3499)
  • Fix a bug with [p]blacklist add that made it impossible to blacklist users that bot doesn’t share a server with (#3472, #3220)
  • Improve user experience of [p]set game/listening/watching/ commands (#3562)
  • Add [p]licenceinfo alias for [p]licenseinfo command to conform with non-American English (#3460)

Admin

  • [p]announce will now only send error message if an actual errors occurs (#3514, #3513)

Alias

  • [p]alias help will now properly work in non-English locales (#3546)

Audio

  • Users should be able to play age-restricted tracks from YouTube again (#3620)

Economy

  • Next payday time will now be adjusted for users when payday time is changed (#3496, #3438)

Downloader

  • Downloader will no longer fail because of invalid info.json files (#3533, #3456)
  • Add better logging of errors when Downloader fails to add a repo (#3558)

Image

  • Fix load error for users that updated Red from version lower than 3.1 to version 3.2 or newer (#3617)

Mod

  • [p]hackban and [p]unban commands support user mentions now (#3524)
  • Ignored guilds/channels have been moved from Mod cog to Core (#3472)

Streams

  • Fix stream alerts for Twitch (#3487)
  • Significantly reduce the quota usage for YouTube stream alerts (#3237)
  • Add [p]streamset timer command which can be used to control how often the cog checks for live streams (#3237)

Trivia

  • Add better handling for errors in trivia session (#3606)

Trivia Lists

  • Remove empty answers in trivia lists (#3581)

Warnings

  • Users can now pass a reason to [p]unwarn command (#3490, #3093)

Developer changelog

Core Bot

  • Updated all our dependencies - we’re using discord.py 1.3.2 now (#3609)
  • Add traceback logging to task exception handling (#3517)
  • Developers can now create a command from an async function wrapped in functools.partial (#3542)
  • Bot will now show deprecation warnings in logs (#3527, #3615)
  • Subcommands of command group with invoke_without_command=True will again inherit this group’s checks (#3614)

Config

Utility Functions

Dev Cog

Downloader

  • Downloader will now replace [p] with clean prefix same as it does in help command (#3592)
  • Add schema validation to info.json file processing - it should now be easier to notice any issues with those files (#3533, #3442)

Documentation changes

  • Add guidelines for Cog Creators in Creating cogs for Red V3 document (#3568)
  • Restructure virtual environment instructions to improve user experience (#3495, #3411, #3412)
  • Getting started guide now explain use of quotes for arguments with spaces (#3555, #3111)
  • latest version of docs now displays a warning about possible differences from current stable release (#3570)
  • Make systemd guide clearer on obtaining username and python path (#3537, #3462)
  • Indicate instructions for different venv types in systemd guide better (#3538)
  • Service file in Setting up auto-restart using systemd on Linux now also waits for network connection to be ready (#3549)
  • Hide alias of randomize_colour in docs (#3491)
  • Add separate headers for each event predicate class for better navigation (#3595, #3164)
  • Improve wording of explanation for required_cogs key in Publishing cogs for Red V3 (#3520)

Miscellaneous

  • Use more reliant way of checking if command is bot owner only in [p]warnaction (Warnings cog) (#3516, #3515)
  • Update PyPI domain in [p]info and update checker (#3607)
  • Stop using deprecated code in core (#3610)

Redbot 3.3.1 (2020-02-05)

Core Bot

  • Add a cli flag for setting a max size of message cache
  • Allow to edit prefix from command line using redbot --edit.
  • Some functions have been changed to no longer use deprecated asyncio functions

Core Commands

  • The short help text for dm has been made more useful
  • dm no longer allows owners to have the bot attempt to DM itself

Utils

  • Passing the event loop explicitly in utils is deprecated (Removal in 3.4)

Mod Cog

  • Hackban now works properly without being provided a number of days

Documentation Changes

  • Add -e flag to journalctl command in systemd guide so that it takes the user to the end of logs automatically.
  • Added section to install docs for CentOS 8
  • Improve usage of apt update in docs

Redbot 3.3.0 (2020-01-26)

Core Bot

  • The bot’s description is now configurable.
  • We now use discord.py 1.3.1, this comes with added teams support.
  • The commands module has been slightly restructured to provide more useful data to developers.
  • Help is now self consistent in the extra formatting used.

Core Commands

  • Slowmode should no longer error on nonsensical time quantities.
  • Embed use can be configured per channel as well.

Documentation

  • We’ve made some small fixes to inaccurate instructions about installing with pyenv.
  • Notes about deprecating in 3.3 have been altered to 3.4 to match the intended timeframe.

Admin

  • Gives feedback when adding or removing a role doesn’t make sense.

Audio

  • Playlist finding is more intuitive.
  • disconnect and repeat commands no longer interfere with eachother.

CustomCom

  • No longer errors when exiting an interactive menu.

Cleanup

  • A rare edge case involving messages which are deleted during cleanup and are the only message was fixed.

Downloader

  • Some user facing messages were improved.
  • Downloader’s initialization can no longer time out at startup.

General

  • Roll command will no longer attempt to roll obscenely large amounts.

Mod

  • You can set a default amount of days to clean up when banning.
  • Ban and hackban now use that default.
  • Users can now optionally be DMed their ban reason.

Permissions

  • Now has stronger enforcement of prioritizing botwide settings.