Prueba ya Smartphone V3Consíguelo Black Friday empieza enBlack Friday · 25% de descuento en toda la tienda · Tiempo limitadoComprar ahora

QUASARSTORE

[32.1] Diamond Casino

Instalación

Instala Diamond Casino en tu servidor FiveM: requisitos, orden de carga en server.cfg, el mapa del casino y la shell VIP, la base de datos y los ítems.

Sección: 32.1
Leer: 12 min
Actualizado: 9 nov

■ 12 min read · Actualizado 9 nov 2026

Antes de empezar#

Antes de instalar Diamond Casino, asegúrate de que tu servidor cumple los requisitos. OneSync, dos librerías y un framework son obligatorios. Todo lo demás es opcional, y casi todo se detecta automáticamente.

Requisito	Estado	Notas
OneSync	Obligatorio	Activado por defecto en los servidores con txAdmin.
`oxmysql`	Obligatorio	Acceso a la base de datos.
`ox_lib`	Obligatorio	Callbacks, zonas, menús y notificaciones.
Framework	Obligatorio	`es_extended` (ESX) o `qb-core` (QBCore), detectado automáticamente. Sin ninguno de los dos, el script recurre a un puente standalone, que es una plantilla que completas tú mismo.
`xsound` o `mx-surround`	Opcional	Reproduce la música de fondo en el casino y en las salas VIP. Sin ninguno de los dos, desactiva la música (consulta Configurar el recurso).
Mapa del casino	Opcional	El `casino_map` incluido, o uno de los MLO de casino compatibles.
`casino_vip`	Incluido	El shell de la sala VIP. Obligatorio para las salas VIP.
Target	Opcional	`qtarget` o `ox_target`. Sin un recurso de target, los NPC y los juegos muestran un aviso 3D y los jugadores pulsan E.
Llaves de vehículo	Opcional	Entrega las llaves del coche ganado en la Lucky Wheel.
Sociedad	Opcional	Ingresa la parte del casino de cada venta en una cuenta de sociedad.
`screenshot-basic`	Opcional	Toma una foto del ganador del jackpot para el anuncio en Discord.
`qs-interface` · `qs-textui`	Opcional	Notificaciones, barras de progreso y avisos 3D con estilo. Sin ellos, el script usa los de ox_lib y los del propio juego.

Algunas integraciones se eligen comprobando qué recursos ya están en ejecución cuando arranca el casino:

Capa	Cómo se elige
Framework	Detectado: `es_extended` o `qb-core`.
Mapa del casino	Se detecta por el nombre del recurso del MLO. Si no se encuentra ninguno, se usa la distribución del Diamond Casino de GTA.
Llaves de vehículo	Se detecta entre once recursos compatibles.
Música	`xsound` → `mx-surround`
Notificaciones	`qs-interface` → `ox_lib`
Sociedad · Target	No se detectan. Configúralos en `config/main.lua`.

Integraciones explica cada capa en detalle y cómo forzar un valor.

github.comReleases · overextended/oxmysqlMySQL resource for FXServer.github.comReleases · overextended/ox_libA FiveM resource and script library for Lua and JS.github.comXogy/xsoundSound library for FiveM, used for the casino's background music.

Descargar Diamond Casino#

Cuando compras Diamond Casino, se vincula automáticamente a tu cuenta de CFX Portal.

Inicia sesión en el CFX Portal con la misma cuenta que usaste al finalizar la compra. Abre Granted Assets y descarga Diamond Casino. La descarga contiene:

lua

[diamondcasino]/
├── qs-diamondcasino/   -- the script
├── casino_map/         -- the Diamond Casino interior (only if you have no other casino MLO)
├── casino_vip/         -- the VIP room shell
├── [sql]/              -- qs-diamondcasino.sql, every table (optional import)
└── [img]/              -- inventory images for the casino items

Dentro de qs-diamondcasino:

lua

qs-diamondcasino/
├── config/          -- config/main.lua, plus one folder per casino map
├── custom/          -- framework bridges (editable)
├── client/custom/   -- target, vehicle keys, weather (editable)
├── server/custom/   -- society, Discord logs, quests (editable)
├── locales/         -- 41 languages
├── music/           -- the casino's music tracks
├── sql/             -- database.sql, the same tables as [sql] (optional import)
└── web/build/       -- the interface, already built

La carpeta debe llamarse qs-diamondcasino. El script comprueba su propio nombre al arrancar. Una copia renombrada muestra You have renamed the script! y no arranca. Tampoco renombres casino_map ni casino_vip.

