# Pause Menu: documentación

> Un reemplazo completo del menú ESC que los jugadores pueden organizar y tematizar por sí mismos.

- URL: https://xexstudio.com/es/docs/pause-menu
- Versión: 2.1.2
- Ficha del producto: https://xexstudio.com/es/scripts/pause-menu
## Descripción general

XeX Pause Menu reemplaza el menú ESC nativo por un panel configurable para ESX, QBCore y Qbox. Los dueños del servidor eligen los valores por defecto; cada jugador puede reorganizar las tarjetas y elegir un tema que se guarda en su perfil.

### Frameworks compatibles

| Framework | Versión | Estado |
|-----------|---------|--------|
| ESX Legacy | 1.6.0+ | ✅ Compatibilidad completa |
| QBCore | Última | ✅ Compatibilidad completa |
| QBox | Última | ✅ Compatibilidad completa |

---

## Resumen de funciones

### Funciones principales

| Categoría | Función | Descripción |
|----------|---------|-------------|
| **UI** | Transparencia ajustable | Los jugadores eligen la opacidad de las tarjetas y del fondo |
| **UI** | 10 temas base + 12 preajustes de color | Temas: Dark, Light, Glass, Midnight, Emerald, Sunset, Rose, Ocean, Gold, Neon |
| **UI** | Adaptable | Compatible con resoluciones de 1080p a 4K |
| **Personalizador** | Arrastrar y soltar | Recoloca las tarjetas libremente |
| **Personalizador** | Selectores de color | Personalización completa de colores |
| **Personalizador** | Escala de la UI | Escalado del 70 % al 130 % |
| **Personalizador** | Preajustes | Guardar/cargar/exportar/importar preajustes personalizados |
| **Personalizador** | Por jugador | Ajustes guardados por jugador |
| **Información** | Estadísticas del jugador | Vida, armadura, hambre, sed, estrés |
| **Información** | Información del vehículo | Modelo, matrícula, combustible, velocidad, motor |
| **Información** | Ubicación | Calle, zona, rumbo, coordenadas (admin) |
| **Información** | Clima | Icono y nombre del clima (en la tarjeta de fecha y hora) |
| **Información** | Hora | Hora real + hora del juego |
| **Información** | Servidor | Jugadores conectados, recuento de trabajos |
| **Información** | Dinero | Efectivo, banco, cripto, dinero sucio |
| **Social** | Enlaces personalizados | Web, Discord, normas, guías |
| **Social** | Redes sociales | Twitter, Instagram, YouTube, TikTok, Twitch |
| **Reportes** | Categorías | Error, jugador, soporte, sugerencia |
| **Reportes** | Webhook de Discord | Integración automática con Discord |
| **Reportes** | Notificaciones a admins | Alertas en el juego para los admins |
| **Framework** | Multiframework | ESX, QBCore, QBox con detección automática |
| **I18n** | 12 idiomas | EN, ES, PT, FR, DE, IT, PL, NL, TR, ZH, RU, AR |
| **Rendimiento** | Optimizado | 0.00ms cuando está cerrado |
| **Actualizador** | Comprobación automática de actualizaciones | Avisa de nuevas versiones |

---

## Instalación

### Requisitos

- Build de servidor FiveM 5181+
- OneSync activado
- Framework: ESX Legacy, QBCore o QBox
- Opcional: ox_lib (para notificaciones mejoradas)

### Inicio rápido

```bash
1. Extract to your resources folder
2. Rename folder to 'xex_pausemenu' if needed
3. Add to server.cfg:
   ensure xex_pausemenu
4. Configure config.lua
5. Configure svconfig.lua (webhooks, tracked jobs)
6. Restart server
```

### Orden de recursos recomendado

```cfg
# server.cfg
ensure oxmysql
ensure ox_lib          # Optional but recommended
ensure es_extended     # or qb-core / qbox
ensure xex_pausemenu
```

---

## Configuración

### Ajustes del framework

```lua
-- config.lua
Config.Framework = 'auto' -- 'auto' | 'esx' | 'qb' | 'qbox'
Config.AutoDetectOrder = {'qbox', 'qb', 'esx'}
```

