dayz-monitor

DayZ monitoring discord bot, that doesn't require RCon! (Thanks to BattleMetrics)

Features

Retrieves player count
Retrieves the time on the server
Lightweight as hell (my instance is running on 3MB of RAM)

Setup

Docker (preferred)

Find the docker image here

This is automatically built on each push to master and pushed to the latest tag.

Simply pull the image and set the required environment variables (see below -> Configuration)

Compilation

To do this you will need Rust installed, so go do that, then come back!

Once Rust has been installed, something like this should do the trick!

git clone https://github.com/Huskehhh/dayz-monitor
cd dayz-monitor
cargo build --release

Now dayz-monitor has been compiled. You're almost ready! All that is left is some configuration.

Step 2. Configuration

First of all, all configuration options are handled via environment variables, which can either be set globally or simply through a .env file (I recommend the latter!) So simply go ahead and create a .env file contaning these following values:

DISCORD_TOKEN=putyoursupersecretdiscordbottokenhere
BATTLEMETRICS_SERVER_ID=putyourbattlemetricsserveridhere
GUILD_ID=putyourdiscordidhere
SERVER_NAME=Server name here

Do NOT use this unless you need to

You have been warned.

If you aren't sure of your BATTLEMETRICS_SERVER_ID or your server has a dynamic IP, you can set BATTLEMETRICS_SEARCH as the filter parameters you use on BattleMetrics to find your server INSTEAD of using BATTLEMETRICS_SERVER_ID

This is NOT recommended, if you know your BATTLEMETRICS_SERVER_ID please use it.

Individually looking at each of the variables:

DISCORD_TOKEN (required) This is the token you will get once you create a Bot on Discord Development portal

Steps:

Create a new application here
On the application's page, go to the "Bot" tab, click "Add Bot", and confirm!
Copy the "Token"

BATTLEMETRICS_SERVER_ID (required) Steps:

Go onto BattleMetrics website and find your server
Copy the ID out of the URL, for example https://www.battlemetrics.com/servers/dayz/5526398 would be 5526398

GUILD_ID and SERVER_NAME (optional) This will enable the creation of a voice channel that will update, showing the player count in a voice channel GUILD_ID must be set to the discord server id SERVER_NAME this is the name of the voice channel

Step 3. Invite the bot

Now you've configured it, you need to invite the bot to your Discord server. To do this, you will need to run the bot.

Simply running cargo run --release will do the trick, I personally run mine in a screen so I can leave it unattended.

The bot will then provide you with an invite link to click, which will drag him into your Discord server!

Step 4. Done

Enjoy the bot, if you pick up on any bugs or would like more functionality, feel free to let me know via the issue tracker here

Commands

!time (or !t) -> Retrieves the current time of the DayZ server
!count (or !c) -> Retrieves the current player count of the DayZ server
!status -> Retrieves the status of the DayZ server (whether it's online or not!)
!info -> Displays all the info in an embedded message

Huskehhh / dayz-monitor

readme