Troubleshooting

---

/create_minigame says "No permission"

The command is admin-gated. Either grant yourself the ACE:

add_ace identifier.discord:123456789012345678 command.create_minigame allow

Or add your identifier to cfg.hacks.adminWhitelist. Discord, license, steam and fivem all work. See Configuration.

For local testing you can also set both to empty:

cfg.hacks.adminAce       = ''
cfg.hacks.adminWhitelist = {}

Every command opens up. Never do this on a live server.

---

Nothing happens when I press E

Work through these in order:

1. Is the point live? Restart the resource and watch the console for the load count. If your hand-written entry in data/saved_minigames.lua is malformed, it is silently skipped.

2. Are you inside the radius? cfg.hacks.pointRadius defaults to 1.5 metres. Bump it while debugging.

3. Is the model streamed? Networked types (laptop_open, monitor) need the player near the spawn coords for the entity handle to resolve. Check the F8 console for waiting for entity warnings.

4. Is another script eating the key? cfg.hacks.pressKey is E (control 38) by default. If a menu script grabs E first, you never get the input.

---

The minigame does not open

Almost always the React bundle. Rebuild it:

cd web
npm run build

The bundle lands in build/. fxmanifest.lua points at build/index.html, so a stale bundle means a blank overlay.

If the bundle is fresh and the overlay is still blank, watch the F8 console for red errors. Missing minigame names come through as:

[rm_3dminigames] unknown minigame: myGame

Check the Minigames map in web/src/App.tsx.

---

Prop mode: the tablet is invisible

Two possibilities.

The stream asset is missing. Confirm stream/rm_tablet_02.ydr and stream/rm_tablet_02.ytyp are both present. Restart the resource and watch the console for couldn't stream asset warnings.

The tablet is drawn behind the player's arm. The default calibration in cfg.propPresets.tablet is dialled in for rm_tablet_02. If you swapped the model, adjust bbOffset, bbScaleX/Y, and attachOffset in small steps.

---

Monitor mode: the camera is inside the wall

Almost always the wrong camOffsetY sign. Y is local-forward on the prop. Negative Y puts the cam in front of the screen, which is what you want. Positive Y puts the cam behind. Flip the sign and try again.

If the framing is off centre, tweak camOffsetX and camOffsetZ after you have the depth right. renderMode = 'quad' presets also need bbOffset and bbScaleX/Y calibrated to the prop's local origin.

---

Monitor mode: every same-model prop in the map shows the minigame

Expected. AddReplaceTexture is model-global. If only one instance is placed per area this is fine.

If you need many identical monitors in the same scene, switch the type to renderMode = 'quad' in its monitor preset. The quad renderer draws onto that one entity only, so the others stay untouched. See the shipped tablet_wall type for a working example.

---

Backspace does not cancel

Two known cases.

A DUI input has focus. Prop and monitor placements forward keyboard input to the DUI. Once a text field takes focus, Backspace edits the field instead of cancelling. That is on purpose. Click outside the input or press Esc first.

The minigame swallows the key. Some minigames rebind Backspace for their own use (delete character, undo). In that case the minigame's own quit button is the way out.

---

Sync-scene props (USB, phone, laptop) do not spawn

The scene tables in cfg.hacks.types.fingerprint and cfg.hacks.types.laptop reference vanilla model hashes. If a mod removes them the scene fails silently. Verify with:

/spawnobject prop_phone_ing

If the object does not spawn, that model is missing from the client's game files.

---

/create_minigame saves the point but a restart forgets it

Check the console for auto-save errors. If cfg.hacks.autoSave = false, persistence is off by design. Otherwise the server needs write access to data/saved_minigames.lua, which txAdmin blocks in some read-only setups.

Also check the file itself is valid Lua. A parse error at load time skips the whole file, so a single trailing comma from a hand-edit can lose every saved point.

---

Networked laptop opens twice / anim glitches

This was a known issue in early builds and is fixed. The symptom was the open anim replaying every time the state bag fired. If you still see it, you are on an old build, update the resource.

If you customised applyStaticAnim in client/fingerprints.lua, verify that the "already playing" fast-path is still in place. Removing it brings the glitch back.

---

Reporting a bug

Include:

• The hack type and minigame name involved.

• Whether it reproduces with /test_minigame <placement> <name> outside a hack point.

• Console output from both F8 and the server console around the failure.

• If prop or monitor mode, whether other minigames work in the same mode.

That output usually pins the cause on the first read.