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

QUASARSTORE

[55.2] Lottery Creator

Uso

Cómo usar Lottery Creator: colocar máquinas de lotería en el juego, comprar y rascar boletos, equilibrar los premios y máquinas de jugadores con stock.

Sección: 55.2
Leer: 11 min
Actualizado: 1 nov

■ 11 min read · Actualizado 1 nov 2026

Dónde lo encuentran los jugadores#

Lottery Creator tiene cuatro puntos de contacto, y conviene saber desde el principio cuál es cuál:

Dónde	Se abre con	Para qué sirve
El creador	`/lotterycreator`	Administradores y trabajos de creador: colocar, editar, teletransportarse a máquinas y eliminarlas.
La máquina	Target, o `E` / `G` en el aviso	Todos: comprar boletos, comprar una máquina que está a la venta, gestionar una máquina propia.
La tarjeta de rasca	Usar el ítem	Todos: la tarjeta en pantalla, que se rasca con el ratón.
El teléfono	La app Lottery	Usuarios de Quasar Smartphone: comprar y rascar boletos desde cualquier lugar.

Colocar una máquina#

/lotterycreator abre el creador. A la izquierda está cada máquina del servidor — un cuadro de búsqueda, una insignia Blip en las que tienen uno, y el precio y la cuenta de cada una. Create Vendor crea una máquina nueva; al elegir una de la lista se abre para editarla.

El formulario#

Sección	Lo que configuras ahí
Vendor Settings	La etiqueta que ven los jugadores en el target, el prop, la cuenta de pago (efectivo, banco o dinero negro), el ítem de rasca que entrega y el precio del boleto.
Placement	Dónde está la máquina y hacia dónde mira, definido en el mundo.
Blip Settings	Un blip opcional en el mapa: su nombre, sprite, color, escala (0.2 a 1) y posición. Los sprites y colores se eligen de listas con búsqueda e imágenes.
Access Control	Los trabajos — y, por trabajo, los rangos — que pueden usar la máquina. Si no se selecciona nada, todos pueden.
Ownership	For sale y el precio de compra. Solo se muestra mientras las máquinas de jugadores están activadas.

Definir la posición#

Pulsa Select en Vendor Position. La ventana se cierra y una copia transparente del prop elegido sigue a donde mires, con un marcador rojo y una línea desde tu personaje hasta ella. Sigues caminando y girando la cámara como siempre; el punto cae sobre lo que estés mirando, hasta 50 metros de distancia.

Tecla	Hace
`Left click`	Coloca la máquina aquí.
`Z` / `X` (mantener)	La gira lentamente, para alinearla con precisión contra una pared.
`Mouse wheel`	La gira 15° por muesca.

El creador se vuelve a abrir con la posición y la orientación rellenadas. Pulsa Save y la máquina aparece para todos los jugadores a la vez — sin reiniciar. Un modelo que el juego no encuentra se rechaza antes de que empiece la vista previa, con Model … is not valid.

Gestionar máquinas#

Acción	Cómo
Editar	Elígela en la lista, cambia el formulario y pulsa Save. La máquina reaparece para todos; se conservan su propietario, ganancias y stock.
Teletransportarse	El botón de teletransporte de su tarjeta te coloca a su lado, para revisarla en persona.
Eliminar	El botón de eliminar, y después confirma. La máquina desaparece para todos y se elimina su fila — con su propietario, ganancias y stock, y no se reembolsa nada.

Props#

La lista de props es Config.VendorProps. Incluye la máquina de lotería transmitida por lottery_machine y dos máquinas expendedoras de GTA; se puede añadir cualquier modelo que se pueda generar, incluidos los tuyos:

lua

Config.VendorProps = {
    { label = 'Lottery Machine', value = 'lotrrery_vending_machine' },
    { label = 'Vending Soda',    value = 'prop_vend_soda_01' },
    { label = 'Vending Snack',   value = 'prop_vend_snak_01' },
    -- { label = 'My machine',   value = 'my_custom_prop' },
}

