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

# Overview

> A multi-framework boss menu for FiveM. Drop placeable, DB-driven access points on the map, gate them by job + boss grade, and let bosses manage their society's balance and roster from a single…

A multi-framework boss menu for FiveM. Drop placeable, DB-driven access points on the map, gate them by job + boss grade, and let bosses manage their society's balance and roster from a single panel.

Works on **ESX**, **QBCore**, and **Qbox** out of the box.

## In this section

* [Installation](/nex_bossmenu/installation)
* [Configuration](/nex_bossmenu/configuration)
* [Usage](/nex_bossmenu/usage)
* [Commands](/nex_bossmenu/commands)
* [Custom frameworks](/nex_bossmenu/custom-frameworks)
* [Troubleshooting](/nex_bossmenu/troubleshooting)

## What you get

* **Framework agnostic** — auto-detects `qbx_core`, `qb-core`, or `es_extended`. Every framework call goes through a single bridge so the same install runs unchanged across all three.
* **Society balance that actually works** on each framework
  * ESX → `addon_account_data` (auto-seeds missing rows)
  * QB / Qbox → Renewed-Banking / qb-management exports, with qb-banking fallback
* **Real hire / fire / promote**
  * Qbox fire calls `RemovePlayerFromJob` (drops the secondary job entry, not just demotes to unemployed)
  * QB / ESX use `SetJob('unemployed', 0)` and **verify** the change actually stuck (ESX's `setJob` silently swallows errors otherwise)
  * Self-fire and self-promote are blocked server-side
  * Cannot fire someone whose grade is a configured boss grade
  * Hire requires the candidate to be within `Config.HireDistance` of the boss at action time (re-checked, not just when the menu opens)
* **Two interaction styles** — `textui` (classic `[E]` prompt) or `target` (eye-target zone, auto-detects ox\_target → qb-target). If `target` is requested but no target script is started, falls back to `textui` so a misconfigured server still works.
* **Admin placement tool** — `/bossmenu_admin` places markers at your position, lists existing ones with distance + GPS + delete actions.
* **txAdmin-friendly perms** — `group.admin` and `group.superadmin` grant admin access out of the box, no `add_ace` needed.
* **Refund on failure** — failed society writes refund the player, never silently lose money.
* `escrow_ignore` on `config.lua` and the bridge files so you can tune behaviour and plug in custom framework support without source access to the rest of the resource.

<Info>
  Migrating from the original 3.x build? The schema bootstrap atomically renames `boss_menu_locations` → `nex_bossmenu` on first boot — your placed markers carry over with no manual SQL.
</Info>