# ติดตั้ง CXG-GTFAT

ติดตั้ง resource โดยใช้ชื่อที่ตรงกันทุกประการคือ `CXG_GTFAT` เปิดใช้ `OneSync` และเพิ่ม resource ในลำดับเริ่มต้นของเซิร์ฟเวอร์ ต้องใช้ framework เฉพาะเมื่อเลือกการบันทึกถาวรที่ต้องพึ่งพา framework นั้น

## ข้อกำหนด

- FiveM ที่เปิดใช้ `OneSync`
- ชื่อโฟลเดอร์และ resource: `CXG_GTFAT`
- ห้ามมี selector CXG Fat/Luxe รุ่นเก่าหรือ metadata package ทางเลือกอื่นจัดการเสื้อผ้าชุดเดียวกัน

โหมดเริ่มต้นไม่ต้องใช้ QB, ESX หรือไลบรารีภายนอกสำหรับหน้าจอหรือภาษา หากตั้งค่าการบันทึกแบบ qb หรือ esx ให้ติดตั้งและเริ่ม framework ที่เลือก สำหรับ custom ให้เขียนส่วนค้นหารหัสประจำตัวเอง ส่วนจัดเก็บ `KVP` ที่มีมาให้ยังทำงานได้ หรือเปลี่ยนไปใช้ผู้ให้บริการจัดเก็บข้อมูลของคุณเอง

## ขั้นตอนติดตั้ง

1. คัดลอกโฟลเดอร์ resource ไปยังโฟลเดอร์ resources ของเซิร์ฟเวอร์โดยใช้ชื่อ `CXG_GTFAT`
2. ลบ resource CXG Fat/Luxe รุ่นเก่า และอย่าเปิด selector หรือ package ทางเลือกสองชุดที่จัดการเสื้อผ้าเดียวกัน
3. ตรวจสอบว่าเปิดใช้ `OneSync` ในการตั้งค่าเซิร์ฟเวอร์แล้ว
4. เพิ่มข้อความนี้ใน `server.cfg`:

   ```cfg
   ensure `CXG_GTFAT`
   ```

5. เริ่มหรือรีสตาร์ตเซิร์ฟเวอร์ หากแก้ไฟล์ตั้งค่า ให้รีสตาร์ต resource:

   ```cfg
   restart `CXG_GTFAT`
   ```

6. เมื่อใช้การเข้าถึงแบบเริ่มต้น ให้สิทธิ์ `ACE` `cxg_gtfat.use` แก่กลุ่มหรือ principal ที่เกี่ยวข้อง ตัวอย่าง:

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

   หากใช้กลุ่มที่กำหนดเอง ให้ผูกกับ identifier จริง:

   ```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 ด้วย identifier ที่ถูกต้องจากเซิร์ฟเวอร์ของคุณ resource ไม่สร้างสิทธิ์หรือ principal ให้อัตโนมัติ

## เริ่มใช้งานครั้งแรก

ด้วยค่าเริ่มต้น `/fatweight` จะเปิดเครื่องชั่งให้ตั้งน้ำหนักระหว่าง 50 ถึง 180 กก. เกณฑ์ Fat คือ 100 กก. รวมค่านั้นด้วย `/fatdecal ui` เป็น alias สำหรับเปิดหน้าจอเดียวกัน ส่วน `/fatdecal status` ใช้ตรวจสถานะ ขณะที่ on และ off จะเปลี่ยนน้ำหนักเพื่อข้ามเกณฑ์ ดู [หน้าจอใช้งาน](https://docs.cxgstudios.com/docs/th/02-cxg-gtfat/06-interfaz.md)

ปิดเครื่องชั่งด้วย Esc หรือปุ่ม X การปิดหน้าต่างไม่ย้อนค่าน้ำหนักที่ใช้แล้วและไม่ปิด Fat

## ปัญหาที่พบบ่อย

| อาการ | สิ่งที่ควรตรวจสอบ |
| --- | --- |
| resource เริ่มทำงานไม่ได้ | ตรวจชื่อ `CXG_GTFAT` ให้ตรง เปิดใช้ `OneSync` และตรวจข้อผิดพลาด Lua ขณะโหลดการตั้งค่า |
| คำสั่งแจ้งว่าไม่มีสิทธิ์ | หากใช้ `ACE` เริ่มต้น ให้สิทธิ์ `cxg_gtfat.use` หากเปลี่ยนเป็น jobs, groups หรือ custom ให้เขียนนโยบายใน `bridge/server.lua` |
| ไม่เห็นสถานี | สถานีปิดไว้ตั้งแต่ต้น เปิดและตั้งค่ารายการใน `Config.Stations` หรือใช้ `/fatweight` |
| น้ำหนักกลับค่าเดิมหลังเชื่อมต่อใหม่ | เป็นพฤติกรรมปกติเมื่อ framework = 'none' ซึ่งบันทึกเฉพาะในเซสชัน หากต้องการให้คงอยู่ให้ตั้งค่าการบันทึกแยกตามตัวละคร |
| เสื้อผ้าไม่เปลี่ยน | ตรวจว่าตัวละครใช้โมเดล freemode หนึ่งในสองแบบ เสื้อผ้าอยู่ในรายการรองรับ และไม่มี resource อื่นจัดการ decal เดียวกันพร้อมกัน |
| เมนูบันทึก technical decal | ใช้ patch ที่ตรงกับเวอร์ชันเมนูด้วยตนเอง หรือเชื่อม `SanitizeAppearance` ที่จุดบันทึก |
| เอฟเฟกต์ยังอยู่หลังแก้ metadata หรือลบ resource | หยุด selector ที่ซ้ำ ลบ metadata package ทางเลือกที่ไม่ใช้งานแล้ว และรีสตาร์ตเซิร์ฟเวอร์กับไคลเอนต์ทั้งหมดเพื่อโหลด metadata ปัจจุบัน |