2023-05-18 19:00:37 +00:00
|
|
|
# li'l Judd version 2
|
|
|
|
|
|
|
|
|
|
"Oh boy, here we go again" ~ me
|
|
|
|
|
|
|
|
|
|
A Discord Bot for Splatoon Teams
|
|
|
|
|
|
|
|
|
|
[](https://gitlab.com/moonleay/liljudd/-/releases)
|
|
|
|
|
[](https://gitlab.com/moonleay/liljudd/-/commits/master)
|
2023-05-21 13:21:00 +00:00
|
|
|
[](https://gitlab.com/moonleay/liljudd/-/blob/master/LICENSE)
|
2023-05-18 19:00:37 +00:00
|
|
|
|
|
|
|
|
## Contributors
|
|
|
|
|
|
2023-05-21 13:21:00 +00:00
|
|
|
[](https://gitlab.com/moonleay)
|
2023-05-18 19:00:37 +00:00
|
|
|
|
|
|
|
|
## Known issues
|
|
|
|
|
|
2023-06-18 16:16:17 +00:00
|
|
|
##### If you encounter any bugs, message me on Discord (@moonleay) or send me a mail (issues@moonleay.net).
|
2023-05-18 19:00:37 +00:00
|
|
|
|
|
|
|
|
## Commands & Features
|
|
|
|
|
|
|
|
|
|
- Commands
|
|
|
|
|
- version -- Show the versions of the bot and the most important dependencies
|
|
|
|
|
- feature -- Manage bot features
|
|
|
|
|
- Features
|
|
|
|
|
- Time Planner -- Make the bot send messages and reactions into a selected channel in order to make planning easier
|
2023-06-28 22:05:12 +00:00
|
|
|
- Availability Manager -- Make the bot assign users roles every day, so it is possible to notify available people
|
2023-05-18 19:00:37 +00:00
|
|
|
|
2023-06-05 10:10:25 +00:00
|
|
|
## (Maybe) upcoming features
|
2023-05-29 11:58:16 +00:00
|
|
|
|
|
|
|
|
- Match Planner (Send Notifications some time before a match starts)
|
2023-06-05 10:10:25 +00:00
|
|
|
- Planning Notifier (Make it possible to ping people, who have time at a specific time)
|
2023-05-29 11:58:16 +00:00
|
|
|
- Game Tracker (Save the results of the last matches)
|
|
|
|
|
- Replay Saver (Maybe; will save the replay code to a database)
|
2023-06-28 20:35:04 +00:00
|
|
|
- Rndm map command
|
2023-05-29 11:58:16 +00:00
|
|
|
|
2023-06-24 13:58:49 +00:00
|
|
|
## TODO
|
|
|
|
|
|
|
|
|
|
- Rewrite the feature system
|
|
|
|
|
- Rewrite the Cronjob system
|
|
|
|
|
- Rewrite the Database connection system (from transactions all over the place to a single package with transactions)
|
|
|
|
|
|
2023-05-18 19:00:37 +00:00
|
|
|
## How to self-host (using the Docker container)
|
|
|
|
|
|
|
|
|
|
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)"
|
|
|
|
|
|
|
|
|
|
## How to self-host (using the JAR)
|
|
|
|
|
|
|
|
|
|
1. Download the latest release from the Package Registry ("Packages and registries" > "Package Registry")
|
|
|
|
|
1. It should be called something like this: "lilJudd-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 lilJudd-X.X.X-xxxxxxxx-prod.jar
|
|
|
|
|
4. The bot should start and create a config file named "credentials.nils" in a folder called "data"
|
|
|
|
|
5. Open it and put in your credentials.
|
|
|
|
|
1. token: your Discord bot token
|
|
|
|
|
2. dbDomain: the domain and port of your postgresql database (e.g.: 192.168.178.1:5432)
|
|
|
|
|
3. dbName: the name of your database
|
|
|
|
|
4. dbUser: the username of the database
|
|
|
|
|
5. dbPassword: the password to your user
|
|
|
|
|
6. Rerun the command
|
|
|
|
|
> java -jar lilJudd-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.
|
|
|
|
|
|
|
|
|
|
## Docker commands 4 me
|
|
|
|
|
|
|
|
|
|
- docker build -t limiteddev/liljudd:x.x.x .
|
|
|
|
|
- docker push limiteddev/liljudd:x.x.x
|