Instalar el recurso#

Mueve las carpetas al directorio de recursos de tu servidor. Pueden estar en cualquier lugar dentro de él, incluida una carpeta de categoría:

lua

resources/
└── [qs]/
    └── [diamondcasino]/
        ├── qs-diamondcasino/
        ├── casino_map/
        └── casino_vip/

Después abre server.cfg. Cada dependencia, y todo lo que quieras que se detecte, tiene que arrancar antes que Diamond Casino:

bash

ensure oxmysql
ensure ox_lib

# Framework
ensure es_extended
# ensure qb-core

# Optional integrations
ensure xsound             # or mx-surround
ensure ox_target          # only with Config.UseTarget = true
ensure qs-vehiclekeys     # or another supported keys resource
ensure esx_society        # or qb-management / qb-banking / ap-government
ensure screenshot-basic

# The map: the included interior OR your casino MLO
ensure casino_map
# ensure gabz_casino
ensure casino_vip

ensure qs-diamondcasino

El orden de carga importa. El framework, el mapa y el recurso de llaves se detectan una sola vez, mientras arranca el casino. Nada que arranque después se encuentra.

La base de datos#

No hay nada que importar. Diamond Casino crea todas las tablas que necesita la primera vez que arranca. Si prefieres crear el esquema tú mismo, importa [sql]/qs-diamondcasino.sql con HeidiSQL, phpMyAdmin o cualquier otro cliente. qs-diamondcasino/sql/database.sql es el mismo archivo, así que importa cualquiera de los dos.

Tabla	Contiene
`casino_memberships`	Membresías, la marca VIP, las fichas (cuando no son un ítem) y las fechas del próximo giro de la ruleta y del reinicio del límite de fichas.
`casino_blocked_players`	Los jugadores vetados del casino, y el motivo.
`casino_store`	Todo lo configurado en el panel de gestión: la banca, el personal, las paredes, las cámaras, el coche del podio, la música, los eventos, el jackpot, la configuración de las salas VIP y las cifras del panel de control.
`casino_jackpot_screens` · `casino_jackpot_winners`	Las pantallas del jackpot y cada ganador del Global Jackpot.
`casino_inside`	Quién se desconectó dentro del casino o de una sala VIP, para devolverlo a la entrada en su próximo inicio de sesión.
`qs_casino_settings` · `qs_casino_shop_items`	Los valores cambiados en `/casinoconfig`, y las listas de la tienda VIP y del bar.

Si tu usuario de la base de datos no puede crear tablas, la consola lo indica y el casino no puede guardar membresías ni ajustes. En ese caso, importa el archivo SQL a mano y reinicia. Cuando actualizas desde una versión anterior, las tablas existentes se conservan y los datos antiguos se migran automáticamente en el primer arranque. Los servidores instalados antes de la 2.2.19 que guardan las fichas como número (no como ítem) pueden ampliar la columna de fichas para que quepan saldos muy grandes:
sql
ALTER TABLE `casino_memberships` MODIFY `chips` BIGINT NOT NULL DEFAULT 0;

Registrar los ítems#

El casino da y quita ítems a través de tu framework, así que cada ítem tiene que existir en tu inventario. Las imágenes están en [img]/. Cópialas en la carpeta de imágenes de tu inventario.

Ítem	Etiqueta	Usado por
`casinochips`	Casino Chips	La moneda del casino, cuando las fichas son un ítem (por defecto).
`gold_watch` · `diamond_ring` · `luxury_cigar` · `expensive_champagne`	Gold Watch · Diamond Ring · Luxury Cigar Box · Expensive Champagne	La tienda VIP y los premios de la Lucky Wheel.
`royal_flush_whiskey` · `high_roller_vodka` · `lucky_7s_tequila` · `blackjack_bourbon`	Royal Flush Whiskey · High Roller Vodka · Lucky 7's Tequila · Blackjack Bourbon	El bar y los premios de la Lucky Wheel. Se pueden usar: beber uno aplica su efecto.
`weapon_pistol`	—	Un premio de la Lucky Wheel. Ya existe en la mayoría de los servidores.

Añade a ox_inventory/data/items.lua:

lua

['casinochips'] = { label = 'Casino Chips', weight = 0, stack = true, close = false, description = 'Chips for the Diamond Casino.' },

