Agency Phone सेटअप गाइड: पूर्ण FiveM इंस्टॉलेशन और कॉन्फ़िगरेशन

यह गाइड आपको आपके FiveM सर्वर पर Agency Phone स्थापित करने और कॉन्फ़िगर करने की पूरी प्रक्रिया से परिचित कराता है। चाहे आप QBCore, ESX, या पूरी तरह से कस्टम फ्रेमवर्क चला रहे हों, आपको यहाँ सब कुछ मिलेगा, आवश्यकताओं से लेकर पहली बूट तक और कॉन्फ़िग को ठीक करने तक। पूर्ण तकनीकी संदर्भ के लिए, आधिकारिक दस्तावेज़ देखें docs.agencyg.de/phone.

पूर्वापेक्षाएँ

Agency Phone स्थापित करने से पहले, सुनिश्चित करें कि आपका सर्वर वातावरण निम्नलिखित आवश्यकताओं को पूरा करता है:

• FiveM सर्वर आर्टिफैक्ट: संस्करण 6633 या नया (अनुशंसित: हमेशा artifacts को अपडेट रखें)
• डेटाबेस: MySQL 5.7+ या MariaDB 10.3+, के साथ oxmysql (अनुशंसित) या mysql-async इंस्टॉल और कॉन्फ़िगर किया गया
• CFX Keymaster: आपके सर्वर की लाइसेंस कुंजी को पंजीकृत और सक्रिय होना चाहिए keymaster.fivem.net
• फ्रेमवर्क (वैकल्पिक): यदि आप गहरे फ्रेमवर्क एकीकरण चाहते हैं तो QBCore या ESX। standalone संचालन के लिए आवश्यक नहीं।
• सक्रिय Agency Phone खरीद: रिसोर्स खरीद के बाद CFX एसेट पोर्टल के माध्यम से वितरित किया जाता है

चरण 1: खरीदें और डाउनलोड करें

आपकी खरीदारी पूरी करने के बाद Agency Scripts shop", आपकी लाइसेंस अपने आप आपके CFX खाते में पंजीकृत हो जाती है। डाउनलोड करने के लिए:

1. में लॉग इन करें keymaster.fivem.net आपकी खरीद से जुड़े CFX खाते के साथ।
2. पर जाएं स्वीकृत संपत्तियां और खोजें agency-phone.
3. क्लिक करें डाउनलोड करें नवीनतम रिलीज़ ज़िप प्राप्त करने के लिए।
4. यदि आपने QBCore या ESX ब्रिज खरीदा है, तो साथ ही डाउनलोड करें agency-phone-bridge-qb या agency-phone-bridge-esx उसी सूची से।

चरण 2: फ़ोल्डर संरचना

ज़िप फ़ाइल(ओं) को निकालें। आपका resources directory should look like this after extraction:

resources/
  [agency]/
    agency-phone/
      client/
      server/
      html/
      config.lua
      fxmanifest.lua
    agency-phone-bridge-qb/   (QBCore only)
      client/
      server/
      fxmanifest.lua

यह [agency] फोल्डर एक श्रेणी फोल्डर है (स्क्वायर ब्रैकेट्स FiveM को बताते हैं कि यह एक रिसोर्स ग्रुप है)। यह सख्ती से आवश्यक नहीं है, आप रख सकते हैं agency-phone directly in resources/लेकिन श्रेणी फ़ोल्डर का उपयोग चीजों को व्यवस्थित रखता है।

चरण 3: डेटाबेस सेटअप

Agency Phone creates its own database tables on first launch using the auto-migration system built into oxmysql. You do not need to manually import any SQL files. Simply ensure your database connection is configured in server.cfg:

# server.cfg, database connection string (oxmysql example)
set mysql_connection_string "mysql://user:password@localhost/fivem_db?charset=utf8mb4"

पहली बार सर्वर शुरू होने पर, Agency Phone निम्नलिखित तालिकाएं बनाएगा: phone_contacts, phone_messages, phone_calls, phone_gallery, phone_social_posts, और phone_settings। यदि आप एक नई डेटाबेस का उपयोग कर रहे हैं, तो तालिकाएँ स्वचालित रूप से बनाई जाएंगी। यदि किसी अन्य फोन स्क्रिप्ट से माइग्रेट कर रहे हैं, तो सुनिश्चित करें कि आपके मौजूदा स्कीमा में कोई नाम संघर्ष न हो।

चरण 4: server.cfg प्रविष्टियाँ

अपने में निम्नलिखित सुनिश्चित लाइनों को जोड़ें server.cfg। आदेश महत्वपूर्ण है, oxmysql को Agency Phone से पहले लोड होना चाहिए:

# Dependencies
ensure oxmysql

# Agency Phone (standalone or with framework bridge)
ensure agency-phone

# Only add if using QBCore bridge:
# ensure qb-core
# ensure agency-phone-bridge-qb

# Only add if using ESX bridge:
# ensure es_extended
# ensure agency-phone-bridge-esx

