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.
Geral
| Chave | Padrao | Descricao |
|---|
Config.Locale | 'en' | Idioma da UI. en, fr, es vem inclusos; adicione mais em locales/. |
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 | false | 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.ServerName | "" | Texto ao lado do icone do Discord. Vazio = "Junte-se ao Discord" localizado. |
Config.DiscordURL | "…" | Convite do Discord aberto pelo botao. |
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" | Um destaque, injetado como uma variavel CSS. Substituido ao vivo pela cascata de tema do hz_lib quando presente. |
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.
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.
