> 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/permissions-and-ranks.md).

# Permissions & Ranks

Jiffy Admin uses a rank-based permission system. Every action in the menu is gated to a minimum rank. Staff can only act on players with a lower rank than themselves.

***

#### Ranks

| Rank       | Power | Description                                                          |
| ---------- | ----- | -------------------------------------------------------------------- |
| **Helper** | 10    | Read-only access — view players, reports, coords, staff chat         |
| **Mod**    | 20    | Moderation tools — goto, bring, freeze, kick, warn, noclip, vehicles |
| **Admin**  | 30    | Full admin — bans, money, items, spectate, world controls, logs      |
| **Owner**  | 99    | Unrestricted — resources, delete warnings/reports, server settings   |

{% hint style="warning" %}
Higher power always wins. A rank 30 admin cannot act on another rank 30 admin unless `protectStaffHierarchy` is disabled in config.
{% endhint %}

***

#### Granting Ranks

Jiffy Admin supports three modes, set via `Config.Permissions.mode` in `config.lua`:

| Mode    | How it works                                                               |
| ------- | -------------------------------------------------------------------------- |
| `mixed` | Staff qualifies if **either** ACE **or** framework group matches (default) |
| `ace`   | ACE principals only                                                        |
| `group` | Framework groups only (QBCore/ESX)                                         |

***

**Via Framework Groups (QBCore / ESX)**

The default group mappings are:

| Rank   | QBCore Groups            |
| ------ | ------------------------ |
| Helper | `helper`                 |
| Mod    | `mod`, `moderator`       |
| Admin  | `admin`, `administrator` |
| Owner  | *(ACE only — see below)* |

Add a player to a group using your framework's normal method (QBCore: `SetPlayerPermissions`, txAdmin, etc.).

You can add or change which groups map to which rank in `config.lua` under `Config.Permissions.ranks`.

***

**Via ACE (server.cfg)**

Any rank can also be granted directly in `server.cfg`:

```
add_ace identifier.license:YOUR_LICENSE jiffyadmin.helper allow
add_ace identifier.license:YOUR_LICENSE jiffyadmin.mod allow
add_ace identifier.license:YOUR_LICENSE jiffyadmin.admin allow
add_ace identifier.license:YOUR_LICENSE jiffyadmin.owner allow
```

***

**Owner — ACE Only**

The Owner rank is **not granted by any framework group**. It must be set explicitly in `server.cfg`:

```
add_ace identifier.license:YOUR_LICENSE jiffyadmin.owner allow # Your Name
```

This is intentional — Owner unlocks destructive actions (resource management, deleting warnings/reports, server settings) and should never be granted automatically.

***

#### Per-Action Permission Reference

Every action maps to a minimum rank. These defaults can be changed in `Config.Permissions.actions` in `config.lua`.

| Permission                        | Default Rank |
| --------------------------------- | ------------ |
| Open menu                         | Helper       |
| View players                      | Helper       |
| View reports                      | Helper       |
| Claim / close reports             | Helper       |
| Copy coords (dev tools)           | Helper       |
| Staff chat                        | Helper       |
| Goto player                       | Mod          |
| Bring player                      | Mod          |
| Freeze player                     | Mod          |
| Heal player                       | Mod          |
| Revive player                     | Mod          |
| Adjust needs (hunger/thirst)      | Mod          |
| Add armour                        | Mod          |
| Clear blood / weapons             | Mod          |
| Kick player                       | Mod          |
| Warn player                       | Mod          |
| NoClip                            | Mod          |
| Spawn vehicle                     | Mod          |
| Delete vehicle                    | Mod          |
| Repair vehicle                    | Mod          |
| Entity inspector                  | Mod          |
| Ban / Unban player                | Admin        |
| Spectate player                   | Admin        |
| View clothing                     | Admin        |
| View inventory                    | Admin        |
| Give / set / remove money         | Admin        |
| Give items                        | Admin        |
| Set job / gang                    | Admin        |
| Revive all                        | Admin        |
| Godmode / infinite ammo / stamina | Admin        |
| Kill / set on fire                | Admin        |
| Clear weapons                     | Admin        |
| Upgrade vehicle performance       | Admin        |
| Change vehicle visuals            | Admin        |
| Give owned vehicle                | Admin        |
| Set weather                       | Admin        |
| Set time                          | Admin        |
| Delete / restore objects          | Admin        |
| View audit logs                   | Admin        |
| Ped model change                  | Owner        |
| Delete warnings                   | Owner        |
| Delete reports                    | Owner        |
| Start / stop / restart resources  | Owner        |
| Manage settings                   | Owner        |