thibautbessone/discordbluebot

Customizable soundboard bot for Discord, along other useful commands

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 dependencies 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 own 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 opens 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

Hosting the bot

You can host your own instance of the bot. To do so, head over to the Releases page and download the latest one. To run BlueBot, you'll need Java 8 and OpenJFX. After installing them (Google is your friend, it depends on your OS), you'll be ready to go.

If you are using the bot on several servers, in order to have a dedicated soundboard per server, you'll have to :

• Enable Discord Developer mode (in the app settings, go to Appearance -> Advanced -> Toggle Developer mode on), then right click on your server and click on Copy ID.
• Inside the soundboard folder, create a folder named like the server ID (for example, if one of the server has 264445054966991498 as ID, you want to name your folder 264445054966991498)
• Drop your .mp3 files inside this folder. These sounds will only be available on this particular server.

To toggle between the general soundboard and the dedicated one, remember to use the !enable and !disable commands.

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

First, install Java with OpenJDK & OpenJFX:

• Install OpenJDK (ex. Debian : sudo apt-get install openjdk-11-jdk)
• Install OpenJFX (ex Debian : sudo apt-get install openjfx)

Since BlueBot is using JavaFX for the GUI, you'll need to install a display emulator to run the app. I personally use Xvfb

• Install Xvfb (ex. Debian : sudo apt-get install xvfb)
• Run Xvfb :1 & to start an emulated display in the background
• Run export DISPLAY=:1 to set it as main display
• Run the bot with java --module-path /usr/share/openjfx/lib --add-modules javafx.controls -jar BlueBot.jar cmd &

License

This project is released under the MIT License.

discordbluebot's Issues

The "replace" words aren't in the config.bluefile

Hello,

in the README.md it tells to replace a few words in the config.blue file but in that file are no "YOURTOKENHERE" "YOURIDHERE". What now?

greetings

No sounds found with BlueBot 2.2

As the title states, using the same sounds and configuration as BlueBot 2.1, no sounds are found by BlueBot 2.2.

As a troubleshooting attempt, I tried deleting all files and starting fresh from the supplied release, copying in the sounds again, however they are still not found.

Additionally, if I copy the 2.1 bits over an 2.2 installation, functionality is restored. Does not seem to be a permissions issue; I confirmed the service account running BlueBot has full control over the folder and items, and again the same set of files works with the 2.1 bits.

log2018-10-15Time23-26-32.blue.txt

[11:26 PM] prenetic: !sound list
[11:26 PM] BOTResonance: No sounds available.
[11:26 PM] prenetic: !sound horn
[11:26 PM] BOTResonance: The sound horn doesn't exist.

Windows Server 2016
Java 1.8.0_181
Monocle 1.8.0_20
Server ID 185871254702522368
User ID 185870652996059136

Running as a registered service with "java.exe -jar -Xmx512m -Dtestfx.robot=glass -Dglass.platform=Monocle -Dmonocle.platform=Headless -Dprism.order=sw BlueBot.jar cmd"

Does this bot have shard support?

Does this bot have shard support?

Have the bot leave the channel after it plays the sound

Would it be possible to add an option to have the bot leave the channel once it's done playing the sound? Would be great! Love the bot 👍