# تثبيت CXG-GTFAT

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

## المتطلبات

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

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

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

1. انسخ مجلد المورد إلى موارد الخادم باسم `CXG_GTFAT`.
2. أزل موارد CXG Fat/Luxe القديمة ولا تشغّل محددين أو حزمتين بديلتين للملابس نفسها.
3. تأكد من تفعيل `OneSync` في إعدادات الخادم.
4. أضف ما يلي إلى `server.cfg`:

   ```cfg
   ensure `CXG_GTFAT`
   ```

5. شغّل الخادم أو أعد تشغيله. أعد تشغيل المورد عند تغيير ملفات الإعداد:

   ```cfg
   restart `CXG_GTFAT`
   ```

6. مع طريقة الوصول الافتراضية، امنح المجموعة أو principal المعني صلاحية `ACE` المسماة `cxg_gtfat.use`. مثال:

   ```cfg
   add_ace group.admin `cxg_gtfat.use` allow
   ```

   لاستخدام مجموعة مخصصة، اربط معرّفات حقيقية بها:

   ```cfg
   add_ace group.fat_scale `cxg_gtfat.use` allow
   add_principal identifier.license:TU_IDENTIFICADOR_REAL group.fat_scale
   ```

7. اتصل بشخصية freemode مخوّلة واستخدم `/fatweight`. اختبر قيمة أقل من العتبة، ثم قيمة تساويها أو تتجاوزها للتحقق من التحول بين Normal وFat.

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

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

بالقيم الافتراضية، يفتح `/fatweight` الميزان لاختيار وزن بين 50 و180 كغ. عتبة Fat هي 100 كغ وتشمل هذه القيمة. يفتح `/fatdecal ui` الواجهة نفسها؛ ويستعلم `/fatdecal status` عن الحالة، بينما يغيّر الأمران on وoff الوزن لعبور العتبة. راجع [الواجهة](https://docs.cxgstudios.com/docs/ar/02-cxg-gtfat/06-interfaz.md).

أغلق الميزان بمفتاح 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` في موضع الحفظ. |
| تستمر التأثيرات بعد تعديل البيانات الوصفية أو إزالة المورد | أوقف المحددات المكررة، وأزل حزمة البيانات الوصفية البديلة التي لم تعد لازمة، ثم أعد تشغيل الخادم والعميل بالكامل لتحميل البيانات الحالية. |