> ## 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.

# Commands

> End users don't get a chat command — bosses open the menu by walking up to a marker. There's exactly one admin command.

End users don't get a chat command — bosses open the menu by walking up to a marker. There's exactly one admin command.

## Admin

| Default           | Description                                                |
| ----------------- | ---------------------------------------------------------- |
| `/bossmenu_admin` | Opens the placement panel — place / list / delete markers. |

The command name is configurable via `Config.AdminCommand` in `config.lua`.

## Permissions

Admin access is granted if **any** of these match:

| Path                     | Effect                                                                            |
| ------------------------ | --------------------------------------------------------------------------------- |
| `group.admin`            | Can use `/bossmenu_admin`. *(Default — listed in `Config.Admin.acePermissions`.)* |
| `group.superadmin`       | Same.                                                                             |
| `bossmenu.admin`         | Same — provided for servers that want a dedicated ACE.                            |
| `command.bossmenu_admin` | Same — standard FiveM command ACE.                                                |
| Framework group          | `admin` / `god` / `superadmin` on QB / Qbox / ESX.                                |

Most txAdmin admins are `group.admin` by default and just work — no `permissions.cfg` edits needed.

### Dedicated ACE

If you want a dedicated ACE separate from `group.admin`:

```
add_ace group.admin bossmenu.admin allow
```

Then only members of `group.admin` get the boss-menu admin tool, even if the rest of your `permissions.cfg` grants them broader access elsewhere.

### Removing default access

To remove default `group.admin` access entirely, edit `Config.Admin`:

```lua theme={null}
Config.Admin = {
    acePermissions = {
        'bossmenu.admin',                  -- keep only the dedicated ACE
    },
    esxGroups = {},
    qbGroups  = {},
}
```

Then explicitly grant only the people you want:

```
add_ace identifier.license:abcd... bossmenu.admin allow
```

## Console output

Every boot prints:

```
[nex_bossmenu] Framework: qbx          -- detected core
[nex_bossmenu] Schema ready.           -- DB ready
```

Hire / fire / promote each log a single line with framework, actor, and target. Failed mutations log in **red** with the reason — so misconfig surfaces immediately instead of being swallowed.
