Vote Rewards

How Vote Rewards works

Vote Rewards turns every vote for your game server into something your players can spend. A player votes on a ranking site (TopGames, DayZ Servers or TrackyServer), collects tokens for that vote in Discord, and spends the tokens in your token shop on Discord roles, in-game items or anything your staff hand over.

It runs on your Discord server and needs no game mod. The only thing it asks of your players is to link their Steam account once. It is a Premium 3 feature.

• 1. The player votesOn the ranking site of your server, as many times as the site allows (usually once every few hours).
• 2. The player collects tokensWith /votes collect in Discord. The bot checks the vote on the site and pays the tokens you set for that site. A vote is paid once, never twice.
• 3. The player spends tokensWith /votes buy, in the token shop you build. Roles arrive at once. In-game items are handed out in game or by your staff, see "Handing out the rewards" below.
• 4. Everyone sees the rankingThe bot can post the top voters of the week and of the month in a channel, to keep the votes coming.

Step by step: set it up in 10 minutes

You need a server on Premium 3 and the permission to manage your Discord server.

1. 01

   Open the page

   Log in at dayzhub.net, open your dashboard, pick your server and choose Vote Rewards in the side menu.

2. 02

   Switch it on and pick your voting sites

   In Settings, switch on Vote Rewards. For each ranking site you use, switch it on, paste its key (see the next section for where to find it) and set how many tokens one vote is worth. Keys are shown as dots after you save them, and only you can replace them.

3. 03

   Build your token shop

   Add the things your players can buy: a name, a price in tokens, an optional stock, and what it gives (a Discord role, an in-game item list, or something your staff hand over).

4. 04

   Choose where things are posted

   Pick the channel for the shop message and the channel for the weekly and monthly rankings. Both are optional.

5. 05

   Decide how rewards get handed out

   With a linked DayzHUB Console, players claim in-game items themselves with !claim. Without it, pick a staff channel: every in-game purchase then opens a request thread for your staff, with a Delivered button. See "Handing out the rewards".

6. 06

   Tell your players

   Post the voting link and a short note: link your Steam with /link-steam, vote, then type /votes collect. Done.

The voting sites, one by one

Use any one, two or all three. Each one has its own key and its own tokens per vote. The bot only reads whether a player voted. It never posts for you and it never sees your site password.

• TopGames (top-games.net)Find the "votes token" of your server on its administration page on TopGames (the API section) and paste it into the TopGames key field. Your players vote on your TopGames page and type their Steam ID (the long number of 17 digits that starts with 7656119) in the optional Username box of the vote form. Then they run /votes collect. TopGames lets a player vote again after 2 hours, and the bot finds a vote for up to 2 hours after it was cast, so collect soon after voting.
• DayZ Servers (dayz-servers.org)On the administration page of your server on DayZ Servers, open the Web API section, copy the votes token shown there and paste it into the DayZ Servers key field. Players vote on your DayZ Servers page and then run /votes collect. The bot marks the vote as used on the site after it pays it, so it can never be paid again.
• TrackyServer (trackyserver.com)Copy the vote key of your server from its administration page on TrackyServer and paste it into the TrackyServer key field. Players vote on your TrackyServer page and then run /votes collect. TrackyServer answers once per vote, which is the claim.

What your players do

Share these steps with your community. The commands work in any channel and the answers are private to the player.

1. 01

   Link Steam once

   Type /link-steam in Discord and follow the steps. It is the same link used by Verify.

2. 02

   Vote

   On your server page of the ranking site. On TopGames, type your Steam ID in the Username box.

3. 03

   Collect

   Type /votes collect in Discord. You get a message with the tokens you collected and your balance. If the site is slow it can take a minute to show the vote.

4. 04

   Check your balance and the shop

   Type /votes balance for your tokens and /votes shop for what you can buy.

5. 05

   Buy

   Type /votes buy and pick the item. Tokens are only taken when the purchase works. If something fails you are not charged.

6. 06

   Get the reward

   A role is yours at once. For an in-game item, type !claim in the game chat (servers with the DayzHUB Console) or wait for the staff to hand it over (you are pinged in your request thread).

7. 07

   Confirm you got it

   After the staff hands over an item, the bot sends you a private message. Press "I received it" when the item is with you, or "I did not receive it" if something is missing and the staff will check again.

Building your token shop

Every item has a name, a price in tokens and an optional stock. When the stock reaches zero the item is sold out. Leave the stock empty for unlimited. There are three kinds of items:

• A Discord roleThe player gets the role the moment they buy. Pick a normal role, for example "VIP voter" or a colour. For safety the bot refuses roles that carry staff powers (like Manage Server or Ban Members) and roles your server uses for staff or verification, so a purchase can never make someone a moderator.
• An in-game item listWrite what the player receives as class names and quantities, separated by semicolons, for example BandageDressing:2;Canteen:1. Players get exactly that list in game. Ask the person who runs your game server if you are unsure about class names.
• Something your staff hand overAnything else: a base repair, a custom skin, a vehicle. The purchase becomes a request for your staff, who give it in game or elsewhere and press Delivered.

