Ajouter un serveur

← Tous les plugins › GTA (FiveM · RageMP · SA-MP)

Plugin GTA (FiveM · RageMP · SA-MP)

Pack multi-plateforme : resource FiveM, script RageMP, include SA-MP/open.mp + paliers mois.

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

Guide pas à pas

De la fiche serveur aux récompenses automatiques — GTA.

  1. Créer la fiche serveur

    Ajoute ton serveur GTA sur VoteServeur — créer ma fiche. Tu récupères le server_token dans le panel.

  2. Télécharger le pack ZIP

    Connecte-toi, choisis ton serveur dans le panneau de droite → ZIP prêt à brancher. Le token est injecté automatiquement.

  3. Installer sur le serveur

    Dézippe dans FiveM · RageMP · SA-MP (voir INSTALL.txt) — le server_token est déjà dans le ZIP.

  4. Tester le claim

    Vote sur la fiche avec la case récompense + ton pseudo in-game ou Steam ID. Le script poll /api/v1/votes/pending puis /votes/claim-username (~15 s) — quand claimed = 1, distribue la récompense une seule fois.

  5. Configurer les paliers mensuels

    Édite les tiers dans le pack (YAML / Lua / JSON). Le plugin lit /api/v1/votes/player (votes_month) pour débloquer les récompenses progressives.

Guide serveur complet : Créer un serveur GTA · Doc API

Flux vote → récompense

  1. Le joueur vote sur la fiche GTA avec la case récompense + son pseudo in-game (Steam recommandé).
  2. Ton script poll /votes/pending puis claim (toutes les ~15 s).
  3. claimed = 1 → tu donnes la récompense une seule fois pour ce vote.
  4. Les paliers mensuels se basent sur /api/v1/votes/player (votes_month).

Plateformes incluses

Ce pack ZIP contient plusieurs plugins — installe celui qui correspond à ton serveur (voir aussi INSTALL.txt dans le ZIP) :

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

Tu peux aussi lister ton serveur sous RageMP ou SA-MP si tu n’utilises pas FiveM.

Installation — GTA

Pack natif — dézippe dans FiveM · RageMP · SA-MP (voir INSTALL.txt). Le server_token est déjà écrit dans la config du ZIP.

Connecté sur VoteServeur → bouton « ZIP prêt à brancher » : token injecté auto, zéro copier-coller.

Paliers mensuels (exemple)

Éditables dans le pack (YAML / Lua / JSON selon le jeu). 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=…

Documentation API complète →