यदि आप QBCore या ESX चला रहे हैं, तो सुनिश्चित करें कि फ्रेमवर्क स्वयं लोड हो रहा है पहले ब्रिज रिसोर्स, जैसा कि ऊपर टिप्पणियों में दिखाया गया है। standalone कोर (agency-phone) किसी भी ब्रिज संसाधन से पहले हमेशा सुनिश्चित किया जाना चाहिए।

चरण 5: कॉन्फ़िगरेशन (config.lua)

खुला agency-phone/config.lua एक टेक्स्ट एडिटर में। यह प्राथमिक कॉन्फ़िगरेशन फ़ाइल है और फोन के व्यवहार के लगभग हर पहलू को नियंत्रित करती है। यहाँ सबसे महत्वपूर्ण सेटिंग्स का विस्तृत मार्गदर्शन है:

Config = {}

-- ============================================================
-- FRAMEWORK
-- "standalone" | "qbcore" | "esx"
-- ============================================================
Config.Framework = "standalone"

-- ============================================================
-- PHONE NUMBERS
-- ============================================================
-- Format string for auto-generated numbers. X = random digit.
Config.PhoneNumberFormat = "555-XXXX"

-- Allow players to pay in-game currency to change their number
Config.AllowNumberChange = true
Config.NumberChangeCost   = 500  -- default currency (adjust per framework)

-- ============================================================
-- APPS: enable/disable individual apps
-- ============================================================
Config.EnableBankingApp   = true
Config.EnableSocialApp    = true
Config.EnableGPSApp       = true
Config.EnableCameraApp    = true
Config.EnableMDT          = false   -- set true only for LEO servers
Config.EnableNotesApp     = true

-- ============================================================
-- MDT (only relevant when Config.EnableMDT = true)
-- ============================================================
-- Jobs that can access the MDT app
Config.MDTJobs = { "police", "sheriff", "highway_patrol" }

-- ============================================================
-- SOCIAL MEDIA
-- ============================================================
-- Rename the social app to match your server's lore
Config.SocialAppName = "Chirper"
-- Max post length in characters
Config.SocialPostMaxLength = 280

-- ============================================================
-- ENCRYPTED MESSAGING
-- Requires players to hold a specific inventory item
-- ============================================================
Config.EncryptedChat     = false
Config.EncryptedChatItem = "burner_phone"

-- ============================================================
-- UI
-- ============================================================
-- Default theme: "dark" or "light"
Config.DefaultTheme = "dark"
-- Notification display duration in milliseconds
Config.NotificationDuration = 5000
-- Phone open keybind (FiveM key name)
Config.PhoneKey = "F1"

QBCore-विशिष्ट नोट्स

जब आप QBCore ब्रिज का उपयोग करते हैं (Config.Framework = "qbcore" ), बैंकिंग ऐप स्वचालित रूप से QBCore अर्थव्यवस्था से बैलेंस और लेन-देन डेटा खींचता है। नौकरी-आधारित ऐप अनुमतियाँ (जैसे MDT एक्सेस) QBCore के मूल नौकरी सिस्टम का उपयोग करती हैं, अतिरिक्त कॉन्फ़िगरेशन की आवश्यकता नहीं है सिवाय इसके कि नौकरी के नाम जोड़ें Config.MDTJobs। फोन नंबर प्रति-कैरेक्टर संग्रहीत होते हैं और QBCore कैरेक्टर पहचानकर्ता से जुड़े होते हैं।

ESX-विशिष्ट नोट्स

With the ESX bridge (Config.Framework = "esx" ), बैंकिंग ऐप ESX खातों से जुड़ता है (डिफ़ॉल्ट: bank ). यदि आपका ESX सेटअप कस्टम खाता नामों का उपयोग करता है, तो उन्हें ब्रिज की अपनी config.lua. MDT एक्सेस के लिए ESX जॉब रैंक का सम्मान किया जाता है, केवल जॉब नामों को सूचीबद्ध करना आवश्यक है; उस जॉब के सभी ग्रेड स्वचालित रूप से एक्सेस प्राप्त करते हैं जब तक कि आप ब्रिज कॉन्फ़िग में ग्रेड प्रतिबंध सेट न करें।

चरण 6: पहली बूट सत्यापन

अपना सर्वर शुरू करें और कंसोल आउटपुट देखें। एक सफल Agency Phone लोड इस तरह दिखता है:

[agency-phone] Database tables verified/created, OK
[agency-phone] Framework: standalone
[agency-phone] Loaded 0 contacts, 0 messages (fresh install)
[agency-phone] Resource started successfully, v2.x.x

