Geliştirici Günlüğü #13: Betik sınırları ve sonsuz döngü

Kısaca: Oyun betikleri döngü kurar, koleksiyonları tarar, eylemleri birbirine zincirler ve modları çalıştırır. MKA Engine bu işlerin her birine tur, üye, kat ve komut sayısıyla bir betik sınırı koyar; sınırları yalnız oyunun manifesti ayarlar, modlar değiştiremez. Sınır aşılınca ilgili etki ya da değerlendirme durur, sorun kayda yazılır; motor çökmez ve sonuç her makinede aynı kalır.

Sınır olmadan ne olur?#

Sınır olmasaydı, hatalı yazılmış hiç bitmeyen bir döngü tek oyuncuda oyunu takardı. Çok oyunculu oyunda bu daha ağırdır: her makine aynı adımı kendi başına koşar ve yavaşlayan bir adım herkesi bekletir. Bu yüzden sınır, betiğin yazarının dikkatine bırakılmaz; motorun parçasıdır.

Hangi sınırlar var?#

Sınırlar oyunun project.bsm dosyasında limits anahtarıyla yazılır. Bir mod bu anahtarı yazarsa motor bunu tanı olarak bildirir. Sınırlar sonucu etkilediği için değişince mod setinin özeti de değişir.

Neden süre değil sayı?#

Süre sınırı akla ilk gelen çözümdür. Ama süreyle kesilen bir işin sonucu makinenin hızına bağlanır: yavaş bir bilgisayarda yarım kalan adım, hızlı bir bilgisayarda tamamlanan adımdan farklı olur. Bu yüzden sınırlar tur, üye, kat ve komut sayısıyla ölçülür; her makine aynı yerde keser.

Oyunun süre hedefi (step_target_ms) ise bir ölçüm hedefidir. bsm run adım süresini bu hedefle karşılaştırır ve aşan adımları yazar; adımı asla kesmez.

Pahalı betik nasıl bulunur?#

İki araç var. bsm check pahalı kalıpları dosya, satır ve sütunla uyarır: her adımda bütün satırları gezen taramaları ve sık çalışan olayların koşullarını. Uyarı çıkış kodunu değiştirmez; derleme hatası değildir. bsm run --script-cost N ise koşunun gün satırlarından sonra en pahalı N betiği, olay ve eylem adlarıyla, çağrı sayısı ve süresiyle yazar.

Testler neyi sınadı#

• Döngü sınırı aşıldığında etki durur ve betik hatası yazılır; sabit sayı sınırı aşıyorsa yükleme hatası verilir.
• İç içe taramalar bütçede durur ve o ana kadar yazılanlar kalır.
• Sınırdan derin bir eylem zinciri tek bir betik hatası olur.
• Oyunun manifesti sınırları ayarlar; mod yakıtı değişince mod setinin özeti değişir.
• bsm check pahalı kalıpları beklenen metinle uyarır ve çıkış kodu değişmez.

Bedeli ne?#

• Sınır, yazılmış işi de keser: 1000 turdan uzun bir döngü istediği işi tamamlayamaz. Yazar döngüyü kısaltmak ya da count ve max ile daraltmak zorundadır.
• Varsayılanlar bir tahmindir; ihtiyaç ölçülürse sınır oyunun manifestinde yükseltilir.
• Bu günlükte ölçüm yok. Yazı sınırların davranışını anlatır; bir betiğin kaç milisaniye sürdüğünü ölçmez.

Sık sorulanlar#

Kaynaklar ve kayıtlar#

İlgili günlükler: Geliştirici Günlüğü #7, Oyun motorunda mod desteği.

Bu günlük hakkında sorularınız ya da önerileriniz varsa iletişim sayfasından yazabilirsiniz. Motorun genel tanıtımı için MKA Engine sayfasına, bütün günlükler için Geliştirici Günlükleri listesine bakabilirsiniz.