Instalar GTFAT

Instala el recurso con el nombre exacto CXG_GTFAT, activa OneSync y añade su orden de inicio al servidor. El framework solo es necesario si seleccionas una opción de persistencia que dependa de él.

Requisitos

FiveM con OneSync habilitado.
Nombre de carpeta y nombre del recurso: CXG_GTFAT.
Ningún selector CXG Fat/Luxe anterior ni otro paquete de metadatos alternativo que gestione las mismas prendas.

El modo inicial no requiere QB, ESX ni una librería externa de interfaz o idiomas. Si configuras persistencia qb o esx, instala y arranca el framework elegido. Para custom, basta con implementar la resolución de identidad; el almacenamiento KVP integrado sigue funcionando. Puedes sustituirlo con un proveedor de almacenamiento propio si lo necesitas.

Pasos de instalación

Copia la carpeta del recurso como CXG_GTFAT dentro de los recursos del servidor.
Retira recursos anteriores de CXG Fat/Luxe y evita arrancar dos selectores o paquetes alternativos para las mismas prendas.
Comprueba que OneSync está activado en la configuración del servidor.
Añade al server.cfg:
Código
```
ensure `CXG_GTFAT`
```
Inicia o reinicia el servidor. Si cambias archivos de configuración, reinicia el recurso:
Código
```
restart `CXG_GTFAT`
```
Con el acceso predeterminado, concede el permiso ACE cxg_gtfat.use al grupo o principal correspondiente. Por ejemplo:
Código
```
add_ace group.admin `cxg_gtfat.use` allow
```
Para un grupo propio, puedes asociar identificadores reales:
Código
```
add_ace group.fat_scale `cxg_gtfat.use` allow
add_principal identifier.license:TU_IDENTIFICADOR_REAL group.fat_scale
```
Conecta un jugador freemode autorizado y usa /fatweight. Prueba un valor por debajo y luego en o por encima del umbral configurado para comprobar el cambio Normal/Fat.

Sustituye TU_IDENTIFICADOR_REAL por el identificador válido de tu servidor. El recurso no crea permisos ni principals automáticamente.

Primer uso

Con los valores iniciales, /fatweight abre la báscula para ajustar un peso entre 50 y 180 kg. El umbral Fat es 100 kg inclusive. /fatdecal ui abre la misma interfaz; /fatdecal status consulta el estado, mientras que on y off cambian el peso para cruzar el umbral. Consulta Interfaz.

La báscula se cierra con Esc o con el botón X. Cerrar la ventana no revierte el peso aplicado ni desactiva Fat.

Problemas frecuentes

Síntoma	Qué comprobar
El recurso no inicia	Verifica el nombre exacto `CXG_GTFAT`, que `OneSync` esté activo y que no haya errores Lua al cargar la configuración.
El comando dice que no hay acceso	Con el acceso inicial `ACE`, concede `cxg_gtfat.use`. Si cambiaste a jobs, groups o custom, implementa la política en `bridge/server.lua`.
No aparece una estación	Las estaciones vienen deshabilitadas. Habilita y configura al menos una entrada en `Config.Stations`; también puedes usar `/fatweight`.
El peso se restablece al reconectar	Es normal con framework = 'none', que guarda solo durante la sesión. Configura persistencia por personaje si la necesitas.
La ropa no cambia	Comprueba que el personaje sea uno de los dos modelos freemode, que la prenda esté cubierta y que otro recurso no gestione simultáneamente el mismo decal.
El menú guarda un decal técnico	Aplica manualmente el parche correspondiente a la versión del menú o integra `SanitizeAppearance` en su punto de guardado.
Cambiaste metadatos o retiraste el recurso y sigue habiendo efectos	Detén selectores duplicados, elimina el paquete de metadatos alternativo que ya no corresponda y reinicia por completo servidor y cliente para cargar los metadatos actuales.