QwtfDiscordBot

A Discord bot for checking the status of QuakeWorld Team Fortress servers

Dependencies

• Ruby >= 2.5.0
• qstat version with JSON support. Tested with commit 2ab78bd5c30fbd47b2bdd4a6279296d66424b37e. Should be added to $PATH.

Installation

gem install qwtf_discord_bot

Usage

• Create a bot on discord
• Create a ~/.config/qwtf_discord_bot/config.yaml file containing your bots credentials and server endpoints

  ---
  token: "dhjksahdkjhhur43hu4hu5b4b5k34j12b4kj3b4kjb4j32kb4kjb4kb3k2b"
  client_id: "873298379487294398"
  endpoints:
    - "sydney.fortressone.org":
      - channel_ids:
        - 832749832749873298
        - 798437748937298448
    - "sydney.fortressone.org:27501":
      - channel_ids:
        - 590204247224745986
    - "dallas.fortressone.org":
      - channel_ids:
        - 480928490328409328
  emojis:
    red:
      scout: "<:scout_red:424097703127941130>"
      sniper: "<:sniper_red:424097704076115978>"
      soldier: "<:soldier_red:424097704197619712>"
      demoman: "<:demoman_red:424097687739301919>"
      medic: "<:medic_red:424097695418941451>"
      pyro: "<:pyro_red:424097704403271691>"
      hwguy: "<:hwguy_red:424097694030757889>"
      spy: "<:spy_red:424097704138899466>"
      engineer: "<:engineer_red:424097694680612864>"
    blue:
      scout: "<:scout_blue:456062063983460353>"
      sniper: "<:sniper_blue:456062061953417216>"
      soldier: "<:soldier_blue:456062062997536801>"
      demoman: "<:demoman_blue:456061938636554240>"
      medic: "<:medic_blue:456062056710537217>"
      pyro: "<:pyro_blue:456062062460928010>"
      hwguy: "<:hwguy_blue:456062063190736926>"
      spy: "<:spy_blue:456062062032846849>"
      engineer: "<:engineer_blue:456062031125020683>"

• Use the QWTF_DISCORD_BOT_CONFIG_FILE environment variable to specify an alternative config file path

  export QWTF_DISCORD_BOT_CONFIG_FILE="config.yaml"

Commands

There are three modules:

Server

qwtf-discord-bot server

This responds to discord messages:

• !server
• !active
• !all

Pug

qwtf-discord-bot pug

This responds to discord messages:

• !status
• !join
• !leave
• !teamsize <no_of_players>
• !kick <@player> [@player2]
• !team <team_no>
• !unteam
• !addmap <map_name>
• !removemap <map_name>
• !maps
• !map [map_name]
• !choose [n]
• !win <team_no>
• !draw
• !notify <@role>
• !end

Watcher

qwtf-discord-bot watcher

This watches the game server and announces if anyone has joined the server. It polls the server once every 30 seconds and will only report a player joining if they haven't been connected for more than ten minutes.

Gem

Build:

gem build qwtf_discrd_bot.gemspec

Install:

gem install --local qwtf_discord_bot-$(cat VERSION).gem

Push:

gem push qwtf_discord_bot-$(cat VERSION).gem

Docker

Run:

Assuming a ./config.yaml file exists:

docker-compose up

Only discord-bot server:

docker run -it \
  --env QWTF_DISCORD_BOT_CONFIG_FILE=config.yaml \
  --mount type=bind,source="$(pwd)"/config.yaml,target=/discord-bot/config.yaml \
  discord-bot server

Only discord-bot watcher:

docker run -it \
  --env QWTF_DISCORD_BOT_CONFIG_FILE=config.yaml \
  --mount type=bind,source="$(pwd)"/config.yaml,target=/discord-bot/config.yaml \
  discord-bot watcher

Only discord-bot pug:

docker run -it \
  --env QWTF_DISCORD_BOT_CONFIG_FILE=config.yaml \
  --mount type=bind,source="$(pwd)"/config.yaml,target=/discord-bot/config.yaml \
  discord-bot pug

Build:

docker build --tag=discord-bot .

Push:

docker tag discord-bot fortressone/discord-bot:latest
docker push fortressone/discord-bot:latest

Create AWS instance:

docker-machine create \
  --driver amazonec2 \
  --amazonec2-access-key <AWS_ACCESS_KEY> \
  --amazonec2-secret-key <AWS_SECRET_KEY> \
  --amazonec2-root-size 30 \
  --amazonec2-region ap-southeast-2 \
  discord-bot

License

The gem is available as open source under the terms of the MIT License.