Ajouter un serveur

← Tous les plugins › SA-MP / open.mp

Plugin SA-MP / open.mp

Filterscript Pawn + poller universel.

both claim · username filterscripts/ ou poller Node

Guide pas à pas

De la fiche serveur aux récompenses automatiques — SA-MP / open.mp.

  1. Créer la fiche serveur

    Ajoute ton serveur SA-MP / open.mp 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

    Natif (filterscripts/ ou poller Node) ou poller universel Node.

  4. Tester le claim

    Vote sur la fiche avec ton pseudo in-game exact. Le script poll /api/v1/votes/claim-username — 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 SA-MP / open.mp · Doc API

Flux vote → récompense

  1. Le joueur vote sur la fiche SA-MP / open.mp avec son pseudo in-game.
  2. Ton script poll l’API VoteServeur (toutes les 20–60 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).

Installation — SA-MP / open.mp

Pack natif — dézippe dans filterscripts/ ou poller Node. Le server_token est déjà écrit dans la config du ZIP.

Poller universel (Node, marche hors process jeu) :

cd universal
npm i          # optionnel : rcon-client
# config.json = token déjà injecté + commandes RCON du jeu
node poller.js
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}.

  • 5+ Palier 5 say [VoteServeur] Merci {player} !
  • 15+ Palier 15 say [VoteServeur] {player} : palier 15 votes ({votes_month} ce mois) !
  • 30+ Palier 30 say [VoteServeur] {player} legendaire ({votes_month} votes ce mois) !

Endpoints

GET /api/v1/votes/claim-username?server_token=…&playername=…
GET /api/v1/votes/claim-steam?server_token=…&steam_id=…
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 →