Handing out the rewards

There are two ways, and your server uses the right one automatically. You can change this in the Staff requests settings of the Vote Rewards page.

• Without the DayzHUB Console: staff requestsWhen a player buys an in-game item or a "staff hand over" item, the bot opens a private thread in the staff channel you chose. The thread says who bought what, the price, the player's Steam ID and what to hand over, and pings the role you picked. In a separate message there are two buttons: Delivered and Refund tokens. A staff member gives the item in game and presses Delivered. The reward is then marked delivered in your log with the name of the staff member and the time, the player is pinged in the thread and the thread is closed. If the item cannot be given, Refund tokens gives the tokens back and cancels the reward. Only your staff can press the buttons (Manage Server, the ping role or a Tickets support role), and only one of them can win if two press at once.
• Confirming the delivery (items only)After a staff member presses Delivered, the player gets a private message from the bot asking if the item arrived, with the buttons "I received it" and "I did not receive it". If the player confirms, the reward is marked complete and your staff is told in the thread. If the player says it did not arrive, the request opens again with your staff role pinged, and the Delivered and Refund tokens buttons work again. If the player has private messages closed, the same question is posted in the request thread. Roles are never asked, because they arrive at once.
• With the DayzHUB Console linked: !claimThe DayzHUB Console is our game server tool (dayzhub.cloud) with an agent mod that sits on your server. When your Console server is linked to your Discord server, nobody on your staff has to do anything: the player types !claim in the game chat and the Console hands the items out by itself within seconds, right next to the player. The Console works on every Console plan for this link, only your Discord server needs Premium 3.
• When the Console is releasedThe Console is not open to everyone yet. Until it is, use the staff requests. The day you link your Console server, nothing else has to change: purchases from then on are handed out with !claim, and requests that were already open stay in their threads for your staff to finish. Switch the mode to "Always" if you prefer to keep the staff requests even with the Console.
• The modesAutomatic (default): staff requests only on servers without a linked Console. Always: staff requests for every in-game purchase, also with the Console. Off: no requests, the rewards wait in the list on the Vote Rewards page.

For your staff: the rewards list and the wallets

Everything the players buy is in one list on the Vote Rewards page, with its status: waiting, delivered or refunded. You can see who delivered it and when.

1. 01

   Rewards waiting

   Each waiting reward shows the player, the item and the price. Press Mark delivered after you gave it, or Cancel and refund to give the tokens back.

2. 02

   Wallets

   Look up a player by Steam ID to see their tokens and their history. Staff can add or remove tokens with a written reason. Every change is recorded in the log with the staff member's name.

3. 03

   Rankings

   Choose a rankings channel and the bot keeps one message there with the top voters of this week and this month, updated by itself.

4. 04

   If a plan ends

   If your Premium 3 ends, Vote Rewards pauses by itself. Nothing is deleted: wallets, items and the log are kept, and it continues the day you are back on Premium 3.

Fair and safe by design

• One vote, one paymentA vote can only be collected once. Collecting twice, from two Discord accounts or at the same time does not pay it again.
• Votes belong to the Steam accountTokens go to the Steam ID linked to the Discord account that collects. Nobody can collect for someone else, and a typed Steam ID only ever pays the real owner of that ID.
• Tokens are never lostA purchase is all or nothing. If anything fails after the payment, the tokens and the stock come back automatically.
• Your keys stay yoursVoting site keys are stored for your server only, never shown in full and never written to logs.

Troubleshooting

• "No new votes found"The vote may not have reached the site yet (wait a minute), it may be older than 2 hours (TopGames) or it may belong to another Steam ID. On TopGames, make sure you typed your Steam ID in the Username box. Vote again when the site allows it and collect again.
• "Could not check the site right now"The site did not answer, or the key in your dashboard is wrong or was changed. Try again in a few minutes. Owners: paste the key again in Settings and save.
• "You need to link your Steam account"Type /link-steam first. Votes are matched by Steam ID.
• I bought an item but nothing happened in gameWith the Console: type !claim in the game chat. Without the Console: your staff has a request thread and hands it over, then presses Delivered. You are pinged there.
• The bot asked me if I received an itemThat is the delivery confirmation: your staff pressed Delivered for an item you bought. Press "I received it" if the item is with you. If not, press "I did not receive it" and the staff will check again. Only you can answer, and only once.
• The buttons in the request thread do not workOnly staff can press them. If you are staff and still cannot, you need Manage Server, the ping role set in Staff requests, or a Tickets support role.
• The bot cannot create the threadGive the bot the permissions View Channel, Send Messages and Create Private Threads in the staff channel. The purchase itself is never affected: the reward waits in the list on the Vote Rewards page.