| Valor | Comportamiento |
|-------|----------|
| `'auto'` | Detecta el framework automáticamente (recomendado) |
| `'esx'` | Fuerza ESX Legacy |
| `'qb'` | Fuerza QBCore |
| `'qbox'` | Fuerza QBox |

### Ajustes del atajo de teclado

```lua
Config.Keybind = 'ESC'         -- 'ESC' | 'F1'-'F10' | 'NONE'
Config.OpenCommand = 'pausemenu' -- Command to open (nil to disable)
```

| Atajo de teclado | Comportamiento |
|---------|----------|
| `'ESC'` | Reemplaza por completo el menú de pausa nativo |
| `'F1'`-`'F3'`, `'F5'`-`'F10'` | Se abre con la tecla F; ESC sigue abriendo el nativo |
| `'NONE'` | Solo funciona el comando |

### Información del servidor

```lua
Config.ServerName = 'Your Server Name'
Config.ServerLogo = 'img/logo.svg' -- Path relative to web/ folder, or nil
Config.ServerSlogan = 'The best roleplay experience'
```

### Opciones de visualización

#### Información del jugador
```lua
Config.ShowPlayerInfo = {
    name = true,         -- Character name
    id = true,           -- Server ID
    job = true,          -- Current job + grade
    gang = true,         -- Gang (QB/QBox only)
    phoneNumber = true,  -- Phone number (auto-detected)
    money = true,        -- Cash, Bank, Crypto, Dirty Money
    playTime = true,     -- Session time
}
```

**Detección automática del número de teléfono:**
- qs-smartphone
- lb-phone
- npwd
- gcphone
- gksphone
- roadphone
- high-phone
- yflip-phone
- d-phone
- renewed-phone
- charinfo.phone de QB/QBox (alternativa)

> **Nota:** `high-phone`, `yflip-phone` y `d-phone` se detectan como recursos de teléfono en ejecución, pero sus exports para obtener el número de teléfono aún no están implementados: el número de teléfono puede aparecer como no disponible con estos recursos.

#### Información del servidor
```lua
Config.ShowServerInfo = {
    onlinePlayers = true,  -- Current/Max players
    maxPlayers = true,
    policeCount = true,    -- Jobs are configured in svconfig.lua
    emsCount = true,
    mechanicCount = true,
}
```

#### Estadísticas del jugador
```lua
Config.ShowPlayerStats = {
    enabled = true,
    health = true,
    armor = true,
    hunger = true,    -- Requires esx_status (ESX) or built-in (QB)
    thirst = true,
    stress = true,    -- QB/QBox only
}
```

#### Información del vehículo
```lua
Config.ShowVehicleInfo = {
    enabled = true,
    model = true,
    plate = true,
    fuel = true,      -- Auto-detects fuel resource
    speed = true,
    engine = true,
}
```

**Detección automática del recurso de combustible:**
- ox_fuel
- LegacyFuel
- ps-fuel
- cdn-fuel
- okokGasStation
- lj-fuel
- Nativo como alternativa

#### Ubicación
```lua
Config.ShowLocation = {
    enabled = true,
    streetName = true,
    zoneName = true,
    heading = true,        -- N, NE, E, SE, S, SW, W, NW
    coords = false,        -- X, Y, Z (always visible for admins)
}
```

#### Fecha/hora
```lua
Config.ShowDateTime = {
    enabled = true,
    realTime = true,
    inGameTime = true,
    weather = true,
}
```

### Botones del menú

```lua
Config.Buttons = {
    map = true,       -- Opens GTA map
    settings = true,  -- Opens customizer
    report = true,    -- Opens report modal
}
```

### Enlaces sociales

