chore: added README.md
Signed-off-by: limited_dev <loginakkisativ@gmail.com>
This commit is contained in:
parent
3bf7b3e388
commit
21ad3492c7
1 changed files with 65 additions and 0 deletions
65
README.md
Normal file
65
README.md
Normal file
|
@ -0,0 +1,65 @@
|
||||||
|
# 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
|
Loading…
Reference in a new issue