Common issues

Fixes for common Frozen Christmas Lottery problems: ticket items, item pictures, admin access, prizes, advent doors and the grand draw.

On this page

Check the server console first. On start the script prints what it found:

[frozen_xmaslottery] framework: esx | inventory: ox
[frozen_xmaslottery] storage: oxmysql
[frozen_xmaslottery] ready: 4 lotteries, 1 kiosks. Admin menu: /xmasadmin

If the framework or inventory is wrong, set it in Configuration.

Using a ticket item does nothing

  • The item isn't set up as usable. With ox_inventory, the item needs server = { export = 'frozen_xmaslottery.useTicket' }. With QBCore, it needs useable = true. See Installation.
  • The script starts before your framework or inventory. Put ensure frozen_xmaslottery below them in server.cfg.
  • No lottery uses that item. In /xmasadmin → Lotteries, check the lottery's Ticket item is exactly the item's name.
  • The lottery is disabled or outside its dates. The player gets "This lottery is closed right now."
  • You renamed the folder. The item export calls frozen_xmaslottery, so the folder must keep that name.

"The item … is not registered in your inventory"

The lottery's ticket item doesn't exist in your inventory yet. Add it (see Installation), restart the inventory, then the script. The admin menu also shows a warning next to any prize or ticket item it can't find.

Item pictures are missing

The script looks for item pictures in your inventory's image folder.

  • Copy the four ticket pictures from [IMAGES] into that folder.
  • With an inventory the script doesn't know, set the folder in Config.ItemImages (see Configuration).
  • Or give a prize its own Picture in the lottery editor.

"You are not allowed to use this" on /xmasadmin

The player isn't an admin for the script. Either:

  • add their group to Config.AdminGroups (default god, superadmin, admin), or
  • add add_ace group.admin frozenlottery.admin allow to server.cfg and make sure the player is in group.admin.

/xmaslottery says "Visit a Christmas Lottery kiosk to play"

Open from anywhere is off in Settings, so players can only open the lottery at a kiosk. Admins can always use the command. Ticket items work anywhere either way.

A player didn't get their prize

Prizes are never lost. If the inventory was full, or the player left mid-game or was offline, the prize is waiting. It's given when they make room and open the lottery, or the next time they join. The dashboard's Prizes waiting shows how many are waiting.

"Finish your current ticket first"

A player plays one ticket at a time. If a game window was closed without finishing, the ticket is finished for them after 90 seconds, and the next one can start.

"The lottery is still starting, try again in a moment"

The script is still loading its data after a (re)start. Wait a few seconds.

"Tickets for this lottery can only be found, not bought"

The lottery is set to Only from the item. To sell it at the booth, switch it to Players can buy in its Tickets & price settings.

The advent door says "No peeking!" or a door can't be opened

The calendar uses the server's date. Check the server's clock and time zone, and the calendar's Month. Doors from earlier days can only be opened when Missed days is set to Can be opened later.

The grand draw didn't happen

  • Enabled must be on.
  • Draw time must be set. Empty means ticket sales are closed and nothing is drawn.
  • The draw time uses the server's clock, which may be in another time zone than yours.
  • The script checks every 15 seconds, so a draw can start up to 15 seconds after the set time.
  • If nobody bought a ticket, nothing is drawn and the pot rolls over.

"The currency can't change now" on the grand draw

Tickets were already sold this round in the old currency. Wait for the draw, or press Cancel round & refund, then change it.

The vendor doesn't appear

Kiosks only appear when a player is near them. If the ped model in the kiosk row doesn't exist, the default s_f_y_shop_mid is used. Check the kiosk's position by pressing its teleport button.

Everything went back to the defaults

You probably switched storage, for example after installing oxmysql. KVP and oxmysql don't share data. Set Config.Storage back to the old one to get your data back.

The fonts look different

The booth's fonts load from Google Fonts. If a player's game can't reach Google Fonts, a standard font is used instead. Everything still works.

Still stuck?Ask on our Discord