Contents

# QwtfDiscordBot

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


## Dependencies

  - Ruby >= 2.5.0
  - [qstat](https://github.com/multiplay/qstat) version with JSON support.  Tested with commit [2ab78bd5c30fbd47b2bdd4a6279296d66424b37e](https://github.com/multiplay/qstat/tree/2ab78bd5c30fbd47b2bdd4a6279296d66424b37e). Should be added to `$PATH`.


## Installation

    $ gem install qwtf_discord_bot


## Usage

Create a bot on discord.

Edit the `.env.example` file, update with your bot's `client_id` and `token` and save as `.env`.

    $ source .env


### List commands

    $ bundle exec exe/qwtf-discord-bot help

There are two features:


### Server

This responds to `!servers` messages by providing information about your game
server. Defaults to the hostname command line argument, but will accept a
hostname from the user. I.E. `!server fortressone.org`

![screenshot of bot responding to !server command](server_screenshot.png)

```
Usage:
  qwtf_discord_bot server

Options:
  [--endpoints=one two three]
                               # Default: ["localhost:27500"]
```

E.G.

    $ qwtf-discord-bot server --endpoints \
          sydney.fortressone.org:27500 \
          sydney.fortressone.org:27501


### 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.

![screenshot of bot reporting player joining server](watcher_screenshot.png)

```
Usage:
  qwtf_discord_bot watcher

Options:
  [--endpoints=one two three]
                               # Default: ["localhost:27500"]
```

E.G.

    $ bundle exec exe/qwtf-discord-bot watcher --endpoints sydney.fortressone.org:27501


## License

The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

Version data entries

9 entries across 9 versions & 1 rubygems

Version	Path
qwtf_discord_bot-3.0.0	README.md
qwtf_discord_bot-2.2.1	README.md
qwtf_discord_bot-2.2.0	README.md
qwtf_discord_bot-2.1.3	README.md
qwtf_discord_bot-2.1.2	README.md
qwtf_discord_bot-2.1.1	README.md
qwtf_discord_bot-2.1.0	README.md
qwtf_discord_bot-2.0.1	README.md
qwtf_discord_bot-2.0.0	README.md