Adicionar servidor

← Todos os plugins › Minecraft Java

Plugin Minecraft Java

Plugin Spigot/Paper + /votestats + níveis YAML.

native claim · username plugins/

Guia passo a passo

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

  1. Criar a ficha do servidor

    Adiciona o teu servidor Minecraft 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 plugins/ — 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 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 Minecraft · Docs API

Fluxo voto → recompensa

  1. O jogador vota em a ficha Minecraft 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 — Minecraft

Pack nativo — descompacta em plugins/. 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 give {player} emerald 5 · xp add {player} 50 levels
  • 15+ Palier 15 give {player} netherite_ingot 1
  • 30+ Palier 30 give {player} elytra 1

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 →