Statistik Ekosistem dan API Publik MSID: Baca Tren Server dan Bangun di Atasnya

Selama ini kamu memakai MSID untuk mencari server atau mendaftarkan servermu sendiri. Sekarang ada dua hal baru yang membuka data di balik direktori: halaman Statistik yang merangkum seluruh ekosistem server Minecraft Indonesia, dan API publik gratis yang menyajikan data itu agar kamu bisa membangun sesuatu di atasnya.

Keduanya berguna untuk orang yang berbeda. Pemain bisa melihat tren: versi apa yang paling ramai, jam berapa server paling hidup. Pemilik server bisa membandingkan diri dengan ekosistem dan mengambil keputusan dari angka, bukan tebakan. Developer bisa menarik data MSID ke bot Discord, dashboard, atau widget status. Artikel ini membahas keduanya, dari cara membaca sampai cara memakainya lewat kode.

Halaman Statistik: apa yang bisa kamu lihat

Semua ada di halaman Statistik. Di bagian atas ada intisari, ringkasan dinamis yang merangkai angka-angka kunci jadi satu paragraf: berapa server terdaftar, berapa yang online sekarang, total pemain, edisi dan versi terpopuler. Di bawahnya, data dipecah jadi lima halaman bertema.

• Pemain. Tren pemain harian seluruh jaringan, jam paling ramai dalam sehari (Waktu Indonesia Barat), serta hari teramai dan tersepi. Ini gambaran kapan komunitas Indonesia benar-benar online.
• Server. Pembagian edisi Java, Bedrock, dan cross-play, keluarga versi yang paling banyak dipakai, kategori (tag) terpopuler beserta kombinasi yang sering muncul bersama, dan pertumbuhan server baru per minggu.
• Hosting. Provider yang paling banyak dipakai, negara tempat server berada, dan jaringan (ASN) di belakangnya. Banyak server Indonesia ternyata berjalan di Singapura karena latensinya rendah ke Indonesia.
• Peringkat. Server teratas berdasarkan skor, vote bulan ini, dan pemain online, plus siapa yang naik daun dan bagaimana peringkat bergeser dari bulan ke bulan.
• Keandalan. Distribusi uptime semua server, mana yang paling andal, dan tren rata-rata uptime. Diukur dari ping kami setiap lima menit.

Setiap halaman punya intisarinya sendiri, jadi kamu dapat kesimpulan satu kalimat sebelum menyelami grafiknya.

Kenapa versi dikelompokkan dari protokol, bukan teks versi

Satu hal yang patut dijelaskan, karena ini sering bikin salah kaprah. Teks versi yang dilaporkan server tidak bisa dipercaya untuk pengelompokan. Server berbasis proxy seperti Velocity sering melaporkan versi build proxy-nya sendiri, bukan versi Minecraft. Jadi sebuah jaringan 1.21 bisa muncul sebagai Velocity 1.7.2-26.1.2, Paper 26.1.2, atau label apa pun yang diatur pemiliknya.

Karena itu MSID mengelompokkan versi dari nomor protokol yang dinegosiasikan saat ping, bukan dari teks versi. Hasilnya keluarga versi yang konsisten seperti 1.21.x, terlepas dari apa yang ditulis server di MOTD-nya. Hal yang sama berlaku di API lewat field versionFamily, jadi kamu tidak perlu menebak-nebak teks versi sendiri.

Buat pemilik server: ubah statistik jadi keputusan

Angka ekosistem paling berguna sebagai pembanding. Beberapa cara memakainya:

• Targetkan versi yang tepat. Kalau mayoritas server ada di satu keluarga versi, menjalankan versi itu (atau membuka kompatibilitasnya) menurunkan friksi buat pemain baru yang ingin masuk.
• Jadwalkan dari jam ramai. Pakai grafik jam paling ramai untuk menaruh event atau pengumuman saat pemain paling banyak online, dan menaruh restart atau maintenance saat paling sepi.
• Patok uptime. Bandingkan keandalan servermu dengan distribusi uptime ekosistem. Kalau kamu di bawah rata-rata, itu sinyal untuk membenahi hosting atau performa sebelum mengejar pertumbuhan.
• Pahami persaingan. Halaman peringkat menunjukkan apa yang sedang naik. Pasangkan dengan strategi di cara menambah pemain server.

Buat pemain, halaman yang sama membantu memilih server yang bagus: server dengan uptime tinggi dan komunitas yang aktif di jam mainmu biasanya pilihan yang lebih aman.

API Publik: bangun di atas data MSID

Kalau kamu ingin menarik data ini ke aplikasimu sendiri, MSID punya API publik baca-saja, gratis, dan tanpa login.

Base URL: https://api.minecraftserver.id/api/v1/public

Aturannya sederhana:

• Tanpa autentikasi. Tidak perlu API key atau token. Header Authorization diabaikan.
• Rate limit 60 permintaan per menit per IP. Setiap respons membawa header RateLimit-Limit, RateLimit-Remaining, dan RateLimit-Reset.
• CORS terbuka. Bisa dipanggil langsung dari browser, jadi cocok untuk widget di situs.
• Format konsisten. Sukses selalu { "success": true, "data": ... }; gagal selalu { "success": false, "error": { "code", "message" } }.

Endpoint yang tersedia:

Contoh mengambil tiga server teratas berdasarkan vote:

curl 'https://api.minecraftserver.id/api/v1/public/servers?limit=3&sort=votes'

Contoh penghitung ekosistem untuk dipasang di widget:

curl 'https://api.minecraftserver.id/api/v1/public/stats/overview'

{
  "success": true,
  "data": { "totalServers": 48, "onlineServers": 41, "totalPlayersOnline": 1862 }
}

Setiap objek server menyertakan protocolVersion dan versionFamily, jadi kamu bisa mengelompokkan menurut versi Minecraft dengan andal tanpa mengurai teks versi yang sering berisi nama build proxy. Detail server juga menyertakan hostProvider dan hostCountry.

Referensi lengkap, termasuk semua parameter dan bentuk respons, ada di halaman Developers.

Sopan santun memakai API

Beberapa hal supaya integrasimu awet dan adil buat semua:

• Cache di sisimu. Data agregat di-cache beberapa menit di server kami, jadi tidak ada gunanya memanggil tiap detik. Simpan hasilnya dan segarkan tiap beberapa menit.
• Hormati rate limit. Kalau kena 429, baca header RateLimit-Reset dan tunggu, jangan langsung mencoba lagi berulang-ulang.
• Sebutkan sumbernya. Kalau kamu menampilkan data ini ke publik, tautkan kembali ke MSID. Itu membuat data tetap gratis untuk semua.

Langkah selanjutnya

Statistik dan API menjadikan seluruh ekosistem server Indonesia transparan, baik untuk dilihat maupun untuk dibangun di atasnya. Lanjutkan dengan:

• Cara memilih server Minecraft yang bagus, pakai statistik untuk memilih dengan cerdas.
• Cara menambah pemain server, ubah angka jadi pertumbuhan.
• Minecraft Java vs Bedrock, pahami pembagian edisi yang kamu lihat di statistik.

Punya server? Daftarkan di MSID supaya ikut terhitung dan ditemukan di daftar server Minecraft Indonesia.