Docs del script

Blips Menu

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

Blips Menu
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

  1. Copia xex_blipsmenu en tu carpeta de recursos.
  2. Añade a server.cfg después de tu framework, ox_lib y oxmysql:
    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):
    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:

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.