Skip to content

Configurare

Configurare

Totul este configurat în config.lua. Această pagină prezintă fiecare opțiune în parte.

General

config.lua
Config.Framework = 'qbox'    -- qbox / qbcore / esx / standalone
Config.Command   = 'animpos' -- denumirea comenzii din chat
Config.Cooldown  = 15        -- timpul de așteptare între utilizări (secunde)
  • Framework — selectează resursta de bază și ce restricții de metadate se aplică.
  • Command — comanda din chat care deschide unealta (folosită și ca denumire pentru asocierea tastelor).
  • Cooldown — numărul minim de secunde între utilizări.

Scurtătură tastă

Le permite jucătorilor să deschidă unealta cu o tastă, reasociabilă din setările GTA V.

config.lua
Config.Keybind = {
    Enabled = true,
    Default = 'F6',  -- tasta implicită (gol pentru Niciuna; jucătorul o poate reasocia)
}
ℹ

Asocierea tastei este înregistrată doar când Enabled = true și Default nu este gol. Jucătorii o pot reasocia oricând din Setări → Setări taste → FiveM.

Permisiuni (opțional)

Restricționează cine poate folosi unealta. Dezactivat implicit.

config.lua
Config.Permission = {
    Enabled = false,
    Type    = 'ace',                     -- 'ace' / 'job'
    Ace     = 'animpos.use',             -- folosit când Type == 'ace'
    Jobs    = { 'police', 'ambulance' }, -- folosit când Type == 'job'
}
  • ace — verificat pe partea de server prin IsPlayerAceAllowed printr-un callback ox_lib (cel mai sigur). Oferă acces cu add_ace ... animpos.use allow.
  • job — denumirea jobului de pe framework al jucătorului trebuie să fie în lista Jobs (QBox / QB-Core / ESX).

Restricții

Blochează utilizarea în timp ce jucătorul se află în anumite stări. Verificările native funcționează pe orice framework; verificările de metadate se aplică doar pentru QBox și QB-Core.

config.lua
Config.Restrictions = {
    -- Bazat pe framework (doar qbox / qbcore)
    CheckDead        = true,   -- blochează în timp ce ești mort
    CheckLastStand   = true,   -- blochează în timp ce ești în last stand
    CheckHandcuffed  = true,   -- blochează în timp ce ești cătușat

    -- Bazat pe funcții native (funcționează pe TOATE framework-urile, inclusiv standalone)
    CheckInVehicle   = true,   -- blochează în timp ce te afli într-un vehicul
    CheckFalling     = true,   -- blochează în timp ce cazi / te dai cu parașuta
    CheckSwimming    = false,  -- blochează în timp ce înoți

    -- Numele câmpurilor de metadate citite din datele jucătorului
    MetaKeys = {
        Dead       = 'isdead',
        LastStand  = 'inlaststand',
        Handcuffed = 'ishandcuffed',
    },
}
⚠

MetaKeys corespund numelelor câmpurilor de metadate din datele jucătorului de pe framework-ul tău. Dacă nucleul tău (sau un pachet personalizat) stochează aceste valori sub alte chei, modifică-le aici pentru ca verificările pentru mort / last stand / cătușat să citească valorile corecte.

Notificări

Alege sistemul utilizat pentru fiecare mesaj.

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

-- Folosit doar când Config.Notify == 'custom'.
-- ntype este unul dintre: 'success' / 'error' / 'primary' / 'inform'
Config.CustomNotify = function(message, ntype)
    -- exports['my-notify']:SendAlert(message, ntype)
end
  • ox_lib — lib.notify (implicit).
  • qbcore — evenimentul QBCore:Notify.
  • esx — evenimentul esx:showNotification.
  • custom — propriul tău handler în Config.CustomNotify.
ℹ

O valoare invalidă pentru Config.Notify va înregistra un avertisment în consola serverului și va reveni automat și în siguranță la ox_lib.

Interfață (UI)

config.lua
Config.UI = {
    Position = 'right',       -- stânga / dreapta / centru
    OffsetX  = 30,            -- distanța față de margine (px)
    OffsetY  = 0,             -- decalaj vertical (px)
    AccentColor = '#f4cb98',  -- culoarea de accent pentru evidențierea tastelor / strălucire
    ShowHeader = true,        -- afișează antetul cu titlu/subtitlu
    ShowTip    = true,        -- afișează rândul cu sfaturi din partea de jos
    ShowAnimations = true,    -- animații la apăsarea tastelor
    AnimationType = {
        Movement = 'pulse',   -- puls / strălucire
        Action   = 'glow',    -- puls / strălucire
    }
}

Mișcare

config.lua
Config.Movement = {
    Speed         = 0.01,  -- viteza de mișcare
    RotationSpeed = 0.5,   -- viteza de rotație
    MaxDistance   = 5.0,   -- distanța maximă față de punctului de pornire (m)
    MaxHeight     = 3.5,   -- înălțimea maximă deasupra punctului de pornire (m)
    MinHeight     = -3.5,  -- înălțimea minimă sub punctul de pornire (m)
    PrecisionMultiplier = 0.25, -- multiplicatorul de viteză în timp ce se ține apăsată tasta de precizie
}

Performanță

config.lua
Config.Performance = {
    NetworkUpdateDelay = 50,   -- întârzierea sincronizării rețelei (ms)
    LoopWait           = 0,    -- timpul de așteptare al buclei principale (ms)
    AnimationDuration  = 300,  -- durata animației UI (ms)
    SyncCooldown       = 50,   -- cooldown anti-spam pe partea de server pentru sincronizare (ms)
}

AnimationDuration este trimis către interfață ca durată de tranziție pentru panou. Valorile legate de sincronizare limitează frecvența cu care sunt trimise și acceptate actualizările de poziție.

Sunete

Sunete opționale GTA V pentru deschidere / confirmare / anulare / resetare.

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' },
}

Setază Enabled = false pentru a dezactiva toate sunetele.

Hook-ul CanUse

O verificare personalizată care rulează de fiecare dată când un jucător încearcă să deschidă unealta. Returnează true pentru

PreviousUsage & ControlsNext Integrations