Instalar o CXG-GTFAT

Instale o recurso com o nome exato CXG_GTFAT, ative o OneSync e adicione-o à ordem de inicialização do servidor. Um framework só é necessário se você escolher uma opção de persistência que dependa dele.

Requisitos

FiveM com OneSync ativado.
Nome da pasta e do recurso: CXG_GTFAT.
Nenhum seletor CXG Fat/Luxe antigo ou outro pacote alternativo de metadados gerenciando as mesmas roupas.

O modo padrão não exige QB, ESX nem bibliotecas externas de interface ou idioma. Se configurar persistência qb ou esx, instale e inicie o framework escolhido. Para persistência customizada, implemente a resolução de identidade; o armazenamento KVP integrado continua funcionando. Se necessário, você pode substituí-lo por seu próprio provedor de armazenamento.

Etapas de instalação

Copie a pasta do recurso para os recursos do servidor com o nome CXG_GTFAT.
Remova recursos CXG Fat/Luxe antigos e não inicie dois seletores ou pacotes alternativos para as mesmas roupas.
Confira se o OneSync está ativado na configuração do servidor.
Adicione ao server.cfg:
Código
```
ensure `CXG_GTFAT`
```
Inicie ou reinicie o servidor. Se alterar arquivos de configuração, reinicie o recurso:
Código
```
restart `CXG_GTFAT`
```
Com o acesso padrão, conceda a permissão ACE cxg_gtfat.use ao grupo ou principal correspondente. Por exemplo:
Código
```
add_ace group.admin `cxg_gtfat.use` allow
```
Para usar um grupo próprio, associe identificadores reais:
Código
```
add_ace group.fat_scale `cxg_gtfat.use` allow
add_principal identifier.license:SEU_IDENTIFICADOR_REAL group.fat_scale
```
Conecte um jogador freemode autorizado e use /fatweight. Teste um valor abaixo e depois um valor igual ou superior ao limite configurado para verificar a mudança Normal/Fat.

Substitua SEU_IDENTIFICADOR_REAL por um identificador válido do servidor. O recurso não cria permissões nem principais automaticamente.

Primeiro uso

Com os valores padrão, /fatweight abre a balança para definir um peso entre 50 e 180 kg. O limite Fat é 100 kg, inclusive. /fatdecal ui abre a mesma interface; /fatdecal status consulta o estado, enquanto on e off alteram o peso para cruzar o limite. Consulte Interface.

Feche a balança com Esc ou pelo botão X. Fechar a janela não desfaz o peso aplicado nem desativa Fat.

Problemas comuns

Sintoma	O que verificar
O recurso não inicia	Confira o nome exato `CXG_GTFAT`, se o `OneSync` está ativo e se há erros Lua ao carregar a configuração.
O comando informa que não há acesso	Com o acesso `ACE` padrão, conceda `cxg_gtfat.use`. Se mudou para jobs, groups ou custom, implemente a política em `bridge/server.lua`.
Nenhuma estação aparece	As estações vêm desativadas. Ative e configure uma entrada em `Config.Stations`; também é possível usar `/fatweight`.
O peso volta ao padrão ao reconectar	Isso é esperado com framework = 'none', que salva somente durante a sessão. Configure a persistência por personagem se precisar.
A roupa não muda	Confira se o personagem usa um dos dois modelos freemode, se a roupa é compatível e se outro recurso não está gerenciando o mesmo decal ao mesmo tempo.
Um menu salva um decal técnico	Aplique manualmente o patch da versão do menu ou integre `SanitizeAppearance` no ponto de salvamento.
Os efeitos continuam após alterar metadados ou remover o recurso	Pare seletores duplicados, remova o pacote alternativo de metadados que não se aplica mais e reinicie completamente o servidor e o cliente para carregar os metadados atuais.