# 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

1. Copia la carpeta del recurso como `CXG_GTFAT` dentro de los recursos del servidor.
2. Retira recursos anteriores de CXG Fat/Luxe y evita arrancar dos selectores o paquetes alternativos para las mismas prendas.
3. Comprueba que `OneSync` está activado en la configuración del servidor.
4. Añade al `server.cfg`:

   ```cfg
   ensure `CXG_GTFAT`
   ```

5. Inicia o reinicia el servidor. Si cambias archivos de configuración, reinicia el recurso:

   ```cfg
   restart `CXG_GTFAT`
   ```

6. Con el acceso predeterminado, concede el permiso `ACE` `cxg_gtfat.use` al grupo o principal correspondiente. Por ejemplo:

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

   Para un grupo propio, puedes asociar identificadores reales:

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

7. 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](https://docs.cxgstudios.com/docs/es/02-cxg-gtfat/06-interfaz.md).

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. |