MCTOOLBOX
MC ToolboxMC TOOLBOX
Protocolo de servidor de Java Edition

Explorador de API de Gestión de Servidores Minecraft

Explora los métodos JSON-RPC vanilla, construye parámetros posicionales, inspecciona esquemas de respuesta y prepara una conexión WebSocket segura sin exponer un secreto de servidor real.

68
Métodos
17
Notificaciones
15
Esquemas
3.0
Protocolo en 26.2
Método invocableSolo lectura1.21.9+
minecraft:server/status

Lee el estado de inicio, los jugadores en línea y la versión de Minecraft en ejecución.

Parámetros

Este método no toma parámetros.

Resultado

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

Constructor de conexión y server.properties

Usa un puerto fijo para las herramientas y deja el secreto vacío una vez para que Minecraft genere un valor válido de 40 caracteres.

Nota de seguridad: Nunca pegues un secreto de gestión real en un sitio web público. Enlaza a localhost o a una red privada, usa un firewall y usa TLS a través de redes no confiables.
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
Conexión de terminal
wscat -c wss://localhost:25585 -s minecraft-v1 -H "Authorization: Bearer YOUR_40_CHARACTER_SECRET"
Ejemplo 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));
});
Guía del protocolo

¿Qué es el Protocolo de Gestión de Servidores de Minecraft?

El Protocolo de Gestión de Servidores es una API de servidor dedicado de Java Edition introducida en 1.21.9. Transmite mensajes JSON-RPC 2.0 a través de WebSocket, por lo que los paneles y la automatización pueden trabajar con jugadores tipados, bans, configuraciones, game rules y el estado del servidor en lugar de analizar texto de consola.

Minecraft 26.2 utiliza la versión 3.0 del protocolo y puede exponer rpc.discover antes de que el servidor de juego haya iniciado completamente. El descubrimiento es la forma más segura para que un cliente aprenda los métodos y notificaciones soportados por el servidor exacto al que se conectó.

Este explorador es una referencia y un constructor de carga útil, no un panel de control remoto. Intencionalmente utiliza un secreto de marcador de posición y realiza todas las ediciones localmente en tu navegador.

Guía operativa

API de Gestión versus RCON

RCON envía comandos de consola y devuelve texto no estructurado. La API de gestión devuelve JSON tipado y puede enviar eventos de unión, salida, guardado, gamerule y estado, lo que la hace más adecuada para paneles de control, monitoreo y bots.

La API es solo para Java Edition y está deshabilitada por defecto. Un cliente de producción debe validar los esquemas descubiertos, manejar objetos de error JSON-RPC estándar, reconectarse con retroceso y tratar las escrituras de stop, clear, set, ban, kick y operator como acciones privilegiadas.

El puerto 0 le pide a Minecraft que elija un puerto aleatorio; no deshabilita el servicio. TLS está habilitado por defecto, y los clientes de navegador también necesitan un Origin permitido más el subprotocolo WebSocket minecraft-v1.

Preguntas frecuentes

¿Puede esta página conectarse a mi servidor de Minecraft en vivo?

No. Construye ejemplos localmente y nunca pide tu secreto real. Usa el fragmento generado en una herramienta local de confianza o usa una biblioteca de cliente mantenida.

¿Por qué los parámetros se muestran como un array JSON?

Los métodos de la API de Minecraft usan parámetros posicionales JSON-RPC. Incluso un método con un solo argumento lógico envía ese valor dentro del array de parámetros.

¿Funciona el protocolo en Bedrock Edition?

No. El Protocolo de Gestión de Servidores de Minecraft es actualmente una característica de servidor dedicado de Java Edition.

¿Debería codificar la lista de métodos en un panel de servidor?

Usar rpc.discover en tiempo de ejecución cuando sea posible. El protocolo ya ha cambiado entre 1.21.9, 1.21.11 y 26.2.