```lua
Config.SocialLinks = {
    enabled = true,
    
    -- Main action buttons
    mainLinks = {
        {
            id = 'website',
            label = 'WEBSITE',
            icon = 'globe',       -- FontAwesome icon name
            url = 'https://your-server.com',
            enabled = true,
            color = '#3B82F6'
        },
        {
            id = 'discord',
            label = 'DISCORD',
            icon = 'discord',
            url = 'https://discord.gg/your-server',
            enabled = true,
            color = '#5865F2'
        },
        {
            id = 'rules',
            label = 'RULES',
            icon = 'scroll',
            url = 'https://your-server.com/rules',
            enabled = true,
            color = '#EF4444'
        },
        {
            id = 'guides',
            label = 'GUIDES',
            icon = 'book-open',
            url = 'https://your-server.com/guides',
            enabled = true,
            color = '#10B981'
        },
    },
    
    -- Social media icons (bottom row)
    socialMedia = {
        {id = 'twitter', icon = 'twitter', url = 'https://twitter.com/...', enabled = true, color = '#FFFFFF'},
        {id = 'instagram', icon = 'instagram', url = 'https://instagram.com/...', enabled = true, color = '#E4405F'},
        {id = 'youtube', icon = 'youtube', url = 'https://youtube.com/...', enabled = true, color = '#FF0000'},
        {id = 'tiktok', icon = 'tiktok', url = 'https://tiktok.com/...', enabled = false, color = '#FFFFFF'},
        {id = 'twitch', icon = 'twitch', url = 'https://twitch.tv/...', enabled = false, color = '#9146FF'},
    }
}
```

**Iconos disponibles:**
- Principales: `globe`, `discord`, `scroll`, `book-open`, `link`, `gamepad`, `headset`, `store`
- Sociales: `twitter`, `instagram`, `youtube`, `tiktok`, `twitch`, `facebook`

### Sistema de reportes

```lua
Config.ReportSystem = {
    enabled = true,
    categories = {
        {id = 'bug', label = '🐛 Bug Report', color = '#F59E0B'},
        {id = 'player', label = '👤 Player Report', color = '#EF4444'},
        {id = 'support', label = '❓ Support Request', color = '#3B82F6'},
        {id = 'suggestion', label = '💡 Suggestion', color = '#10B981'},
    },
    minMessageLength = 20,    -- Minimum characters
    maxSubjectLength = 100,   -- Maximum subject length (checked on the server)
    maxMessageLength = 1000,  -- Maximum message length (checked on the server)
    cooldown = 60,            -- Seconds between reports
    notifyAdmins = true,      -- In-game notification to admins
    sendToDiscord = true,     -- Send to webhook
}
```

### Opciones de desconexión

```lua
Config.Disconnect = {
    showConfirmation = true,
    leaveMessage = 'Thanks for playing! See you soon! 👋',
    options = {
        disconnect = true,      -- Disconnect from server
        quitGame = true,        -- Close FiveM
        characterSelect = true, -- Return to character selection
    }
}
```

### Personalización de la UI

```lua
Config.UI = {
    accentColor = '#C5F24A',  -- Brand color: accent of the Default preset
    buttonImages = {          -- Faint background of these buttons: path relative to web/, URL, or false
        map = 'img/buttons/map.webp',
        settings = false,
        report = false,
    },
    sounds = {
        enabled = true,
        open = true,
        close = true,
        hover = true,
        click = true,
    },
    hideRadar = true,         -- Hide minimap when open
    showOverlay = true,       -- Dark overlay behind menu
    overlayOpacity = 0.7,     -- 0.0 - 1.0
    enableCustomizer = true,  -- Allow player customization
}
```

### Opciones del personalizador

Controla qué pueden personalizar los jugadores:

```lua
Config.CustomizerOptions = {
    -- Enable/disable entire tabs
    tabs = {
        theme = true,    -- Theme, background, animations
        colors = true,   -- Color customization
        layout = true,   -- Drag & drop, visibility
        cards = true,    -- Card styles
        presets = true,  -- Save/load presets
    },
    
    -- Theme tab
    theme = {
        baseTheme = true,         -- Theme selection
        backgroundOpacity = true, -- Overlay opacity
        backgroundImage = true,   -- Custom background
        cardOpacity = true,       -- Card transparency
        animations = true,        -- Enable/disable
        displayMode = true,       -- Fullscreen/Boxed
        uiScale = true,           -- Scale slider
    },
    
    -- Colors tab
    colors = {
        mainColors = true,        -- Primary, Secondary, Accent
        backgroundColors = true,  -- Background colors
        textColors = true,        -- Text colors
        statusBarColors = true,   -- HP, Armor, etc.
        jobColors = true,         -- Police, EMS, Mechanic
    },
    
    -- Layout tab
    layout = {
        editMode = true,          -- Drag & drop
        cardVisibility = true,    -- Show/hide cards
        columnLayout = true,      -- Column count
        resetPositions = true,    -- Reset button
    },
    
    -- Cards tab
    cards = {
        cardStyle = true,         -- Glass, Solid, Minimal, Neon
        borderRadius = true,      -- Corner rounding
        cardSpacing = true,       -- Gap between cards
    },
    
    -- Presets tab
    presets = {
        themePresets = true,      -- Built-in presets
        savePreset = true,        -- Save custom
        importExport = true,      -- Import/Export JSON
    },
}
```

