Documentação Pixel Host
Integração Pixel Host
Entenda a diferença entre o token público da API e o segredo usado pelo plugin gerenciado.O PixelHostIntegration é instalado automaticamente em servidores Paper, Purpur e Spigot. Ao preparar a aba Jogadores, o painel gera um segredo exclusivo da instância e grava o mesmo valor no cadastro interno e em plugins/PixelHostIntegration/config.yml.
Esse segredo não é uma API key pública e não deve ser usado por bots. Para integrações externas, crie um token na aba API, escolha a expiração e os escopos, e envie-o no cabeçalho Authorization: Bearer.
Depois de instalar ou atualizar o JAR, reinicie o servidor. O console deve mostrar Integracao Pixel Host ativa. Para testar, mova um item com encantamento e execute Dar OP; o painel aguardará a confirmação do plugin.
O plugin deve continuar compatível com servidores antigos que rodam Java 8. Se o servidor mostrar Unsupported Java ou falha de classe Java, valide a versão do Minecraft, a versão do Java escolhida pelo runtime e o JAR instalado.
- Configuração gerenciada: plugins/PixelHostIntegration/config.yml
- Nunca reutilize o segredo em outra instância
- Nunca coloque um token público da API no config.yml do plugin
- Reinstale o plugin pelo painel quando config.yml, server-id ou secret estiverem divergentes
- Modo online/offline deve ser tratado na aba de conexão e sincronizado com proxy/server.properties
- Diagnóstico de conexão fica nos logs centralizados do gateway e pode ser filtrado por scripts/diagnose-minecraft-gateway.sh
panel-url: "https://pixel-host.com.br"
server-id: "UUID_DA_INSTANCIA"
secret: "GERADO_AUTOMATICAMENTE_PELO_PAINEL"
sync-interval-seconds: 10
action-poll-seconds: 2