|
2 | 2 | This repository contains the source code of SSPŠ KB discord bot. |
3 | 3 |
|
4 | 4 | ## Deploying |
| 5 | +This project is automatically built and deployed with docker, so you can simply run it with |
| 6 | +```shell |
| 7 | +docker run ghcr.io/ssps-kb/workshop-bot |
| 8 | +``` |
| 9 | +if the pull and start was successful, you'll get `There is no Config.toml in current directory nor in /etc/workshop-bot` |
| 10 | +error. See [configuration](#configuration) |
| 11 | + |
| 12 | +### Tags |
| 13 | +Here is a list of tags you can find in the registry, and it's description. |
| 14 | + |
| 15 | +| Tag | Description | |
| 16 | +|---------|------------------------------------------------| |
| 17 | +| latest | The latest stable (tagged) release | |
| 18 | +| x.x.x | The specific version (stable) ie. 0.3.0 | |
| 19 | +| edge | Bleeding edge version, contents of main branch | |
| 20 | +| sha-xxx | Specific commit. ie. adbfca5 = sha-adbfca5 | |
| 21 | + |
| 22 | +## Configuration |
| 23 | +Most of this project's configuration is self-explanatory if you ever set up a discord bot. |
| 24 | +The project looks in current directory for `Config.toml` and if there is no configuration it checks `/etc/workshop-bot`. |
| 25 | +If running in docker, you'll want to either add a volume to `/app/Config.toml` or even better add a whole folder to |
| 26 | +`/etc/workshop-bot`. |
| 27 | + |
| 28 | +Instead of using names, the bot is using IDs to find channels. |
| 29 | + |
| 30 | +### Discord token (discord_token) |
| 31 | +This is the only required value, it is used to authenticate with discord. NEVER SHARE IT WITH ANYONE. |
| 32 | +To get it create a bot on https://discord.com/developers. If you don't know how to do that, search "How to create a |
| 33 | +discord bot", it has been explained over thousand times. |
| 34 | + |
| 35 | +### Workshop invite channel (workshop_invite_channel) |
| 36 | +This configuration option is basically useless. It's used to create and log an invite at the bot's startup. |
| 37 | +It's only used for the invite to look more professional. |
| 38 | + |
| 39 | +### Guilds config |
5 | 40 | SOON<sup>TM</sup> |
6 | 41 |
|
7 | 42 | ## License |
|
0 commit comments