API sürümleri

Mod API'si blockheads:api@<sürüm> olarak sürümlenir. Bir mod, hangi sürümlerle çalıştığını mod.toml içinde söyler:

api = "^0.2"

Sürüm	Ekledikleri
0.1	olaylar (katılma, ayrılma, sohbet, komut, tick, dünya yükleme ve kaydetme), komutlar, zamanlayıcı, depolama, oyuncular, günlük
0.2	oynanış olayları (giriş öncesi, blok koyma / kırma / değişme, nesne koyma, hasar, ölüm, hareket), player:pos(), servisler, özel olaylar, yerel kanallar
0.3	istemci arayüzü (ui), mod içeriği ve kozmetikler (content)
0.3.1	ağ üzerinden servisler: istemci modu ve sunucu modu birbirini çağırır (call-remote, cancel-remote, caller); bir yama sürümü, başka bir şey değişmez

Uyumluluk

• Sunucular 0.3.1'i uygular ve 0.3, 0.2 ile 0.1'i de sunar. 0.x içinde yeni bir alt sürüm yalnızca bir şeyler ekler; yani api = "^0.1" olan bir mod değişmeden yüklenmeye ve çalışmaya devam eder.
• 0.2'den bir şey mi kullanıyorsun? api = "^0.2" bildir; 0.3'ten ise "^0.3", ağ üzerinden servisler için "^0.3.1". Eski sunucular, çalışma anında hata vermek yerine modunu atlar.
• 0.1'e göre derlenmiş WASM modları çalışmaya devam eder: sunucular dondurulmuş 0.1 WIT dosyasını da bağlar.
• bh.host.api_version() sunucunun neyi çalıştırdığını söyler.

Bu sitedeki başvuru 0.3.1 içindir: API başvurusu. 0.2 veya 0.3'te yeni olan fonksiyonlar ve alanlar (0.2) ya da (0.3) ile işaretlidir.