Todo lo que puedes ajustar está en shared/config.lua. Reinicia el recurso después de cualquier cambio.
General
| Opción | Tipo | Por defecto | Qué hace |
|---|---|---|---|
debug | boolean | false | Escribe trazas en la consola del servidor. También se activa poniendo la convar cuxial_pausemenu_debug a 1. |
Interfaz · ui
| Opción | Tipo | Por defecto | Qué hace |
|---|---|---|---|
accent | string (hex) | configurable | Color de acento de la interfaz. También colorea la etiqueta del trabajo mientras el jugador está de servicio. |
particles.color | string (hex) | '' | Color neutro de las partículas y del icono de presencia del mapa. Vacío = blanco. |
particles.accent | string (hex) | '' | Color de realce de las partículas y del icono de presencia del menú. Vacío = el acento. |
El logo de la cabecera es web/dist/img/logo.webp. Sustituye el archivo, con el mismo nombre, para poner el tuyo.
Servidor · server
| Opción | Tipo | Por defecto | Qué hace |
|---|---|---|---|
name | string | 'My Server' | Nombre del servidor que se muestra en la cabecera. Cámbialo por el tuyo. |
maxPlayers | number | 0 | Plazas que se muestran junto a los conectados. 0 = usa sv_maxclients. |
Teclas · keys
| Opción | Tipo | Por defecto | Qué hace |
|---|---|---|---|
menu | string | 'ESCAPE' | Tecla por defecto que abre el menú. |
map | string | 'P' | Tecla por defecto que abre el mapa de GTA directamente. '' quita esta tecla. |
Son solo valores por defecto. FiveM recuerda las teclas de cada jugador, y cada uno puede cambiarlas en los ajustes de teclas de GTA.
Accesos · tiles
Los botones grandes de la columna izquierda, en el orden en que aparecen en la lista.
| Campo | Tipo | Qué hace |
|---|---|---|
id | string | Acción del botón. 'resume' = volver al juego, 'nativeMap' = mapa de GTA, 'nativeSettings' = ajustes de GTA, 'quit' = desconectar o cerrar el juego. |
image | string | Imagen de fondo, un archivo dentro de web/dist/img/tiles/. Opcional. |
Quita una línea para ocultar ese botón. Los textos salen de los archivos de idioma: UI_TILE_<ID> y UI_TILE_<ID>_HINT.
tiles = {
{ id = 'resume', image = 'resume.webp' },
{ id = 'nativeMap', image = 'map.webp' },
{ id = 'quit', image = 'exit.webp' },
},Normas · rules
Una lista de textos, uno por norma, que se muestran en el orden escrito. Las que vienen son ejemplos: sustitúyelas por las tuyas. Con la lista vacía, el menú indica que el servidor no ha publicado normas.
rules = {
'Trata a los demás jugadores con respeto.',
'Prohibido usar cheats o software externo.',
},Comunidad · socials
Las redes que aparecen debajo de las normas, cada una con su icono, su nombre y su dirección. Las que vienen son ejemplos. Con la lista vacía, la sección se oculta.
| Campo | Tipo | Qué hace |
|---|---|---|
id | string | Elige el icono: discord, instagram, tiktok, youtube, twitter, x, telegram, web o website. Cualquier otro valor usa un icono genérico de enlace. |
label | string | Nombre de la red. |
handle | string | Dirección o nombre de usuario que sale debajo. Opcional. |
color | string (hex) | Color del icono. Opcional; si falta, el acento. |
socials = {
{ id = 'discord', label = 'Discord', handle = 'discord.gg/tuservidor', color = '#5865F2' },
{ id = 'web', label = 'Web', handle = 'tuservidor.com', color = '#ffffff' },
},Moneda extra · coins
| Opción | Tipo | Por defecto | Qué hace |
|---|---|---|---|
enabled | boolean | false | true muestra un tercer saldo junto al efectivo y el banco. false lo oculta; la ficha del personaje enseña entonces el tiempo jugado, si tu framework guarda un valor playtime para el jugador. |
account | string | 'coins' | Cuenta de dinero que se lee de tu framework. |
Pon enabled = true solo si tu framework tiene esa cuenta. Si la cuenta no existe, el saldo sale a 0.
Servicios de guardia · duty
| Opción | Tipo | Por defecto | Qué hace |
|---|---|---|---|
police | string | 'leo' | Trabajo que cuenta como policía de servicio. |
medical | string | 'ems' | Trabajo que cuenta como sanitario de servicio. |
En QBox y QBCore el valor se compara con el tipo de trabajo y con el nombre del trabajo, así que 'leo' cuenta todos los trabajos policiales.
En ESX solo se compara el nombre del trabajo. Usa los nombres de tus trabajos, por ejemplo police = 'police' y medical = 'ambulance'. La etiqueta de banda se muestra en QBox y QBCore.
Reloj · clock
| Opción | Tipo | Por defecto | Qué hace |
|---|---|---|---|
refreshMs | number | 20000 | Milisegundos entre refrescos de la hora, el clima y los contadores de servicio con el menú abierto. Mínimo 1000. |
Iconos de presencia · aura
Iconos que orbitan sobre la cabeza de un jugador que tiene abierto el menú, los ajustes o el mapa, para que los demás sepan que no está mirando el juego.
| Opción | Tipo | Por defecto | Qué hace |
|---|---|---|---|
enabled | boolean | true | true muestra los iconos. false apaga la función entera. |
distance | number | 22.0 | Metros a partir de los cuales los iconos no se dibujan. |
requireLos | boolean | true | true los dibuja solo con línea de visión despejada. false los dibuja a través de las paredes. |
showSelf | boolean | true | true muestra también tus propios iconos. En primera persona se ocultan. |
headOffset | number | 0.42 | Altura sobre la cabeza, en metros. |
clearOnDeath | boolean | true | true no muestra iconos mientras el jugador está muerto o abatido. false los mantiene. |
tick | number | 0 | Milisegundos entre actualizaciones de posición mientras hay iconos a la vista. 0 = cada fotograma. De 0 a 250. |
checkMs | number | 200 | Milisegundos entre comprobaciones de quién está cerca y a la vista. De 50 a 1000. |
rescanMs | number | 3000 | Milisegundos entre búsquedas de jugadores que llegan con el menú ya abierto. 0 desactiva la búsqueda; si no, mínimo 500. |
heartbeatMs | number | 20000 | Milisegundos entre las señales que mantienen vivo el estado de un jugador. Mínimo 2000. |
maxSeconds | number | 90 | Segundos tras los que el servidor borra un estado que dejó de enviar señales. Mínimo 5, y nunca menos del doble de heartbeatMs. |
healMs | number | 1000 | Milisegundos que espera el menú antes de cerrarse solo cuando pierde el foco sin haberse cerrado. Mínimo 250. |
rate.limit | number | 10 | Cambios de estado que se aceptan por jugador en cada ventana. |
rate.windowMs | number | 10000 | Duración de esa ventana, en milisegundos. |
Menú de GTA · native
Tiempos con los que se mantiene oculta la pantalla de pausa de GTA y se abren su mapa y sus ajustes. Los valores por defecto sirven para la mayoría de servidores.
| Opción | Tipo | Por defecto | Qué hace |
|---|---|---|---|
suppressFrames | number | 20 | Fotogramas que se bloquea la pantalla de pausa de GTA tras pulsar la tecla del menú. |
mapKeyBlockFrames | number | 6 | Fotogramas que se bloquea al soltar la tecla del mapa, antes de abrirlo. |
mapScreen | number | 0 | Pantalla del menú de GTA que abre el acceso al mapa. 0 = mapa. |
mapOpenDelayMs | number | 100 | Milisegundos de espera antes de entrar en el mapa. |
settingsOpenDelayMs | number | 500 | Milisegundos de espera tras abrir los ajustes. |
watchdogMs | number | 250 | Milisegundos entre comprobaciones de una pantalla de pausa de GTA abierta por otra vía (un mando, otro recurso). Si la encuentra, la cierra y abre este menú. 0 desactiva la comprobación. |
Colores de GTA · hudColours
Sustituye colores de la interfaz de GTA para que el mapa y los ajustes vayan a juego con el menú. Cada entrada es [índice] = { rojo, verde, azul, alfa }, con valores de 0 a 255; el alfa es opcional. El índice es el número de color HUD de GTA.
hudColours = {
[116] = { 255, 255, 255, 255 },
},Deja la tabla vacía para conservar los colores originales de GTA.
