XJ Container Bar — Bar en contenedor con dueños, empleados y caja para FiveM (QB-Core / ESX)

▶ Video: https://youtu.be/NZABbZDKlmg

XJ Container Bar is a 20 ft shipping container turned into a bar. You place it anywhere on the map and you walk into it: it is not an MLO and there are no teleports. The container sits on the ground and everyone sees it from outside.

What it does

• Original model. XJ Scripts model, textures and collisions. The interior is furnished with base-game props called by name: no Rockstar files are shipped.

• Synced mechanisms. Staff door with handle or E, motorised shutter and retractable awning. Late joiners see every part in its real state, and anyone arriving mid-movement sees and hears what is left of it.

• Light and sound. Three-position switch (night, automatic 19:00-07:00, closed), interior light and lit sign. 3D sounds with distance, panning and inside/outside attenuation.

• Two upgrades. Premium LED lighting under the bar, with smooth fades, and a music system with its own volume panel (xsound).

• Business. Fridge and storage, drink preparation with a progress bar, cash register and card terminal - the customer accepts or declines - and an outside shop for customers.

• Owners and employees. Every container is a business with its own owner. The owner hires and fires and picks what each employee may do: door, shutter and awning, fridge and storage, drinks, register, music.

• Money per container. Sales go to the container that sold, never to the employee. The business money lives in its own XJ account, and it works with whatever bank your server runs — or with none at all.

• Nothing through walls. Fridge, storage, drinks, register, terminal, lights and music only work from inside and next to the object, checked on the server against the real position - rotated container, on a slope or several side by side.

• Working stools. Anyone sits facing the bar with GTA V's bar-stool animation, one player per stool.

• XJ Containers shop (/xjcontainers): buy the bar and its upgrades, place and move your own, GPS and a live 3D preview. The server sets the price, checks the money and logs every purchase, with a refund if anything fails.

Configurable without touching code

• Price of the bar and of each upgrade, or give the upgrades to everyone.

• Which drinks can be made and what ingredients they need.

• Employee permissions, how many per container and which ones they get when hired.

• Public or private door, and an optional job restriction.

• Automatic-mode hours, LED colour and brightness, and every sound volume.

• Every line of text. Spanish and English ship in locales/, outside the escrow, and you can add your own language.

Requirements

• A current FiveM artifact. OneSync recommended: the server checks real positions and distances with it.

• oxmysql for the shop. Without it the bar still works from a JSON file, but nothing can be bought.

• QBCore or ESX for the money, both detected automatically. Without a framework it runs standalone.

• Optional and all auto-detected: ox_lib, ox_target or qb-target, ox_inventory or qb-inventory and xsound.

• Any bank, and none is required: qb-banking, Renewed-Banking, okokBanking, ESX, QBCore or standalone.

What stays open

• config.lua - every setting and every text.

