Yapılandırma

Her şey config.lua dosyasından yapılandırılır. Bu sayfa her bir seçeneği detaylıca açıklar.

Genel

config.lua

Config.Framework = 'qbox'    -- qbox / qbcore / esx / standalone
Config.Command   = 'animpos' -- chat komut adı
Config.Cooldown  = 15        -- kullanım aralığı (saniye)

Framework — temel kaynağı ve hangi meta veri kısıtlamalarının geçerli olacağını seçer.
Command — aracı açan sohbet komutu (aynı zamanda tuş ataması adı olarak da kullanılır).
Cooldown — kullanımlar arasındaki minimum saniye.

Tuş Ataması

Oyuncuların aracı bir tuşla açmasına olanak tanır, GTA V ayarlarından yeniden atanabilir.

config.lua

Config.Keybind = {
    Enabled = true,
    Default = 'F6',  -- varsayılan tuş (hiçbiri için boş bırakın; oyuncu yeniden atayabilir)
}

ℹ

Tuş ataması yalnızca Enabled = true ve Default boş olmadığında kaydedilir. Oyuncular bunu her zaman Ayarlar → Tuş Atamaları → FiveM altından değiştirebilir.

İzin (isteğe bağlı)

Aracı kimin kullanabileceğini kısıtlayın. Varsayılan olarak kapalıdır.

config.lua

Config.Permission = {
    Enabled = false,
    Type    = 'ace',                     -- 'ace' / 'job'
    Ace     = 'animpos.use',             -- Type == 'ace' olduğunda kullanılır
    Jobs    = { 'police', 'ambulance' }, -- Type == 'job' olduğunda kullanılır
}

ace — ox_lib geri çağrısı (callback) aracılığıyla IsPlayerAceAllowed üzerinden sunucu tarafında kontrol edilir (en güvenli yöntem). add_ace ... animpos.use allow ile yetki verin.
job — oyuncunun framework meslek adı Jobs listesinde olmalıdır (QBox / QB-Core / ESX).

Kısıtlamalar

Oyuncu belirli durumlardayken kullanımı engeller. Native kontroller tüm framework'lerde çalışır; meta veri kontrolleri yalnızca QBox ve QB-Core için geçerlidir.

config.lua

Config.Restrictions = {
    -- Framework tabanlı (yalnızca qbox / qbcore)
    CheckDead        = true,   -- ölü iken engelle
    CheckLastStand   = true,   -- son direnişte (last stand) iken engelle
    CheckHandcuffed  = true,   -- kelepçeliyken engelle

    -- Native tabanlı (standalone dahil TÜM framework'lerde çalışır)
    CheckInVehicle   = true,   -- araç içindeyken engelle
    CheckFalling     = true,   -- düşerken / paraşütle atarken engelle
    CheckSwimming    = false,  -- yüzerken engelle

    -- Oyuncu verilerinden okunan meta veri alan adları
    MetaKeys = {
        Dead       = 'isdead',
        LastStand  = 'inlaststand',
        Handcuffed = 'ishandcuffed',
    },
}

⚠

MetaKeys, framework'ünüzün oyuncu verilerindeki meta veri alan adlarıyla eşleşir. Altyapınız (veya özel bir paketiniz) bunları farklı anahtarlar altında saklıyorsa, ölü / son direniş / kelepçe kontrollerinin doğru değerleri okuması için bunları buradan değiştirin. {% endcode %}

Bildirimler

Her mesaj için kullanılan arka uç sistemini seçin.

config.lua

Config.Notify = 'ox_lib'  -- 'ox_lib' / 'qbcore' / 'esx' / 'custom'

-- Yalnızca Config.Notify == 'custom' olduğunda kullanılır.
-- ntype şunlardan biri olabilir: 'success' / 'error' / 'primary' / 'inform'
Config.CustomNotify = function(message, ntype)
    -- exports['my-notify']:SendAlert(message, ntype)
end

ox_lib — lib.notify (varsayılan).
qbcore — QBCore:Notify eventi.
esx — esx:showNotification eventi.
custom — Config.CustomNotify içindeki kendi işleyiciniz.

{% hint style="info" %} Geçersiz bir Config.Notify değeri sunucu konsolunda bir uyarı kaydeder ve güvenli bir şekilde ox_lib'e geri döner.

Arayüz (UI)

config.lua

Config.UI = {
    Position = 'right',       -- left / right / center
    OffsetX  = 30,            -- kenardan mesafe (px)
    OffsetY  = 0,             -- dikey uzaklık (px)
    AccentColor = '#f4cb98',  -- tuş vurguları / parıltı için vurgu rengi
    ShowHeader = true,        -- başlık/alt başlık bölümünü göster
    ShowTip    = true,        -- alt ipucu satırını göster
    ShowAnimations = true,    -- tuş basma animasyonları
    AnimationType = {
        Movement = 'pulse',   -- pulse / glow
        Action   = 'glow',    -- pulse / glow
    }
}

Hareket

config.lua

Config.Movement = {
    Speed         = 0.01,  -- hareket hızı
    RotationSpeed = 0.5,   -- dönme hızı
    MaxDistance   = 5.0,   -- başlangıç noktasından maksimum mesafe (m)
    MaxHeight     = 3.5,   -- başlangıç noktasından maksimum yükseklik (m)
    MinHeight     = -3.5,  -- başlangıç noktasından minimum yükseklik (m)
    PrecisionMultiplier = 0.25, -- Precision (Hassasiyet) tuşuna basılı tutarken hız çarpanı
}

Performans

config.lua

Config.Performance = {
    NetworkUpdateDelay = 50,   -- ağ senkronizasyon gecikmesi (ms)
    LoopWait           = 0,    -- ana döngü beklemesi (ms)
    AnimationDuration  = 300,  -- arayüz animasyon süresi (ms)
    SyncCooldown       = 50,   -- sunucu tarafı spam karşıtı senkronizasyon bekleme süresi (ms)
}

AnimationDuration, panel için geçiş süresi olarak arayüze iletilir. Senkronizasyonla ilgili değerler, konum güncellemelerinin ne sıklıkla gönderildiğini ve kabul edildiğini sınırlar.

Sesler

Açma / onaylama / iptal etme / sıfırlama için isteğe bağlı GTA V ön yüz (frontend) sesleri.

config.lua

Config.Sounds = {
    Enabled = true,
    Open    = { name = 'SELECT',        set = 'HUD_FRONTEND_DEFAULT_SOUNDSET' },
    Confirm = { name = 'SELECT',        set = 'HUD_FRONTEND_DEFAULT_SOUNDSET' },
    Cancel  = { name = 'CANCEL',        set = 'HUD_FRONTEND_DEFAULT_SOUNDSET' },
    Reset   = { name = 'RESET_PROMPTS', set = 'HUD_FRONTEND_DEFAULT_SOUNDSET' },
}

Tüm sesleri sessize almak için Enabled = false olarak ayarlayın.

CanUse Kancası (Hook)

Bir oyuncu aracı her açmaya çalıştığında çalışan özel bir kontrol. İzin vermek için true, engellemek için (isteğe bağlı bir mesaj dizesiyle birlikte) false döndürün.

Config.CanUse = function()
    -- Örnek: Hasar alırken engelle
    -- local ped = PlayerPedId()
    -- if HasEntityBeenDamagedByAnyPed(ped) then
    --     return false, '

PreviousUsage & Controls Next Integrations