Cada máquina se genera en cada cliente congelada en su sitio e indestructible, así que no se puede empujar, mover ni volar.

Comprar un boleto#

En una máquina, el target ofrece Buy <name> - $<price>; sin target, acércate y pulsa E. El personaje hace un breve gesto de entrega, el precio se cobra de la cuenta de pago de la máquina y una tarjeta de rasca llega al inventario. El servidor comprueba que el jugador puede pagar antes de que nada cambie de manos.

Lo que vende una máquina depende de su estado:

Estado	Boletos	Notas
Máquina del servidor — sin propietario, no está a la venta	Se venden	Boletos ilimitados. El dinero sale de la economía.
A la venta — sin propietario, en venta	No se venden	Fuera de servicio: la única opción es Buy machine.
Con propietario, con stock	Se venden	Cada boleto usa una unidad de stock y paga al propietario.
Con propietario, vacía	No se venden	La opción del boleto desaparece hasta que el propietario reponga.

Una máquina restringida a trabajos solo muestra su opción de boleto a los jugadores con un trabajo y rango permitidos. Con la propiedad de jugadores desactivada, cada máquina es una máquina del servidor.

Rascar una tarjeta#

Usar la tarjeta de rasca desde el inventario abre la tarjeta. El personaje sostiene un boleto de lotería con una animación de portapapeles, y el ratón se convierte en una moneda: mantén el botón y arrastra para rascar. Las seis casillas se sortean en el servidor en el momento en que se usa la tarjeta, y el boleto se consume — lo que hay bajo la capa se decide antes del primer rascado.

Rasca aproximadamente una cuarta parte de la tarjeta y el resto se revela solo, con los premios iluminándose.
Claim prize paga el total. Close en una tarjeta ganadora también la cobra, así que nunca se pierde un premio al cerrar.
Una tarjeta perdedora solo ofrece Close, con Better luck next time!

La tabla de premios#

Lo que puede pagar una tarjeta es una lista, Config.PossibleRewards:

lua

Config.PossibleRewards = {
    { label = 'NO WIN', type = 'none',  amount = 0,    chance = 80 },
    { label = '$10',    type = 'money', amount = 10,   chance = 5 },
    { label = '$50',    type = 'money', amount = 50,   chance = 3 },
    { label = '$150',   type = 'money', amount = 150,  chance = 1 },
    { label = '$250',   type = 'money', amount = 250,  chance = 0.5 },
    { label = '$1,000', type = 'money', amount = 1000, chance = 0.2 },
}

Campo	Significado
`label`	Lo que se imprime en la casilla. Mantenlo sincronizado con `amount`: el jugador lee la etiqueta, el script paga la cantidad.
`type`	`money` paga la cantidad; `none` es una casilla perdedora.
`amount`	Lo que paga la casilla, en efectivo.
`chance`	Su peso. Los pesos se comparan entre sí, así que no tienen que sumar 100 — los incluidos suman 89.7. Se admiten decimales.

Cómo se sortea una tarjeta#

Cada una de las seis casillas se sortea por separado contra la tabla, y la tarjeta paga el total de todas las casillas ganadoras: tres casillas de $10 pagan $30, una de $10 y una de $1,000 pagan $1,010. La probabilidad de que una casilla caiga en un premio es su chance dividida entre la suma de todas las chances.

Equilibrarla#

La media que paga una tarjeta es:

lua

average per card = 6 × Σ(amount × chance) ÷ Σ(chance)

Con la tabla incluida, eso es 6 × 675 ÷ 89.7 ≈ $45 por tarjeta, frente a un boleto de $30. Alrededor de la mitad de las tarjetas ganan algo, y de media los jugadores sacan más de lo que ponen. Para convertir la lotería en un sumidero de dinero, sube el peso de NO WIN o baja los premios — solo con subir NO WIN de 80 a 150 la media baja a unos $25 por tarjeta.

Las máquinas con propietario no cambian estos cálculos. El propietario gana con el precio del boleto y los premios los paga el sistema aparte, así que una tabla generosa le cuesta a tu economía, nunca al propietario.

