From a6c9f5089013a54f6ef564f921339608a22dec77 Mon Sep 17 00:00:00 2001 From: 404invalid-user Date: Sat, 5 Apr 2025 22:05:51 +0100 Subject: [PATCH] Update README.md --- README.md | 90 +++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 77 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 14c205a..fee5f00 100644 --- a/README.md +++ b/README.md @@ -3,27 +3,91 @@ the all-purpose open source discord bot for CWH11's Hangout Crew. ### set up -- go to discord.com/developers and make a bot token - - take note of the client id, client secret, snd then bot token - -- make a mysql server with a db - -- copy the .env.example file to .env fill in the client id, client secret bot token and database uri -- from the folder run `npm install --save-dev` then `npm run build` finally `npm run start` +go to discord.com/developers and make a bot token -## Features +take note of the client id, client secret, and then bot token - [ ] - reaction roles +just google for a guide theres plenty out there. - [ ] - message macros +
+ +## Bare metal + + +make a linux or windows server (tested and run on a Debain LXC) + +install mariadb (plent of guides on this out there) + +includes making a user db + +
+ +pick your fave install location on your server + +```sh +cd /opt +``` + +
+ +clone the knighrider repo if your on windows/ have a gui you can just get the zip file from github and extract it +```sh +git pull https://github.com/404invalid-user/knightrider.git +cd knightrider +``` + +
+ +setup your env file with the details for your bot client id, client secret bot token and database uri + +``` +cp .env.example .env +nano .env +``` + +
+ +now running the bot +first do `npm install --save-dev` then `npm run build` finally `npm run start` if you want to run the bot in the background I recommend pm2 + +```sh +sudo npm i -g pm2 +pm2 start dist/index.js --name knightrider +``` + +## Docker + + +locate the compose file in this repo add it to your server edit it adding your bot tokens + +```sh +cd /opt/ +mkdir knighrider +cd knightrider +curl -fsSL https://raw.githubusercontent.com/404invalid-user/knightrider/refs/heads/main/docker-compose.yml -o docker-compose.yml +nano docker-compose.yml +``` + +run it +```sh +docker compose pull +docker compose up -d +``` + + + + +### Features + + [x] - reaction roles + + [x] - message macros [ ] - custom reaction role embeds - [ ] - reaction ban - - [ ] - reaction kick + [x] - reaction ban [ ] - user info/strike system