Docs del script · Gratis

Business Details

Un directorio de los negocios de la ciudad con estado de apertura en vivo, waypoints y reseñas.

Business Details
Versión
v2.0.0
Frameworks
ESX · QBCore · Qbox
Requiere
ox_lib, oxmysql (opcional, para las reseñas)
Código
Escrow
resmon
0,00 ms en reposo · 0,00 ms con el directorio abierto
Actualizado
6 oct 2026

Un directorio de los negocios de tu ciudad: cuáles están abiertos ahora mismo, dónde están, qué ofrecen y qué opinan los jugadores de ellos. Los empleados abren y cierran su negocio desde la misma pantalla. ESX, QBCore y Qbox.

Gratuito y de código abierto.

Requisitos

  • ox_lib
  • Un framework: ESX, QBCore o Qbox
  • Opcional: oxmysql para las reseñas de jugadores (la tabla se crea en el primer arranque)

Instalación

  1. Copia xex_businessdetails en tu carpeta de recursos.
  2. Añade a server.cfg después de tu framework, ox_lib y oxmysql:
    ensure xex_businessdetails
  3. Configura el idioma con setr ox:locale en (o es).
  4. Opcional, para permitir que el staff elimine reseñas:
    add_ace group.admin xex_businessdetails.staff allow
  5. Edita config.lua con tus negocios y trabajos, y coloca tus imágenes en ui/images/ (16:9, con 640×360 es suficiente).

Los jugadores abren el directorio con /business (configurable), una tecla opcional o una app del teléfono (ver más abajo).

Configuración

Todo está en config.lua:

Ajuste Qué hace
Config.Framework auto, o fuerza esx / qb / qbox
Config.Command / Config.Keybind Cómo abren los jugadores el directorio
Config.UI Nombre de marca, título y color de acento
Config.Status Tiempo de espera antes de reabrir, distancia al negocio, requisito de estar de servicio, cierre automático cuando no hay personal conectado
Config.Announce Notificación a todos los jugadores al abrir / cerrar, y un recordatorio periódico de lo que está abierto
Config.Blips Blips del mapa, solo para negocios abiertos o siempre
Config.Descriptions Permite a los empleados reescribir su descripción en el juego (se guarda entre reinicios)
Config.Reviews Reseñas de jugadores: activadas / desactivadas, distancia, longitud del comentario
Config.Categories Chips de filtro
Config.Businesses Tus negocios: id, etiqueta, trabajo, rango mínimo, categoría, imagen, coordenadas, descripción

config_server.lua contiene el webhook de Discord (aperturas, cierres, ediciones de descripción, reseñas). Nunca se envía a los jugadores.

Varios negocios pueden compartir un mismo trabajo. Mantén cada id único y no lo cambies una vez que los jugadores hayan dejado reseñas.

Apps de teléfono

Abre el directorio desde cualquier app de teléfono con el export del cliente:

exports.xex_businessdetails:Open()

Ejemplo para lb-phone (lb-phone/config/config.lua, dentro de Config.CustomApps):

['businesses'] = {
    name = 'Businesses',
    description = 'What is open in the city right now',
    developer = 'XeX',
    defaultApp = true,
    icon = 'https://your-cdn/businesses.png', -- your own icon
    onUse = function()
        exports.xex_businessdetails:Open()
    end,
},

Para desarrolladores

-- server
exports.xex_businessdetails:IsOpen('burgershot')        -- true / false
exports.xex_businessdetails:GetOpen()                   -- { 'burgershot', 'vanilla', ... }
exports.xex_businessdetails:SetOpen('burgershot', true) -- open or close from another resource (announced as usual)

AddEventHandler('xex_businessdetails:statusChanged', function(id, open, src) end)

Los clientes pueden leer GlobalState.xex_businesses ({ [id] = openedAt }) para el estado en vivo.

bridge/server.lua es abierto: adáptalo si usas un framework o sistema de trabajos personalizado.

Seguridad

  • Abrir, cerrar y editar se comprueba en el servidor: trabajo, rango, servicio, distancia y tiempo de espera.
  • Las reseñas se validan en el servidor (estrellas, longitud, distancia, una por jugador y negocio, no se puede reseñar el propio negocio) y tienen límite de frecuencia.
  • Todo texto escrito por los jugadores se muestra como texto plano en la UI, nunca como HTML.