GTA (FiveM · RageMP · SA-MP) plugin

Multi-platform pack: FiveM resource, RageMP script, SA-MP/open.mp include + monthly tiers.

native claim · steam+username FiveM · RageMP · SA-MP (voir INSTALL.txt)

Step-by-step guide

From server listing to automatic rewards — GTA.

  1. Create the server listing

    Add your GTA server on VoteServeur — create my listing. You get the server_token in the panel.

  2. Download the ZIP pack

    Sign in, pick your server in the right panel → Ready-to-use ZIP. The token is injected automatically.

  3. Install on the server

    Unzip into FiveM · RageMP · SA-MP (voir INSTALL.txt) — the server_token is already in the ZIP.

  4. Test the claim

    Vote on the listing with the reward checkbox + your in-game name or Steam ID. The script polls /api/v1/votes/pending then /votes/claim-username (~15 s) — when claimed = 1, give the reward once.

  5. Configure monthly tiers

    Edit tiers in the pack (YAML / Lua / JSON). The plugin reads /api/v1/votes/player (votes_month) for progressive rewards.

Full server guide: Create a GTA server · API docs

Vote → reward flow

  1. The player votes on the GTA listing with the reward checkbox + their in-game name (Steam recommended).
  2. Your script polls /votes/pending then claims (every ~15 s).
  3. claimed = 1 → give the reward once for that vote.
  4. Monthly tiers use /api/v1/votes/player (votes_month).

Included platforms

This ZIP pack contains several plugins — install the one that matches your server (see also INSTALL.txt in the ZIP):

  • fivem/voteserveur-rewards — FiveM — ESX/QB/standalone resource
  • ragemp — RageMP — packages/voteserveur/ script
  • samp — SA-MP / open.mp — Pawn include

You can also list your server under RageMP or SA-MP if you don’t use FiveM.

Install — GTA

Native pack — unzip into FiveM · RageMP · SA-MP (voir INSTALL.txt). The server_token is already written in the ZIP config.

Signed in on VoteServeur → “Ready-to-use ZIP” button: auto-injected token, zero copy-paste.

Monthly tiers (example)

Editable in the pack (YAML / Lua / JSON per game). Placeholders: {player} {votes_month} {votes_total}.

  • 7+ Palier 7 say [VoteServeur] {player} : {votes_month} votes ce mois — bonus fidelite !
  • 15+ Palier 15 say [VoteServeur] {player} VIP mois ({votes_month} votes) !
  • 30+ Palier 30 say [VoteServeur] {player} legendaire ({votes_month} votes ce mois) !

Endpoints

GET /api/v1/votes/pending?server_token=…
GET /api/v1/votes/claim?server_token=…&identity=…
GET /api/v1/votes/player?server_token=…&playername=…
GET /api/v1/votes/check?server_token=…&playername=…
GET /api/v1/votes/top?server_token=…&period=month&limit=10
GET /api/v1/server?server_token=…

Full API documentation →