MCTOOLBOX
MC ToolboxMC TOOLBOX
Protokol server Java Edition

Penjelajah API Manajemen Server Minecraft

Jelajahi metode JSON-RPC vanilla, buat parameter posisi, periksa skema respons, dan siapkan koneksi WebSocket yang aman tanpa mengekspos rahasia server yang sebenarnya.

68
Metode
17
Notifikasi
15
Skema
3.0
Protokol di 26.2
Metode yang dapat dipanggilHanya baca1.21.9+
minecraft:server/status

Baca status startup, pemain online, dan versi Minecraft yang sedang berjalan.

Parameter

Metode ini tidak memerlukan parameter.

Hasil

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

Pembuat koneksi dan server.properties

Gunakan port tetap untuk alat dan biarkan rahasia kosong sekali agar Minecraft menghasilkan nilai 40 karakter yang valid.

Catatan keamanan: Jangan pernah menempelkan rahasia manajemen yang sebenarnya ke situs web publik. Ikat ke localhost atau jaringan pribadi, gunakan firewall, dan gunakan TLS di seluruh jaringan yang tidak tepercaya.
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
Koneksi terminal
wscat -c wss://localhost:25585 -s minecraft-v1 -H "Authorization: Bearer YOUR_40_CHARACTER_SECRET"
Contoh WebSocket 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));
});
Panduan protokol

Apa itu Protokol Manajemen Server Minecraft?

Protokol Manajemen Server adalah API server khusus Java Edition yang diperkenalkan pada 1.21.9. Ini membawa pesan JSON-RPC 2.0 melalui WebSocket, sehingga dasbor dan otomatisasi dapat bekerja dengan pemain bertipe, ban, pengaturan, game rules, dan status server alih-alih mengurai teks konsol.

Minecraft 26.2 menggunakan versi protokol 3.0 dan dapat mengekspos rpc.discover sebelum server game sepenuhnya dimulai. Penemuan adalah cara teraman bagi klien untuk mempelajari metode dan notifikasi yang didukung oleh server yang tepat yang dijangkaunya.

Penjelajah ini adalah referensi dan pembuat payload, bukan panel kontrol jarak jauh. Ini sengaja menggunakan rahasia placeholder dan melakukan semua pengeditan secara lokal di browser Anda.

Panduan operasional

API Manajemen versus RCON

RCON mengirimkan perintah konsol dan mengembalikan teks tidak terstruktur. API manajemen mengembalikan JSON bertipe dan dapat mendorong acara join, leave, save, gamerule, dan status, yang membuatnya lebih cocok untuk panel kontrol, pemantauan, dan bot.

API ini hanya untuk Java Edition dan dinonaktifkan secara default. Klien produksi harus memvalidasi skema yang ditemukan, menangani objek kesalahan JSON-RPC standar, menyambung kembali dengan backoff, dan memperlakukan penulisan stop, clear, set, ban, kick, dan operator sebagai tindakan istimewa.

Port 0 meminta Minecraft untuk memilih port acak; itu tidak menonaktifkan layanan. TLS defaultnya diaktifkan, dan klien browser juga memerlukan Origin yang diizinkan ditambah subprotokol WebSocket minecraft-v1.

Pertanyaan yang sering diajukan

Bisakah halaman ini terhubung ke server Minecraft saya yang sedang berjalan?

Tidak. Ini membangun contoh secara lokal dan tidak pernah meminta rahasia Anda yang sebenarnya. Gunakan cuplikan yang dihasilkan di alat lokal tepercaya, atau gunakan pustaka klien yang dikelola.

Mengapa parameter ditampilkan sebagai array JSON?

Metode API Minecraft menggunakan parameter JSON-RPC posisi. Bahkan metode dengan satu argumen logis mengirimkan nilai tersebut di dalam array params.

Apakah protokol ini berfungsi di Bedrock Edition?

Tidak. Protokol Manajemen Server Minecraft saat ini adalah fitur server khusus Java Edition.

Haruskah saya meng-hard-code daftar metode di panel server?

Gunakan rpc.discover saat runtime jika memungkinkan. Protokol telah berubah di seluruh 1.21.9, 1.21.11, dan 26.2.