Configuración

Configuration

Todo lo que el propietario de un servidor debe modificar se encuentra en config.lua, y el archivo está comentado sección por sección. Los permisos, la duración y los límites se explican en Permissions & Duration; el webhook tiene su propia página. Esta página cubre el resto.

General

config.lua

Config.Command      = 'status'
Config.Keybind      = ''             -- 'F6', 'F7', 'INSERT'… vacío lo desactiva
Config.ClearCommand = 'statusclear'
Config.Debug        = false

Texto en el mundo

Lo que otros jugadores ven flotando sobre el ped.

Opción	Por defecto	Propósito
`Config.Text.ViewDistance`	`6.0`	No se dibuja nada más allá de esta distancia, en metros.
`Config.Text.ScanInterval`	`800`	Con qué frecuencia (ms) el cliente vuelve a escanear en busca de jugadores cercanos que lleven notas. Un valor más alto consume menos recursos pero tarda más en aparecer.
`Config.Text.Size`	`0.34`	Escala base; el script también se adapta a la distancia de la cámara.
`Config.Text.Font`	`4`	ID de fuente de GTA — 0 chalet, 1 sign, 2 slab, 4 chalet comprime, 7 pricedown.
`Config.Text.Outline`	`true`	Contorno oscuro detrás del texto para que sea legible en cualquier superficie.
`Config.Text.MinScale` / `MaxScale`	`0.10` / `0.58`	Límite para que el texto nunca sea ilegible o cómicosamente grande.
`Config.Text.Alpha`	`225`	Opacidad del texto, 0–255.
`Config.Text.ColorBySeverity`	`true`	Colorea el texto con el color de gravedad. `false` = siempre blanco.
`Config.Text.White`	`255, 255, 255`	Color utilizado cuando el coloreado por gravedad está desactivado o es desconocido.
`Config.Text.OnlyWhileAiming`	`false`	Solo se dibuja mientras el observador mantiene presionada la tecla de apuntar.

Cámara

El panel se abre sobre una interfaz transparente y la cámara del juego hace el trabajo.

Opción	Por defecto	Propósito
`Config.Camera.AutoFrame`	`true`	Mide desde la cabeza hasta los pies del ped y lo encuadra automáticamente. Recomendado: funciona en cualquier modelo de ped.
`Config.Camera.Fill`	`0.88`	Qué parte de la altura de la pantalla ocupa el cuerpo cuando `AutoFrame` está activado.
`Config.Camera.VerticalNudge`	`0.0`	Ajuste fino en metros. Un valor positivo mueve al personaje hacia abajo en la pantalla.
`Config.Camera.Distance`	`3.35`	Distancia desde el ped — solo se usa cuando `AutoFrame` es `false`.
`Config.Camera.Height`	`0.95`	Altura a la que mira la cámara — solo se usa cuando `AutoFrame` es `false`.
`Config.Camera.SideOffset`	`0.45`	Empuja al ped hacia la izquierda para que el panel nunca lo cubra. `0` lo centra.
`Config.Camera.Fov`	`34.0`	Un valor más bajo simula una lente de retrato con menos distorsión.
`Config.Camera.ZoomMin` / `ZoomMax` / `ZoomStep`	`1.60` / `4.60` / `0.20`	Límites de zoom y el incremento por cada pulsación de botón.
`Config.Camera.RotateSensitivity`	`0.6`	Grados que gira el ped por cada píxel de arrastre del ratón.
`Config.Camera.FreezePlayer`	`true`	Congela al ped mientras el panel está abierto.
`Config.Camera.HideRadar`	`true`	Oculta el minimapa mientras el panel está abierto.
`Config.Camera.HotspotRefresh`	`30`	Con qué frecuencia (ms) se envían las posiciones de los huesos a la interfaz. Auméntalo a 50–60 en servidores con mucho tráfico.

ℹ

Cuando AutoFrame está activado, los límites de zoom se derivan del encuadre medido en lugar de ZoomMin / ZoomMax, por lo que los botones siempre realizan una acción lógica sin importar el tamaño del ped.

Interfaz

config.lua

Config.UI = {
    Accent        = '#5b6cf0',  -- cualquier color CSS
    Watermark     = true,       -- marca de agua "Status" dibujada a mano detrás del personaje
    ShowSeverity  = true,
    ShowTypes     = true,
    CloseOnEscape = true,
}

Tipos y gravedades

Ambos son listas simples. La interfaz se adapta a lo que pongas en ellas; las etiquetas provienen de los archivos de localización.

config.lua

Config.Types = {
    { id = 'injury',  icon = 'activity' },  -- etiqueta: 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 es el nombre de un icono de lucide renderizado por la interfaz. Añadir una entrada requiere una línea correspondiente type_<id> o sev_<id> en cada archivo de localización.

Partes del cuerpo

Dieciséis regiones vienen configuradas por defecto, cada una anclada a un hueso de un ped de GTA.

config.lua

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

Campo	Significado
`bone`	El índice del hueso del ped al que está anclada la anotación.
`offset`	Separa el texto flotante en el mundo del hueso para que no quede dentro del modelo. Aumenta `z` si el texto se cruza con la ropa. No mueve el marcador en el que se puede hacer clic.
`marker`	Opcional. Mueve únicamente el marcador interactivo dentro del panel. Si lo dejas vacío, el marcador se sitúa exactamente sobre el hueso, lo cual es correcto en casi todos los casos.

Eliminar una entrada oculta esa región en todas partes. Añadir una requiere un índice de hueso válido y una línea correspondiente bp_<id> en cada archivo de localización.

Avanzado

config.lua

Config.Table = 'bupa_syncstatus'  -- se crea automáticamente en el primer inicio

⚠

Las tablas de búsqueda al final de config.lua (Config.BodyPartMap, Config.TypeMap, Config.SeverityMap) se generan a partir de las listas anteriores al iniciar. No las edites manualmente.

PreviousPermissions & Duration Next Discord Logging