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

البدء مع Agency Phone

Agency Phone is a premium phone script designed for FiveM roleplay servers running QBCore, ESX, or standalone frameworks. This guide walks you through the complete installation process, from downloading the resource to configuring it for your specific server setup. Whether you are an experienced developer or setting up your first server, these steps will get Agency Phone running smoothly.

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

قبل بدء التثبيت، تأكد من أن خادمك يفي بالمتطلبات التالية. تحتاج إلى خادم 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 حيث يمكن للفريق وأصحاب الخوادم الآخرين مساعدتك.