समस्या निवारण

टूल नहीं खुल रहा है

खोलने पर एक पूर्ण जाँच पाइपलाइन चलती है। यदि कोई भी जाँच विफल हो जाती है, तो आपको कारण बताने वाली एक सूचना मिलती है। इनमें से समाधान ढूँढें:

• अनुमति (Permission) — यदि Config.Permission.Enabled = true है, तो पुष्टि करें कि खिलाड़ी पास हो जाता है। Type = 'ace' के लिए, सुनिश्चित करें कि ACE (animpos.use) को add_ace के साथ प्रदान किया गया है। Type = 'job' के लिए, सुनिश्चित करें कि खिलाड़ी का जॉब Config.Permission.Jobs में है।
• स्थिति प्रतिबंध (State restriction) — वाहन में होने, गिरने/पैराशूट से उतरने, तैरने (यदि सक्षम है), मृत होने, अंतिम स्थिति (last stand) में होने या हथकड़ी लगे होने पर आपको रोका जाता है। सूचना आपको बताती है कि कौन सी स्थिति है। यदि ब्लॉकिंग अवांछित है तो प्रासंगिक Config.Restrictions फ़्लैग को समायोजित करें।
• कोडाउन (Cooldown) — प्रत्येक उपयोग के बाद Config.Cooldown (डिफ़ॉल्ट 15 सेकंड) प्रतीक्षा होती है। "Too fast! Please wait a moment." का अर्थ है कि कोडाउन अभी भी सक्रिय है।
• CanUse हुक — false लौटाने वाला एक कस्टम Config.CanUse खुलना बंद कर देगा। वहाँ कस्टम लॉजिक की जाँच करें।

कोई सूचना (notifications) दिखाई नहीं देती है

यह लगभग हमेशा एक बैकएंड बेमेल (backend mismatch) है। Config.Notify को किसी ऐसे नोटिफिकेशन सिस्टम से मेल खाना चाहिए जो वास्तव में चल रहा है:

• ox_lib — ox_lib के शुरू होने की आवश्यकता है (यदि इसे ox_lib पर सेट किया गया है लेकिन ox_lib नहीं चल रहा है तो कंसोल चेतावनी देता है)।
• qbcore — QB-Core और इसके QBCore:Notify इवेंट की आवश्यकता है।
• esx — ESX और इसके esx:showNotification इवेंट की आवश्यकता है।
• custom — Config.CustomNotify में एक काम करने वाले हैंडलर की आवश्यकता है।

अमान्य मान ox_lib पर वापस आ जाता है और कंसोल चेतावनी लॉग करता है।

कीबाइंड (keybind) कुछ नहीं करता

• पुष्टि करें कि Config.Keybind.Enabled = true और Config.Keybind.Default खाली नहीं है — कीमैपिंग केवल तभी पंजीकृत होती है जब दोनों सेट हों।
• कीमैपिंग रिसोर्स शुरू होने पर पंजीकृत होती है; यदि आपने कॉन्फ़िगरेशन बदला है, तो रिसोर्स को रीस्टार्ट करें।
• जाँचें कि खिलाड़ी ने Settings → Key Bindings → FiveM के तहत कुंजी को रीबाउंड (या साफ़) तो नहीं किया है। कीबाइंड के बावजूद /animpos कमांड हमेशा काम करती है।

टेक्स्ट गलत भाषा / अंग्रेज़ी में है

• server.cfg में setr ox:locale "<code>" सेट करें (setr का उपयोग करें ताकि यह क्लाइंट्स पर दोहराया जा सके)।
• समर्थित कोड का उपयोग करें: en, tr, de, fr, es, pt, ru.
• एक गायब अनुवाद कुंजी अंग्रेज़ी पर वापस आ जाती है — सत्यापित करें कि आपकी लोकेल फ़ाइल में en.json के समान सटीक नाम वाली वह कुंजी है।

फ्रेमवर्क सुविधाएँ काम नहीं कर रही हैं / पहचानी नहीं गई हैं

• अपने सर्वर से ठीक से मेल खाने के लिए Config.Framework सेट करें (qbox, qbcore, esx या standalone). एक अमान्य मान कंसोल चेतावनी लॉग करता है।
• मृत / अंतिम स्थिति / हथकड़ी प्रतिबंध केवल qbox और qbcore पर काम करते हैं। esx और standalone पर वे मेटाडेटा जाँच डिज़ाइन द्वारा छोड़ दी जाती हैं — केवल वाहन / गिरना / तैरना लागू होता है।
• यदि QBox/QB-Core पर मेटाडेटा प्रतिबंध अभी भी ट्रिगर नहीं होते हैं, तो आपका फ्रेमवर्क उन फ़ील्ड को अलग-अलग कुंजियों के तहत संग्रहीत कर सकता है — Config.Restrictions.MetaKeys को समायोजित करें।

कैरेक्टर फंसा हुआ या पारदर्शी हो गया है

रिसोर्स बंद होने पर स्क्रिप्ट अल्फा को साफ़ करती है, पेड को अनफ्रीज करती है और रैगडॉल को पुनर्स्थापित करती है, इसलिए bupa-animpos को रीस्टार्ट करने से फंसी हुई स्थिति हल हो जाती है। यदि किसी इंटीग्रेशन ने पेड स्केलिंग को暂停 (pause) छोड़ा था, तो सफाई के दौरान रिज़्यूम एक्सपोर्ट भी कॉल किया जाता है।