Install CXG-GTFAT

Install the resource under the exact name CXG_GTFAT, enable OneSync, and add it to the server's startup order. A framework is only required if you choose a persistence option that depends on one.

Requirements

FiveM with OneSync enabled.
Folder and resource name: CXG_GTFAT.
No older CXG Fat/Luxe selector or other alternative metadata package managing the same clothing.

The default mode does not require QB, ESX, or an external interface or language library. If you configure qb or esx persistence, install and start the selected framework. For custom persistence, implement identity resolution; the built-in KVP storage continues to work. You can replace it with your own storage provider if needed.

Installation steps

Copy the resource folder into the server's resources as CXG_GTFAT.
Remove older CXG Fat/Luxe resources and do not start two selectors or alternative packages for the same clothing.
Check that OneSync is enabled in the server configuration.
Add this to server.cfg:
Code
```
ensure `CXG_GTFAT`
```
Start or restart the server. If you change configuration files, restart the resource:
Code
```
restart `CXG_GTFAT`
```
With the default access mode, grant the ACE permission cxg_gtfat.use to the relevant group or principal. For example:
Code
```
add_ace group.admin `cxg_gtfat.use` allow
```
To use a custom group, associate real identifiers:
Code
```
add_ace group.fat_scale `cxg_gtfat.use` allow
add_principal identifier.license:YOUR_REAL_IDENTIFIER group.fat_scale
```
Connect an authorized freemode player and use /fatweight. Try a value below the configured threshold and then one at or above it to check the Normal/Fat change.

Replace YOUR_REAL_IDENTIFIER with a valid identifier from your server. The resource does not create permissions or principals automatically.

First use

With the default values, /fatweight opens the scale to set a weight between 50 and 180 kg. The Fat threshold is 100 kg inclusive. /fatdecal ui opens the same interface; /fatdecal status checks the status, while on and off change the weight to cross the threshold. See Interface.

Close the scale with Esc or the X button. Closing the window does not revert the applied weight or turn off Fat.

Common issues

Symptom	What to check
The resource does not start	Check the exact `CXG_GTFAT` name, that `OneSync` is enabled, and for Lua errors while loading the configuration.
The command reports no access	With the default `ACE` access, grant `cxg_gtfat.use`. If you changed to jobs, groups, or custom, implement the policy in `bridge/server.lua`.
No station appears	Stations are disabled by default. Enable and configure an entry in `Config.Stations`; you can also use `/fatweight`.
Weight resets after reconnecting	This is expected with framework = 'none', which saves only for the session. Configure per-character persistence if needed.
Clothing does not change	Check that the character uses one of the two freemode models, that the clothing is covered, and that another resource is not managing the same decal at the same time.
A menu saves a technical decal	Manually apply the patch for that menu version or integrate `SanitizeAppearance` at its save point.
Effects remain after changing metadata or removing the resource	Stop duplicate selectors, remove the alternative metadata package that no longer applies, and fully restart the server and client to load the current metadata.