MCTOOLBOX
MC ToolboxMC TOOLBOX
Protocollo server Java Edition

Esploratore API di gestione server Minecraft

Sfoglia i metodi JSON-RPC vanilla, crea parametri posizionali, ispeziona gli schemi di risposta e prepara una connessione WebSocket sicura senza esporre un vero segreto del server.

68
Metodi
17
Notifiche
15
Schemi
3.0
Protocollo in 26.2
Metodo richiamabileSola lettura1.21.9+
minecraft:server/status

Leggi lo stato di avvio, i giocatori online e la versione di Minecraft in esecuzione.

Parametri

Questo metodo non accetta parametri.

Risultato

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

Generatore di connessione e server.properties

Usa una porta fissa per gli strumenti e lascia il segreto vuoto una volta in modo che Minecraft generi un valore valido di 40 caratteri.

Nota di sicurezza: Non incollare mai un vero segreto di gestione in un sito web pubblico. Associa a localhost o a una rete privata, usa un firewall e usa TLS su reti non attendibili.
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
Connessione terminale
wscat -c wss://localhost:25585 -s minecraft-v1 -H "Authorization: Bearer YOUR_40_CHARACTER_SECRET"
Esempio WebSocket del browser
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));
});
Guida al protocollo

Cos'è il protocollo di gestione server Minecraft?

Il protocollo di gestione server è un'API per server dedicati Java Edition introdotta in 1.21.9. Trasporta messaggi JSON-RPC 2.0 su WebSocket, in modo che dashboard e automazione possano lavorare con giocatori tipizzati, ban, impostazioni, game rules e stato del server invece di analizzare il testo della console.

Minecraft 26.2 utilizza la versione del protocollo 3.0 e può esporre rpc.discover prima che il server di gioco sia completamente avviato. La scoperta è il modo più sicuro per un client di apprendere i metodi e le notifiche supportati dal server esatto che ha raggiunto.

Questo esploratore è un riferimento e un generatore di payload, non un pannello di controllo remoto. Utilizza intenzionalmente un segreto segnaposto ed esegue tutte le modifiche localmente nel tuo browser.

Guida operativa

API di gestione contro RCON

RCON invia comandi console e restituisce testo non strutturato. L'API di gestione restituisce JSON tipizzato e può inviare eventi di join, leave, save, gamerule e status, il che la rende più adatta per pannelli di controllo, monitoraggio e bot.

L'API è solo per Java Edition e disabilitata per impostazione predefinita. Un client di produzione dovrebbe convalidare gli schemi scoperti, gestire gli oggetti di errore JSON-RPC standard, riconnettersi con backoff e trattare le scritture di stop, clear, set, ban, kick e operator come azioni privilegiate.

La porta 0 chiede a Minecraft di scegliere una porta casuale; non disabilita il servizio. TLS è abilitato per impostazione predefinita e i client browser necessitano anche di un'origine consentita più il sottoprocollo WebSocket minecraft-v1.

Domande frequenti

Questa pagina può connettersi al mio server Minecraft live?

No. Costruisce esempi localmente e non chiede mai il tuo vero segreto. Usa lo snippet generato in uno strumento locale fidato o usa una libreria client mantenuta.

Perché i parametri sono mostrati come un array JSON?

I metodi API di Minecraft utilizzano parametri posizionali JSON-RPC. Anche un metodo con un solo argomento logico invia quel valore all'interno dell'array params.

Il protocollo funziona su Bedrock Edition?

No. Il protocollo di gestione server Minecraft è attualmente una funzionalità del server dedicato Java Edition.

Dovrei codificare l'elenco dei metodi in un pannello del server?

Usa rpc.discover a runtime quando possibile. Il protocollo è già cambiato tra 1.21.9, 1.21.11 e 26.2.