███████╗██████╗ ██████╗ █████╗ ██╗ ██╗ ██╔════╝██╔══██╗██╔═══██╗██╔══██╗██║ ██╔╝ ███████╗██████╔╝██║ ██║███████║█████╔╝ ╚════██║██╔═══╝ ██║ ██║██╔══██║██╔═██╗ ███████║██║ ╚██████╔╝██║ ██║██║ ██╗ ╚══════╝╚═╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝
Yüksek performanslı, Lock-Free ve Zero-Copy Minecraft Araçları API'ı.
Rust ve Axum ile geliştirildi. Devasa trafik yüklerine dayanıklı TTL tabanlı Moka önbelleği kullanır.
Tüm endpoint'ler saniyelik rate-limit'e tabi olup, sıkça kullanılan yanıtlar anında RAM'den (Moka) dönmektedir.
| Endpoint | İşlev |
|---|---|
GET /api/mcping | Hedef Minecraft sunucusunun canlı verilerini, gecikme sürelerini ve MOTD formatlarını getirir. (Ping Flood Korumalı) |
GET /api/player/:username | Oyuncu UUID'sini, Skin model tipini ve cape (pelerin) detaylarını Mojang'dan çekip önbellekler. |
GET /api/seedmap/tile | Cubiomes C kütüphanesini kullanarak Minecraft dünyalarının anlık biyom chunk'larını üretir ve Zero-Copy (BytesMut) ile direkt bytestream döner. |
GET /api/seedmap/structures | Belirli bir koordinatın etrafındaki Tapınak, Köy veya Gemi Enkazı gibi yapıları listeler. |
GET /api/serverjars/* | Mojang, Paper ve Leaf build versiyonlarının güncel dağıtımlarını listeler. |
Gereksinimler: Rust Stable (1.75+) ve Cubiomes (C-FFI) derlemek için GCC/Clang.
# 1. Depoyu indirin
git clone https://github.com/spoakk/backend
cd spoak-backend
# 2. Çevresel değişkenleri yapılandırın (PORT vs.)
cp .env.example .env
# 3. Yüksek performans modunda (release) çalıştırın
cargo run --release- Zero-Copy & Moka Cache: Ağır CPU kullanan C FFI (Cubiomes) sonuçları Moka üzerinde asenkron olarak önbelleklenir. Chunk başına
$<1ms$ dönüş sağlanır. - Lock-Free Rate Limiter: Arka planda sunucuyu bloke eden eski
DashMapyapıları kaldırılarak TTL tabanlı Moka Rate-Limiter sistemine geçilmiştir. - Graceful Shutdown:
ctrl_cdinlenerek, aktif bağlantıların güvenle kapatılması sağlanır.
- Web Sitesi:spoak.cc
- Topluluk:Discord Sunucumuz
- CLI Versiyonu:spoak-cli