Skip to content

Latest commit

 

History

History
663 lines (524 loc) · 53.5 KB

CHANGELOG.md

File metadata and controls

663 lines (524 loc) · 53.5 KB
Raw

Changelog

3.2.1

  • Bot#stop and Gateway#stop now explicitly return nil, for more convenient use in commands
  • The API method to query for users has been removed as the endpoint no longer exists
  • Some more methods have been changed to resolve IDs, which means they can be called with integer and string IDs instead of just the objects (#313, thanks @LikeLakers2)
  • Bulk deleting now uses the new non-deprecated URL – this has no immediate effect, but once the old one will be removed bots using it will not be able to bulk delete anymore (see also #309)

Bugfixes

  • Fixed another bug with resumes that caused issues when resuming a zombie connection
  • Fixed a bug that caused issues when playing short files (#326)

3.2.0.1

  • Attempt to fix an issue that causes a strange problem with dependencies when installing discordrb

3.2.0

  • Various parts of gateway error handling were improved, leading to significant stability improvements:
    • A long standing bug was fixed that prevented resumes in most cases, which caused unnecessary reconnections.
    • The error handler that handles problems with sending the raw data over TCP now catches errors more broadly.
    • Heartbeat ACKs (opcode 11) are now checked, which allows the client to detect zombie connections early on. If this causes problems for you you can disable it using bot.gateway.check_heartbeat_acks = false.
    • Received heartbeats are now properly handled again
  • Added a client for webhooks, implemented as a separate gem discordrb-webhooks. This allows the creation of applications that only use webhooks without the overhead provided by the rest of discordrb. The gem is added as a dependency by normal discordrb so you don't need to install it separately if you're already using that.
  • Adding, updating or deleting custom emoji is now supported (#285, thanks @Daniel-Worrall)
  • Rich embeds can now be sent alongside messages, for example using the embed parameter in send_message, or with the new method Channel#send_embed
  • advanced_functionality bots now support escaping using backslashes (#293 / #304, thanks @LikeLakers2)
  • Added type checking and conversion for commands (#298, thanks @ohtaavi)
  • Bulk deleting messages now checks for message age (see also hammerandchisel/discord-api-docs#208). By default, it will ignore messages that are too old to be bulk deleted, but there is also a strict mode setting now that raises an exception in such a case.
  • Reactions can now be viewed for existing messages (#262, thanks @z64), added to messages (#266, thanks @z64), and listened for using gateway events as well as internal handlers (#300).
  • Game types and stream URLs are now cached (#297)
  • The default non-streaming game was changed to be 0 instead of nil (#277, thanks @zeyla)
  • A method Channel#delete_message was added to support deleting single messages by ID without prior resolution.
  • Permission overwrites can now be deleted from channels (#268, thanks @greenbigfrog)
  • There is now a utility method IDObject.synthesise that creates snowflakes with specific timestamps out of thin air.
  • Typing events are now respondable, so you can call #respond on them for example (#270, thanks @VxJasonxV)
  • Message authors can now be User objects if a Member object could not be found or created (#290)
  • Added two new events, unknown (#288) and raw, that are raised for unknown dispatches and all dispatches, respectively.
  • Bots can now be set to fully ignore other bots (#257, thanks @greenbigfrog)
  • Voice state update events now have an old_channel property/attribute that denotes the previous channel the user was in in case of joining/moving/leaving.
  • The default help command no longer shows commands the user can't use (#275, thanks @FormalHellhound)
  • Updated the command example to no longer include user-specific stuff (#260)
  • Server#role now resolves IDs, so they can be passed as strings if necessary.

Bugfixes

  • Fixed bots' shard settings being ignored in certain cases
  • Parsing role mentions using Bot#parse_mention works properly now.
  • Fixed some specific REST methods that were broken by the API module refactor (#302, thanks @LikeLakers2)
  • Cached channel data is now updated properly on change (#272)
  • Users' avatars are now updated properly on change (#265, thanks @Roughsketch)
  • Fixed voice state tracking for newly created channels (#292)
  • Fixed event attribute handling for PlayingEvent (#303, thanks @sven-strothoff)
  • Getting specific emoji by ID no longer fails to resolve non-cached emoji (#283, thanks @greenbigfrog)
  • Voice state update events no longer fail to be raised for users leaving channels, if the event handler had a channel attribute set (#301)
  • Bots that don't define any events should work properly again
  • Fixed error handling for messages over the character limit (#276)
  • Fixed some specific log messages not being called properly (#263, thanks @Roughsketch)
  • Fixed some edge case bugs in the default help command:
    • In the case of too many commands to be sent in the channel, it no longer replies with "Sending help in PM!" when called from PM
    • It no longer fails completely if called from PM if there are any commands that require server-specific checks (#308)
    • Fixed a slight formatting mistake
  • Quoted command arguments in advanced_functionality are no longer split by newline
  • Fixed a specific edge case in command chain handling where handling commands with the same name as the chain delimiter was broken

3.1.1

Bugfix-only release.

Bugfixes

  • An oversight where a GUILD_DELETE dispatch would cause an internal error was fixed. (#256, thanks @greenbigfrog)

3.1.0

  • Emoji handling support (#226, thanks @greenbigfrog)
  • A channels attribute has been added to CommandBot as well as Command to restrict the channels in which either of the two works (#249, thanks @Xzanth)
  • The bulk deletion endpoint is now exposed directly using the Channel#delete_messages method (#235, thanks @z64)
  • The internal settings fields for user statuses that cause statuses to persist across restarts can now be modified (#233, thanks @Daniel-Worrall)
  • A few examples have been added to the docs (#250, thanks @SunDwarf)
  • The specs have been improved; they're still not exhaustive by far but there are at least slightly more now.

Bugfixes

  • Fixed an important bug that caused the logger not to work in some cases. (#243, thanks @Daniel-Worrall)
  • Fixed logger token redaction.
  • unavailable_servers should no longer crash the bot due to being nil in some cases (#244, thanks @Daniel-Worrall)
  • Profile#on for member resolution is now no longer overwritten by an alias for #online (#247, thanks @Daniel-Worrall)
  • A CommandBot without any commands should no longer crash when receiving a message that triggers it (#242)
  • Changing nicknames works again, it has apparently been broken in 3.0.0.

3.0.2

  • A small change to how CommandBot parameter lists are formatted (#240, thanks @FormalHellhound)

Bugfixes

  • Setting properties on a channel (e.g. Channel#topic=) works again (#238 / #239, thanks @Daniel-Worrall)

3.0.1

A tiny update to support webhook-sent messages properly!

  • Added the utility methods Message#webhook? and User#webhook? to check whether a message or a user belongs to a webhook
  • Added Message#webhook_id to get the ID of the sending webhook for webhook messages
  • Added the webhook_commands parameter to CommandBot that, if false (default true), prevents webhook-sent messages from being parsed and handled as commands.

Bugfixes

  • Fixed webhook-sent messages being ignored because their author couldn't be resolved.
  • Fixed a minor performance problem where a CommandBot would create unnecessarily create redundant objects for every received message.

3.0.0

I didn't think there could possibly be a release larger than 2.0.0 was, but here it is! Including the respective release commit, there were 540 commits from 1.8.1 to 2.0.0, but a whopping 734 commits from 2.1.3 to 3.0.0.

As with 2.0.0, there are some breaking changes! They are, as always, highlighted in bold.

  • The application_id parameter has been renamed to client_id. With the changes to how bot applications work, it would just be confusing to have it be called application_id any longer. If you try to use application_id now, it will raise a descriptive exception; with 3.1.0 that will be removed too (you'll get a less descriptive exception).
  • The gateway implementation has been completely rewritten, for more performance, stability and maintainability. This means that to call some internal methods like inject_reconnect, a Gateway instance (available as Bot#gateway) now needs to be used.
  • User login using email and password has been removed. Use a user token instead, see also here.
  • In addition to the rewrite, the gateway version has also been upgraded to protocol version 6 (the rewrite was for v5). With this, the way channel types are handled has been changed a bit! If you've been using the abstraction methods like Channel#voice?, you should be fine though. This also includes support for group chats on user accounts, as that was the only real functionality change on v6. (#211, thanks @Daniel-Worrall)
  • Custom prefix handlers for CommandBots now get the full message object as their parameter rather than only the content, for even more flexibility.
  • For internal consistency, the UnknownGuild error was renamed to UnknownServer. I doubt this change affects anyone, but if you handle that error specifically in your bot, make sure to change it.
  • The API module has undergone a refactor, if you were using any manual API calls you will have to update them to the new format. Specifically, endpoints dealing with channels have been moved to API::Channel, ones dealing with users to API::User and so on. (#203, thanks @depl0y)
  • Calling users on a text channel will now only return users who have permission to read it (#186)
  • A variety of new fields have been added to Message objects, specifically embeds (Message#embeds), when it was last edited (#edited_timestamp), whether it uses TTS (#tts?), its nonce (#nonce), whether it was ever edited (#edited?), and whether it mentions everyone (mention_everyone?) (#206, thanks @SnazzyPine25)
  • A variety of new functionality has been added to Server and Channel objects (#181, thanks @SnazzyPine25):
    • Bitrate and user limit can now be read and set for voice channels
    • Server integrations can now be read
    • Server features and verification level can now be read
    • Utility functions to generate widget, widget banner and splash URLs
  • Message pinning is now supported, both reading pin status and pinning existing messages (#145 / #146, thanks @hlaaftana)
  • Support for the new available statuses:
    • Bot#dnd to make the bot show up as DnD (red dot)
    • Bot#invisible to make the bot show up as offline
  • Setting the bot's status to streaming is now supported (#128 and #143, thanks @SnazzyPine25 and @barkerja)
  • You can now set a message to be sent when a CommandBot's command fails with a NoPermission error (#200, thanks @PoVa)
  • There is now an optional field to list the parameters a command can accept (#201, thanks @FormalHellhound)
  • Commands can now have an array of roles set that are required to be able to use it (#178, thanks @PoVa)
  • Methods like CommandEvent#<< for quickly responding to an event are now available in MessageEvent too (#154, thanks @hlaaftana)
  • Temporary messages, that automatically delete after some time, can now be sent to channels (#136 / #139, thanks @unleashy)
  • Captions can now be sent together with files, and files can be attached to events to be sent on completion (#130, thanks @SnazzyPine25)
  • There is now a Channel#load_message method to get a single message by its ID (#174, thanks @z64)
  • Channel#define_overwrite can now be used with a Profile object, together with some internal changes (#232)
  • There are now endpoint methods to list a server's channels and channel invites (#197)
  • Two methods, Member#roles= and Member#modify_roles to manipulate a member's roles in a more advanced way have been added (#223, thanks @z64)
  • Role mentionability can now be set using Role#mentionable=
  • The current bot's OAuth application can now be read (#175, thanks @SnazzyPine25)
  • You can now mute and deafen other members (#157, thanks @SnazzyPine25)
  • The internal Logger now supports writing to a file instead of STDOUT (#171)
    • Building on top of that, you can also write to multiple streams at the same time now, in case you want to have input on both a file and STDOUT, or even more advanced setups. (#217, thanks @PoVa)
  • Roles can now have their permissions bitfield set directly (#177)
  • The Bot#invite_url method now supports adding permission bits into the generated URL (#218, thanks @PoVa)
  • A utility method User#send_file has been added to directly send a file to a user in PM (#168 / #172, thanks @SnazzyPine25)
  • You can now get the list of members that have a particular role assigned using Role#members (#147, thanks @hlaaftana)
  • You can now check whether a VoiceBot is playing right now using #playing? (#137, thanks @SnazzyPine25)
  • You can now get the channel a VoiceBot is playing on (#138, thanks @snapcase)
  • The permissions bit map has been updated for emoji, "Administrator" and nickname changes (#180, thanks @megumisonoda)
  • A method Bot#connected? has been added to check whether the bot is currently connected to the gateway.
  • The indescriptive error message that was previously sent when calling methods like Bot#game= without an active gateway connection has been replaced with a more descriptive one.
  • The bot's token is now, by default, redacted from any logging output; this can be turned off if desired using the redact_token initialization parameter. (#225 / #231, thanks @Daniel-Worrall)
  • The new rate limit headers are now supported. This will have no real impact on any code using discordrb, but it means discordrb is now considered compliant again. See also here.
  • Rogue presences, i.e. presences without an associated cached member, now print a log message instead of being completely ignored
  • A variety of aliases have been added to existing methods.
  • An example to show off voice sending has been added to the repo, and existing examples have been improved.
  • A large amount of fixes and clarifications have been made to the docs.

Bugfixes

  • The almost a year old bug where changing the own user's username would reset its avatar has finally been fixed.
  • The issue where resolving a large server with the owner offline would sometimes cause a stack overflow has been fixed (#169 / #170 / #191, thanks @stoodfarback)
  • Fixed an issue where if a server had an AFK channel set, but that AFK channel couldn't be connected to, resolving the server (and in turn all objects depending on it) would fail. This likely fixes any random NoPermission errors you've ever encountered in your log.
  • A message's author will be resolved over the REST API like other objects in case it's not cached yet. This should fix all instances of "Member not cached even thought it should be". (#210, thanks @megumisonoda)
  • Voice state handling has been completely redone, fixing a variety of caching issues. (#159)
  • Getting a voice channel's users no longer does a chunk request (#142)
  • Channel#define_overwrite can now be used to define user overwrites, apparently that didn't work at all before
  • Nested command chains where an inner command doesn't exist now no longer crash the command chain handler (#215)
  • Gateway errors should no longer spam the console (#141 / #148, thanks @meew0)
  • Role hoisting (both setting and reading it) should now work properly
  • The VoiceBot#stop_playing method should now work more predictably
  • Voice states with a nil channel should no longer crash when accessed (#183, thanks @Apexal)
  • A latent bug in how PM channels were cached is fixed, previously they were cached twice - once by channel ID and once by recipient ID. Now they're only cached by recipient ID.
  • Two problems in how Discord outages are handled are now fixed; the bot should now no longer break when one happens. Specifically, the fixed problems are:
    • GUILD_DELETE events for unavailable servers are now ignored
    • Opcode 9 packets which are received while no session currently exists are handled correctly
  • A possible regression in PM channel creation was fixed. (#227 / #228, thanks @heimidal)

2.1.3

Bugfix-only release.

Bugfixes

  • Various messages that were just printed to stdout that should have been using the Logger system now do (#132 and #133, thanks @PoVa)
  • A mistake in the documentation was fixed (#140)
  • Handling of the GUILD_MEMBER_DELETE gateway event should now work even if, for whatever reason, Discord sends an invalid server ID (#129)
  • If the processing of a particular voice packet takes too long, the user will now be warned instead of an error being raised (#134)

2.1.2

  • A reader was added (Bot#awaits) to read the hash of awaits, so ones that aren't necessary anymore can be deleted.
  • Channel#prune now uses the bulk delete endpoint which means it will be much faster and no longer rate limited (#118, thanks @snapcase)

Bugfixes

  • A few unresolved links in the documentation were fixed.
  • The tracking of streamed servers was updated so that very long lists of servers should now all be processed.
  • Resolution methods now return nil if the object to resolve can't be found, which should alleviate some rare caching problems (#124, thanks @Snazzah)
  • In the rare event that Discord sends a voice state update for a nonexistent member, there should no longer be a gateway error (#125)
  • Network errors (EPIPE and the like) should no longer cause an exception while processing (#127)
  • Uncached members in messages are now logged.

2.1.1

Bugfix-only release.

Bugfixes

  • Fixed a caching error that occurred when deleting roles (#113)
  • Commands should no longer be triggered with nil authors (#114)

2.1.0

  • API support for the April 29 Discord update, which was the first feature update in a while with more than a few additions to the API, was added. This includes: (#111)
    • Members' nicknames can now be set and read (Member#nick) and updates to them are being tracked.
    • Roles now have a mentionable? property and a mention utility method.
    • Message now tracks a message's role mentions.
  • The internal REST rate limit handler was updated:
    • It now tracks message rate limits server wide to properly handle new bot account rate limits. (#100)
    • It now keeps track of all requests, even those that are known not to be rate limited (it just won't do anything to them). This allows for more flexibility should future rate limits be added.
  • Guild sharding is now supported using the optional shard_id and num_shards to bot initializers. Read about it here: discord/discord-api-docs#17 (#98)
  • Commands can now require users to have specific action permissions to be able to execute them using the :required_permissions attribute. (#104 / #112)
  • A heartbeat event was added that gets triggered every now and then to allow for roughly periodic actions. (#110)
  • Prefixes are now more flexible in the format they can have - arrays and callables are now allowed as well. Read the documentation for more info.(#107 / #109)

2.0.4

  • Added a utility method Invite#url (#86/#101, thanks @PoVa)

Bugfixes

  • Fix a caching inconsistency where a server's channels and a bot's channels wouldn't be identical. This caused server channels to not update properly (#105)
  • Setting avatars should now work again on Windows (#96)
  • Message edit events should no longer be raised with nil authors (#95)
  • Invites can now be created again (#87)
  • Voice states are now preserved for chunked members, fixes an issue where a voice channel's users would ignore all voice states that occurred before the call (#103)
  • Fixed some possible problems with heartbeats not being sent with unstable connections

2.0.3

  • All examples now fully use v2 (#92, thanks @snapcase)
  • The message that occurs when a command is missing permission can now be changed or disabled (#94, thanks @snapcase)
  • The log message that occurs when you disconnect from the WebSocket is now more compact (#90)
  • Bot#ignored? now exists to check whether a user is ignored

Bugfixes

  • A problem where getting channel history would sometimes cause an exception has been fixed (#88)
  • split_message should now behave correctly in a specific edge case (#85, thanks @AnhNhan)
  • DCA playback should no longer cause an error when playback ends due to a specific reason

2.0.2

  • Added Server#text_channels and #voice_channels (#79)
  • Added Server#online_users (#80)
  • Added Member#role? (#83)
  • Added three utility methods User#online?, #offline?, and #idle?
  • Bot#send_message can now take channel objects as well as the ID

Bugfixes

  • Removing the bot from a server will no longer result in a gateway message error
  • Fixed an exception raised if a previously unavailable guild goes online after the stream timeout
  • server_create will no longer be raised for newly available guilds
  • Fixed the annoying message about constant reassignment at startup
  • Fixed an error where rarely a server's owner wouldn't be initialized correctly

2.0.1

  • Added some more examples (#75, thanks @greenbigfrog)
  • Users can now be ignored from messages at gateway level (Bot#ignore_user, Bot#unignore_user)
  • Member#add_role and Member#remove_role were re-added from User - they were missing before

Bugfixes

  • Fixed some typos in the documentation
  • If a server is actually unavailable it will no longer spam the console with timeout messages
  • VoiceBot now sends five frames of silence after finishing a track. This fixes an issue where the sound from the last track would bleed over into the new one due to interpolation.
  • Fixed a bug where playing something right after connecting to voice would sometimes cause the encryption key to not be set

2.0.0

This is the first major update with some breaking changes! Those are highlighted in bold with migration advice after them. Ask in the Discord channel (see the README) if you have questions.

  • Bot initializers now only use named parameters. This shouldn't be a hard change to adjust to, but everyone will have to do it. Here's some examples:
# Previously
bot = Discordrb::Bot.new '[email protected]', 'hunter2', true

# Now
bot = Discordrb::Bot.new email: '[email protected]', password: 'hunter2', log_mode: :debug
# Previously
bot = Discordrb::Bot.new :token, 'TOKEN HERE'

# Now
bot = Discordrb::Bot.new token: 'TOKEN HERE', application_id: 163456789123456789
# Previously
bot = Discordrb::Commands::CommandBot.new :token, 'TOKEN HERE', '!', nil, {advanced_functionality: false}

# Now
bot = Discordrb::Commands::CommandBot.new token: 'TOKEN HERE', application_id: 163456789123456789, prefix: '!', advanced_functionality: false
  • Connecting to multiple voice channels at once (only available with bot accounts) is now supported. This means bot.voice now takes the server ID as the parameter. For a seamless switch, the utility method MessageEvent#voice was added - simply replace bot.voice with event.voice in all instances.
  • The Member and Recipient classes were split off from User. Members are users on servers and recipients are partners in private messages. Since both are delegates to User, most things will work as before, but most notably roles were changed to no longer be by ID (for example, instead of event.author.roles(event.server.id), you'd just use event.author.roles instead).
  • All previously deprecated methods were removed. This includes:
    • Server#afk_channel_id= (use afk_channel=, it works with the ID too)
    • Channel#is_private (use private? instead, it's more reliable with edge cases like Twitch subscriber-only channels)
    • Bot#find (use find_channel instead, it does the exact same thing without confusion with find_user)
  • Server is now used instead of Guild in all external methods and classes. Previously, all the events regarding roles and such were called GuildRoleXYZEvent, now they're all called ServerRoleXYZEvent for consistency with other attributes and methods.
  • advanced_functionality is now disabled by default. If you absolutely need it, you can easily re-enable it by just setting that parameter in the CommandBot initializer, but for most people that didn't need it this will fix some bugs with mentions in commands and such.
  • User#bot? was renamed to User#current_bot? with the addition of the User#bot_account? reader to check for bot account-ness (the "BOT" tag visible on Discord)
  • Member chunks will no longer automatically be requested on startup, but rather once they're actually needed (event.server.members). This is both a performance change (much faster startup for large bots especially) and an important API compliance one - this is what the Discord devs have requested.
  • Initial support for bots that have no WebSocket connection was started. This is useful for web apps that need to get information on something without having to run something in the background all the time. A tutorial on these will be coming soon, in the meantime, use this short example:
require 'discordrb'
require 'discordrb/light'

bot = Discordrb::Light::LightBot.new 'token here'
puts bot.profile.username
  • OAuth bot accounts are now better supported using a method Bot#invite_url to get a bot's invite URL and sending tokens using the new Bot prefix.
  • discordrb now fully uses websocket-client-simple (a.k.a. WSCS) instead of Faye::WebSocket, this means that the annoying OpenSSL library thing won't have to be done anymore.
  • The new version of the Discord gateway (v4) is supported and used by default. This should bring more stability and possibly slight performance improvements.
  • Some older v3 features that weren't supported before are now:
    • Compressed ready packets (should decrease network overhead for very large bots)
  • Discord rate limits are now supported better - the client will never send a message if it knows it's going to be rate limited, instead it's going to wait for the correct time.
  • Requests will now automatically be retried if a 502 (cloudflare error) is received.
  • MessageEditEvents now have a whole message instead of just the ID to allow for checking the content of edited messages.
  • Messages now have an attachments array with files attached to the message.
  • ReadyEvent and DisconnectEvent now have the bot as a readable attribute - useful for container-based bots that don't have a way to get them otherwise.
  • Bot#find_channel can now parse channel mentions and search for specific types of channels (text or voice).
  • Server#create_channel can now create voice channels.
  • A utility function User#distinct was added to get the distinct representation of a user (i.e. name + discrim, for example "meew0#9811")
  • The User#discriminator attribute now has more aliases (#tag, #discord_tag, #discrim)
  • Permission objects can now be created or set even without a role writer, useful to quickly get byte representations of permissions
  • Permission overwrites can now be defined more easily using the utility method Channel#define_overwrite
  • Messages returned at the end of commands (for example using User#pm or Message#edit) will now no longer be sent (#66)
  • The :with_text event attribute is now aliased to :exact_text (#65)
  • Server icons (Server#icon=) can now be set just like avatars (Profile#avatar=)
  • Lots of comments were added to the examples and some bugs fixed
  • The overall performance and memory usage was improved, especially on Ruby 2.3 (using the new frozen string literal comment)
  • The documentation was slightly improved.

Bugfixes:

  • A lot of latent bugs with caching were fixed. This doesn't really have a noticeable effect, it just means better stability and reliability as a whole.
  • Command bots no longer respond when there are spaces between the prefix and the command. Because this behaviour may be desirable, a spaces_allowed attribute was added to the CommandBot initializer that can be set to true to re-enable this behaviour.
  • Permission calculation (User#permission?) has been thoroughly rewritten and should now account for edge cases like server owners and Manage Permissions.
  • The gateway reconnect logic now uses a correct falloff system - before it would start at 1 second between attempts and immediately jump to 120. Now the transition is more smooth.
  • Commands with aliases now show up correctly in the auto-generated help command (#72)
  • The auto-generated help command can now actually be disabled by setting the corresponding attribute to nil (#73)
  • Including empty containers now does nothing instead of raising an error
  • Command bots now obey should_parse_self

1.8.1

Bugfixes

  • Fixed an error (caused by an undocumented API change) that would write a traceback to the console every time someone started typing in a channel invisible to the bot.

1.8.0

  • The built-in logger has been somewhat redone.
    • It now has a fancy mode, settable using Discordrb::LOGGER.fancy = true/false, that makes use of ANSI escape codes to prettify the log output.
    • It now supports more things than just debug, there's also warn, error, good, info, in, and out.
    • You now have finer control over what gets output, using Discordrb::LOGGER.mode= which accepts one of :debug, :verbose, :normal, :quiet, :silent.
  • You can now log in with just a token by setting the email parameter to :token and the password to the token you want to log in with.
  • DCA playback now supports DCA1.
  • All data classes (now generalized using the IDObject mixin) have a creation_date parameter that specifies when the object was created.
  • Channel#mention was added that mentions a channel analogous to User#mention.
  • The aliases tag and discord_tag have been added to the discriminator because that's what Discord calls them now.

Bugfixes

  • A problem some users had where voice playback would leak FFmpeg processes has been fixed.
  • The VWS internal thread now has a name in debug messages (vws-i)
  • Users' voice channels should now always be set if they are in one

1.7.5

  • Channel#send_message and Bot#send_message now have an extra tts parameter (false by default) to specify whether the message should use TTS.

Bugfixes

  • Attempting to p a data class, especially a User or Profile, should no longer lock up the interpreter due to very deep recursion.
  • Manual TTS using API.send_message will now work correctly.

1.7.4

  • Added methods Channel#text? and Channel#voice? to check a channel's type.
  • Frequently allocated strings have been turned into symbols or frozen constants, this should improve performance slightly.

Bugfixes

  • VoiceBot#destroy will now properly disconnect you and should no longer cause segfaults.
  • Fixed a bug where you couldn't set any settings on a role created using Server#create_role.
  • Fixed Profile#avatar= doing absolutely nothing.

1.7.3

  • The server banlist can now be accessed more nicely using Server#bans.
  • Some abstractions for OAuth application creation were added - bot.create_oauth_application and bot.update_oauth_application. See the docs about how to use them.

1.7.2

  • The bot object can now be read from all events, not just from command ones.
  • You can now set the filter_volume on VoiceBot, which corresponds to the old way of doing volume handling, in case the new way is too slow for you.

1.7.1

  • A clear! method was added to EventContainer that removes all events from it, so you can overwrite modules by defining them again. (It's unnecessary for CommandContainers because commands can never be duplicate.)

Bugfixes

  • The tokens will now be verified correctly when obtained from the cache. (I messed up last time)
  • Events of the same type in different containers will now be merged correctly when including both containers.
  • Got rid of the annoying undefined method 'game' for nil:NilClass error that sometimes occurred on startup. (It was harmless but now it's gone entirely)

1.7.0

  • bot.find and bot.find_user have had their fuzzy search feature removed because it only caused problems. If you still need it, you can copy the code from the repo's history. In addition, find was renamed to find_channel but still exists as a (deprecated) alias.
  • The in-line documentation using Yard is now complete and can be accessed at RubyDoc. It's not quite polished yet and some things may be confusing, but it should be mostly usable.
  • Events and commands can now be thoroughly modularized using a system I call 'containers'. (TODO: Add a tutorial here later)
  • Support for the latest API changes:
    • Server.leave does something different than Server.delete
    • The WebSocket connection now uses version 3 of the protocol
  • Voice bots now support playing DCA files using the play_dca method. (TODO: Add a section to the voice tutorial)
  • The volume of a voice bot can now be changed during playback and not only for future playbacks.
  • A Channel.prune method was added to quickly delete lots of messages from a channel. (It appears that this is something lots of bots do.)
  • Server#members is now aliased to users.
  • An attribute Server#member_count was added that is accurate even if chunked members have not been added yet.
  • An attribute Server#large? was added that is true if a server could possibly have an inaccurate list of members.
  • Some more specific error classes have been added to replace the RestClient generic ones.
  • Quickly sending a message using the event << 'text' syntax now works in every type of message event, not just commands.
  • You can now set the bitrate of sent audio data using bot.voice.encoder.bitrate = 64000 (see Encoder#bitrate=). Note that sent audio data will always be unaffected by voice channel bitrate settings, those only tell the client at what bitrate it should send.
  • A rate limiting feature was added to commands - you can define buckets using the bucket method and use them as a parameter for command.
    • A SimpleRateLimiter class was also added if you want rate limiting independent from commands (e. g. for events)
  • Connecting to the WebSocket now uses an exponential falloff system so we don't spam Discord with requests anymore.
  • Debug timestamps are now accurate to milliseconds.

Bugfixes

  • The token cacher will now detect whether a cached token has been invalidated due to a password change.
  • breaking from an event or command will no longer spew LocalJumpErrors to the console.

1.6.6

Bugfixes

  • Fixed a problem that would cause an incompatibility with Ruby 2.1
  • Fixed servers sometimes containing duplicate members

1.6.5

  • The bot will now request the users that would previously be sent all in one READY packet in multiple chunks. This improves startup time slightly and ensures compatibility with the latest Discord change, but it also means that some users won't be in server members lists until a while after creation (usually a couple seconds at most).

1.6.4

Bugfixes

  • Fixed a bug that made the joining of servers using an invite impossible.

1.6.3

Bugfixes

  • Fixed a bug that prevented the banning of users over the API

1.6.2

Bugfixes

  • RbNaCl is now installed directly instead of the wrapper that also contains libsodium. This has the disadvantage that you will have to install libsodium manually but at least it's not broken on Windows anymore.

1.6.1

  • It's now possible to prevent the READY packet from being printed in debug mode, run bot.suppress_ready_debug once before the bot.run to do it.

Bugfixes

  • Token cache files with invalid JSON syntax will no longer crash the bot at login.

1.6.0

  • The inline documentation using YARD was greatly improved and is now mostly usable, at least for the data classes and voice classes. It's still not complete enough to be released on GitHub, but you can build it yourself using YARD.
  • It's now possible to encrypt sent voice data using an optional parameter in voice_connect. The encryption uses RbNaCl's SecretBox and is enabled by default.
  • The new library comparison is now fully supported, barring voice receive and multi-send: (#39)
    • bot.invite will create an Invite object from a code containing information about it.
    • server.move(user, channel) will move a user to a different voice channel.
    • The events bot.message_edit and bot.message_delete are now available for message editing and deletion. Note that Discord doesn't provide the content of edited/deleted messages, so you'll have to implement message caching yourself if you really need it.
    • The events bot.user_ban and bot.user_unban are now available for users getting banned/unbanned from servers.
  • A bot's name can now be sent using bot.name=. This data will be sent to Discord with the user-agent and it might be used for cool statistics in the future.
  • Discord server ownership transfer is now implemented using the writer server.owner=. (#41)
  • CommandBots can now have command aliases by simply using an array of symbols as the command name.
  • A utility method server.default_channel was implemented that returns the default text channel of a server, usually called #general. (An alias general_channel is available too.)
  • Tokens will no longer appear in debug output, so you're safe sending output logs to other people.
  • A reader server.owner that returns the server's owner as a User was added. Previously, users had to manually get the User object using bot.user.
  • Most methods that accept IDs or data objects now also accept Integers or Strings containing the IDs now. This is implemented by adding a method resolve_id to all objects that could potentially contain an ID. (Note that this change is not complete yet and I might have missed some methods.) (#40)
  • The writer server.afk_channel_id= is now deprecated as its functionality is now covered by server.afk_channel=.
  • A new reader user.avatar_url was added that returns the full image URL to a user's avatar.
  • To avoid confusion with avatar_url, the reader user.avatar was renamed to avatar_id. (user.avatar still exists but is now deprecated.)
  • Symbols are now used instead of strings as hash keys in all methods that send JSON data to somewhere. This might improve performance slightly.

Bugfixes

  • Fixed the reader server.afk_channel_id not containing a value sometimes.
  • An issue was fixed where attempting to create a Server object from a stub server that didn't contain any role data would cause an exception.
  • The Invite server property will now be initialized directly from the invite data instead of the channel the invite is to, to prevent it being nil when the invite channel was stubbed.
  • The inviter of an Invite will now be nil instead of causing an exception when it doesn't exist in the invite data.

1.5.4

  • The opus-ruby and levenshtein dependencies are now optional - if you don't need them, it won't crash immediately (only when you try to use voice / find with a threshold > 0, respectively)

Bugfixes

  • Voice volume can now be properly set when using avconv (#37, thanks @purintai)
  • websocket-client-simple, which is required for voice, is now specified in the dependencies.

1.5.3

  • Voice bot length adjustments are now configurable using bot.voice.adjust_interval and bot.voice.adjust_offset (make sure the latter is less than the first, or no adjustment will be performed at all)
  • Length adjustments can now be made more smooth using bot.voice.adjust_average (true allows for more smooth adjustments, may improve stutteriness but might make it worse as well)

1.5.2

  • bot.voice_connect can now use a channel ID directly.
  • A reader bot.volume now exists for the corresponding writer.
  • The attribute bot.encoder.use_avconv was added that makes the bot use avconv instead of ffmpeg (for those on Ubuntu 14.x)
  • The PBKDF2 iteration count for token caching was increased to 300,000 for extra security.

Bugfixes

  • Fix a bug where play_file wouldn't properly accept string file paths (#36, thanks @purintai)
  • Fix a concurrency issue where VoiceBot would try to read from nil

1.5.1

  • The connection to voice was made more reliable. I haven't experienced any issues with it myself but I got reports where recv worked better than recvmsg.

1.5.0

  • Voice support: discordrb can now connect to voice using bot.voice_connect and do the following things:
    • Play files and URLs using VoiceBot.play_file
    • Play arbitrary streams using VoiceBot.play_io
    • Set the volume of future playbacks using VoiceBot.volume=
    • Pause and resume playback (VoiceBot.pause and VoiceBot.continue)
  • Authentication tokens are now cached and no login request will be made if a cached token is found. This is mostly to reduce strain on Discord's servers.

Bugfixes

  • Some latent ID casting errors were fixed - those would probably never have been noticed anyway, but they're fixed now.
  • Bot.parse_mention now works, it didn't work at all previously

1.4.8

  • The User class now has the methods add_role and remove_role which add a role to a user and remove it, respectively.
  • All data classes now have a useful == implementation.
  • The Game class and all references to it were removed. Games are now only identified by their name.

Bugfixes

  • When a role is deleted, the ID is now obtained correctly. (#30)

1.4.7

  • Presence event handling is now divided into two separate events; PresenceEvent to handle online/offline/idle statuses and PlayingEvent to handle users playing games.
  • The user property of MessageEvent is now automatically resolved to the cached user, so you can modify roles instantly without having to resolve it yourself.
  • Message now has a useful to_s method that just returns the content.

Bugfixes

  • The TypingEvent user property is now initialized correctly (#29, thanks @purintai)

1.4.6

Bugfix-only release.

Bugfixes

  • The user and server properties of PresenceEvent are now initialized correctly.

1.4.5

  • The Bot.game property can now be set to an arbitrary string.
  • Discord mentions are handled in the old way again, after Discord reverted an API change.

1.4.4

  • Add Server.leave_server as an alias for delete_server
  • Use the new Discord mention format (mentions array). Reverted in 1.4.5
  • Discord rate limited API calls are now handled correctly - discordrb will try again after the specified time.
  • Debug logging is now handled by a separate Logger class

Bugfixes

  • Message timestamps are now parsed correctly.
  • The quickadders for awaits (User.await, Channel.await etc.) now add the correct awaits.

1.4.3

  • Added a method Bot.find_user analogous to Bot.find.

Bugfixes

  • Remove a leftover debug line (#23, thanks @VxJasonxV)

1.4.2

  • discordrb will now send a user agent in the format requested by the Discord devs.

1.4.1

Bugfix-only release.

Bugfixes

  • Empty messages will now never be sent
  • The command-not-found message in CommandBot can now be disabled properly

1.4.0

  • All methods and classes where the words "colour" or "color" are used now have had aliases added with the respective other spelling. (Internally, everything uses "colour" now).
  • discordrb now supports everything on the Discord API comparison, except for voice (see also #22)
    • Roles can now be created, edited and deleted and their permissions modified.
    • There is now a method to get a channel's message history.
    • The bot's user profile can now be edited.
    • Servers can now be created, edited and deleted.
    • The user can now display a "typing" message in a channel.
    • Invites can now be created and deleted, and an Invite class was made to represent them.
  • Command and event handling is now threaded, with each command/event handler execution in a separate thread.
  • Debug messages now specify the current thread's name.
  • discordrb now handles created/updated/deleted servers properly with events added to handle them.
  • The list of games handled by Discord will now be updated automatically.

Bugfixes

  • Fixed a bug where command handling would crash if the command didn't exist.

1.3.12

  • Add an attribute Bot.should_parse_self (false by default) that prevents the bot from raising an event if it receives a message from itself.
  • User.bot? and Message.from_bot? were implemented to check whether the user is the bot or the message was sent by it.
  • Add an event for private messages specifically (Bot.pm and PrivateMessageEvent)

Bugfixes

  • Fix the MessageEvent attribute that checks whether the message is from the bot not working at all.

1.3.11

  • Add a user selector (:bot) that is usable in the from: MessageEvent attribute to check whether the message was sent by a bot.

Bugfixes

  • Channel.private? now checks for the server being nil instead of the is_private attribute provided by Discord as the latter is unreliable. (wtf)

1.3.10

  • Add a method Channel.private? to check for a PM channel
  • Add a MessageEvent attribute (:private) to check whether a message was sent in a PM channel
  • Add various aliases to MessageEvent attributes
  • Allow regexes to check for strings in MessageEvent attributes

Bugfixes

  • The matches_all method would break in certain edge cases. This didn't really affect discordrb and I don't think anyone else uses that method (it's pretty useless otherwise). This has been fixed

1.3.9

  • Add awaits, a powerful way to add temporary event handlers.
  • Add a Bot.find method to fuzzy-search for channels.
  • Add methods to kick, ban and unban users.

Bugfixes

  • Permission overrides now work correctly for private channels (i. e. they don't exist at all)
  • Users joining and leaving servers are now handled correctly.

1.3.8

  • Added Bot.users and Bot.servers readers to get the list of users and servers.

Bugfixes

  • POST requests to API calls that don't need a payload will now send a nil payload instead. This fixes the bot being unable to join any servers and various other latent problems. (#21, thanks @davidkus)

1.3.7

Bugfix-only release.

Bugfixes

  • Fix the command bot being included wrong, which caused crashes upon startup.

1.3.6

  • The bot can now be stopped from the script using the new method Bot.stop.

Bugfixes

  • Fix some wrong file requires which caused crashes sometimes.

1.3.5

  • The bot can now be run asynchronously using Bot.run(:async) to do further initialization after the bot was started.