> For the complete documentation index, see [llms.txt](https://jiffyjrdevelopment.gitbook.io/jiffyjrdevelopmentdocs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jiffyjrdevelopment.gitbook.io/jiffyjrdevelopmentdocs/jiffy-jr-development-docs/jiffy-admin-menu/troubleshooting-and-faqs.md).

# Troubleshooting & FAQs

***

#### The menu won't open

**Check these in order:**

1. Make sure `jiffy-admin` is ensured in `server.cfg` **after** `ox_lib` and `oxmysql`
2. Open F8 and look for any `[jiffy-admin]` errors in red
3. Confirm you have at least Helper rank — the menu won't open for players with no rank
4. Try the command directly: `/admin` or `/jadmin`
5. If you're on QBCore and the command conflicts with another resource (like `qb-adminmenu`), set `skipQbDuplicates = false` in `config.lua` or remove the conflicting resource

***

#### I have no rank / the menu says I'm not authorized

* Confirm your rank is granted correctly — see **Permissions & Ranks**
* If using framework groups: make sure `Config.Permissions.mode` is `'mixed'` or `'group'`, and that the group name matches exactly what's in `Config.Permissions.ranks`
* If using ACE: confirm the `add_ace` line is in `server.cfg` and the server has been restarted since adding it
* Type `add_ace` lines use `identifier.license:` — make sure you're using your **Rockstar license**, not Steam or Discord

***

#### Owner rank isn't working

> Owner is ACE-only. No framework group (including `qbcore.god` or `superadmin`) grants it automatically. You must add this to `server.cfg`:

```
add_ace identifier.license:YOUR_LICENSE jiffyadmin.owner allow
```

***

#### Webhooks aren't sending

1. Make sure the URL is pasted correctly in `editable/webhooks.lua` — no extra spaces, no missing `https://`
2. Discord webhooks require the full URL from: Channel Settings → Integrations → Webhooks → Copy Webhook URL
3. Check resolution order — if you set a `categories.default` URL but left `categories.punishments` blank, bans will still go to default. If you set `actions.ban` to a different URL, that wins over everything
4. Check the server console — if the webhook fails, FiveM will print a HTTP error
5. Make sure `Config.Logging.database = true` is not the only thing set — webhooks are separate from database logging

***

#### SQL errors on startup

* Make sure you imported `sql/jiffy_admin.sql` into the correct database
* Confirm `mysql_connection_string` in `server.cfg` points to the right database
* oxmysql must be ensured before `jiffy-admin`
* If you see "table doesn't exist" errors, the SQL import didn't run — try importing again via HeidiSQL or phpMyAdmin

***

#### Bans/warnings aren't saving

* `Config.Logging.database` must be `true`
* The SQL tables must exist (see above)
* Check the server console for any MySQL errors when a ban/kick/warn is issued

***

#### Vehicle spawns but I can't drive it / hotwire prompt appears

> Jiffy Admin sets `SetVehicleNeedsToBeHotwired` to false on spawn. If your vehicle keys resource re-applies a hotwire requirement on vehicle entry, disable that setting within the keys resource config. Jiffy Admin does not integrate with vehicle key resources — vehicles spawned by admins are intended to be immediately driveable.

***

#### NoClip isn't working

* Confirm you have at least Mod rank (`jiffyadmin.noclip` = Mod by default)
* If another resource is blocking noclip controls, check for conflicting keybinds
* NoClip is server-logged — if the toggle fires but nothing happens client-side, check the F8 console for client errors

***

#### Staff can act on other staff / rank protection

> By default `protectStaffHierarchy = false`, meaning staff of equal rank can act on each other. Set it to `true` in `Config.Permissions` to prevent this — staff will only be able to act on players with strictly lower power than themselves.

***

#### The NUI (menu UI) is a black screen

* Make sure `web/dist/` exists and contains `index.html` and the `assets/` folder. If it's missing, the NUI was not built.
* If you're a developer editing the source: run `pnpm install` then `pnpm build` inside the `web/` folder
* If you purchased the resource and `web/dist/` is missing, re-download from Tebex

***

#### A feature is greyed out / disabled

> Every button in the menu checks your rank against the required permission. If a button is greyed out, your rank doesn't meet the minimum. Check the **Per-Action Permission Reference** table on the Permissions & Ranks page to see what rank is required, then confirm your rank is granted correctly.

***

#### How do I add more ranks?

> Add a new entry to `Config.Permissions.ranks` in `config.lua` with a unique name, power level, and groups/ACE:

```lua
supermod = {
    power = 25,
    groups = { 'supermod' },
    ace = { 'jiffyadmin.supermod' }
},
```

> Then set any actions to `'supermod'` in `Config.Permissions.actions`. The system reads power levels dynamically — no hardcoded rank names anywhere in the core code.

***

#### Can I use this without QBCore?

> Yes. Set `Config.Framework = 'standalone'` and use ACE-only permissions (`Config.Permissions.mode = 'ace'`). Framework-specific features (job/gang setters, inventory, clothing) will gracefully disable themselves if no supported framework is detected.