### Funciones de admin

```lua
Config.Admin = {
    showAdminBadge = true,       -- Badge next to admin names
    showCoordsForAdmins = true,  -- Coordinates visible
}
```

Quién cuenta como admin se configura en `svconfig.lua` (consulta Detección de admins).

### Opciones de rendimiento

```lua
Config.Performance = {
    updateInterval = 1000,         -- Update frequency (ms)
    cachePlayerData = true,        -- Enable caching
    cacheDuration = 5000,          -- Cache duration (ms)
}
```

---

## Configuración del servidor

### svconfig.lua

Las notificaciones usan ox_lib automáticamente cuando está en ejecución; si no, las notificaciones propias del framework.

#### Webhooks de Discord

```lua
ConfigSv.ReportWebhook = 'https://discord.com/api/webhooks/...'

ConfigSv.WebhookColors = {
    bug = 16753920,        -- Orange
    player = 15548997,     -- Red
    support = 3447003,     -- Blue
    suggestion = 5763719,  -- Green
}

ConfigSv.WebhookName = 'XeX Reports'
ConfigSv.WebhookAvatar = nil -- URL to avatar
```

#### Detección de admins

```lua
-- ESX groups
ConfigSv.ESXAdminGroups = {'admin', 'superadmin', 'mod', 'owner', 'god'}

-- QB/QBox permissions
ConfigSv.QBPermissions = {'admin', 'god', 'mod'}

-- Custom check (optional)
ConfigSv.CustomAdminCheck = function(source)
    return IsPlayerAceAllowed(source, 'command.admin')
end
```

#### Seguimiento de trabajos

```lua
ConfigSv.TrackedJobs = {
    {
        id = 'police',
        label = 'Police',
        icon = 'fas fa-shield',
        color = '#3B82F6',
        jobs = {'police', 'sheriff', 'fbi', 'lspd', 'bcso'}
    },
    {
        id = 'ems',
        label = 'EMS',
        icon = 'fas fa-truck-medical',
        color = '#EF4444',
        jobs = {'ambulance', 'ems', 'doctor', 'hospital'}
    },
    {
        id = 'mechanic',
        label = 'Mechanics',
        icon = 'fas fa-wrench',
        color = '#F59E0B',
        jobs = {'mechanic', 'bennys', 'lscustoms'}
    },
    -- Add unlimited jobs!
}

ConfigSv.OnlyCountOnDuty = true -- QB/QBox, and ESX Legacy 1.10+ (job.onDuty)
```

#### Número de teléfono

Se detecta automáticamente con lb-phone, npwd, qs-smartphone, gksphone, roadphone, renewed-phone y gcphone, con `charinfo.phone` como alternativa en QB/QBox. Para cualquier otro teléfono:

```lua
ConfigSv.GetPhoneNumber = function(source)
    return exports['my-phone']:GetNumber(source)
end
```

#### Límites

```lua
ConfigSv.MaxRequestsPerMinute = 30 -- Menu data requests per player (0 = no limit)
ConfigSv.MaxLayoutSize = 32768     -- Max bytes of a saved player layout
```

El tiempo de espera entre reportes es `Config.ReportSystem.cooldown` en `config.lua`.

#### Registro

```lua
ConfigSv.LogToConsole = false -- Set to true for debugging
```

#### Actualizaciones

```lua
ConfigSv.CheckForUpdates = true -- Checks xexstudio.com on start
```

---

## Localización

### Idiomas compatibles

