Sunucu adresinin yanında “124 / 500” gibi bir sayaç göstermek için oyun sunucusuna eklenti kurmana gerek yok. Sayfan JavaScript ile MCAPI’ye istek gönderir ve sunucunun durum yanıtındaki players.online değerini ekrana yazar. Aşağıdaki örnek kendi tasarımına yerleştirebileceğin düz bir metin sayacı oluşturur.
HTML örneği
Kodu sayfanın gövdesine ekle. mc.hypixel.net yerine oyuncuların Minecraft’ta kullandığı adresi yaz. Bedrock için yorumdaki satırı aç. Özel port kullanıyorsan adresi adres:port biçiminde gir.
<p id="mc-players" role="status">Oyuncu sayısı yükleniyor…</p>
<script>
async function showPlayerCount() {
const label = document.getElementById('mc-players');
const address = 'mc.hypixel.net';
const url = new URL('https://mcapi.tr/api/v1/status/' + encodeURIComponent(address));
// url.searchParams.set('bedrock', 'true');
try {
const response = await fetch(url, { signal: AbortSignal.timeout(12000) });
if (!response.ok) throw new Error('HTTP ' + response.status);
const data = await response.json();
if (!data.online || !Number.isInteger(data.players?.online)) {
throw new Error('No player count');
}
const format = new Intl.NumberFormat('tr');
const count = format.format(data.players.online);
const capacity = Number.isInteger(data.players.max) && data.players.max > 0
? ' / ' + format.format(data.players.max)
: '';
label.textContent = count + capacity + (data.stale ? ' (son bilinen sayı)' : '');
} catch {
label.textContent = "Durum bilgisi alınamadı";
}
}
showPlayerCount();
</script>
Sıfır, eski veri ve bağlantı hatası
- Sunucu yanıt verip
players.online: 0bildirirse ekranda 0 görünür. stale: truevarsa sayı önceki başarılı kontrolden gelir. Örnek bunu etiketler.- Adres çözülemezse, istek zaman aşımına uğrarsa veya API sınırına takılırsa durumun alınamadığı yazılır. Bu durumda oyuncu sayısı bilinmez.
Her sayfa açılışında bir sorgu yeterli. Otomatik yenileyeceksen bir önceki sorgu tamamlandıktan sonra en az 60 saniye bekle ve 429 yanıtında yenilemeyi yavaşlat. İçerik güvenlik politikan varsa bağlantı kaynağı olarak https://mcapi.tr adresine izin ver. Site editörün JavaScript’i kaldırıyorsa hazır iframe widget’ını kullan.