Studios
Minigamesmini-2.jpg

Troubleshooting

FreeMinigamesStandalone
PAGE 05 OF 08  ·  EXAMPLES → TROUBLESHOOTING → COMMANDS & EXPORTSdocs.glitchstudios.dev
Browse docs

An export returns false straight away#

Another game is still running. Check IsBusy() before you start one. If a resource stopped mid-game, the watchdog frees the lock within 2 seconds. A game that runs longer than 10 minutes is also ended.

Players get no XP#

Check that a resource named in config.XP.Resources is started, that the game is in config.XP.Games with an amount above 0, and that the call did not pass { xp = false }. Opt-in games need { xp = true }. A win does not count if it is shorter than MinDuration (or the game's entry in MinDurations), comes within the 15 second cooldown, or goes past 20 awards in the last hour. With RequireServerSession = true, a client-reported win only counts after your server called OpenXPSession for that game.

The server console says XP is client reported#

That line prints once at start when ClientReported = true and RequireServerSession = false, which is the package default. It is a reminder that a modified client can claim wins up to the hourly cap. If hacking XP buys more than perks on your server, switch to one of the stricter modes in XP and Perks.

lib.skillCheck still shows the ox_lib UI#

The redirect needs the ox_lib patch in Commands & Exports. Every ox_lib update removes it.

No keycap HUD appears#

With config.KeybindDisplay = 'auto' the HUD comes from glitch-uiElements or ox_lib text UI. Start one of them before this resource, or set 'standalone' to always use ox_lib.

The panels use the wrong font#

The fonts ship in ui/fonts. If you moved or renamed that folder, put it back and restart. Only the Latin character set is bundled, so other alphabets fall back to system fonts.

The console says a model, anim dict or scaleform did not load#

Loading gives up after 5 seconds. This usually means the client is still streaming assets after joining. Try again after a moment.

The drill prop does not appear#

Fleeca and Plasma Drilling spawn the drill as a networked prop from the client. If your server uses entity lockdown to block client-created entities, the prop may not spawn. Allow client entities for players, or expect the drill to run without a visible tool.

Game exports fail after renaming the folder#

Other resources call exports['glitch-minigames']. Keep that exact folder name.

Getting help#

Open an issue on the GitHub repository. Include the resource version, your framework, which optional resources you run, the steps to reproduce, and any server or F8 errors.