Docs del script · Gratis
Business Details
Un directorio de los negocios de la ciudad con estado de apertura en vivo, waypoints y reseñas.

- 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
- Copia
xex_businessdetailsen tu carpeta de recursos. - Añade a
server.cfgdespués de tu framework, ox_lib y oxmysql:ensure xex_businessdetails - Configura el idioma con
setr ox:locale en(oes). - Opcional, para permitir que el staff elimine reseñas:
add_ace group.admin xex_businessdetails.staff allow - Edita
config.luacon tus negocios y trabajos, y coloca tus imágenes enui/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.