# 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

1. Copie a pasta do recurso para os recursos do servidor com o nome `CXG_GTFAT`.
2. Remova recursos CXG Fat/Luxe antigos e não inicie dois seletores ou pacotes alternativos para as mesmas roupas.
3. Confira se o `OneSync` está ativado na configuração do servidor.
4. Adicione ao `server.cfg`:

   ~~~cfg
   ensure `CXG_GTFAT`
   ~~~

5. Inicie ou reinicie o servidor. Se alterar arquivos de configuração, reinicie o recurso:

   ~~~cfg
   restart `CXG_GTFAT`
   ~~~

6. Com o acesso padrão, conceda a permissão `ACE` `cxg_gtfat.use` ao grupo ou principal correspondente. Por exemplo:

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

   Para usar um grupo próprio, associe identificadores reais:

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

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

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