BlueBot - A Java-written Discord bot

Join the support server :

You can add the bot to your server by clicking on this link

You can also contact me on Steam :

The API can be found here. However, the required dependancies for the bot are included in this repository.

BlueBot will provide useful features like :

• Moderation & utility features
• Ability to enable & disable features
• Owner-only commands
• Extensible & customizable soundboard
• CleverBot integration (currently disabled)
• GIFs search
• Twitch alerts
• Command prefix customization
• Quick reactions, jokes & other stuff
• Cyanide & Hapiness comics

• More to come !

Getting started

To edit the code, just follow these steps :

• Create your onw app here.
• Clone the project into your favorite IDE using GitHub's integration (if you're not downloading a release).
• On your application page, get your application token
• Open config.blue
• Replace YOURTOKENHERE by your application token
• Replace YOURIDHERE by your ID
• Create a directory named soundboard in the bot's root folder. You will place your .mp3 files here.

Interface

• Double click anywhere on the background to minimize
• Click anywhere on the background to drag the window
• Start buttons launches the bot, Stop button stops it
• Edit button open the config file in your default text editor
• Quit button stops the bot (if running) and closes the window

Commands

BlueBot provides a lot of commands. Use !help to display the complete list of them.

By typing help after each command, you'll get information on how to use the command.

Example : by typing !ping help you'll get the following response :

The command ping pings the bot (to check if it's online). Usage : !ping

Running BlueBot on a headless device (VPS, Raspberry ...)

Since BlueBot is using JavaFX for the GUI, you'll need to install an additional library to run the app without a display. The OpenJFX Monocle library can be found here (you can find it on the web, but this is the version I'm using on my server).

• Install Java 8 (ex. Debian : sudo apt-get install java-8-oracle)
• Install OpenJFX (ex Debian : sudo apt-get install openjfx)
• Place the downloaded .jar in the ${JAVA_HOME}/jre/lib/ext folder (for me it's /usr/lib/jvm/java-8-oracle/jre/lib/ext with Debian 8)
• Run the bot with java -jar -Xmx512m -Dtestfx.robot=glass -Dglass.platform=Monocle -Dmonocle.platform=Headless -Dprism.order=sw BlueBot.jar cmd

License

This project is released under the MIT License.

Also !

I'm currently a student, so the project may take a while to come to its end. Don't expect too many updates, I have some work to do and some social life to have.

And I like blue, obviously.