كيفية تثبيت Agency Phone على خادم FiveM

البدء مع Agency Phone

Agency Phone هو سكربت هاتف مدفوع مصمم لخوادم تقمص الأدوار في FiveM التي تستخدم QBCore أو ESX أو أطر عمل مستقلة. يرشدك هذا الدليل خلال عملية التثبيت كاملة، بدءًا من تنزيل المورد وصولًا إلى إعداده بما يناسب تكوين خادمك. سواء كنت مطورًا متمرسًا أو تجهز خادمك الأول، ستساعدك هذه الخطوات على تشغيل Agency Phone بسلاسة.

المتطلبات المسبقة

قبل بدء التثبيت، تأكد من أن خادمك يفي بالمتطلبات التالية. تحتاج إلى خادم FiveM يعمل مع QBCore أو ESX أو إطار عمل مخصص. يجب أن يكون خادمك يعمل بأحدث إصدارات FiveM الموصى بها، وتحتاج إلى الوصول إلى ملفات الخادم عبر FTP أو إدارة الملفات المباشرة. بالإضافة إلى ذلك، تأكد من أن لديك ترخيصًا صالحًا من متجر Agency Scripts Tebex.

الخطوة 1: تحميل واستخراج

بعد شراء Agency Phone من متجر Tebex، قم بتنزيل ملفات الموارد من حساب Keymaster الخاص بك. فك ضغط الأرشيف وضع agency-phone المجلد إلى دليل موارد الخادم الخاص بك. يجب أن تبدو بنية المجلد كما يلي resources/[phone]/agency-phone/ على الرغم من أنه يمكنك وضعه في أي مجلد فرعي تفضله.

الخطوة 2: تكوين الإطار الخاص بك

افتح ال config.lua الملف داخل مجلد agency-phone. اضبط إطار عملك بتغيير Config.Framework القيمة إلى إما "qbcore", "esx"، أو "standalone". Agency Phone يكتشف تلقائياً معظم إعدادات الإطار، لكن قد ترغب بتخصيص أنماط الإشعارات، التطبيقات الافتراضية، وصيغ أرقام الهاتف لتتناسب مع موضوع سيرفرك.

الخطوة 3: إعداد قاعدة البيانات والتشغيل

استورد ملف SQL المقدم إلى قاعدة بياناتك لإنشاء الجداول اللازمة لجهات الاتصال، الرسائل، وسجلات المكالمات. ثم أضف ensure agency-phone إلى server.cfg الملف. أعد تشغيل خادمك واختبر الهاتف بالضغط على المفتاح المكون (الافتراضي هو F1 ). يجب أن يفتح الهاتف مع حركة سلسة ويعرض شاشة البداية مع جميع التطبيقات الافتراضية جاهزة للاستخدام.

استكشاف المشكلات الشائعة وإصلاحها

إذا لم يفتح الهاتف، تحقق من أن المورد قيد التشغيل بفحص وحدة تحكم الخادم لأي رسائل خطأ. المشكلة الأكثر شيوعًا هي اعتماد مفقود أو تكوين إطار عمل غير صحيح. تحقق من أن أسماء تصدير الإطار الخاص بك تطابق ما يتوقعه Agency Phone. إذا واجهت أخطاء قاعدة بيانات، تأكد من اكتمال استيراد SQL بدون مشاكل وأن مستخدم قاعدة البيانات لديه الأذونات المناسبة. للمساعدة الإضافية، انضم إلى مجتمع Agency Scripts على Discord حيث يمكن للفريق وأصحاب الخوادم الآخرين مساعدتك.