Skip to main content

cold_blipscreator

cold_blipscreator es un creador visual de blips persistentes para FiveM. Abre una NUI propia, guarda cada punto en SQL y lo sincroniza a todos los clientes cuando el recurso arranca, cuando un jugador entra y cada vez que alguien crea, edita o elimina un blip.

Mapa rapido​

Lo que hace de verdad el script​

  • Usa oxmysql y crea o verifica la tabla acv_blips al iniciar.
  • Carga todos los blips en memoria y los reenvia a todos los clientes con acv_blips:setBlips.
  • Abre el creador con Config.Command, que por defecto es blipscreator.
  • Guarda blips nuevos en la posicion actual del jugador que los crea.
  • Permite editar nombre, sprite, color, escala y short_range.
  • Permite eliminar blips persistentes desde la misma NUI.
  • Incluye selector visual de sprites y colores en html/app.js.
  • Puede restringir toda la gestion con ACE usando Config.UseAcePerms y Config.AcePermission.

Puntos importantes antes de usarlo​

  • No depende de qbx, qb-core ni es_extended.
  • Todos los blips son globales para todo el servidor; no hay filtros por job, gang o jugador.
  • La edicion actual no mueve coordenadas. Si quieres recolocar un blip, debes borrarlo y crearlo otra vez.
  • Aunque aqui lo documentemos como cold_blipscreator, el codigo actual mantiene prefijos internos acv_blips:*, logs [ACV_BLIPS] y la tabla SQL acv_blips.
  • Config.DefaultShortRange existe en config.lua, pero la implementacion actual no lo usa como fallback real.

Componentes principales​

  • config.lua: comando, ACE y defaults basicos.
  • server/main.lua: tabla SQL, cache global, permisos y CRUD.
  • client/main.lua: blips del mapa, apertura de NUI y callbacks.
  • html/index.html: layout del panel.
  • html/app.js: formulario, tabla y selectores visuales.
  • html/blips/*.png: previews para una lista concreta de sprites.

Resumen operativo​

  1. Al arrancar el recurso, el servidor verifica acv_blips y carga todos los registros.
  2. Cada cliente pide la lista al iniciar el recurso y tambien al dispararse playerSpawned.
  3. El comando configurado abre la NUI si el jugador tiene permiso.
  4. Al crear un blip nuevo, el cliente adjunta sus coordenadas actuales y el servidor inserta el registro.
  5. Al editar o borrar, el servidor actualiza SQL, refresca cache y reenvia el estado a todos.
  6. La NUI del creador solo se refresca al jugador que la tiene abierta, pero el mapa se actualiza a toda la sesion.

Orden recomendado de lectura​

  1. Dependencies
  2. Installation
  3. Configuration
  4. Usage Guide
  5. Resource Integration
  6. Technical Reference
  7. FAQ