['gold_watch']          = { label = 'Gold Watch',          weight = 200, stack = true },
['diamond_ring']        = { label = 'Diamond Ring',        weight = 50,  stack = true },
['luxury_cigar']        = { label = 'Luxury Cigar Box',    weight = 300, stack = true },
['expensive_champagne'] = { label = 'Expensive Champagne', weight = 750, stack = true },

['royal_flush_whiskey'] = { label = 'Royal Flush Whiskey', weight = 500, stack = true, close = true },
['high_roller_vodka']   = { label = 'High Roller Vodka',   weight = 500, stack = true, close = true },
['lucky_7s_tequila']    = { label = "Lucky 7's Tequila",  weight = 500, stack = true, close = true },
['blackjack_bourbon']   = { label = 'Blackjack Bourbon',   weight = 500, stack = true, close = true },

Copia las imágenes en ox_inventory/web/images/.

Añade a qb-core/shared/items.lua. Las bebidas son useable; todo lo demás no:

lua

casinochips         = { name = 'casinochips',         label = 'Casino Chips',        weight = 0,   type = 'item', image = 'casinochips.png',         unique = false, useable = false, shouldClose = false, description = 'Chips for the Diamond Casino.' },
gold_watch          = { name = 'gold_watch',          label = 'Gold Watch',          weight = 200, type = 'item', image = 'gold_watch.png',          unique = false, useable = false, shouldClose = false, description = '' },
diamond_ring        = { name = 'diamond_ring',        label = 'Diamond Ring',        weight = 50,  type = 'item', image = 'diamond_ring.png',        unique = false, useable = false, shouldClose = false, description = '' },
luxury_cigar        = { name = 'luxury_cigar',        label = 'Luxury Cigar Box',    weight = 300, type = 'item', image = 'luxury_cigar.png',        unique = false, useable = false, shouldClose = false, description = '' },
expensive_champagne = { name = 'expensive_champagne', label = 'Expensive Champagne', weight = 750, type = 'item', image = 'expensive_champagne.png', unique = false, useable = false, shouldClose = false, description = '' },
royal_flush_whiskey = { name = 'royal_flush_whiskey', label = 'Royal Flush Whiskey', weight = 500, type = 'item', image = 'royal_flush_whiskey.png', unique = false, useable = true,  shouldClose = true,  description = '' },
high_roller_vodka   = { name = 'high_roller_vodka',   label = 'High Roller Vodka',   weight = 500, type = 'item', image = 'high_roller_vodka.png',   unique = false, useable = true,  shouldClose = true,  description = '' },
lucky_7s_tequila    = { name = 'lucky_7s_tequila',    label = "Lucky 7's Tequila",  weight = 500, type = 'item', image = 'lucky_7s_tequila.png',    unique = false, useable = true,  shouldClose = true,  description = '' },
blackjack_bourbon   = { name = 'blackjack_bourbon',   label = 'Blackjack Bourbon',   weight = 500, type = 'item', image = 'blackjack_bourbon.png',   unique = false, useable = true,  shouldClose = true,  description = '' },

Copia las imágenes en la carpeta html/images/ de tu inventario.

Añade a qs-inventory/shared/items.lua:

lua

['casinochips'] = {
    name = 'casinochips', label = 'Casino Chips', weight = 0, type = 'item',
    image = 'casinochips.png', unique = false, useable = false, shouldClose = false,
    description = 'Chips for the Diamond Casino.'
},
['royal_flush_whiskey'] = {
    name = 'royal_flush_whiskey', label = 'Royal Flush Whiskey', weight = 500, type = 'item',
    image = 'royal_flush_whiskey.png', unique = false, useable = true, shouldClose = true,
    description = ''
},
-- repeat for the other shop items and drinks: drinks useable = true, the rest useable = false

Copia las imágenes en qs-inventory/html/images/.

Para un inventario de ESX que lee los ítems de la base de datos:

sql

INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
('casinochips', 'Casino Chips', 0, 0, 1),
('gold_watch', 'Gold Watch', 1, 0, 1),
('diamond_ring', 'Diamond Ring', 1, 0, 1),
('luxury_cigar', 'Luxury Cigar Box', 1, 0, 1),
('expensive_champagne', 'Expensive Champagne', 1, 0, 1),
('royal_flush_whiskey', 'Royal Flush Whiskey', 1, 0, 1),
('high_roller_vodka', 'High Roller Vodka', 1, 0, 1),
('lucky_7s_tequila', 'Lucky 7''s Tequila', 1, 0, 1),
('blackjack_bourbon', 'Blackjack Bourbon', 1, 0, 1);

Obtener el acceso de administrador#

