MCTOOLBOX
MC ToolboxMC TOOLBOX
Protocolo de servidor Java Edition

Explorador da API de Gerenciamento de Servidor Minecraft

Navegue pelos métodos JSON-RPC vanilla, construa parâmetros posicionais, inspecione esquemas de resposta e prepare uma conexão WebSocket segura sem expor um segredo de servidor real.

68
Métodos
17
Notificações
15
Esquemas
3.0
Protocolo em 26.2
Método chamávelSomente leitura1.21.9+
minecraft:server/status

Leia o estado de inicialização, jogadores online e a versão do Minecraft em execução.

Parâmetros

Este método não aceita parâmetros.

Resultado

Tipo de resultado
Server State
Requisição JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "minecraft:server/status"
}
Exemplo de resposta
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "started": true,
    "players": [
      {
        "id": "853c80ef-3c37-49fd-aa49-938b674adae6",
        "name": "jeb_"
      }
    ],
    "version": {
      "name": "26.2",
      "protocol": 774
    }
  }
}

Construtor de conexão e server.properties

Use uma porta fixa para ferramentas e deixe o segredo vazio uma vez para que o Minecraft gere um valor válido de 40 caracteres.

Nota de segurança: Nunca cole um segredo de gerenciamento real em um site público. Vincule a localhost ou a uma rede privada, use um firewall e use TLS em redes não confiáveis.
server.properties
management-server-enabled=true
management-server-host=localhost
management-server-port=25585
management-server-secret=
management-server-tls-enabled=true
management-server-tls-keystore=management-server.p12
management-server-allowed-origins=http://localhost:3000
Conexão de terminal
wscat -c wss://localhost:25585 -s minecraft-v1 -H "Authorization: Bearer YOUR_40_CHARACTER_SECRET"
Exemplo de WebSocket para navegador
const socket = new WebSocket('wss://localhost:25585', [
  'minecraft-v1',
  'YOUR_40_CHARACTER_SECRET'
]);

socket.addEventListener('open', () => {
  socket.send("{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"minecraft:server/status\"}");
});

socket.addEventListener('message', ({ data }) => {
  console.log(JSON.parse(data));
});
Guia do protocolo

O que é o Protocolo de Gerenciamento de Servidor Minecraft?

O Protocolo de Gerenciamento de Servidor é uma API de servidor dedicado Java Edition introduzida na versão 1.21.9. Ele transporta mensagens JSON-RPC 2.0 via WebSocket, permitindo que dashboards e automação trabalhem com jogadores tipados, bans, configurações, game rules e estado do servidor em vez de analisar texto do console.

Minecraft 26.2 usa a versão 3.0 do protocolo e pode expor rpc.discover antes que o servidor do jogo tenha iniciado completamente. A descoberta é a maneira mais segura para um cliente aprender os métodos e notificações suportados pelo servidor exato que ele alcançou.

Este explorador é uma referência e um construtor de payload, não um painel de controle remoto. Ele usa intencionalmente um segredo de placeholder e realiza todas as edições localmente em seu navegador.

Orientação operacional

API de Gerenciamento versus RCON

RCON envia comandos de console e retorna texto não estruturado. A API de gerenciamento retorna JSON tipado e pode enviar eventos de entrada, saída, salvamento, gamerule e status, o que a torna mais adequada para painéis de controle, monitoramento e bots.

A API é apenas para Java Edition e está desabilitada por padrão. Um cliente de produção deve validar os esquemas descobertos, lidar com objetos de erro JSON-RPC padrão, reconectar com backoff e tratar as escritas de stop, clear, set, ban, kick e operator como ações privilegiadas.

A porta 0 pede ao Minecraft para escolher uma porta aleatória; isso não desabilita o serviço. O TLS é habilitado por padrão, e os clientes de navegador também precisam de uma Origin permitida mais o subprotocolo WebSocket minecraft-v1.

Perguntas frequentes

Esta página pode se conectar ao meu servidor Minecraft ativo?

Não. Ele constrói exemplos localmente e nunca pede seu segredo real. Use o snippet gerado em uma ferramenta local confiável ou use uma biblioteca cliente mantida.

Por que os parâmetros são mostrados como um array JSON?

Os métodos da API do Minecraft usam parâmetros JSON-RPC posicionais. Mesmo um método com um argumento lógico envia esse valor dentro do array de parâmetros.

O protocolo funciona na Bedrock Edition?

Não. O Protocolo de Gerenciamento de Servidor Minecraft é atualmente um recurso de servidor dedicado da Java Edition.

Devo codificar a lista de métodos em um painel de servidor?

Use rpc.discover em tempo de execução quando possível. O protocolo já mudou entre 1.21.9, 1.21.11 e 26.2.