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

# Troubleshooting

> If something's not working, check the F8 console (client) and your server console, filtered for [nex_hotels]. Most issues print a clear error there.

If something's not working, check the **F8** console (client) and your **server console**, filtered for `[nex_hotels]`. Most issues print a clear error there.

## Common issues

| Problem                                           | Fix                                                                                                                                                                                                  |
| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Hotel doesn't show up after I created it          | Almost always a wrong `Config.Framework`. Make sure it matches your actual core resource.                                                                                                            |
| Players fall through the map when entering a room | The MLO or IPL for that hotel isn't streamed on your server. You need to own and load the matching interior — see [pre-configured hotels](/nex_hotels/installation#pre-configured-hotels) for links. |
| Door doesn't lock — it just opens                 | The door object name is wrong. Use the door picker in `/hoteladmin` (left-click a door prop in the world to auto-fill it).                                                                           |
| Money is charged but the rental doesn't activate  | Wrong `Config.Framework`, or `nex_hotels` is starting before your core resource. Check `server.cfg` order.                                                                                           |
| `/hoteladmin` does nothing                        | You're not in an admin group. Use `add_principal identifier.<your-id> group.admin` or join your framework's admin group.                                                                             |
| Recovery locker is empty after checkout           | Items take a second or two to transfer. If they never appear, check your `ox_inventory` log.                                                                                                         |
| Front-desk ped doesn't spawn                      | The model name is invalid or unloaded. Try a vanilla model like `s_m_m_doctor_01` to confirm, then try yours.                                                                                        |
| `ox_target` interactions don't appear             | Either `ox_target` isn't started, or `Config.Interact = 'textui'`. The doors always use the keycap regardless.                                                                                       |
| "Insufficient funds" but I have money             | `Config.PaymentAccount` is your primary, and the other is used as a fallback. The rental is only refused if **neither** has enough.                                                                  |
| Expired rental wasn't evicted                     | The eviction sweep runs every 60 seconds by default. Wait a minute. If it never happens, check the server console for boot errors.                                                                   |
| Bundled SQL import fails with `Duplicate entry`   | The hotel already exists. Either delete it from `/hoteladmin` first, or the import is fine to re-run on supported MySQL/MariaDB versions.                                                            |

## Before opening a support ticket

Please include:

1. Your `Config.Framework` value.
2. Your FiveM artifact build number.
3. Whether it's a fresh install or after a config change.
4. Server console output filtered for `[nex_hotels]` from when the issue happens.
5. F8 console output filtered for `[nex_hotels]`.
6. Whether you used a bundled SQL import or built the hotel via `/hoteladmin`.

See [Support & contact](/general/support) for how to reach us.