Adicionar servidor

← Todos os plugins › alt:V

Plugin alt:V

Preset de poller universal alt:V.

universal claim · username poller Node

Guia passo a passo

Da ficha do servidor às recompensas automáticas — alt:V.

  1. Criar a ficha do servidor

    Adiciona o teu servidor alt:V 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

    Executa o poller Node (cd universal && node poller.js) — config.json pré-preenchido.

  4. Testar o claim

    Vota em a ficha com a caixa de recompensa + o teu nome in-game exato. 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 alt:V · Docs API

Fluxo voto → recompensa

  1. O jogador vota em a ficha alt:V com a caixa de recompensa + o seu nome in-game.
  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).

Instalação — alt:V

Poller universal (Node, corre fora do processo do jogo):

cd universal
npm i          # opcional: rcon-client
# config.json = token já injetado + comandos RCON do jogo
node poller.js
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}.

  • 5+ Palier 5 say Merci {player} pour ton vote !
  • 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) !

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 →