Compare commits

...
Sign in to create a new pull request.

1 commit
main ... dev

Author SHA1 Message Date
a6c9f50890 Update README.md 2025-04-05 22:05:51 +01:00

View file

@ -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
<br>
## 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
<br>
pick your fave install location on your server
```sh
cd /opt
```
<br>
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
```
<br>
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
```
<br>
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