twstatus-bot

README

twstatus-bot

This is the more user friendly variant of the Teeworlds Server Status Bot which uses the DDNet HTTP master servers for fetching its data contrary to polling each individual server on its own.

User guide

Add this bot to your Discord server: Click here

Discord setup commands

Initially you need to specify which channel you want to allow the bot to post into. This is done by simply executing the command /add-channel in the channel that the bot is supposed to write the server status messages into. Afterwards you stay in the same channel and add tracking for your Teeworlds servers like this /add-tracking address:123.123.123.123:8301 or for ipv6 addresses you use /add-tracking address:[fe80::9656:d028:8652:66b6]:8303

If you want to remove tracking, you simply delete the messages that the bot created.

When you are done with your setup, you finally need to activate the channel to be updated by the bot like this /start in the corresponding channel.

If you want to stop the from updating server status messages for a specific channel, you can execute the /stop slash command in that channel.

All of these commands provide an optional parameter called channel which you can use to execute all of these commands in a different channel from the channel that you want to use for posting server status updates.

Hoster guide

In case you want to host this yourself, you can use this guide to do so.

build instructions

There are about three ways to get you up and running. In case that you have the Go compiler toolchain installed, you can execute:

go install github.com/jxsl13/twstatus-bot@latest

This downloads, compiles and installs the executable into echo "$(go env GOPATH)/bin".

Alternatively you can clone this repository and build the executable yourself. Use make build or go build . for that purpose.

Lastly, you can build and deploy the docker container using docker compose by calling make deploy (make redeploy and make stop).

Usage

Environment variables:
  TWBOT_DISCORD_TOKEN         Discord App token.
  TWBOT_SUPER_ADMINS          Comma separated list of Discord User IDs that are super admins.
  TWBOT_DISCORD_GUILD_ID      Discord Bot Owner Guild ID
  TWBOT_DISCORD_CHANNEL_ID    Discord Bot Owner ChannelID for logs
  TWBOT_POLL_INTERVAL         Poll interval for DDNet's http master server (default: "16s")
  TWBOT_LEGACY_FORMAT         Use legacy message format. If disabled, rich text embeddings will be used. (default: "false")
  TWBOT_POSTGRES_HOSTNAME     Postgres host (default: "postgres")
  TWBOT_POSTGRES_PORT         Postgres port (default: "5432")
  TWBOT_POSTGRES_USER         Postgres user
  TWBOT_POSTGRES_PASSWORD     Postgres password
  TWBOT_POSTGRES_DATABASE     Postgres database (default: "twdb")
  TWBOT_POSTGRES_SSLMODE      Postgres ssl mode (default: "disable")

Usage:
  twstatus-bot [flags]
  twstatus-bot [command]

Available Commands:
  completion  Generate completion script
  help        Help about any command

Flags:
  -c, --config string               .env config file path (or via env variable TWBOT_CONFIG)
  -i, --discord-channel-id string   Discord Bot Owner ChannelID for logs
  -g, --discord-guild-id string     Discord Bot Owner Guild ID
  -t, --discord-token string        Discord App token.
  -h, --help                        help for twstatus-bot
  -l, --legacy-format               Use legacy message format. If disabled, rich text embeddings will be used.
  -p, --poll-interval duration      Poll interval for DDNet's http master server (default 16s)
  -D, --postgres-database string    Postgres database (default "twdb")
  -H, --postgres-hostname string    Postgres host (default "postgres")
  -W, --postgres-password string    Postgres password
  -P, --postgres-port uint16        Postgres port (default 5432)
  -S, --postgres-sslmode string     Postgres ssl mode (default "disable")
  -U, --postgres-user string        Postgres user
  -a, --super-admins string         Comma separated list of Discord User IDs that are super admins.

Docker usage: Create a .env file in the current directory

# mandatory parameters
TWBOT_DISCORD_TOKEN="Nj..."
TWBOT_SUPER_ADMINS="134948708277026816"
TWBOT_DISCORD_GUILD_ID="1196213160911311018"
TWBOT_DISCORD_CHANNEL_ID="1196213253102129343"

# mandatory database parameters
TWBOT_POSTGRES_HOSTNAME="postgres"  # you might want to change this to 'localhost' if you run outside of a container.
TWBOT_POSTGRES_USER="twbot"
TWBOT_POSTGRES_PASSWORD="database_password"

# optional parameters
# format: 1h30m5s
TWBOT_POLL_INTERVAL="16s"

# optional database parameters
TWBOT_POSTGRES_PORT="5432"
TWBOT_POSTGRES_DATABASE="twdb"
TWBOT_POSTGRES_SSLMODE="disable"

and then execute (on Linux):

make start

This will build and start a docker image locally.

If you want to stop the container, you can simply execute:

make stop