| Código | Idioma | Código | Idioma |
|------|----------|------|----------|
| `en` | English | `it` | Italiano |
| `es` | Español | `pl` | Polski |
| `pt` | Português | `nl` | Nederlands |
| `fr` | Français | `tr` | Türkçe |
| `de` | Deutsch | `zh` | 中文 |
| `ru` | Русский | `ar` | العربية |

### Establecer el idioma

```lua
Config.Locale = 'en' -- Change to your language code
```

### Añadir idiomas personalizados

```lua
Config.Locales['custom'] = {
    pause_menu = 'CUSTOM MENU',
    close = 'Close',
    back = 'Back',
    -- ... all keys (see existing locales for reference)
}
```

---

## Personalizador visual

### Preajustes de tema

| Tema | Estilo |
|-------|-------|
| Dark | Fondos oscuros, acentos sutiles |
| Light | Fondos claros, texto oscuro |
| Glass | Transparencia máxima |
| Midnight | Tonos azul profundo |
| Emerald | Verde de aire natural |
| Sunset | Tonos cálidos naranja/rojo |
| Rose | Estilo romántico en rosa |
| Ocean | Azul de aire acuático |
| Gold | Tonos dorados de lujo |
| Neon | Cyberpunk vibrante |

### Preajustes de color

Un clic aplica una paleta completa (acento, fondos, texto, barras de estado y colores de trabajos):

| Preajuste | Acento |
|--------|--------|
| Default | Tu `Config.UI.accentColor` (lima por defecto) sobre grafito |
| Midnight | Azul suave sobre azul marino |
| Forest | Verde sobre verde profundo |
| Ember | Naranja sobre marrón cálido |
| Amethyst | Violeta sobre púrpura profundo |
| Sunset | Coral y rosa sobre ciruela |
| Arctic | Azul hielo sobre verde azulado oscuro |
| Rosé | Rosa sobre baya oscura |
| Mono | Blanco sobre negro, sin acento de color |
| Synthwave | Magenta y cian sobre púrpura |
| Cyberpunk | Amarillo y cian, tarjetas neón |
| Light | Índigo sobre blanco |

### Estilos de tarjeta

| Estilo | Descripción |
|-------|-------------|
| Glass | Fondo de tarjeta con un borde fino (por defecto) |
| Solid | Fondo opaco |
| Minimal | Diseño plano y sutil |
| Neon | Bordes brillantes |

### Opciones de diseño

| Diseño | Descripción |
|--------|-------------|
| 3 columnas | Por defecto, tarjetas en 3 columnas |
| 2 columnas | Tarjetas en 2 columnas más anchas |
| Centrado | Una sola columna, centrada |

### Modos de visualización

| Modo | Descripción |
|------|-------------|
| Pantalla completa | El menú cubre toda la pantalla |
| Encuadrado | Menú centrado con fondo personalizado |

---

## Sistema de notificaciones

### Orden de prioridad

1. **ox_lib** - Si está instalado e iniciado
2. **Framework** - Nativo de ESX/QB/QBox
3. **Nativo** - Notificaciones de GTA V

Para usar otro recurso de notificaciones, edita `Bridge.Notify` en `bridge/client.lua`.

---

## Integraciones (archivos abiertos)

Todo lo que se comunica con tu framework o con otros recursos está en dos archivos que no están cifrados:

| Archivo | Función | Qué hace |
|---|---|---|
| `bridge/client.lua` | `Bridge.GetFuel(vehicle)` | Nivel de combustible (ox_fuel, LegacyFuel, ps-fuel, cdn-fuel, okokGasStation, lj-fuel, nativo) |
| | `Bridge.GetNeeds()` | Hambre, sed y estrés (esx_status, metadatos de QB/QBox) |
| | `Bridge.IsDead()` | Comprobación de muerte; los eventos de muerte disparan el evento local `xex_pausemenu:deathChanged` |
| | `Bridge.OpenCharacterSelect()` | Botón «Cambiar personaje» (esx_multicharacter, qb-multicharacter) |
| | `Bridge.Notify(title, message, type)` | Notificaciones |
| `bridge/server.lua` | `Bridge.GetOnlineJobs()` | Trabajos y estado de servicio de los jugadores conectados (contador de trabajos seguidos) |
| | `Bridge.IsAdmin(source)` | Comprobación de admin (también `ConfigSv.CustomAdminCheck`) |
| | `Bridge.GetPhoneNumber(source)` | Número de teléfono (también `ConfigSv.GetPhoneNumber`) |
| | `Bridge.GetCharacter(source, data)` | Nombre, trabajo, rango, banda y cuentas |

