Configuração

Tudo o que o dono de um servidor deve mexer fica em config.lua, e o arquivo é comentado seção por seção. Permissões, duração e limites são abordados em Permissions & Duration; o webhook tem sua própria página. Esta página cobre o resto.

Geral

config.lua

Config.Command      = 'status'
Config.Keybind      = ''             -- 'F6', 'F7', 'INSERT'… vazio desativa
Config.ClearCommand = 'statusclear'
Config.Debug        = false

Texto no mundo

O que outros jogadores veem flutuando no ped.

Opção	Padrão	Finalidade
`Config.Text.ViewDistance`	`6.0`	Nada é renderizado além desta distância, em metros.
`Config.Text.ScanInterval`	`800`	Com que frequência (ms) o client redescobre jogadores próximos carregando notas. Valores mais altos são mais leves e demoram mais para aparecer.
`Config.Text.Size`	`0.34`	Escala base; o script também se ajusta à distância da câmera.
`Config.Text.Font`	`4`	ID da fonte do GTA — 0 chalet, 1 sign, 2 slab, 4 chalet comprime, 7 pricedown.
`Config.Text.Outline`	`true`	Contorno escuro atrás do texto para que ele permaneça legível em qualquer superfície.
`Config.Text.MinScale` / `MaxScale`	`0.10` / `0.58`	Limite (clamp) para que o texto nunca fique ilegível ou comicamente grande.
`Config.Text.Alpha`	`225`	Opacidade do texto, 0–255.
`Config.Text.ColorBySeverity`	`true`	Tingir o texto com a cor de gravidade. `false` = sempre branco.
`Config.Text.White`	`255, 255, 255`	Cor usada quando a coloração por gravidade está desativada ou desconhecida.
`Config.Text.OnlyWhileAiming`	`false`	Renderizar apenas enquanto o observador estiver segurando a tecla de mira.

Câmera

O painel abre sobre uma interface transparente e a câmera do jogo faz o trabalho.

Opção	Padrão	Finalidade
`Config.Camera.AutoFrame`	`true`	Mede da cabeça aos pés do ped e enquadra automaticamente. Recomendado — funciona em qualquer modelo de ped.
`Config.Camera.Fill`	`0.88`	Quanto da altura da tela o corpo preenche quando `AutoFrame` está ativado.
`Config.Camera.VerticalNudge`	`0.0`	Ajuste fino em metros. Valores positivos movem o personagem para baixo na tela.
`Config.Camera.Distance`	`3.35`	Distância do ped — usado apenas quando `AutoFrame` é `false`.
`Config.Camera.Height`	`0.95`	Altura para a qual a câmera olha — usado apenas quando `AutoFrame` é `false`.
`Config.Camera.SideOffset`	`0.45`	Empurra o ped para a esquerda para que o painel nunca o cubra. `0` centraliza.
`Config.Camera.Fov`	`34.0`	Valores mais baixos parecem mais com uma lente de retrato com menos distorção.
`Config.Camera.ZoomMin` / `ZoomMax` / `ZoomStep`	`1.60` / `4.60` / `0.20`	Limites de zoom e o incremento por pressionamento de botão.
`Config.Camera.RotateSensitivity`	`0.6`	Graus que o ped gira por pixel de arrasto do mouse.
`Config.Camera.FreezePlayer`	`true`	Congelar o ped enquanto o painel estiver aberto.
`Config.Camera.HideRadar`	`true`	Ocultar o minimapa enquanto o painel estiver aberto.
`Config.Camera.HotspotRefresh`	`30`	Com que frequência (ms) as posições dos ossos são enviadas para a interface. Aumente para 50–60 em servidores muito movimentados.

ℹ

Quando AutoFrame está ativado, os limites de zoom são derivados do enquadramento medido em vez de ZoomMin / ZoomMax, para que os botões sempre façam sentido, independentemente do tamanho do ped.

Interface

config.lua

Config.UI = {
    Accent        = '#5b6cf0',  -- qualquer cor CSS
    Watermark     = true,       -- marca d'água "Status" desenhada à mão atrás do personagem
    ShowSeverity  = true,
    ShowTypes     = true,
    CloseOnEscape = true,
}

Tipos e gravidades

Ambos são listas simples. A interface se adapta ao que você colocar neles; os rótulos vêm dos arquivos de tradução.

config.lua

Config.Types = {
    { id = 'injury',  icon = 'activity' },  -- rótulo: type_injury
    { id = 'bandage', icon = 'plus'     },
    { id = 'note',    icon = 'message'  },
}

Config.Severities = {
    { id = 'minor',    color = { r = 143, g = 214, b = 171 } },
    { id = 'moderate', color = { r = 195, g = 201, b = 209 } },
    { id = 'severe',   color = { r = 255, g = 154, b = 157 } },
}

icon é um nome de ícone do lucide renderizado pela interface. Adicionar uma entrada requer uma linha correspondente type_<id> ou sev_<id> em cada arquivo de tradução.

Partes do corpo

Dezesseis regiões vêm por padrão, cada uma ancorada a um osso do ped do GTA.

config.lua

{ id = 'head', bone = 31086, offset = { x = 0.0, y = 0.0, z = 0.28 } },

Campo	Significado
`bone`	O índice do osso do ped ao qual a anotação está ancorada.
`offset`	Afasta o texto flutuante no mundo do osso para que ele não fique dentro do modelo. Aumente `z` se o texto atravessar a roupa. Isso não move o marcador clicável.
`marker`	Opcional. Move o marcador clicável apenas no painel. Deixe de fora e o marcador ficará exatamente no osso, o que é correto em quase todos os casos.

Remover uma entrada oculta essa região em todos os lugares. Adicionar uma requer um índice de osso válido e uma linha correspondente bp_<id> em cada arquivo de tradução.

Avançado

config.lua

Config.Table = 'bupa_syncstatus'  -- criado automaticamente na primeira inicialização

⚠

As tabelas de consulta na parte inferior de config.lua (Config.BodyPartMap, Config.TypeMap, Config.SeverityMap) são construídas a partir das listas acima na inicialização. Não as edite manualmente.

PreviousPermissions & Duration Next Discord Logging