تثبيت CXG-GTFAT

ثبّت المورد بالاسم الدقيق CXG_GTFAT، وفعّل OneSync، وأضفه إلى ترتيب بدء تشغيل الخادم. لا يلزم إطار عمل إلا عند اختيار طريقة حفظ دائم تعتمد عليه.

المتطلبات

FiveM مع تفعيل OneSync.
اسم المجلد والمورد: CXG_GTFAT.
عدم تشغيل محدد CXG Fat/Luxe قديم أو حزمة بيانات وصفية بديلة أخرى تدير الملابس نفسها.

لا يحتاج الوضع الافتراضي إلى QB أو ESX أو مكتبة خارجية للواجهة أو اللغات. إذا أعددت الحفظ باستخدام qb أو esx، فثبّت إطار العمل المختار وشغّله. لوضع custom، نفّذ تحديد المعرّف؛ وسيظل تخزين KVP المضمّن يعمل. ويمكن استبداله بمزوّد تخزين خاص بك عند الحاجة.

خطوات التثبيت

انسخ مجلد المورد إلى موارد الخادم باسم CXG_GTFAT.
أزل موارد CXG Fat/Luxe القديمة ولا تشغّل محددين أو حزمتين بديلتين للملابس نفسها.
تأكد من تفعيل OneSync في إعدادات الخادم.
أضف ما يلي إلى server.cfg:
الكود
```
ensure `CXG_GTFAT`
```
شغّل الخادم أو أعد تشغيله. أعد تشغيل المورد عند تغيير ملفات الإعداد:
الكود
```
restart `CXG_GTFAT`
```
مع طريقة الوصول الافتراضية، امنح المجموعة أو principal المعني صلاحية ACE المسماة cxg_gtfat.use. مثال:
الكود
```
add_ace group.admin `cxg_gtfat.use` allow
```
لاستخدام مجموعة مخصصة، اربط معرّفات حقيقية بها:
الكود
```
add_ace group.fat_scale `cxg_gtfat.use` allow
add_principal identifier.license:TU_IDENTIFICADOR_REAL group.fat_scale
```
اتصل بشخصية freemode مخوّلة واستخدم /fatweight. اختبر قيمة أقل من العتبة، ثم قيمة تساويها أو تتجاوزها للتحقق من التحول بين Normal وFat.

استبدل TU_IDENTIFICADOR_REAL بمعرّف صالح من خادمك. لا ينشئ المورد الصلاحيات أو principals تلقائياً.

الاستخدام الأول

بالقيم الافتراضية، يفتح /fatweight الميزان لاختيار وزن بين 50 و180 كغ. عتبة Fat هي 100 كغ وتشمل هذه القيمة. يفتح /fatdecal ui الواجهة نفسها؛ ويستعلم /fatdecal status عن الحالة، بينما يغيّر الأمران on وoff الوزن لعبور العتبة. راجع الواجهة.

أغلق الميزان بمفتاح Esc أو زر X. لا يؤدي إغلاق النافذة إلى التراجع عن الوزن المطبق أو إيقاف Fat.

المشكلات الشائعة

العَرَض	ما يجب التحقق منه
لا يبدأ المورد	تحقق من الاسم الدقيق `CXG_GTFAT` وتفعيل `OneSync` وعدم وجود أخطاء Lua أثناء تحميل الإعداد.
تفيد الرسالة بأن الأمر غير مخوّل	مع صلاحية `ACE` الافتراضية، امنح `cxg_gtfat.use`. إذا اخترت jobs أو groups أو custom، فنفّذ السياسة في `bridge/server.lua`.
لا تظهر محطة	المحطات معطّلة افتراضياً. فعّل سجلاً في `Config.Stations` وأعدّ إعداداته أو استخدم `/fatweight`.
يُعاد ضبط الوزن بعد الاتصال مجدداً	هذا متوقع مع framework = 'none' الذي يحفظه للجلسة فقط. أعدّ الحفظ لكل شخصية إذا لزم الأمر.
لا تتغير الملابس	تحقق من استخدام الشخصية أحد نموذجي freemode، ومن أن الملابس مشمولة، ومن عدم وجود مورد آخر يدير decal نفسه في الوقت نفسه.
تحفظ القائمة decal تقنياً	طبّق تصحيح إصدار القائمة يدوياً أو ادمج `SanitizeAppearance` في موضع الحفظ.
تستمر التأثيرات بعد تعديل البيانات الوصفية أو إزالة المورد	أوقف المحددات المكررة، وأزل حزمة البيانات الوصفية البديلة التي لم تعد لازمة، ثم أعد تشغيل الخادم والعميل بالكامل لتحميل البيانات الحالية.