Configuration
Configuration
हर चीज़ config.lua में कॉन्फ़िगर की जाती है। यह पेज हर विकल्प के बारे में बताता है।
General
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.Keybind = {
Enabled = true,
Default = 'F6', -- default key (empty for none; player can rebind)
}कीमैपिंग तभी रजिस्टर्ड होती है जब Enabled = true और Default खाली न हो। खिलाड़ी इसे हमेशा Settings → Key Bindings → FiveM के तहत रीबाइंड कर सकते हैं।
Permission (optional)
प्रतिबंधित करें कि टूल का उपयोग कौन कर सकता है। डिफ़ॉल्ट रूप से बंद है।
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.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.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)
endox_lib—lib.notify(डिफ़ॉल्ट)।qbcore—QBCore:Notifyइवेंट।esx—esx:showNotificationइवेंट।custom—Config.CustomNotifyमें आपका अपना हैंडलर।
एक अमान्य Config.Notify मान सर्वर कंसोल में एक चेतावनी लॉग करता है और सुरक्षित रूप से ox_lib पर वापस आ जाता है।
UI
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.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.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.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.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
endControls
कंट्रोल की स्कैनकोड भी Config.Controls के तहत पूरी तरह से कॉन्फ़िगर करने योग्य हैं (आगे, पीछे, ऊपर, नीचे, बाएं, दाएं, घुमाएं, कन्फर्म, कैंसिल + दो विकल्प, रीसेट और प्रिसिजन)। डिफ़ॉल्ट लेआउट के लिए Usage & Controls पेज देखें।