MCTOOLBOX
MC ToolboxMC TOOLBOX
Java Edition Serverprotokoll

Minecraft-Serververwaltungs-API-Explorer

Durchsuchen Sie die Vanilla JSON-RPC-Methoden, erstellen Sie positionale Parameter, überprüfen Sie Antwortschemata und bereiten Sie eine sichere WebSocket-Verbindung vor, ohne ein echtes Server-Geheimnis preiszugeben.

68
Methoden
17
Benachrichtigungen
15
Schemata
3.0
Protokoll in 26.2
Aufrufbare MethodeNur lesen1.21.9+
minecraft:server/status

Lesen Sie den Startstatus, die Online-Spieler und die laufende Minecraft-Version.

Parameter

Diese Methode benötigt keine Parameter.

Ergebnis

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

Verbindungs- und server.properties-Builder

Verwenden Sie einen festen Port für Tools und lassen Sie das Geheimnis einmal leer, damit Minecraft einen gültigen 40-stelligen Wert generiert.

Sicherheitshinweis: Fügen Sie niemals ein echtes Management-Geheimnis auf einer öffentlichen Website ein. Binden Sie an localhost oder ein privates Netzwerk, verwenden Sie eine Firewall und verwenden Sie TLS über nicht vertrauenswürdige Netzwerke.
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
Terminalverbindung
wscat -c wss://localhost:25585 -s minecraft-v1 -H "Authorization: Bearer YOUR_40_CHARACTER_SECRET"
Browser WebSocket Beispiel
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));
});
Protokollanleitung

Was ist das Minecraft Server Management Protocol?

Das Server Management Protocol ist eine Java Edition Dedicated-Server-API, die in 1.21.9 eingeführt wurde. Es überträgt JSON-RPC 2.0-Nachrichten über WebSocket, sodass Dashboards und Automatisierungen mit typisierten Spielern, Bans, Einstellungen, game rules und dem Serverstatus arbeiten können, anstatt Konsolentext zu parsen.

Minecraft 26.2 verwendet Protokollversion 3.0 und kann rpc.discover verfügbar machen, bevor der Spielserver vollständig gestartet ist. Discovery ist der sicherste Weg für einen Client, die von dem genauen Server, den er erreicht hat, unterstützten Methoden und Benachrichtigungen zu erfahren.

Dieser Explorer ist ein Referenz- und Payload-Builder, keine Fernbedienung. Er verwendet absichtlich ein Platzhalter-Geheimnis und führt alle Bearbeitungen lokal in Ihrem Browser durch.

Betriebsanleitung

Verwaltungs-API im Vergleich zu RCON

RCON sendet Konsolenbefehle und gibt unstrukturierten Text zurück. Die Management-API gibt typisiertes JSON zurück und kann Join-, Leave-, Save-, gamerule- und Statusereignisse pushen, was sie besser für Bedienfelder, Überwachung und Bots geeignet macht.

Die API ist nur für Java Edition und standardmäßig deaktiviert. Ein Produktionsclient sollte erkannte Schemata validieren, Standard-JSON-RPC-Fehlerobjekte behandeln, mit Backoff wieder verbinden und Stop-, Clear-, Set-, Ban-, Kick- und Operator-Schreibvorgänge als privilegierte Aktionen behandeln.

Port 0 fordert Minecraft auf, einen zufälligen Port zu wählen; er deaktiviert den Dienst nicht. TLS ist standardmäßig aktiviert, und Browser-Clients benötigen außerdem einen erlaubten Origin sowie das WebSocket-Subprotokoll minecraft-v1.

Häufig gestellte Fragen

Kann diese Seite eine Verbindung zu meinem Live-Minecraft-Server herstellen?

Nein. Es erstellt Beispiele lokal und fragt niemals nach Ihrem echten Geheimnis. Verwenden Sie den generierten Snippet in einem vertrauenswürdigen lokalen Tool oder verwenden Sie eine gewartete Client-Bibliothek.

Warum werden Parameter als JSON-Array angezeigt?

Die Minecraft-API-Methoden verwenden positionale JSON-RPC-Parameter. Selbst eine Methode mit einem logischen Argument sendet diesen Wert innerhalb des params-Arrays.

Funktioniert das Protokoll auf der Bedrock Edition?

Nein. Das Minecraft Server Management Protocol ist derzeit eine Funktion des dedizierten Java Edition Servers.

Sollte ich die Methodenliste in einem Serverpanel fest codieren?

Verwenden Sie rpc.discover zur Laufzeit, wenn möglich. Das Protokoll hat sich bereits zwischen 1.21.9, 1.21.11 und 26.2 geändert.