Máquinas de jugadores#

Con Config.Ownership.enabled, un jugador puede comprar y gestionar una máquina, como un negocio de máquinas expendedoras: fija el precio, la mantiene abastecida y cobra lo que gana.

Poner una máquina a la venta#

Marca For sale en la sección Ownership del creador y fija su precio de compra — 25,000 por defecto. Mientras esté en venta y sin propietario, la máquina no vende boletos: los jugadores que se acercan ven Buy machine - $25000.

Comprar una#

La pantalla de compra muestra el precio, la cuenta con la que se paga (bank por defecto), el precio actual del boleto y qué parte de cada boleto se queda el propietario. Un jugador puede tener hasta Config.Ownership.maxPerPlayer máquinas — dos por defecto, 0 para ilimitadas.

Una máquina comprada empieza vacía: no vende nada hasta que su nuevo propietario carga stock de boletos.

Gestionarla#

El propietario se acerca y elige Manage machine — en el target, o G junto al aviso del boleto (E cuando es la única opción).

Sección	Qué hace
Precio del boleto	Lo que cuesta un boleto, dentro de `priceLimits` — de $5 a $1,000 por defecto. Los clientes ven el nuevo precio al instante.
Stock de boletos	Boletos cargados, de un máximo de `maxStock` (500). Restock carga más por `restockCost` por boleto ($5) desde la cuenta del propietario — no hace falta ningún ítem. Cada venta usa uno.
Ganancias disponibles	Lo que han generado las ventas desde el último cobro. Collect lo ingresa en la cuenta del propietario.
Cifras	Boletos vendidos, ingresos totales antes de comisión y la tasa de comisión.
Sell machine	La revende por el `resaleRefund` del precio de compra (50%) más las ganancias aún no cobradas. El stock cargado se pierde y la máquina vuelve directamente a la venta. Oculto cuando `allowResale` está desactivado.

Solo el propietario puede cobrar, reponer o vender. Las ganancias, el stock y las cifras se escriben en la base de datos a medida que cambian, así que sobreviven a un reinicio.

Adónde va el dinero#

En cada boleto	Cantidad
El cliente paga	El precio del boleto, desde la cuenta de pago de la máquina.
El propietario gana	El precio menos la comisión, redondeado hacia abajo — $27 de un boleto de $30 con el 10% predeterminado.
El servidor se queda	La comisión.
Los premios	Los paga el sistema — nunca salen de las ganancias del propietario.

Con los valores predeterminados, un boleto de $30 le da al propietario $27 y le cuesta $5 de stock: $22 por boleto.

Controles de administrador#

Un administrador del framework que abre Manage machine en una máquina con propietario también ve una sección Admin, y puede cambiar su precio de boleto:

Control	Qué hace
Listed for sale · Purchase price	Los ajustes de venta de la máquina, los mismos que edita el creador.
Evict owner	Elimina al propietario. Las ganancias no cobradas y el stock cargado se borran sin reembolso. La máquina vuelve a la venta solo si `defaultForSale` está activado; si no, se convierte en una máquina del servidor.

Desactivarlo#

Config.Ownership.enabled = false convierte cada máquina en una máquina del servidor de precio fijo: sin opción Buy ni Manage, y sin sección Ownership en el creador. Los propietarios, ganancias y stock se quedan intactos en la base de datos, y vuelven si lo activas de nuevo.

La app del teléfono#

Con Quasar Smartphone, los jugadores tienen una app Lottery, que se activa con Config.Phone.enabled. Lee la lotería en directo desde el servidor:

