lilJudd/README.md
limited_dev 21ad3492c7 chore: added README.md
Signed-off-by: limited_dev <loginakkisativ@gmail.com>
2023-05-18 21:00:37 +02:00

65 lines
2.4 KiB
Markdown

# li'l Judd version 2
"Oh boy, here we go again" ~ me
A Discord Bot for Splatoon Teams
[![Latest Release](https://gitlab.com/moonleay/liljudd/-/badges/release.svg)](https://gitlab.com/moonleay/liljudd/-/releases)
[![pipeline status](https://gitlab.com/moonleay/liljudd/badges/master/pipeline.svg)](https://gitlab.com/moonleay/liljudd/-/commits/master)
[![coverage report](https://gitlab.com/moonleay/liljudd/badges/master/coverage.svg)](https://gitlab.com/moonleay/liljudd/-/commits/master)
## Contributors
<div class="aside">
<img src="https://img.shields.io/badge/moonleay-Head%20Developer-red" alt="moonleay: Head Developer"/>
</div>
## Known issues
- None (currently). Report issues to issues@moonleay.net or moonleay#0069
## 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
## 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