Diamond Casino tiene dos paneles con reglas de acceso distintas. /casinoconfig contiene los ajustes y es para los administradores del servidor. /casino gestiona el local y es para los administradores, el dueño del casino y sus empleados.

Automático, nada que configurar. Los administradores del servidor pueden abrir ambos paneles. En ESX eso significa los grupos admin y superadmin. En QBCore significa los permisos god y admin, o cualquiera con el ace command.

Para que alguien cambie los ajustes sin hacerlo administrador del framework, dale el ace qs-diamondcasino.config en server.cfg:

bash

add_ace group.admin qs-diamondcasino.config allow
# or a single player
add_ace identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx qs-diamondcasino.config allow

Este ace abre solo /casinoconfig. Está deliberadamente fuera de command., para que nadie lo herede por accidente.

Después, entrega el casino a su dueño. Como administrador, abre /casino, pulsa el botón de la corona junto al título y elige un jugador conectado. El dueño podrá entonces contratar empleados y gestionar el casino sin ningún permiso del servidor. No interviene ningún trabajo; el acceso lo guarda el propio casino.

Configurar el recurso#

Los precios, los límites, las reglas de los juegos, las listas de la tienda y el idioma se configuran en el juego con /casinoconfig, se guardan en la base de datos y se aplican en vivo. Los archivos solo contienen lo que hay que saber antes de que arranque el servidor, o lo que depende del mapa:

Archivo	Contenido
`config/main.lua`	La detección del framework, el mapa y las llaves; la sociedad; el modo de target; las pistas de música; los modelos de pared personalizados; la forma de la sala VIP; el punto de ruta del teléfono; las funciones del HUD.
`config/<map>/main.lua`	Los NPC, las puertas, el blip, la zona del casino, las cámaras de seguridad y los puntos clave de ese mapa.
`config/<map>/*.lua`	Las posiciones de mesas y máquinas, los límites de las mesas, la multitud, los premios de la Lucky Wheel y las mesas de billar.
`server/custom/webhooks.lua`	Los logs de Discord, una URL por categoría.
`server/custom/society/`	La cuenta de sociedad en la que paga cada recurso compatible.

Los valores que debes revisar primero, en config/main.lua:

lua

Config.Society        = 'esx_society'        -- 'none', 'esx_society', 'qb-management', 'qb-banking', 'ap-government'
Config.UseTarget      = false                -- true = qtarget / ox_target, false = 3D prompt + E
Config.TargetDistance = 5.0                  -- target reach, in metres
Config.Sound          = 'midnight_tokyo.mp3' -- starting music track, false = no music

Servidores QBCore: cambia Config.Society. Viene configurado como esx_society. Cámbialo a qb-management, qb-banking o none. Config.Sound solo define la pista con la que arranca el casino. Cuando alguien elige una pista en /casino → Music, esa elección se guarda, y editar el archivo después no cambia nada.

Verificar la instalación#

Reinicia el servidor y lee la consola. Deberías ver el framework que se cargó:

bash

[INFO] Successfully loaded the framework. esx

esx o qb significa que se encontró el framework. standalone significa que no; mueve tu framework por encima de ensure qs-diamondcasino. Después entra al servidor y recorre la primera visita:

Entra al casino
El blip del Diamond Casino está en el mapa. Dentro, los NPC del cajero, el mostrador de membresías, los porteros, la tienda y el bar aparecen al acercarte, junto con la multitud y la música.
Compra una membresía y fichas
Compra una membresía en el mostrador de membresías y luego cambia dinero del banco por fichas en el cajero. Siéntate en cualquier mesa para jugar.
Prepara el casino
Abre /casinoconfig para elegir el idioma, los precios y los límites. Después abre /casino y asigna al dueño. Uso explica el resto.

A partir de aquí, casi nada necesita un reinicio. Los pocos ajustes que sí lo necesitan están marcados como Needs restart en el panel.

[··] Documentación

Cargandola guía

Antes de empezar#

Descargar Diamond Casino#

Instalar el recurso#

La base de datos#

Registrar los ítems#

Obtener el acceso de administrador#

Configurar el recurso#

Verificar la instalación#

Entra al casino

Compra una membresía y fichas

Prepara el casino

Antes de empezar#

Descargar Diamond Casino#

Instalar el recurso#

La base de datos#

Registrar los ítems#

Obtener el acceso de administrador#

Configurar el recurso#

Verificar la instalación#

Entra al casino

Compra una membresía y fichas

Prepara el casino