---

## Exports y eventos

### Exports de cliente

```lua
-- Check if menu is open
local isOpen = exports['xex_pausemenu']:IsMenuOpen()

-- Open menu programmatically
exports['xex_pausemenu']:OpenPauseMenu()

-- Close menu
exports['xex_pausemenu']:ClosePauseMenu()
```

### Exports compartidos

```lua
-- Get the framework bridge object (useful for integrations)
local bridge = exports['xex_pausemenu']:GetBridge()
```

### Callbacks de servidor

| Callback | Devuelve | Descripción |
|----------|---------|-------------|
| `xex_pausemenu:getData` | `table` | Obtención principal de datos: devuelve información del jugador, estadísticas del servidor, estado de admin y trabajos seguidos |

### Eventos de servidor

| Evento | Parámetros | Descripción |
|-------|------------|-------------|
| `xex_pausemenu:submitReport` | `reportData` | Recibe el envío de un reporte, lo manda al webhook de Discord y avisa a los admins |
| `xex_pausemenu:disconnect` | — | Expulsa al jugador con el mensaje de salida configurado |
| `xex_pausemenu:checkAdmin` | — | Comprueba el estado de admin del jugador y envía el resultado al cliente |
| `xex_pausemenu:saveLayout` | `layoutData` | Guarda el diseño del personalizador del jugador en el almacenamiento KVP |
| `xex_pausemenu:requestLayout` | — | Carga el diseño guardado y lo envía al cliente que lo solicita |

### Eventos de cliente

| Evento | Parámetros | Descripción |
|-------|------------|-------------|
| `xex_pausemenu:reportNotification` | `reportData` | Avisa a los admins conectados de un nuevo reporte |
| `xex_pausemenu:setAdmin` | `isAdmin` | Establece el indicador de admin en el cliente |
| `xex_pausemenu:loadLayout` | `layoutData` | Recibe y aplica el diseño guardado desde el servidor |
| `xex_pausemenu:resetLayout` | — | Restablece el diseño del jugador a los valores por defecto |
| `xex_pausemenu:notify` | `message, type` | Respuesta del servidor (p. ej., reporte rechazado) |

### Eventos locales de cliente (para otros recursos)

Úsalos para ocultar tu propio HUD mientras el menú está abierto:

```lua
AddEventHandler('xex_pausemenu:opened', function() --[[ hide HUD ]] end)
AddEventHandler('xex_pausemenu:closed', function() --[[ show HUD ]] end)
```

### Callbacks NUI

| Callback | Datos | Descripción |
|----------|------|-------------|
| `close` | — | Cierra el menú y libera el foco NUI |
| `modalOpened` | `type` | Registra cuándo se abre el modal de reporte/salida |
| `modalClosed` | — | Registra cuándo se cierra el modal |
| `playSound` | `sound` | Reproduce sonidos del frontend de GTA (CONTINUE, BACK, SELECT, NAV_UP_DOWN) |
| `openMap` | — | Abre el mapa nativo de GTA |
| `openSettings` | — | Abre el menú de ajustes nativo de GTA |
| `openLink` | `url` | Abre una URL en el navegador del jugador |
| `submitReport` | `reportData` | Envía un reporte al servidor |
| `disconnect` | — | Desconecta al jugador del servidor |
| `quitGame` | — | Fuerza el cierre de FiveM mediante `ForceSocialClubUpdate()` |
| `characterSelect` | — | Vuelve a la pantalla de selección de personaje |
| `saveLayout` | `layoutData` | Guarda el diseño del personalizador del jugador en el servidor |

### Comandos

