Configuracao

Tudo esta em config.lua. As configuracoes voltadas ao jogador (graficos, mira) sao escolhidas por cada jogador no jogo e armazenadas no lado do cliente — as chaves abaixo sao apenas os padroes da primeira execucao e as opcoes de nivel admin.

config.lua e um script compartilhado — ele carrega tanto na VM Lua do servidor quanto na do cliente. As chaves que controlam o comportamento do cliente sao aplicadas no cliente; com o hz_lib, as substituicoes de admin sao enviadas ao cliente ao vivo.

14 chaves também estão no /hzpanel. Config.Locale, Config.LowPerformanceMode, Config.Brand, Config.ServerName, Config.DiscordURL, Config.ShopURL, Config.Accent e as chaves de Config.Hud, exceto Custom, também podem ser ajustadas no painel do hz_lib, seção Pause Menu. O config.lua vale enquanto nenhum valor for salvo no painel. Um valor salvo no painel vence o config.lua e se aplica ao vivo, e o botão de redefinir dele devolve a chave ao config.lua (com hz_lib 1.2.1 ou mais recente). Antes do HZ-PauseMenu 1.2.1, os padrões do painel venciam o config.lua para essas chaves mesmo sem nada salvo, então atualize tanto o hz_pausemenu quanto o hz_lib para a 1.2.1. Com o hz_lib, Config.Locale precisa ser en, fr ou es, os três idiomas que o painel oferece: qualquer outro valor volta para en.

Geral

Chave	Padrao	Descricao
`Config.Locale`	`'en'`	Idioma da UI. `en`, `fr`, `es` vem inclusos; adicione mais em `locales/`. Com o hz_lib, use `en`, `fr` ou `es`.
`Config.Debug`	`false`	Mostra no console os erros ao carregar os arquivos de idioma.
`Config.Framework`	`'auto'`	`auto` detecta es_extended → qbx_core → qb-core → ox_core → vRP → standalone. Force um nome apenas se dois cores rodarem lado a lado.
`Config.LowPerformanceMode`	`false`	Desativa transicoes/desfoque da UI para clientes muito fracos.
`Config.ClientWait`	`300000`	ms em que um cliente reutiliza uma busca de informacoes do servidor. A contagem de jogadores e sempre lida na hora.

Perfil

Chave	Padrao	Descricao
`Config.Mugshot.Enabled`	`true`	Mostra o rosto do jogador (pedheadshot da GPU → base64) em vez de uma inicial. Autocontido, em cache, regenerado apenas na mudanca de ped.
`Config.Mugshot.Transparent`	`true`	`true` = rosto recortado sobre o gradiente do circulo; `false` = fundo de estudio cortado no circulo.
`Config.Mugshot.PollSeconds`	`4`	Com que frequencia verificar uma mudanca de roupa/modelo.
`Config.DefaultNationality`	`'USA'`	Mostrado quando o framework nao carrega nenhuma (ESX base). Defina `""` para manter `--`.
`Config.LogoutCommand`	`'logout'`	Comando executado pelo cartao de personagem quando o servidor tem multichar. Deixe `""` sem multichar → o cartao abre a aba PROFILE em vez disso (sem botao morto).
`Config.CharacterImage`	`'images/character.webp'`	Imagem no cartao de personagem da aba GAME (em `web/public/`). `""` recorre ao logotipo VICE.

Marca e loja

Chave	Padrao	Descricao
`Config.Brand`	`"No\\|Trace"`	Texto do logo no topo, ao centro. A parte antes de `\\|` assume a cor do tema. `""` o oculta.
`Config.ServerName`	`""`	Texto ao lado do icone do Discord. Vazio = "Junte-se ao Discord" localizado.
`Config.DiscordURL`	`"https://discord.me/hzscript"`	Convite do Discord aberto pelo botão. Troque pelo seu.
`Config.ShopURL`	`""`	A aba SHOP abre esta URL no navegador do jogador (deve ser `http(s)://`). Vazio = a aba SHOP fica oculta.

Destaque e tema

Chave	Padrao	Descricao
`Config.Accent`	`"#FF6EC7"`	Tom de fallback do menu nativo de Configurações do GTA V, usado só enquanto nenhum tema do hz_lib foi recebido. O menu em si pega as cores do tema do hz_lib, e o tom nativo também, assim que o tema carrega.
`Config.NativeMenuAccent`	(tabela)	Tinge o menu nativo de Configuracoes do GTA V com o seu destaque. Veja Tema.

Configuracoes do jogador (padroes)

Chave	Padrao	Descricao
`Config.Graphics.Enabled`	`true`	`false` oculta todo o painel de FPS.
`Config.Graphics.Timecycles`	`{}`	Nomes de timecycle oferecidos no menu suspenso. Vazio de proposito — o GTA tem um unico slot de timecycle e os scripts de clima o controlam. So preencha em um servidor onde nada mais o controla.
`Config.CrosshairEnabled`	`true`	`false` oculta todo o painel de Mira.
`Config.KeybindsEnabled`	`true`	`false` oculta o subpainel de Atalhos.
`Config.KeybindLayout`	`'qwerty'`	`qwerty` ou `azerty` — as fileiras de letras fisicas no quadro.
`Config.Keybinds`	(lista)	Lista de atalhos standalone, `"KEY\\|LABEL\\|icon\\|DESC"`. Se o HZ-Loading estiver rodando, seus atalhos compartilhados sao usados em vez disso.

Veja Configuracoes do jogador para como isso e renderizado no jogo.

Integracao com HUD

Config.Hud oculta seu HUD enquanto o menu (ou o mapa/configuracoes nativos) esta aberto, depois o restaura. Funciona com qualquer resource de HUD. Referencia completa: Integracao com HUD.