Installation

Dependencies

Install and start these before legacy-bossmenu in server.cfg:

• legacy-lib — provides the framework/banking/inventory bridges (Framework, Banking, Inventory), Target, branding (GetAccentColor, GetAccentGradient, GetLogo), locale loading, and the Store persistence helper used for data/locations.json.
• ox_lib — used for lib.callback, lib.notify, and NUI callback plumbing.
• oxmysql — used for the SQL tables described below (and, if present, queried directly for chart data from legacy-banking/legacy-billing).

Steps

1. Ensure legacy-lib, ox_lib and oxmysql are installed and started before this resource.
2. Import the SQL schema to create the required tables:

mysql -u youruser -p yourdatabase < sql/schema.sql

This creates:

• legacy_bossmenu_locations — legacy storage for boss menu zones (only used for one-time migration into data/locations.json; not written to afterward).
• legacy_bossmenu_audit — action log (hire/fire/promote/demote/deposit/withdraw/stash_open/etc).
• legacy_bossmenu_hours — per-employee duty-time buckets, populated from the legacy-bossmenu:dutyHeartbeat event.

⚠️ Re-running sql/schema.sql on a live server drops and recreates all three tables, wiping audit history, tracked hours, and any legacy zone rows. Back up first if needed.

3. Review config.lua and set Config.Locale, Config.AdminGroups, Config.AdminCommand, Config.Stash, Config.WithdrawDestination and Config.Webhooks as needed.
4. Optionally adjust Config.SeedDefaultLocations / Config.DefaultLocations to control which boss menu zones are seeded on first start (only applies when there is no existing data/locations.json and nothing to import from the legacy SQL table).
5. Build the NUI frontend:

cd web
npm install
npm run build
# outputs to web/dist, loaded via nui://legacy-bossmenu/web/dist/

6. Add ensure legacy-bossmenu to server.cfg after its dependencies.

Getting players into a boss menu

There is no direct player command to open the boss menu. Access is only via:

• Walking up to a placed ox_target zone (created via Config.AdminCommand, default /bossmenu_admin), or
• Another resource calling the OpenBossMenu export / triggering legacy-bossmenu:openClient.

If Config.SeedDefaultLocations is false and no admin has placed a zone yet, no one can open any boss menu until one exists.