| Comando | Contexto | Descripción |
|---------|---------|-------------|
| `/{OpenCommand}` | Cliente | Abre el menú de pausa (por defecto: `/pausemenu`) |
| `resetlayout` | Admin / Consola | `/resetlayout <player_id>`: restablece el diseño guardado de un jugador a los valores por defecto |

---

## Estructura de archivos

```
xex_pausemenu/
├── bridge/
│   ├── client.lua         # Fuel, needs, death, character select, notifications (open)
│   └── server.lua         # Jobs, admin, phone, character data (open)
├── client/
│   └── main.lua           # Client-side logic
├── server/
│   └── main.lua           # Server-side logic and version check
├── shared/
│   ├── bridge.lua         # Framework abstraction
│   └── lib_loader.lua     # ox_lib loader
├── web/
│   ├── index.html         # UI structure
│   ├── style.css          # Styles
│   ├── app.js             # Main app logic
│   ├── customizer.js      # Customizer panel
│   ├── customizer.css     # Customizer styles
│   └── img/               # Images folder
│       └── logo.svg       # Server logo (placeholder, replace it)
├── config.lua             # Client configuration
├── svconfig.lua           # Server configuration
├── fxmanifest.lua         # Resource manifest
├── LICENSE                # Commercial license
└── DOCS.md                # This documentation
```

---

## Solución de problemas

### El menú no se abre

1. Comprueba que el recurso está iniciado: `ensure xex_pausemenu`
2. Revisa la consola en busca de errores
3. Comprueba que se detecta el framework
4. Revisa conflictos de atajos de teclado

### No se detecta el framework

```lua
-- Force framework
Config.Framework = 'esx' -- instead of 'auto'
```

### No se muestran las estadísticas

- **ESX**: requiere `esx_status` para hambre/sed
- **QB/QBox**: usa los metadatos integrados

### No se muestra el combustible

- Asegúrate de que el recurso de combustible se inicia antes que xex_pausemenu
- Comprueba si los exports del recurso de combustible están disponibles

### El personalizador no guarda

- Revisa la consola del servidor en busca de errores de guardado/carga
- Comprueba que el jugador tiene un identificador válido
- Los datos del diseño se guardan en el servidor mediante KVP (`SetResourceKvp`/`GetResourceKvpString`)
- Usa `/resetlayout <player_id>` para restablecer el diseño de un jugador si está corrupto

### Selección de personaje

- **ESX:** requiere que `esx_multicharacter` esté en ejecución. Si no se encuentra, el jugador será desconectado en su lugar.
- **QB/QBox:** dispara `qb-multicharacter:client:chooseChar`.

### Comportamiento del menú

- El menú se cierra automáticamente cuando el jugador muere y no se puede volver a abrir hasta que reaparece.
- La tecla Retroceso (control 177) también sirve para cerrar el menú como alternativa a ESC/botón de cerrar.
- Los efectos de sonido usan el `HUD_FRONTEND_DEFAULT_SOUNDSET` con los sonidos: CONTINUE (abrir), BACK (cerrar), SELECT (clic), NAV_UP_DOWN (hover).

---

## Registro de cambios

### v2.1.2
- Inicio más sobrio: el botón Salir es ahora una fila neutra como los botones de enlace, en rojo solo en su icono y al pasar el cursor
- Los botones Mapa, Ajustes y Reporte usan la misma superficie neutra y opacidad que las tarjetas; su color está en el icono y al pasar el cursor, y sigue el preajuste activo (el icono de Reporte ya no toma el color de acento)
- El botón Mapa tiene un mapa tenue de la ciudad de fondo. `Config.UI.buttonImages` establece el fondo de los botones Mapa, Ajustes y Reporte (una ruta o URL, como una captura de tu servidor, o `false`)
- Corregido: los tintes de los botones no se mostraban en el juego porque el navegador de FiveM no admite `color-mix()`
- `showOverlay` y `overlayOpacity` ahora establecen la oscuridad del fondo por defecto para los jugadores que no la han cambiado en el personalizador
- Eliminadas opciones de configuración que no tenían efecto: `Config.Buttons.inventory` y `phone`; `Config.UI.theme`, `blurIntensity`, `glassmorphism`, `animationSpeed` y `layout`; opciones del personalizador `autoTheme`, `animationSpeed` y `cardShadow`

