> For the complete documentation index, see [llms.txt](https://docs.cuxial.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cuxial.com/scripts/es/interfaz/cuxial-pausemenu/configuration.md). # Configuración Todas las opciones de Cuxial Pause Menu explicadas: nombre del servidor, teclas, accesos, normas, redes e iconos de presencia. 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. | {% hint style="info" %} Son solo valores por defecto. FiveM recuerda las teclas de cada jugador, y cada uno puede cambiarlas en los ajustes de teclas de GTA. {% endhint %} ## 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_` y `UI_TILE__HINT`. {% code title="shared/config.lua" %} ```lua tiles = { { id = 'resume', image = 'resume.webp' }, { id = 'nativeMap', image = 'map.webp' }, { id = 'quit', image = 'exit.webp' }, }, ``` {% endcode %} ## 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. {% code title="shared/config.lua" %} ```lua rules = { 'Trata a los demás jugadores con respeto.', 'Prohibido usar cheats o software externo.', }, ``` {% endcode %} ## 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. | {% code title="shared/config.lua" %} ```lua socials = { { id = 'discord', label = 'Discord', handle = 'discord.gg/tuservidor', color = '#5865F2' }, { id = 'web', label = 'Web', handle = 'tuservidor.com', color = '#ffffff' }, }, ``` {% endcode %} ## 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. | {% hint style="info" %} Pon `enabled = true` solo si tu framework tiene esa cuenta. Si la cuenta no existe, el saldo sale a `0`. {% endhint %} ## 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. {% hint style="warning" %} 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. {% endhint %} ## 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. {% code title="shared/config.lua" %} ```lua hudColours = { [116] = { 255, 255, 255, 255 }, }, ``` {% endcode %} Deja la tabla vacía para conservar los colores originales de GTA. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.cuxial.com/scripts/es/interfaz/cuxial-pausemenu/configuration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.