Parte	Lo que muestra o hace
Wallet	Las tarjetas de rasca que llevas, el precio del boleto y tus saldos en efectivo y en el banco.
Buy	Uno o varios boletos sin ir a una máquina, cuando `allowRemotePurchase` está activado. Llegan al inventario como tarjetas de rasca normales.
Scratch	Usa un boleto en el teléfono; el premio se paga en efectivo, como en una máquina. Una tarjeta a medio rascar te espera cuando vuelves a abrir la app.
Prizes	La tabla de premios con cada chance.
Recent winners	Los últimos diez premios del servidor, en máquinas y en teléfonos.
History	Tus últimas 50 tarjetas del teléfono, con tu total ganado y gastado.
Jackpot	Una cifra comunitaria que crece un 10% de cada compra desde el teléfono. Se muestra en la app; el script no la paga.

Los ajustes#

Cada opción de config/main.lua. Las máquinas en sí se editan en el juego; estos se leen cuando se inicia el recurso, así que reinícialo tras un cambio.

Ajuste	Predeterminado	Qué hace
`Config.Locale`	`'en'`	El archivo de idioma de `locales/`.
`Config.Intl`	en-US · USD · 0 decimales	Cómo se formatean las cantidades en la interfaz: formato de número, moneda y decimales.
`Config.CreatorJobs`	police, ambulance	Trabajos que pueden abrir el creador. `grade` es `false` para cualquier rango, o una lista como `{ 3, 4 }`.
`Config.CreatorMoneyTypes`	Cash · Bank · Black Money	Las cuentas de pago que se ofrecen en el creador. Cada `value` debe ser una cuenta que tu framework conozca.
`Config.SyncChunkSize`	15	Cuántas máquinas se envían a un jugador que se conecta por cada mensaje de red. Bájalo en servidores muy grandes.
`Config.VendorDefaults`	$30 · money · scratchcard	Los valores con los que empieza una máquina nueva, y el precio, la cuenta y el ítem de las compras desde el teléfono. Su `item` es el que abre una tarjeta.
`Config.VendorProps`	3 modelos	La lista de props del creador.
`Config.Ownership`	activado	Máquinas de jugadores — consulta la siguiente tabla.
`Config.UseTarget`	auto	`true` cuando ox_target o qb-target está iniciado. Ponlo en `false` para forzar los avisos.
`Config.VendorInteractDistance`	2.0	Alcance, en metros, de las opciones del target y de los avisos.
`Config.PossibleRewards`	6 premios	La tabla de premios.
`Config.Phone`	activado · compra remota activada	`enabled` sirve la app Lottery; `allowRemotePurchase` le permite vender boletos.
`ActionControls` · `CameraOptions`	—	Las indicaciones de teclas y las velocidades de la herramienta de cámara del creador. La colocación en sí usa clic izquierdo, `Z` / `X` y la rueda, así que rara vez hace falta tocarlos.
`Config.Debug`	`false`	Salida adicional en la consola.
`Config.DisableSounds`	`false`	Silencia los sonidos de juego de la interfaz. El sonido de rascar con la moneda de la tarjeta sigue sonando.
`Config.EnableInventoryShop` · `Config.EnableWinAnim` · `Config.WinAnim`	desactivado	Presente en el archivo, pero esta versión no lo usa.

Config.Ownership#

Clave	Predeterminado	Qué hace
`enabled`	`true`	El interruptor principal.
`account`	`'bank'`	Paga una máquina y las reposiciones, y recibe las ganancias cobradas y los reembolsos de reventa.
`defaultForSale`	`false`	Si una máquina guardada sin ajustes de venta queda en venta, y si una máquina desalojada vuelve a la venta.
`defaultPurchasePrice`	25000	Precio de compra de una máquina nueva; editable por máquina.
`maxPerPlayer`	2	Máquinas que puede tener un jugador. `0` es ilimitado.
`commission`	0.10	La parte del servidor de cada boleto, de 0 a 1.
`allowResale`	`true`	Si los propietarios pueden revender su máquina.
`resaleRefund`	0.5	Parte del precio de compra reembolsada en la reventa, de 0 a 1.
`priceLimits`	5 – 1000	Precio mínimo y máximo del boleto que puede fijar un propietario.
`maxStock`	500	Máximo de boletos que puede contener una máquina.
`restockCost`	5	Lo que paga el propietario por cada boleto cargado.

[··] Documentación

Cargandola guía