discordrb
An implementation of the Discord API using Ruby.
Installation
Linux
On Linux, it should be as simple as running:
$ gem install discordrb
Windows
On Windows, to install discordrb, run this in a shell:
$ gem install discordrb
Run the ping example to verify that the installation works (make sure to replace the username and password in there with your own or your bots'!):
$ ruby ping.rb
Troubleshooting
If you get an error like this when installing the gem:
ERROR: Error installing discordrb:
The 'websocket-driver' native gem requires installed build tools.
You're missing the development kit required to build native extensions. Download the development kit here (scroll down to "Development Kit", then choose the one for Ruby 2.0 and your system architecture) and extract it somewhere. Open a command prompt in that folder and run:
$ ruby dk.rb init
$ ruby dk.rb install
Then reinstall discordrb:
$ gem uninstall discordrb
$ gem install discordrb
If you get an error like this when running the example:
terminate called after throwing an instance of 'std::runtime_error'
what(): Encryption not available on this event-machine
You're missing the OpenSSL libraries that EventMachine, a dependency of discordrb, needs to be built with to use encrypted connections (which Discord requires). Download the OpenSSL libraries from here, install them to their default location and reinstall EventMachine using these libraries:
$ gem uninstall eventmachine
$ gem install eventmachine -- --with-ssl-dir=C:/OpenSSL-Win32
Usage
You can make a simple bot like this:
require 'discordrb'
bot = Discordrb::Bot.new "[email protected]", "hunter2"
bot.(with_text: "Ping!") do |event|
event.respond "Pong!"
end
bot.run
This bot responds to every "Ping!" with a "Pong!".
Development
After checking out the repo, run bin/setup
to install dependencies. Then, run rake false
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/meew0/discordrb.
License
The gem is available as open source under the terms of the MIT License.