Troubleshooting

Notifications

The tool shows short toasts in the top-left when something fails or succeeds. Here's what each one means:

Toast	Meaning	Fix
measure failed: model_not_in_cdimage	The hash you selected isn't in the loaded game build.	Use a stock GTA prop, or make sure your custom DLC streaming pack is up.
measure failed: model_load_timeout	The model didn't finish loading in 4 s.	Try again; if it keeps failing, the asset is corrupt or your streaming is overloaded.
spawn failed: model_not_in_cdimage	Same cause as above, just hit by the spawner instead of the measurer.	Same fix.
spawn failed: model_load_failed	RequestModel never returned in 4 s.	Try again — usually a transient issue.
spawn failed: create_object_failed	CreateObjectNoOffset returned 0.	Very rare; usually means the prop is invalid even though it loaded.
invalid model name	You typed something that doesn't match ^[a-z0-9_\-]+$ or is over 80 characters.	Use only lowercase letters, digits, _ and -.
already in defaults: <name>	The name is already in Config.Models.	Just pick it from the list.
already added: <name>	The name is already in your custom list.	Same — pick it from the list.
not in game CD image: <name>	Custom model validation failed at IsModelInCdimage / IsModelValid.	Double-check the spelling and that the asset is streamed.
load timeout: <name>	Custom model didn't load within 2.5 s during validation.	Try again, or check your streaming setup.
not a prop/object: <name>	The hash is valid but is a ped, vehicle, weapon, or other non-object.	Use only prop_* / p_* / object hashes.
reset to auto-measured baseline	You hit Reset. The four values are back to the values from Measure.FromModel.	Informational.
saved: <name>	The active model's current values are stored in memory.	Informational — remember to export.
removed: <name>	You deleted a custom model.	Informational.

Common Issues

/board_calibrate does nothing

Possible causes:

• The resource isn't running.
• Another resource has stuck NUI focus.
• The command was registered after a syntax error earlier in the file.

Fix:

1. Check the resource is running:

   ensure f5_board_calibrate

2. Look at the F8 console for Lua errors mentioning f5_board_calibrate. The command only registers if the rest of the file parsed cleanly.

3. If a key is held or the cursor doesn't show up after running the command, run /board_calibrate again to toggle it off, then once more to reopen. Failing that, restart the resource.

Prop spawns but the wireframe doesn't show

Possible causes:

• The Wire toggle is off.
• The auto-measure put the wireframe inside the prop, hidden by geometry.
• No model is selected yet (the picker still says "No model selected").

Fix:

1. Look at the header chips — make sure the Wire dot is lit.
2. Walk around the prop. The wire is single-sided in appearance but visible from both sides; if you don't see it at all, it's likely sitting inside the prop. Bump surfaceForward up by a few 0.01 m clicks until the cyan rectangle pops out.
3. Click the picker bar at the top of the panel and pick a model from the list.

I can't shoot or punch while the panel is open

This is intentional. While the panel is open and a prop is spawned, the tool disables FiveM control IDs 24 (attack), 25 (aim) and 142 (melee attack alternate) every frame. Otherwise clicking buttons in the NUI would also fire your weapon. Close the panel to get controls back.

My saved models are gone after a restart

Saved snapshots and custom models live in client memory only. There is no database, no Save Resource Kvp, no server sync. They reset when you:

• Restart f5_board_calibrate.
• Restart the server.
• Disconnect and reconnect.

Always export before stopping. Once you've pasted the block into f5_board/config/config.lua, the values are persistent through f5_board instead.

"Export all" emits an empty block

Only models you have clicked Save model on will appear in the export — half-tuned values are not included. Open each model in turn, click Save model, then re-export.

If you only have one model saved and want to use Export all for the wrapper, that's fine — the block will contain just that one entry.

The mouse won't release for camera control

Camera mode requires holding the right mouse button — not a click. Press and hold RMB, look around, release to return the cursor. If RMB doesn't do anything:

• Check that the NUI panel actually has focus (it should — the panel opens with SetNuiFocus(true, true)).
• Make sure another resource isn't capturing RMB before the NUI sees it.

The textarea export is cut off

Browser autocomplete or scrollbar can hide text. Click into the textarea, press Ctrl+A to select all, then Copy to clipboard — that copies the full contents regardless of what's visible.

The prop spawns inside a wall

The spawn position uses placementInFrontOfPlayer (player coords + gameplay camera yaw, + 0.6 m on Z). If you're standing too close to a wall or in a tight room, the prop clips into geometry. Move into open space and press the Reposition button (circular arrow icon in the header) to re-spawn it.

Step multiplier resets to ×2 when I switch models

The multiplier is a UI-only setting — it's not part of the per-model state, but it does default to ×2 on resource start. Switching models doesn't change it; pressing 1, 2, 3, or 4 sets it to ×1 / ×2 / ×5 / ×10 respectively.

Lua / Console Errors

The tool has very few server-side moving parts (none, in fact — all scripts are client_scripts plus a shared config.lua). If you see Lua errors in console, they're almost always one of:

• A syntax error you introduced in config.lua.
• A natives error from running on a FiveM build older than what lua54 requires.
• An out-of-memory / stuck NUI from too many resources fighting for focus.

Strip your config.lua back to the shipped defaults and retry before assuming the tool is broken.