RpgUltimateBot

RpgUltimateBot is a bot developed in C# using DsharpPLus and Lavalink to improve your tabletop sessions

The bot has two main functions, roll dice and play music to create an ambient atmosphere. The purpose of rolling dice is to make the checks on the table available for everyone to see.In the case of the DiceHidden command, for the GM to have a way to roll dice in secret and see the result. For the music functions, now you can play whatever audio, theme or song you want to any circumstance you want.

How to make the bot work:

1. Enter https://discord.com/developers/applications and create a bot
2. Give the bot autorization to join channels, play audio, text in channel and see messages.
3. Generate a Token for the Bot and copy it in a safe location.
4. Create a URL and add the bot to the server you want.
5. Copy the repository.
6. Add your token to appsettings.json.
7. Open your cmd and go to the directory you added the project.
8. Open the AmbientBot and run the following command java -jar Lavalink.jar.

List of commands:

1. Dice: Send the command with the amount of dices to show a result, the dices must follow the format of XdY+Z, with X,Y and Z being integers.
2. DiceHidden: It follows the same rules of the Dice command but send the result to the private chat of the person who send it.
3. Join: Makes the bot join the voice channel the command was used.(It must be used on the chat of a Voice Channel)
4. Leave: Makes the bot leave the voice channel it is.
5. Play: Play the audio of a video that was chosen.
6. Pause: Pause the audio that was playing in the bot.
7. Resume: Resume the audio after it was paused.
8. Volume: Set the volume based on an integer number it was typed.