Voting Methods:

API information for vote reward!

If you are hosting a game other than Minecraft you may want an easy way to find out if a Steam User or Username has voted within the past 24 hours. With our API you can easily check for that and even set the vote claimed status.

How to check if a Steam User or Username has voted within the last 24 hours?

URL to check for a Steam User:

URL to check for a Username:

Response	Description
0	There was an issue with the server key, steamid, username, or the player has not voted in the last 24 hours!
1	Player has voted in the last 24 hours and has not claimed their reward.
2	Player has voted in the last 24 hours and has claimed their reward.

How to set a vote to claim status for a Steam User or Username?

URL to check for a Steam User:

URL to check for a Username:

Response	Description
0	There was an issue with the server key, steamid, username, or the player has not voted in the last 24 hours!
1	Player has voted in the last 24 hours and vote is set as claim. (You can reward them!)
2	Player has voted in the last 24 hours and has already claimed their reward! (DO NOT REWARD THEM!)

---

Postback method!

If you decided that you would like to use your own script and have us send data to you when a player votes, then you can use our Postback method.

What is my Postback URL supposed to look like?

This is an example of a Postback URL:

or

What should my vote link look like?

This is an example of a voting link using the Postback method:

What data am I gonna receive?

When a player votes we will send an HTTP GET request with two parameters in the Postback URL which are username and userip.

An example of the URL we will send to you:

What am I supposed to do with the data I receive?

Below is an example script and how you could handle the incoming data (Note: This is just an example and is not ready for use right away):

#Example PHP Postback Script #This script is just an example and we do not take responsibility or liability for actions caused by this script! // Your Database Connection Details $host = 'localhost'; $db_name = ''; $db_user = ''; $db_password = ''; $connection = mysqli_connect($host, $db_user, $db_password); mysqli_select_db($connection, $db_name); // Username $userid = isset($_POST['username']) ? $_POST['username'] : null; // User ip $userip = isset($_POST['userip']) ? $_POST['userip'] : null; // User voted on bestservers.com? 1 = unique vote, 0 = Already voted $valid = isset($_POST['voted']) ? (int)$_POST['voted'] : 0; // Make sure the user was not yet rewarded on your system // For example by checking your reward logs if (!is_null($userid) && $valid == 1) { // Make userid safe to use in query $userid = mysqli_real_escape_string($connection, $userid); // COUNT rows where reward_date is today $result = mysqli_query($connection, "SELECT COUNT(*) FROM `reward_log` WHERE `username` = '$userid' AND `reward_date` >= CURDATE()"); $rewarded = mysqli_num_rows($result); // No results means not rewarded yet, so grant reward and set the reward date/time log if(!$rewarded) { // Grant reward, for example points mysqli_query($connection, "UPDATE `users` SET `points` = `points` + 1 WHERE `username` = '$userid'"); // Insert log mysqli_query($connection, "INSERT INTO `reward_log` (`username`, `reward_date`) VALUES ('$userid', NOW())"); } } // Close connection mysqli_close($connection);

---

Votifier Method

If you own a Minecraft server and you would like to reward players for voting then we have support for the popular Minecraft reward plugin called Votifier!

How does it work?

Install Votifier on your server. Then when adding your server on our site, enter your Votifier information in the correct section. Lastly, all players have to do is enter their username correctly on the vote link and they will be rewarded!

What connection details do I need

If you enable this setting in your server settings then you will need your Votifier ip, Votifier query ip and Votifier public key.

You can configure you Votifier settings at ./config/votifier/config.yml on your server

Your Votifier could be your server ip or a custom one:

Your Votifier default query port is 8192 unless you change it in your Votifier server configuration:

Your Votifier public key is found at ./config/votifier/rsa/public.key on your server and is used to encrypt vote data:

ex. MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0N7KtjNgKU26NjF8Xho04dhtakaBRJBeJlFDw7PqwhE33q/khKrVc4xgFfNQIoJuxjgZit6dtW4B1NEjApVj+caRNUCtmxgF5G3yuz4QIxN12Fw+J3gEYKJdI6mJLQvLRS0G2rqtpdFydNKbscYfxI3cjx4vaeD3m/SV7gIeKsIQZJjn6RBL7J1BlyqTPd6F3JKCGmCW74wFrdhO5CgU3xHQbfIh4AYyY5W585awoTsP/DnxPILjujyUZdjuztJWkQ8aTaJgThJDrWKATH64Z9ux1g7pHUpbv9MIQzcTqN0DH/dDcutYZANIWgQ8jGbLsyna1qJTskxD4p

That is pretty much it! If you have any questions don't hesitate to Contact us!