# Blips Menu: documentación

> Crea, edita y comparte blips del mapa desde el mapa de pausa, públicos o privados.

- URL: https://xexstudio.com/es/docs/blips-menu
- Versión: 2.0.0
- Ficha del producto: https://xexstudio.com/es/scripts/blips-menu
Crea, edita y comparte blips del mapa desde el mapa de pausa. Los administradores gestionan los blips públicos (opcionalmente limitados a trabajos,
rangos o bandas); los jugadores mantienen sus propios blips privados. ESX, QBCore y Qbox. Cada cambio se valida en el servidor.

## Requisitos

- [ox_lib](https://github.com/overextended/ox_lib)
- [oxmysql](https://github.com/overextended/oxmysql)
- Un framework: **ESX**, **QBCore** o **Qbox**

## Instalación

1. Copia `xex_blipsmenu` en tu carpeta de recursos.
2. Añade a `server.cfg` después de tu framework, ox_lib y oxmysql:
   ```cfg
   ensure xex_blipsmenu
   ```
3. Configura el idioma con `setr ox:locale en` (o `es`).
4. Logs de Discord opcionales (solo en el servidor, nunca se envían a los jugadores):
   ```cfg
   set xex_blipsmenu_webhook "https://discord.com/api/webhooks/..."
   ```

La tabla `user_blips` se crea en el primer arranque (`install/blips.sql` si prefieres ejecutarlo tú mismo).

### Actualización desde v1

- Conserva tu tabla `user_blips`: se mantienen todos los blips. La columna `blipdata` se amplía automáticamente.
- Elimina `mysql-async` del manifest si lo añadiste; v2 usa oxmysql.
- `Config.Framework`, `Config.AdminRoles` y los ajustes del webhook han cambiado: copia tus valores en el nuevo `config.lua`.
- Mueve tu webhook al convar `xex_blipsmenu_webhook`. En v1 estaba en `config.lua`, que los jugadores pueden descargar.

## Cómo se usa

Abre el mapa de pausa y pulsa **ESPACIO** (los jugadores pueden reasignarla en Ajustes > Asignación de teclas > FiveM), o escribe `/blips`.

- **Crea** un blip en el mapa, en tu posición o por coordenadas.
- **Edita** tipo (icono, área o radio), nombre, icono, color, tamaño, rotación, opacidad, visualización en mapa/minimapa, corto alcance,
  contorno y tick. Cada cambio se previsualiza en vivo en el mapa y solo se guarda cuando lo confirmas.
- **Visible para** (blips públicos): déjalo vacío para todos, o añade trabajos (`police`), rangos mínimos (`police:2`),
  bandas en QBCore/Qbox (`ballas`) o grupos de `Config.JobGroups`.
- Pon un waypoint a cualquier blip, duplícalo o muévelo.

## Configuración

Todo está en `config.lua`:

| Ajuste | Qué hace |
| --- | --- |
| `Config.Framework` | `auto`, o fuerza `esx` / `qb` / `qbox` |
| `Config.Key`, `Config.Command`, `Config.MapHint` | Cómo se abre el menú y la pista en el mapa de pausa |
| `Config.Admin` | Grupos y ace que gestionan los blips públicos |
| `Config.PrivateBlips` | Activa o desactiva los blips privados y limita cuántos tiene cada personaje |
| `Config.JobGroups` | Atajos para el campo "Visible para": una lista de trabajos o una función del servidor |
| `Config.UI` | Marca, título y color de acento del menú |
| `Config.Defaults` | Nombre, icono, color y tamaño de los blips nuevos |
| `Config.Logs` | Nombre del log de Discord y si se registran los blips privados |

Un grupo puede ser una función para sistemas de trabajos personalizados:

```lua
Config.JobGroups = {
    gangs = function(job, source) return job:find('^gang') ~= nil end,
}
```

## Para desarrolladores

```lua
-- server
local id = exports.xex_blipsmenu:AddPublicBlip(vec3(215.0, -810.0, 30.0), { title = 'Event', sprite = 280, colour = 5 })
exports.xex_blipsmenu:UpdatePublicBlip(id, { colour = 1 })
exports.xex_blipsmenu:RemovePublicBlip(id)
local blips = exports.xex_blipsmenu:GetPublicBlips()

AddEventHandler('xex_blipsmenu:changed', function(action, blip, source)
    -- action: 'created' | 'updated' | 'removed'
end)
```

`bridge/server.lua` y `bridge/client.lua` son abiertos: adáptalos para un framework, sistema de permisos o de trabajos personalizado.

## Seguridad

- Solo los administradores pueden crear, editar o eliminar blips públicos; solo el propietario puede tocar un blip privado. Se comprueba en el servidor.
- Los nombres, colores, tamaños y listas de trabajos se limpian y limitan en el servidor antes de almacenarse o compartirse.
- Los jugadores solo reciben los blips públicos que tienen permitido ver: los blips restringidos nunca llegan a otros clientes.
- Los blips privados por personaje están limitados, y los cambios tienen límite de frecuencia.
- El webhook de Discord se lee de un convar del servidor y nunca se envía a los jugadores.
