Sorun Giderme

Araç açılmıyor

Açılış, tam bir kontrol boru hattını (pipeline) çalıştırır. Herhangi bir kontrol başarısız olursa nedenini açıklayan bir bildirim alırsınız. Bunları inceleyin:

• İzin (Permission) — eğer Config.Permission.Enabled = true ise, oyuncunun bu şartı sağladığından emin olun. Type = 'ace' için, ACE (animpos.use) yetkisinin add_ace ile verildiğinden emin olun. Type = 'job' için, oyuncunun mesleğinin Config.Permission.Jobs içinde olduğundan emin olun.
• Durum kısıtlaması (State restriction) — bir araçta, düşerken/paraşütle atlarken, yüzerken (etkinse), ölü durumdayken, son direnişte (last stand) veya kelepçeliyken engellenirsiniz. Bildirim size hangi durumda olduğunuzu söyler. Engelleme istenmiyorsa ilgili Config.Restrictions bayrağını ayarlayın.
• Bekleme süresi (Cooldown) — her kullanımdan sonra bir Config.Cooldown (varsayılan 15 s) bekleme süresi vardır. "Too fast! Please wait a moment." mesajı, bekleme süresinin hâlâ aktif olduğu anlamına gelir.
• CanUse kancası (Hook) — false döndüren özel bir Config.CanJoin / Config.CanUse açılışı engeller. Oradaki özel mantığı kontrol edin.

Hiçbir bildirim görünmüyor

Bu durum neredeyse her zaman bir arka uç uyumsuzluğundan (backend mismatch) kaynaklanır. Config.Notify, sunucunuzda gerçekten çalışmakta olan bir bildirim sistemiyle eşleşmelidir:

• ox_lib — ox_lib'in başlatılmış olmasını gerektirir (ox_lib olarak ayarlanmışsa ancak ox_lib çalışmıyorsa konsol uyarı verir).
• qbcore — QB-Core ve bunun QBCore:Notify olayını (event) gerektirir.
• esx — ESX ve bunun esx:showNotification olayını gerektirir.
• custom — Config.CustomNotify içinde çalışan bir işleyici (handler) gerektirir.

Geçersiz bir değer otomatik olarak ox_lib'e geri döner ve konsola bir uyarı kaydeder.

Tuş ataması (keybind) hiçbir şey yapmıyor

• Config.Keybind.Enabled = true olduğunu ve Config.Keybind.Default değerinin boş olmadığını onaylayın — tuş ataması yalnızca her ikisi de ayarlandığında kaydedilir.
• Tuş ataması kaynak (resource) başlatıldığında kaydedilir; yapılandırmayı (config) değiştirdiyseniz kaynağı yeniden başlatın.
• Oyuncunun Ayarlar → Tuş Atamaları → FiveM altında tuşu yeniden atamadığından (veya silmediğinden) emin olun. /animpos komutu, tuş atamasından bağımsız olarak her zaman çalışır.

Metin yanlış dilde / İngilizce görünüyor

• server.cfg dosyasına setr ox:locale "<code>" ekleyin (istemcilere iletilmesi için setr kullanın).
• Desteklenen bir kod kullanın: en, tr, de, fr, es, pt, ru.
• Eksik bir çeviri anahtarı İngilizceye geri döner — yerel ayar (locale) dosyanızda ilgili anahtarın en.json ile tamamen aynı ada sahip olduğunu doğrulayın.

Altyapı (Framework) özellikleri çalışmıyor / algılanmıyor

• Config.Framework değerini tam olarak sunucunuzla eşleşecek şekilde ayarlayın (qbox, qbcore, esx veya standalone). Geçersiz bir değer konsola uyarı kaydeder.
• Ölü / son direniş (last stand) / kelepçeli kısıtlamaları yalnızca qbox ve qbcore üzerinde çalışır. esx ve standalone üzerinde bu meta veri kontrolleri tasarımları gereği atlanır — yalnızca araç / düşme / yüzme geçerlidir.
• Meta veri kısıtlamaları QBox/QB-Core üzerinde hâlâ tetiklenmiyorsa, altyapınız bu alanları farklı anahtarlar altında saklıyor olabilir — Config.Restrictions.MetaKeys ayarını düzenleyin.

Karakter donmuş veya şeffaf halde takılıyor

Komut dosyası kaynak durdurulduğunda alfa değerini temizler, ped donmasını kaldırır ve ragdoll'u geri yükler, bu nedenle bupa-animpos yeniden başlatıldığında takılan durum çözülür. Eğer bir entegrasyon ped ölçeklendirmesini duraklatılmış bıraktıysa, temizleme sırasında devam ettirme (resume) export'u da çağrılır.