Usage — Lottery Creator | Quasar Store | Quasar Store

Usage — Lottery Creator | Quasar Store | Quasar Store

Where Players Meet It#

Lottery Creator has four touch points, and it helps to know which is which from the start:

Where	Opened with	What it is for
The creator	`/lotterycreator`	Admins and creator jobs: placing, editing, teleporting to and deleting machines.
The machine	Target, or `E` / at the prompt

Section	What you set there
Vendor Settings	The label players see on the target, the prop, the payment account (cash, bank or black money), the scratch item it hands out and the ticket price.
Placement	Where the machine stands and which way it faces, set in the world.
Blip Settings	An optional map blip: its name, sprite, colour, scale (0.2 to 1) and position. Sprites and colours are picked from searchable lists with pictures.
Access Control	The jobs — and, per job, the grades — that may use the machine. Nothing selected means everyone.
Ownership	For sale and the purchase price. Shown only while player-owned machines are enabled.

Action	How
Edit	Pick it in the list, change the form and Save. The machine respawns for everyone; its owner, earnings and stock are kept.
Teleport	The teleport button on its card puts you beside it, to check it in person.
Delete	The delete button, then confirm. The machine disappears for everyone and its row is removed — owner, earnings and stock with it, and nothing is refunded.

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' },
}

State	Tickets	Notes
Server machine — no owner, not for sale	Sold	Unlimited tickets. The money leaves the economy.
For sale — no owner, listed	Not sold	Not in service: the only option is Buy machine.
Owned, with stock	Sold	Each ticket uses one unit of stock and pays the owner.
Owned, empty	Not sold	The ticket option disappears until the owner restocks.

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 },
}

Field	Meaning
`label`	What is printed on the square. Keep it in step with `amount`: the player reads the label, the script pays the amount.
`type`	`money` pays the amount; `none` is a losing square.
`amount`	What the square pays, in cash.
`chance`	Its weight. Weights are compared with each other, so they do not have to add up to 100 — the shipped ones add up to 89.7. Decimals are fine.

Section	What it does
Ticket price	What a ticket costs, inside `priceLimits` — $5 to $1,000 by default. Customers see the new price at once.
Ticket stock	Tickets loaded, out of `maxStock` (500). Restock loads more for `restockCost` per ticket ($5) from the owner's account — no item needed. Each sale uses one.
Available earnings	What sales have earned since the last collection. Collect pays it into the owner's account.
Figures	Tickets sold, total revenue before commission, and the commission rate.
Sell machine	Sells it back for `resaleRefund` of the purchase price (50%) plus any earnings not yet collected. Loaded stock is lost, and the machine goes straight back on sale. Hidden when `allowResale` is off.

On every ticket	Amount
The customer pays	The ticket price, from the machine's payment account.
The owner earns	The price minus the commission, rounded down — $27 of a $30 ticket at the default 10%.
The server keeps	The commission.
The prizes	Paid by the system — never out of the owner's earnings.

Control	What it does
Listed for sale · Purchase price	The machine's sale settings, the same ones the creator edits.
Evict owner	Removes the owner. Uncollected earnings and loaded stock are cleared without a refund. The machine goes back on sale only if `defaultForSale` is on; otherwise it becomes a server machine.

Part	What it shows or does
Wallet	The scratchcards you carry, the ticket price, and your cash and bank balances.
Buy	One or several tickets without visiting a machine, when `allowRemotePurchase` is on. They arrive in the inventory as ordinary scratchcards.
Scratch	Use a ticket on the phone; the prize is paid in cash, as at a machine. A card left half-scratched is waiting when the app is reopened.
Prizes	The prize table with every chance.
Recent winners	The last ten wins on the server, at machines and on phones.
History	Your last 50 phone cards, with your total won and spent.
Jackpot	A community figure that grows by 10% of every phone purchase. It is shown in the app; the script does not pay it out.

Setting	Default	What it does
`Config.Locale`	`'en'`	The language file from `locales/`.
`Config.Intl`	en-US · USD · 0 decimals	How amounts are formatted in the interface: number format, currency and decimals.
`Config.CreatorJobs`	police, ambulance	Jobs that may open the creator. `grade` is `false` for any grade, or a list such as `{ 3, 4 }`.
`Config.CreatorMoneyTypes`	Cash · Bank · Black Money	The payment accounts offered in the creator. Each `value` must be an account your framework knows.
`Config.SyncChunkSize`	15	How many machines are sent to a joining player per network message. Lower it on very large servers.
`Config.VendorDefaults`	$30 · money · scratchcard	The values a new machine starts with, and the price, account and item of phone purchases. Its `item` is the one that opens a card.
`Config.VendorProps`	3 models	The creator's prop list.
`Config.Ownership`	on	Player-owned machines — see the next table.
`Config.UseTarget`	auto	`true` when ox_target or qb-target is started. Set it to `false` to force the prompts.
`Config.VendorInteractDistance`	2.0	Range, in metres, of the target options and the prompts.
`Config.PossibleRewards`	6 rewards	The prize table.
`Config.Phone`	on · remote purchase on	`enabled` serves the Lottery app; `allowRemotePurchase` lets it sell tickets.
`ActionControls` · `CameraOptions`	—	The creator's key hints and camera-tool speeds. Placement itself uses left click, `Z` / `X` and the wheel, so these rarely need touching.
`Config.Debug`	`false`	Extra console output.
`Config.DisableSounds`	`false`	Mutes the interface's game sounds. The coin-scratch sound of the card still plays.
`Config.EnableInventoryShop` · `Config.EnableWinAnim` · `Config.WinAnim`	off	Present in the file but not used by this version.

Key	Default	What it does
`enabled`	`true`	The master switch.
`account`	`'bank'`	Pays for a machine and for restocks, and receives collected earnings and resale refunds.
`defaultForSale`	`false`	Whether a machine saved without sale settings is listed, and whether an evicted machine goes back on sale.
`defaultPurchasePrice`	25000	Purchase price of a new machine; editable per machine.
`maxPerPlayer`	2	Machines one player may own. `0` is unlimited.
`commission`	0.10	The server's cut of every ticket, from 0 to 1.
`allowResale`	`true`	Whether owners can sell their machine back.
`resaleRefund`	0.5	Share of the purchase price refunded on resale, from 0 to 1.
`priceLimits`	5 – 1000	Lowest and highest ticket price an owner may set.
`maxStock`	500	Most tickets a machine can hold.
`restockCost`	5	What the owner pays per ticket loaded.