Shops

Sistema de tiendas para el inventario estándar y ox_inventory: tiendas con cesta, armerías, mercado negro rotativo, ofertas del día, vendedores NPC y un editor de tiendas en el juego.

Funciones

• Tres tipos de tienda: tienda con cesta, armería y mercado negro. Se paga con tarjeta o en efectivo, en el mercado negro con dinero negro.
• El servidor comprueba precios, total, peso y distancia. Stock solo en tiendas compradas. Reglas por tipo de tienda, tienda u objeto.
• Tiendas en venta: los jugadores compran una tienda, fijan precios, traen mercancía del mayorista y gestionan la caja.
• Mercado negro rotativo con ubicaciones, surtido y precios cambiantes, además de ofertas del día en las tiendas normales.
• Editor de tiendas en el juego con modelo de NPC, escenario, marcador con vista previa en directo y blip propio.
• Logs de Discord por compra y estadísticas en directo en Discord.

Instalación

1. Pon la carpeta off_shops en tu carpeta resources.
2. Todos los objetos de config/settings/config.items.lua deben existir en tu inventario – ESX: tabla items, ox_inventory: ox_inventory/data/items.lua. Las armas (weapon_…) no necesitan entrada con ESX.
3. En el server.cfg – después de ESX, oxmysql y tu inventario:

ensure oxmysql
ensure es_extended
ensure ox_inventory
ensure off_shops

Las tablas se crean automáticamente y se completan en las actualizaciones.

Configuración

config/settings/config.lua

Reglas (rules) hay por tipo de tienda, tienda u objeto: jobs, blockedJobs, minGrade y hours = { from, to } (hora del juego, 22–5 = 22:00–04:59).

config/settings/config.locations.lua – Ubicaciones

{ type = 'normal', label = 'LTD Davis', interactionType = 'ped', position = vec4(-47.02, -1758.23, 29.42, 45.05), categories = { 'food', 'drinks', 'tools' } },
{ type = 'blackmarket', interactionType = 'ped', position = vec4(14.2280, -1104.0475, 29.7970, 340.0), categories = { 'weapons', 'illegal' } },

Las ubicaciones con type = 'blackmarket' son posibles sitios del mercado negro – de ellas, activeLocations están activas a la vez.

Categorías y objetos

food = { label = 'Essen', items = { 'bread', 'kebab', 'wrap' } }, -- categoría
{ name = 'water', label = 'Wasser', price = 10 },                  -- objeto

• Opcional por objeto: max (cantidad máxima propia), image (imagen propia), rules (reglas propias).
• weapon_… se trata como arma: se compra de una en una, con 42 balas en el inventario de ESX, no por duplicado.
• Imágenes: ESX carga web/dist/assets/items/<name>.png, ox_inventory usa las suyas. Pon las imágenes de armas que falten en web/dist/assets/weapons/<name>.png.

config/functions.lua

Logs de Discord

Los webhooks los pones en config/settings/config.server.lua (solo en el servidor): purchases registra cada compra, stats son las estadísticas en directo. Una url vacía ('') desactiva el log.

Idiomas

Todos los textos están en config/locales/<idioma>.json. Para un idioma propio, copia un archivo, tradúcelo y ajusta locale – deja dentro los placeholders como %s y {total}.

En el juego

Pulsa E en el vendedor o el marcador (o usa ox_target), elige artículos y paga. En la tienda hay una cesta, en la armería y en el mercado negro eliges un artículo.

Editor de tiendas (/shopeditor)

• A la izquierda están todas las tiendas del editor. Las tiendas de la config no aparecen ahí, esas las cambias en config/settings/config.locations.lua.
• Nueva crea una tienda en tu posición actual, Editar abre una existente.
• Puedes ajustar tipo, nombre, categorías, NPC o marcador, posición con orientación y blip.
• NPC: Elige un modelo de una lista con imágenes de todos los peds de GTA (búsqueda y categorías), además de escenario y orientación, todo con vista previa en directo en el juego. Un ped addon lo eliges con el nombre exacto del modelo en la búsqueda. Predeterminado = vendedor de shopTypes.
• Marcador: Tipo, tamaño, distancia al suelo, rotación, color, opacidad y movimiento con vista previa en directo en el juego.
• Blip: activado o no, opcionalmente con icono y color propios. Si no, se usa el blip de shopTypes.
• Mientras el editor está abierto, te mueves con WASD y miras alrededor manteniendo pulsado el botón derecho. Luego pulsa Tomar posición.
• Tras Guardar, el cambio se aplica al instante para todos los jugadores. Un mercado negro del editor es fijo y vende todos los artículos de sus categorías.

Tiendas en venta

Si una tienda se puede comprar lo ajustas con price en config.locations.lua para las tiendas de la config, y en el editor para las tiendas del editor (grupo Propiedad: En venta, Precio de compra). El mercado negro nunca está en venta. Las tiendas sin dueño venden como siempre, sin stock.

En el juego: En una tienda en venta, E abre primero una elección entre Comprar y Gestión, con una cámara sobre el vendedor si hay un NPC. Si la tienda es de otra persona, se abre directamente la tienda. Sin dueño, Gestión lleva a la oferta, como dueño a la gestión con Resumen (caja, ventas de hoy/7 días/total, gráfico, artículos casi agotados), Almacén, Precios, Pedido y Caja (sacar/ingresar en efectivo o cuenta, historial, vender la tienda). Los clientes pagan a la caja y solo pueden comprar lo que hay en stock.

Entrega: Elige la mercancía, el coste sale de la caja. Te teletransportan al punto vanSpawn y te sientan en la furgoneta – ve al mayorista, E en el marcador (cargar), vuelve y aparca la furgoneta en el marcador, luego ve al vendedor y pulsa E. Solo entonces entra en el almacén. Si la furgoneta se destruye, se acaba el tiempo o sales del servidor, la mercancía se pierde (reembolso según refundPercent). Tras reiniciar el servidor, una entrega abierta se reembolsa entera.

Log de Discord: webhook ownership en config/settings/config.server.lua (compra, venta, entregas, retiradas/ingresos). Liberar en el editor deja la tienda libre (almacén y caja se pierden).

Problemas frecuentes