Docs del script
Blips Menu
Crea, edita y comparte blips del mapa desde el mapa de pausa, públicos o privados.

- Versión
- v2.0.0
- Frameworks
- ESX · QBCore · Qbox
- Requiere
- ox_lib, oxmysql
- Código
- Escrow
- resmon
- 0,00 ms en reposo · 0,00 ms con el menú abierto
- Actualizado
- 6 oct 2026
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
Instalación
- Copia
xex_blipsmenuen tu carpeta de recursos. - Añade a
server.cfgdespués de tu framework, ox_lib y oxmysql:ensure xex_blipsmenu - Configura el idioma con
setr ox:locale en(oes). - Logs de Discord opcionales (solo en el servidor, nunca se envían a los jugadores):
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 columnablipdatase amplía automáticamente. - Elimina
mysql-asyncdel manifest si lo añadiste; v2 usa oxmysql. Config.Framework,Config.AdminRolesy los ajustes del webhook han cambiado: copia tus valores en el nuevoconfig.lua.- Mueve tu webhook al convar
xex_blipsmenu_webhook. En v1 estaba enconfig.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 deConfig.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:
Config.JobGroups = {
gangs = function(job, source) return job:find('^gang') ~= nil end,
}
Para desarrolladores
-- 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.