> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexdevelopment.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fixes for common NEX Anim Pos issues.

If something's wrong, check your **F8** console and **server console** first — filter for `nex_animpos` and `ox_lib`.

## Common issues

| Problem                                              | Fix                                                                                                                                                                                                                                                                            |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Script errors on start mentioning `@ox_lib/init.lua` | `ox_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 nothing                              | You'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 resource           | Rename it via `Config.Command` in `shared/config.lua` and restart the resource.                                                                                                                                                                                                |
| `V` or `F` don't respond                             | These 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 around                             | You 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 panel        | Movement is suspended while you're editing a value in the panel. Click off the field and movement resumes.                                                                                                                                                                     |
| "Reached the maximum distance" warning               | You 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 away                    | The fly-cam is tethered to `Config.Camera.free.maxDistance` (default `30.0` m) from the start point. Raise it if needed.                                                                                                                                                       |
| UI is blank                                          | The 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 large                             | Adjust `Config.UI.scale` (bump for 1440p+, lower for 1080p).                                                                                                                                                                                                                   |
| Text shows locale keys or the wrong language         | The 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 `X`        | That'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 console                     | That'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](/general/support).