Skip to main content
If something’s wrong, check your F8 console and server console first — filter for nex_animpos and ox_lib.

​
Common issues

ProblemFix
Script errors on start mentioning @ox_lib/init.luaox_lib isn’t installed or isn’t started. Install it and make sure ensure ox_lib comes before ensure nex_animpos in server.cfg.
/animpos does nothingYou’re in a vehicle — the command is ignored there. Otherwise the resource didn’t start: from F8, lua print(GetResourceState('nex_animpos')) should print started.
Command name clashes with another resourceRename it via Config.Command in shared/config.lua and restart the resource.
V or F don’t respondThese are per-player FiveM key bindings (animpos_camtoggle, animpos_recenter). Check Settings → Key Bindings — another resource may use the same key, or the player rebound them. Changing Config.Keybinds doesn’t move the key for players who already joined once.
Camera won’t look aroundYou have to hold Right Mouse to capture the view. If another resource fights for NUI focus, close it or pause the session via the DisableCommands export.
Keyboard movement stops while using the panelMovement is suspended while you’re editing a value in the panel. Click off the field and movement resumes.
”Reached the maximum distance” warningYou hit the Config.MaxDistance ring (default 5.0 m from the start). Raise it in shared/config.lua if you need more room.
Free-fly camera stops moving awayThe fly-cam is tethered to Config.Camera.free.maxDistance (default 30.0 m) from the start point. Raise it if needed.
UI is blankThe resource’s UI files are missing or incomplete — re-download from your purchase and re-upload the whole folder, then restart the resource.
UI too small / too largeAdjust Config.UI.scale (bump for 1440p+, lower for 1080p).
Text shows locale keys or the wrong languageThe language follows the ox:locale convar (setr ox:locale "en"). Make sure a matching file exists in locales/. Only en.json ships by default.
Ended up back at the start after pressing XThat’s by design — cancel always restores your starting spot because the placed position has no collision. Use Confirm (G) to keep the spot.
Update box in the server consoleThat’s the built-in version check telling you a newer release exists. It’s informational — grab the update from your keymaster.

​
Stuck or frozen character

Every exit path (cancel, confirm-then-exit, death, entering a vehicle, resource stop) funnels through the same cleanup, which unfreezes your character and removes the anchor. If a crash ever leaves someone stuck, restart nex_animpos — the stop handler tears the session down safely.

​
Before opening a support ticket

Please include:
  1. Your FiveM artifact build number and ox_lib version.
  2. F8 and server console output mentioning nex_animpos.
  3. Whether the issue is reproducible from a fresh resource start.
  4. What you did and what you expected to happen.
See Support & contact.