From 21ad3492c71fdf14efb3a73ef4b99c21e62ef62a Mon Sep 17 00:00:00 2001 From: limited_dev Date: Thu, 18 May 2023 21:00:37 +0200 Subject: [PATCH] chore: added README.md Signed-off-by: limited_dev --- README.md | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..316a71b --- /dev/null +++ b/README.md @@ -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 + +
+ moonleay: Head Developer +
+ +## 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