Skip to content

Configuration

Configuration

हर चीज़ config.lua में कॉन्फ़िगर की जाती है। यह पेज हर विकल्प के बारे में बताता है।

General

config.lua
Config.Framework = 'qbox'    -- qbox / qbcore / esx / standalone
Config.Command   = 'animpos' -- chat command name
Config.Cooldown  = 15        -- cooldown between uses (seconds)
  • Framework — कोर रिसोर्स और कौन से मेटाडाटा प्रतिबंध (restrictions) लागू होते हैं, यह चुनता है।
  • Command — चैट कमांड जो टूल को खोलती है (कीमैपिंग नाम के रूप में भी उपयोग की जाती है)।
  • Cooldown — उपयोग के बीच न्यूनतम सेकंड।

Keybind

खिलाड़ियों को एक कुंजी (key) के साथ टूल खोलने की अनुमति देता है, जिसे GTA V सेटिंग्स में रीबाइंड किया जा सकता है।

config.lua
Config.Keybind = {
    Enabled = true,
    Default = 'F6',  -- default key (empty for none; player can rebind)
}

कीमैपिंग तभी रजिस्टर्ड होती है जब Enabled = true और Default खाली न हो। खिलाड़ी इसे हमेशा Settings → Key Bindings → FiveM के तहत रीबाइंड कर सकते हैं।

Permission (optional)

प्रतिबंधित करें कि टूल का उपयोग कौन कर सकता है। डिफ़ॉल्ट रूप से बंद है।

config.lua
Config.Permission = {
    Enabled = false,
    Type    = 'ace',                     -- 'ace' / 'job'
    Ace     = 'animpos.use',             -- used when Type == 'ace'
    Jobs    = { 'police', 'ambulance' }, -- used when Type == 'job'
}
  • ace — ox_lib कॉलबैक के माध्यम से IsPlayerAceAllowed द्वारा सर्वर-साइड चेक किया जाता है (सबसे सुरक्षित)। इसे add_ace ... animpos.use allow के साथ प्रदान करें।
  • job — खिलाड़ी का फ्रेमवर्क जॉब नाम Jobs सूची में होना चाहिए (QBox / QB-Core / ESX)।

Restrictions

खिलाड़ी के कुछ निश्चित अवस्थाओं (states) में होने पर उपयोग को ब्लॉक करें। नेटिव चेक हर फ्रेमवर्क पर काम करते हैं; मेटाडाटा चेक केवल QBox और QB-Core पर लागू होते हैं।

config.lua
Config.Restrictions = {
    -- Framework based (qbox / qbcore only)
    CheckDead        = true,   -- block while dead
    CheckLastStand   = true,   -- block while in last stand
    CheckHandcuffed  = true,   -- block while handcuffed

    -- Native based (works on ALL frameworks incl. standalone)
    CheckInVehicle   = true,   -- block while inside a vehicle
    CheckFalling     = true,   -- block while falling / parachuting
    CheckSwimming    = false,  -- block while swimming

    -- Metadata field names read from the player data
    MetaKeys = {
        Dead       = 'isdead',
        LastStand  = 'inlaststand',
        Handcuffed = 'ishandcuffed',
    },
}

MetaKeys आपके फ्रेमवर्क के प्लेयर डेटा पर मेटाडाटा फ़ील्ड नामों से मेल खाते हैं। यदि आपका कोर (या कोई कस्टम पैकेज) इन्हें अलग कुंजियों के तहत स्टोर करता है, तो उन्हें यहाँ बदलें ताकि मृत / अंतिम स्थिति / हथकड़ी वाले चेक सही मान पढ़ सकें।

Notifications

प्रत्येक संदेश के लिए उपयोग किए जाने वाले बैकएंड को चुनें।

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

-- Only used when Config.Notify == 'custom'.
-- ntype is one of: 'success' / 'error' / 'primary' / 'inform'
Config.CustomNotify = function(message, ntype)
    -- exports['my-notify']:SendAlert(message, ntype)
end
  • ox_liblib.notify (डिफ़ॉल्ट)।
  • qbcoreQBCore:Notify इवेंट।
  • esxesx:showNotification इवेंट।
  • customConfig.CustomNotify में आपका अपना हैंडलर।

एक अमान्य Config.Notify मान सर्वर कंसोल में एक चेतावनी लॉग करता है और सुरक्षित रूप से ox_lib पर वापस आ जाता है।

UI

config.lua
Config.UI = {
    Position = 'right',       -- left / right / center
    OffsetX  = 30,            -- distance from the edge (px)
    OffsetY  = 0,             -- vertical offset (px)
    AccentColor = '#f4cb98',  -- accent colour for key highlights / glow
    ShowHeader = true,        -- show the title/subtitle header
    ShowTip    = true,        -- show the bottom tip line
    ShowAnimations = true,    -- key press animations
    AnimationType = {
        Movement = 'pulse',   -- pulse / glow
        Action   = 'glow',    -- pulse / glow
    }
}

Movement

config.lua
Config.Movement = {
    Speed         = 0.01,  -- movement speed
    RotationSpeed = 0.5,   -- rotation speed
    MaxDistance   = 5.0,   -- max distance from start (m)
    MaxHeight     = 3.5,   -- max height above start (m)
    MinHeight     = -3.5,  -- min height below start (m)
    PrecisionMultiplier = 0.25, -- speed multiplier while holding Precision
}

Performance

config.lua
Config.Performance = {
    NetworkUpdateDelay = 50,   -- network sync delay (ms)
    LoopWait           = 0,    -- main loop wait (ms)
    AnimationDuration  = 300,  -- UI animation duration (ms)
    SyncCooldown       = 50,   -- server-side anti-spam sync cooldown (ms)
}

AnimationDuration को पैनल के लिए ट्रांज़िशन लंबाई के रूप में UI पर पास किया जाता है। सिंक से संबंधित मान यह नियंत्रित करते हैं कि स्थिति अपडेट कितनी बार भेजे और स्वीकार किए जाते हैं।

Sounds

ओपन / कन्फर्म / कैंसिल / रीसेट के लिए वैकल्पिक GTA V फ्रंटएंड ध्वनियाँ।

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

सभी ध्वनियों को म्यूट करने के लिए Enabled = false पर सेट करें।

CanUse hook

एक कस्टम चेक जो हर बार खिलाड़ी द्वारा टूल खोलने का प्रयास करने पर चलता है। अनुमति देने के लिए true लौटाएं, या ब्लॉक करने के लिए false (वैकल्पिक रूप से संदेश स्ट्रिंग के साथ)।

config.lua
Config.CanUse = function()
    -- Example: block while taking damage
    -- local ped = PlayerPedId()
    -- if HasEntityBeenDamagedByAnyPed(ped) then
    --     return false, 'You cannot do this while taking damage!'
    -- end
    return true
end

Controls

कंट्रोल की स्कैनकोड भी Config.Controls के तहत पूरी तरह से कॉन्फ़िगर करने योग्य हैं (आगे, पीछे, ऊपर, नीचे, बाएं, दाएं, घुमाएं, कन्फर्म, कैंसिल + दो विकल्प, रीसेट और प्रिसिजन)। डिफ़ॉल्ट लेआउट के लिए Usage & Controls पेज देखें।