2023-04-14 21:16:39 +00:00
|
|
|
# Botendo version 6
|
2023-03-28 21:34:10 +00:00
|
|
|
|
2023-04-14 21:16:39 +00:00
|
|
|
"6th times the charm" ~ me
|
2023-03-28 21:34:10 +00:00
|
|
|
|
2023-03-25 23:46:32 +00:00
|
|
|
A Discord music bot, written in Kotlin using the kord library.
|
2023-05-11 15:48:29 +00:00
|
|
|
|
|
|
|
[![Latest Release](https://gitlab.com/moonleay/botendo/-/badges/release.svg)](https://gitlab.com/moonleay/botendo/-/releases)
|
|
|
|
[![pipeline status](https://gitlab.com/moonleay/botendo/badges/master/pipeline.svg)](https://gitlab.com/moonleay/botendo/-/commits/master)
|
2023-05-21 13:24:07 +00:00
|
|
|
[![License](https://img.shields.io/badge/license-GPL--3.0-brightgreen)](https://gitlab.com/moonleay/botendo/-/blob/master/LICENSE)
|
2023-03-28 21:34:10 +00:00
|
|
|
|
|
|
|
## Contributors
|
|
|
|
|
2023-05-21 13:24:07 +00:00
|
|
|
[![Developer](https://img.shields.io/badge/moonleay-Developer-red)](https://gitlab.com/moonleay)
|
2023-03-28 21:34:10 +00:00
|
|
|
|
2023-04-19 19:18:46 +00:00
|
|
|
## Special Thanks to
|
|
|
|
|
2023-05-09 07:33:37 +00:00
|
|
|
- HopeBaron for helping me a lot
|
2023-04-19 19:18:46 +00:00
|
|
|
|
2023-05-08 21:24:29 +00:00
|
|
|
## Known issues
|
|
|
|
|
2023-05-21 13:24:07 +00:00
|
|
|
- None (currently). Open an issue, report issues to issues@moonleay.net or message moonleay#0001 on Discord
|
2023-05-08 21:24:29 +00:00
|
|
|
|
2023-05-11 06:29:54 +00:00
|
|
|
## Commands & Features
|
|
|
|
|
|
|
|
- Commands
|
2023-05-18 01:28:40 +00:00
|
|
|
- info -- Show basic infos about the bot
|
|
|
|
- play -- Play a song and or add it to queue
|
|
|
|
- upsert -- Play a song next up
|
|
|
|
- stop -- Stop playing a song and leave the vc
|
|
|
|
- skip -- Skip to the next song
|
|
|
|
- queue -- Show what songs are next up
|
|
|
|
- nowplaying -- Show what is currently playing
|
2023-05-11 06:29:54 +00:00
|
|
|
- Features
|
|
|
|
- Button Controller -- You can control the currently playing music using buttons.
|
2023-03-28 21:34:10 +00:00
|
|
|
|
2023-04-19 19:18:46 +00:00
|
|
|
## How to self-host (using the Docker container)
|
|
|
|
|
2023-04-26 15:48:53 +00:00
|
|
|
1. Pull the container
|
|
|
|
2. Map /data/ to a folder on disk
|
|
|
|
3. Run the Bot once
|
|
|
|
4. Follow step 4 - 7 of "How to self-host (using the JAR)"
|
|
|
|
|
2023-04-19 19:18:46 +00:00
|
|
|
## How to self-host (using the JAR)
|
2023-03-28 21:34:10 +00:00
|
|
|
|
|
|
|
1. Download the latest release from the Package Registry ("Packages and registries" > "Package Registry")
|
|
|
|
1. It should be called something like this: "Botendo-X.X.X-xxxxxxxx-prod.jar" (replace "X.X.X" with the latest
|
|
|
|
version and xxxxxxxx" with the commit its based on.)
|
|
|
|
2. If you want to run an early version, which may be (very) unsable, you can run a development version. Just use an
|
|
|
|
entry ending in "-dev.jar"
|
|
|
|
2. Place it anywhere you want.
|
|
|
|
3. Run the following command:
|
|
|
|
> java -jar Botendo-X.X.X-xxxxxxxx-prod.jar
|
2023-04-19 19:18:46 +00:00
|
|
|
4. The bot should start and create a config file named "credentials.nils" in a folder called "data"
|
2023-03-28 21:34:10 +00:00
|
|
|
5. Open it and put in your credentials.
|
|
|
|
1. token: your Discord bot token
|
|
|
|
2. lavaip: the IP of your LavaLink instance e.g.: ("ws://192.168.178.1:2333")
|
|
|
|
3. lavapw: your password for the LavaLink instance
|
|
|
|
6. Rerun the command
|
|
|
|
> java -jar Botendo-X.X.X-xxxxxxxx-prod.jar
|
|
|
|
7. The bot should now be up and running.
|
|
|
|
|
|
|
|
## How to set up workspace
|
|
|
|
|
|
|
|
Install IntellJ and import the project from git.
|
|
|
|
Done.
|
2023-04-14 21:13:24 +00:00
|
|
|
|
|
|
|
## Docker commands 4 me
|
|
|
|
|
|
|
|
- docker run -it -m 2g -v/home/limited_dev/Documents/Code/Botendo/run/data/:/data/:rw limiteddev/botendo:x.x.x
|
|
|
|
- docker build -t limiteddev/botendo:x.x.x .
|
|
|
|
- docker push limiteddev/botendo:x.x.x
|