Plugin GTA (FiveM · RageMP · SA-MP)

Pack multiplataforma: resource FiveM, script RageMP, include SA-MP/open.mp + níveis mensais.

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

Guia passo a passo

Da ficha do servidor às recompensas automáticas — GTA.

  1. Criar a ficha do servidor

    Adiciona o teu servidor GTA no VoteServeur — criar a minha ficha. Obténs o server_token no painel.

  2. Descarregar o pack ZIP

    Inicia sessão, escolhe o teu servidor no painel direito → ZIP pronto a usar. O token é injetado automaticamente.

  3. Instalar no servidor

    Descompacta em FiveM · RageMP · SA-MP (voir INSTALL.txt) — o server_token já está no ZIP.

  4. Testar o claim

    Vota em a ficha com a caixa de recompensa + o teu nome in-game ou Steam ID. O script consulta /api/v1/votes/pending depois /votes/claim-username (~15 s) — quando claimed = 1, entrega a recompensa uma única vez.

  5. Configurar níveis mensais

    Edita os níveis no pack (YAML / Lua / JSON). O plugin lê /api/v1/votes/player (votes_month) para recompensas progressivas.

Guia completa do servidor: Criar um servidor GTA · Docs API

Fluxo voto → recompensa

  1. O jogador vota em a ficha GTA com a caixa de recompensa + o seu nome in-game (Steam recomendado).
  2. O teu script consulta /votes/pending e faz claim (a cada ~15 s).
  3. claimed = 1 → entrega a recompensa uma única vez por esse voto.
  4. Os níveis mensais usam /api/v1/votes/player (votes_month).

Plataformas incluídas

Este ZIP contém vários plugins — instala o que corresponde (vê também INSTALL.txt no ZIP):

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

Também podes listar o teu servidor em RageMP ou SA-MP se não usares FiveM.

Instalação — GTA

Pack nativo — descompacta em FiveM · RageMP · SA-MP (voir INSTALL.txt). O server_token já está na config do ZIP.

Conectado no VoteServeur → botão «ZIP pronto a usar»: token injetado automaticamente, zero copiar-colar.

Níveis mensais (exemplo)

Editáveis no pack (YAML / Lua / JSON consoante o jogo). 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) !

Pontos de acesso

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=…

Documentação API completa →