### v2.1.1
- Más ligero con el menú abierto (0.01 ms en resmon): hambre, sed y estrés se leen del evento de actualización propio del framework en lugar de copiar todos los datos del jugador cada segundo, la calle y la zona solo se consultan cuando el jugador se mueve, y solo se envían al menú los datos que cambian
- La tarjeta del vehículo se oculta cuando el jugador se baja con el menú abierto
- La configuración estática se envía cuando carga la página del menú, no en la primera apertura

### v2.1.0
- Todas las integraciones con el framework y con terceros (combustible, necesidades, muerte, selección de personaje, notificaciones, comprobación de admin, teléfonos, recuento de trabajos, datos del personaje) se han movido a los archivos abiertos `bridge/client.lua` y `bridge/server.lua`, para poder adaptarlas sin tocar el código cifrado

### v2.0.2
- La comprobación de actualizaciones imprime el mismo mensaje de una línea que los demás scripts de XeX y no muestra nada si no se puede contactar con xexstudio.com
- Eliminados el export `CheckForUpdates` y el comando de consola `pausemenu_update`

### v2.0.1
- Corrección: el menú podía abrirse estando muerto (los manejadores de muerte nunca se registraban)
- Corrección: los botones de web/Discord/redes sociales ahora abren el enlace en el navegador
- Corrección: los datos del menú en ESX/QBCore podían no cargarse cuando ox_lib se iniciaba sin su global `lib`
- Seguridad: los reportes se validan en el servidor (categoría, longitudes, tiempo de espera) y se avisa a los jugadores cuando se rechaza uno
- Seguridad: los diseños guardados tienen un límite de tamaño en el servidor
- `/resetlayout` también borra el diseño almacenado en la NUI del jugador
- `cachePlayerData`, `cacheDuration` y `MaxRequestsPerMinute` ahora funcionan; eliminadas opciones que no hacían nada
- La comprobación de actualizaciones ahora usa xexstudio.com
- El minimapa permanece oculto mientras el menú está abierto aunque un HUD lo siga reactivando
- Nuevos eventos locales `xex_pausemenu:opened` / `xex_pausemenu:closed` para integraciones con HUD
- La cuenta cripto solo se muestra cuando tiene saldo (QB/QBox)
- Nuevo logo de ejemplo (SVG)
- El trabajo muestra su rango (p. ej. `LSPD · Officer`)
- Filas de número de teléfono y tiempo de sesión en la tarjeta del jugador (estaban en la configuración pero nunca se mostraban); corregidos los exports de lb-phone y npwd, hook `ConfigSv.GetPhoneNumber`
- El clima muestra su nombre en lugar de una temperatura inventada
- ESX: `OnlyCountOnDuty` se respeta en ESX Legacy 1.10+
- Font Awesome e Inter incluidos en `web/vendor/` (no hace falta CDN)
- Nueva paleta por defecto (grafito y lima) y 12 preajustes rediseñados: Default, Midnight, Forest, Ember, Amethyst, Sunset, Arctic, Rosé, Mono, Synthwave, Cyberpunk y Light
- Las tarjetas de preajuste muestran una miniatura en vivo con los colores del propio preajuste
- `Config.UI.accentColor` ahora establece el acento del preajuste Default
- El texto de las insignias y botones con color de acento alterna entre oscuro y blanco por contraste
- El menú se desplaza a la izquierda mientras el personalizador está abierto, de modo que el panel ya no cubre la columna derecha
- Espaciado entre las secciones del personalizador

### v2.0.0
- Reescritura completa con arquitectura moderna
- Compatibilidad multiframework (ESX, QBCore, QBox)
- Personalizador visual avanzado
- 10 preajustes de tema
- Visualización del clima (icono + temperatura)
- Compatibilidad con 12 idiomas
- Integración con ox_lib
- Sistema de reportes mejorado
- Optimizaciones de rendimiento

---


## Licencia

Este es software comercial. Consulta LICENSE para conocer los términos.

**Restricciones:**
- Uso en un solo servidor
- Sin redistribución
- Sin reventa
- Sin compartir el código fuente

© 2024-2026 XeX Development. Todos los derechos reservados.