यदि इस चरण में आपको त्रुटियाँ दिखती हैं, तो नीचे दिए गए ट्रबलशूटिंग सेक्शन को देखें। एक बार सर्वर चलने लगे, क्लाइंट से कनेक्ट करें और दबाएँ F1 (या आपके कॉन्फ़िगर किए गए फोन की को दबाकर फोन खोलें। पहली बार उपयोग पर, फोन खिलाड़ी से उनका नंबर सेट करने के लिए कहेगा यदि अभी तक कोई नंबर असाइन नहीं किया गया है।

सामान्य त्रुटियाँ और समाधान

Error: "oxmysql is not started"

इसका मतलब है कि oxmysql को आपके server.cfg। स्थानांतरित करें ensure oxmysql ऊपर की लाइन ensure agency-phone और सर्वर पुनः प्रारंभ करें।

Error: "Failed to create table phone_contacts: Table already exists"

यह एक चेतावनी है, घातक त्रुटि नहीं, इसका मतलब है कि आप मौजूदा डेटाबेस पर पुनःस्थापना कर रहे हैं। मौजूदा डेटा सुरक्षित रहता है। आप इस चेतावनी को सुरक्षित रूप से नजरअंदाज कर सकते हैं। यदि आप एक साफ इंस्टॉल चाहते हैं, तो मैन्युअल रूप से phone_* अपने डेटाबेस में पहले तालिकाएं।

फोन UI की दबाने पर खुलती नहीं है

पहले, जांचें कि संसाधन सर्वर कंसोल में बिना त्रुटियों के शुरू हुआ है। दूसरे, सत्यापित करें कि कोई अन्य संसाधन समान कीबाइंड (डिफ़ॉल्ट: F1) का उपयोग नहीं कर रहा है। आप कीबाइंड को में बदल सकते हैं config.lua के तहत Config.PhoneKeyतीसरा, NUI फोकस संघर्षों की जांच करें, यदि कोई अन्य संसाधन एक ही समय में NUI फोकस कैप्चर कर रहा है, तो फोन सही तरीके से कीप्रेस प्राप्त नहीं कर सकता।

बैंकिंग ऐप $0 / खाली बैलेंस दिखाता है

यदि आप standalone मोड चला रहे हैं, तो बैंकिंग ऐप डिफ़ॉल्ट रूप से एक आंतरिक वॉलेट का उपयोग करता है। इसे QBCore या ESX अर्थव्यवस्था से कनेक्ट करने के लिए, आपको संबंधित ब्रिज संसाधन का उपयोग करना होगा और सेट करना होगा Config.Framework सही ढंग से। यदि ब्रिज सुनिश्चित है लेकिन बैलेंस अभी भी शून्य दिखाता है, तो जांचें कि खिलाड़ी का चरित्र फ्रेमवर्क में पूरी तरह लोड हो चुका है फोन प्रारंभ होने से पहले (server.cfg में फ्रेमवर्क लोड क्रम)।

पुलिस अधिकारियों के लिए MDT ऐप दिखाई नहीं दे रहा है

पुष्टि करें कि Config.EnableMDT = true config.lua में और खिलाड़ी की वर्तमान नौकरी का नाम ठीक उसी तरह मेल खाना चाहिए जैसा कि entries में है Config.MDTJobs। नौकरी नाम मिलान केस-संवेदनशील होता है। अपने फ्रेमवर्क के नौकरी कॉन्फ़िग में परिभाषित सटीक नौकरी नाम स्ट्रिंग का उपयोग करें।

अतिरिक्त कॉन्फ़िगरेशन विकल्प

Agency Phone has many more configuration options beyond what is covered in this guide. Some of the most useful advanced settings include:

• Config.MaxContactsPerPlayerखिलाड़ी द्वारा संग्रहीत संपर्कों की संख्या सीमित करें (डिफ़ॉल्ट: असीमित)
• Config.GPSUpdateInterval , खिलाड़ी के स्थान ब्लिप को साझा GPS पर कितनी बार अपडेट किया जाता है (मिलीसेकंड में)
• Config.SocialPostCooldownस्पैम रोकने के लिए सोशल मीडिया पोस्ट्स के बीच न्यूनतम समय (सेकंड)
• Config.AllowAnonCalls , क्या खिलाड़ी कॉल कर सकते हैं जो प्राप्तकर्ता से उनका नंबर छुपाते हैं
• Config.CameraPhotoQuality , NUI स्क्रीनशॉट गुणवत्ता स्तर (1-10, इन-गेम गैलरी छवि आकार को प्रभावित करता है)

सभी विकल्पों के साथ पूर्ण एनोटेटेड कॉन्फ़िग फ़ाइल आधिकारिक दस्तावेज़ में उपलब्ध है। docs.agencyg.de/phone. दस्तावेज़ हर रिलीज़ के साथ अपडेट होते हैं और सेटिंग्स बदलने पर संस्करण-विशिष्ट माइग्रेशन नोट्स शामिल करते हैं।

Agency Phone को अपडेट रखना

जब नया संस्करण जारी होता है, तो आपको अपने CFX keymaster खाते में एक सूचना प्राप्त होगी। अपडेट करने के लिए, Granted Assets पेज से नया ज़िप डाउनलोड करें, इसे निकालें, और मौजूदा को बदलें agency-phone फोल्डर आपके सर्वर पर। लाइव सर्वर पर अपडेट करने से पहले हमेशा अपडेट चेंजलॉग पढ़ें, यह config.lua कुंजियों में किसी भी बदलाव को सूचीबद्ध करता है जिन पर आपका ध्यान आवश्यक है। आपका डेटाबेस और मौजूदा खिलाड़ी डेटा कभी भी अपडेट द्वारा हटाया नहीं जाता।