• locales/*.lua - every text, in Spanish and English.

• bridge/*.lua - the framework and inventory adapters.

• server/bridge/banking/*.lua - the bank adapters, so you can add your own.

• sql/*.sql and data/*.json.

What you get

• The resource, plus installation and feature guides in Spanish and English.

• Online documentation, kept up to date.

• Free updates for as long as the product stays in the catalogue.

• Support by ticket on the XJ Scripts Discord.

• This is the NORMAL edition. The COMPLETE edition adds the hydraulic self-levelling system, the terrace and XJ Service, and upgrading keeps your containers, owners and purchases.

More modules coming

This bar is the first module of the system. I am working on more container modules, with different layouts and different businesses inside the same 20 ft container, and they will arrive as updates: same placement system, same owner and employee permissions, same money handling.

Español

XJ Container Bar es un contenedor marítimo de 20 pies convertido en bar. Lo colocas en cualquier punto del mapa y se entra caminando: no es un MLO ni un interior con teletransporte. El contenedor está ahí, apoyado en el suelo, y se ve desde fuera.

Qué hace

• Modelo propio. Modelo, texturas y colisiones de XJ Scripts. El mobiliario de dentro son props del juego base llamados por nombre: el recurso no incluye archivos de Rockstar.

• Mecanismos sincronizados. Puerta de empleados con pomo o con la tecla E, persiana motorizada y toldo retráctil. Quien llega tarde ve cada pieza en su estado real, y quien llega a mitad de un movimiento ve y oye lo que queda.

• Luz y sonido. Interruptor de tres posiciones -noche, automático de 19:00 a 07:00 y cerrado-, luz interior y rótulo iluminado. Sonidos 3D con volumen por distancia, panorámica y atenuación entre dentro y fuera.

• Dos mejoras. Iluminación premium LED bajo la barra, con encendido y apagado progresivos, y equipo de música con su panel de volumen (xsound).

• Negocio. Nevera y almacén, preparación de bebidas con barra de progreso, cobro en efectivo por caja o con tarjeta por TPV -el cliente acepta o rechaza- y tienda exterior para los clientes.

• Dueños y empleados. Cada contenedor es un negocio con su dueño. El dueño contrata, despide y decide qué puede hacer cada empleado: puerta, persiana y toldo, nevera y almacén, bebidas, caja, música.

• Dinero por contenedor. Lo que se vende va al contenedor que vende, nunca al empleado. El dinero del negocio vive en su propia cuenta XJ, y funciona con el banco que lleves en tu servidor, o sin ninguno.

• Nada a través de las paredes. La nevera, el almacén, las bebidas, la caja, el TPV, las luces y la música solo funcionan desde dentro y junto al objeto, con la posición real comprobada en el servidor: contenedor girado, en pendiente o con varios juntos.

• Taburetes funcionales. Cualquier jugador se sienta mirando a la barra con la animación de bar del juego, uno por taburete.

• Tienda XJ Containers (/xjcontainers): comprar el bar y sus mejoras, colocar y mover el tuyo, GPS y vista 3D del modelo real. El servidor fija el precio, comprueba el dinero y registra cada compra, con devolución si algo falla.

Configurable sin tocar código

• Precio del bar y de cada mejora, o las mejoras de serie para todos.

• Qué bebidas se preparan y qué ingredientes piden.

• Permisos de los empleados, cuántos caben por contenedor y cuáles se dan al contratar.

• Puerta pública o privada, y restricción por trabajo si la quieres.

• Horario del modo automático, color y brillo de los LED, y todos los volúmenes.

• Todos los textos. El español y el inglés vienen en locales/, fuera del cifrado, y puedes añadir el tuyo.

Requisitos

• Un artefacto de FiveM actual. OneSync recomendado: con él el servidor comprueba posiciones y distancias de verdad.

• oxmysql para la tienda. Sin él el bar funciona con un archivo JSON, pero no se puede comprar nada.

• QBCore o ESX para el dinero, los dos se detectan solos. Sin framework funciona en modo standalone.

• Opcionales, y también automáticos: ox_lib, ox_target o qb-target, ox_inventory o qb-inventory y xsound.

• El banco que uses, y ninguno es obligatorio: qb-banking, Renewed-Banking, okokBanking, ESX, QBCore o standalone.

Qué queda abierto

• config.lua - todos los ajustes y todos los textos.

• locales/*.lua - todos los textos, en español e inglés.

• bridge/*.lua - los puentes de framework e inventario.

• server/bridge/banking/*.lua - los adaptadores de banco, para que añadas el tuyo.

• sql/*.sql y data/*.json.

Qué incluye tu compra

• El recurso, con la guía de instalación y la de características en español e inglés.

• Documentación online, al día.

• Actualizaciones gratis mientras el producto siga en catálogo.

• Soporte por ticket en el Discord de XJ Scripts.

• Esta es la edición NORMAL. La edición COMPLETE añade el autonivelador hidráulico, la terraza y XJ Service, y al pasar a ella se conservan contenedores, dueños y compras.

Habrá más módulos

Este bar es el primer módulo del sistema. Estoy trabajando en más módulos de contenedor, con distribuciones y negocios distintos dentro del mismo contenedor de 20 pies, y llegarán como actualizaciones: el mismo sistema de colocación, los mismos permisos de dueño y empleados y la misma gestión del dinero.

https://tierras-altas-rp.gitbook.io/xj-scripts/xj-container-bar