التثبيت

يستخدم هذا الدليل حزمة التوزيع التي تتضمن واجهة مبنية مسبقًا. لا تحتاج إلى Node.js ولا إلى إعادة بناء الواجهة لتثبيتها.

المتطلبات

المكوّن	متى تحتاج إليه
`oxmysql` واتصال فعّال بقاعدة البيانات	مطلوب لحفظ بيانات المورد.
Qbox أو QBCore أو ESX	إذا كنت تستخدم اقتصادها وأذوناتها. يمكنك ربط اقتصاد آخر عبر عمليات استدعاء مستقلة.
حزم الوشم	اختيارية. يمكنك تثبيت أي عدد منها.
`ox_lib`	اختياري لإشعار TextUI؛ يتوفر بديل أصلي.
نظام المظهر	إذا كان خادمك يستخدمه، فراجع جسر المظهر.

تُشارك المخططات عبر رموز. لا تحتاج إلى إضافة عنصر إلى المخزون لاستخدام الإعداد المرفق.

ضع المورد

فك ضغط الحزمة في أحد مجلدات موارد خادمك.
نستخدم في هذه الأدلة cxg-tattoos اسمًا للمجلد. إذا كان اسم مجلدك مختلفًا، فاستخدم اسمه الفعلي في أوامر ensure وrestart.
احتفظ ببنية الملفات المرفقة. تحقق من وجود config.lua وshared/tattoos.json وbridge/ وui/dist/index.html مع ملفات الحزمة.
اضبط اتصال قاعدة البيانات وتأكد من أن oxmysql يعمل على نحو سليم.

ترتيب التشغيل

مثال باستخدام Qbox ومن دون حزم خارجية:

الكود

ensure oxmysql
ensure qbx_core
ensure cxg-tattoos

إذا كنت تستخدم QBCore أو ESX، فاستبدل qbx_core بـ qb-core أو es_extended. شغّل نظام المظهر قبل المورد إذا كنت تستخدمه. أما في وضع standalone، فاضبط أولًا عمليات استدعاء المدفوعات والأذونات.

إذا كانت لديك حزم، فشغّل الحزم المثبّتة فقط قبل المورد. على سبيل المثال:

الكود

ensure oxmysql
ensure qbx_core
ensure xgc_TattooClasic
ensure xgc_TattooGangs
ensure cxg-tattoos

لا تضف أسطر ensure لحزم لا تملكها. يمكن إبقاء المصادر الافتراضية في Config.TattooCatalog.sources؛ إذ يتم تخطي الحزم التي لم يبدأ تشغيلها.

التشغيل الأول

يجهّز المورد مساحة التخزين تلقائيًا. لا تحتاج إلى استيراد مخطط يدويًا عند التثبيت الجديد.

قبل التجربة، راجع الملف config.lua:

Config.Locale: اللغة العامة.
Config.Purchases: الاقتصاد وحسابات التحصيل.
Config.Permissions: صلاحيات الإدارة.
Config.Identity: نظام الهوية في الخادم والمعرّف المستخدم لحفظ بيانات اللاعب واستعادتها. راجع نظام الهوية.
Config.Shops: المواقع الأولية للمتاجر.

اقترب من متجر مضبوط واستخدم التفاعل الخاص به. تحقق من الكتالوج والمعاينة وإتمام عملية شراء بشخصية تجريبية. أعد تحميل الشخصية للتحقق من احتفاظها بالوشم.

يمكن ضبط الأمر الإداري المرفق في Config.AdminCommand؛ واسمه الافتراضي /tattooadmin. راجع الأذونات والمدفوعات قبل استخدامه.

تطبيق التغييرات

بعد تعديل config.lua أو أحد الجسور، احفظ الملف وأعد تشغيل المورد:

الكود

restart cxg-tattoos

تُقرأ مصادر الكتالوج مجددًا عند بدء التشغيل، ويمكن مزامنتها من لوحة الإدارة. تظل الإعدادات المحفوظة من اللوحة كما هي؛ لذا راجع الإعداد والكتالوج قبل توقع أن تستبدلها قيمة موجودة في الملف.

مشكلات شائعة

العَرَض	ما ينبغي التحقق منه
المورد لا يبدأ	تحقق من تشغيل `oxmysql`، وسلامة الاتصال، واكتمال الحزمة.
حزمة غير موجودة في المتجر	تحقق من تشغيل موردها، ومن أن `enabled` ليست `false`، ومن مطابقة مسار JSON لمسار الحزمة.
الواجهة فارغة	تحقق من نسخ `ui/dist/index.html` والملفات المشار إليها في `ui/dist/assets/` معًا.
اللوحة ترفض الوصول	تحقق من `Config.AdminCommand.permission` وربط الأذونات والأدوار أو إعداد ACE.
رُفض الدفع	تحقق من إطار العمل المختار، وأسماء الموارد، والرصيد، وعمليات الاستدعاء المستقلة عند انطباقها.
ظهور تفاعلين للوشم في المكان نفسه	تحقق مما إذا كان مورد آخر للمظهر أو المتاجر يفعّل الموقع نفسه أيضًا. أبقِ مدخلًا واحدًا للمتجر الذي تريد استخدامه.
لم يُطبّق تغيير المتجر أو المستوى	تحقق مما إذا كان هناك إعداد محفوظ بالفعل من اللوحة. عدّل القيمة الفعلية هناك.

يمكنك تفعيل Config.Debug وConfig.Permissions.debug مؤقتًا لتشخيص المشكلات. أوقفهما بعد الانتهاء.

تابع إلى الإعداد.