Zum Inhalt
SERVOTINGDocs

Hilfe

English summary

SERVOTING is a ranking and voting platform for game servers. This page summarises the essentials in English. Listing, votes and the ranking are free, and no paid plan affects rank or votes.

Add or claim your server

Create an account and add your server at Add server. If it is already listed, click Is this your server? on its page and verify ownership with a code in your server name, your Cfx.re account (FiveM/RedM), an RCON login (Minecraft, Rust, ARK, CS2, Garry's Mod, DayZ, Arma and more), a DNS TXT record servoting-verify=<code> on _servoting.your-domain.com, a file at /.well-known/servoting-verify.txt on your website, or a manual review by our team (up to 48 hours).

How vote rewards work

  1. A player votes for your server and enters the in-game name.
  2. SERVOTING creates a vote event with a unique event_id.
  3. Your server receives the event: by polling the API (resource or plugin), by webhook or, for Minecraft, through Votifier.
  4. Your server gives the reward and marks the event as claimed. Each event can be claimed once.

Tip: link players to the vote page with their name already filled in:

https://servoting.com/servers/<your-server>/vote?player=PlayerName

Every entry also has a direct review link that opens only the review form: /servers/<name>/bewerten, /hosting/…, /anbieter/…, /agenturen/… and /streamer/<name>/bewerten (streamers also have /streamer/<name>/vote). Your links with QR codes are in your dashboard under Your links.

Best option: a personal vote link from the game. The resource creates it on /vote and binds the vote to the player's license, even if the character name differs. Valid once, for 6 hours.

https://servoting.com/v/K7Q2MX9

FiveM and RedM

Download the resource, copy it to resources/, add your API key to server.cfg and adjust the reward in config.lua. Players see the vote link with /vote.

set servoting_api_key "sv_xxxxxxxx.yyyyyyyy"
ensure servoting-rewards

Download resource for FiveM and RedM

Code examples for ESX, QBCore/Qbox, RSG-Core and VORP are on the FiveM page.

Minecraft, Rust, CS2 and other games

Your dashboard (Rewards & API) shows the setup for your game:

  • Minecraft: through NuVotifier, the standard of all vote sites. Enter address, Votifier port (default 8192) and the token from plugins/nuvotifier/config.yml. Your vote plugin (VotingPlugin, SuperbVote, …) gives the reward. Votes arrive with the service name SERVOTING.
  • Rust: plugin ServotingRewards.cs for Oxide (uMod) and Carbon. Enter the API key and reward console commands ({steamid}, {name}) in its config. Download
  • Garry's Mod: server addon. Enter the API key and the reward in lua/servoting/config.lua. Download
  • Counter-Strike 2: CounterStrikeSharp plugin; enter the API key and your shop plugin's command in its config. Download
  • Unturned: RocketMod plugin, gives 100 experience per vote by default. Allow vote for the default group. Download
  • ARK, Project Zomboid, 7 Days to Die: SERVOTING Bridge, a small Python program that runs next to the server and rewards over RCON or telnet. Download
  • All other games: API or webhook, see below. DayZ, Arma, V Rising and Space Engineers need your own mod; Valheim, Enshrouded and SCUM cannot give rewards from the server.

Plugins confirm each vote with SERVOTING first and reward only afterwards, so a vote is never rewarded twice. Players who vote while offline get the reward on their next join.

API

Create an API key on your server page under Rewards & API and send it with every request:

Authorization: Bearer sv_xxxxxxxx.yyyyyyyy
EndpointPurpose
GET /api/v1/votes/pendingUnclaimed votes of the last 7 days, oldest first. With ?player=Name only the votes of that player.
POST /api/v1/vote-linkCreate a personal vote link for a player (JSON: player, identifier). Valid for 6 hours.
POST /api/v1/votes/{event_id}/claimMarks a vote as rewarded. A second claim returns claimed: false.
GET /api/v1/votes/check?player=NameDid this player vote in the last 24 hours, and was it claimed?
GET /api/v1/serverName, vote link, votes per period and position.

Limit: 120 requests per minute per key. Votes stay available for 7 days.

Webhooks

With a webhook URL, SERVOTING sends each vote as a POST request:

Check the signature: HMAC-SHA256 of "<t>.<raw body>" with your webhook secret, and reject old timestamps. Code samples in PHP and Node.js are on the webhooks page.

Answer with a 2xx status. Otherwise SERVOTING retries after 1, 5, 30, 120, 360 and 720 minutes.

Store the event_id of every rewarded vote. If the same event arrives twice, do not reward it again.

Streamer pages

Streamers get their own page at servoting.com/@name: all links in one place, live status from Twitch (optional) and cards of the servers they play on, with status and vote button. A server link needs both sides: the streamer requests it, the server confirms in its dashboard under Streamers (or the other way round). Paid partnerships are labelled as ads. The page has an optional legal notice (Impressum) the streamer maintains. Free: 3 colour schemes, 8 links, 30 days of statistics. Creator Pro and Creator Plus add designs, background images, more links and longer statistics; Plus also hides the SERVOTING note and is shown as "Featured" in the directory. Links to servers never affect rankings or votes.

Hosters and providers

Hosters (/hosting) and providers of scripts, MLOs, vehicles, clothing and services (/anbieter, formerly /partner, old links redirect) get a profile with reviews, seal and widgets. "Partner" on SERVOTING only means a real partnership: official partner hosters and partner servers. Both add their channels (website, Discord, YouTube, Twitch, Kick, TikTok, Instagram, X, Facebook) under Social media; they show as an icon row for free. With a package (Provider Pro or VIP, for hosters "Highlight hoster" or VIP) the profile also shows the latest posts from YouTube and Twitch, with up to 3 pinned posts. Kick has no public videos and TikTok and Instagram have no feed without an app review, so posts from there are pinned by link and load only after a click. On streamer pages the latest videos show for everyone; pinning and hiding need Creator Pro.

Contact

Questions? Use the contact form or write to support@servoting.com.

Simple questions are answered first by the SERVOTING AI from this documentation, short and to the point. Once your issue is solved, it asks if there is anything else. If not, it announces the close and closes the ticket after 24 hours (Discord: 12 hours) unless you reply. Payments, refunds, privacy, legal matters and partnerships are always handled by the team. Write “human” to talk to a person.