Installation

​

Requirements

• FiveM server
• MySQL or MariaDB
• ox_inventory
• ox_lib
• oxmysql
• One of: qbx_core, qb-core, or es_extended (or none to run framework-less — set in config.lua)

​

Steps

1. Drop the nexdev_itemwhitelist folder into your resources, e.g. resources/[nex]/nexdev_itemwhitelist/.
2. (Optional) Import install.sql into your database. You can skip this — the nexdev_whitelist table auto-creates and auto-migrates on first start.
3. Add it to server.cfg after its dependencies:
   ensure ox_lib
   ensure oxmysql
   ensure ox_inventory
   ensure nexdev_itemwhitelist
   
4. (Optional) Open config.lua and adjust:
   • Config.Framework — auto (default), Qbox, QB, ESX, or none.
   • Config.NotifySystem — which notification backend to use.
   • Config.Commands — chat command names.
   • Config.AdminGroup — ACE group required for the menu and chat commands (default group.admin).
   • Config.Discord.webhook — paste your webhook here to log blocked attempts.
5. Grant yourself the admin group:
   add_ace identifier.steam:XXXXXXXXX group.admin
   
6. Restart your server.

​

Checking it worked

/whitelistmenu

lua print(GetResourceState('nexdev_itemwhitelist'))

​

Updating

1. Replace the resource files with the new version (keep your edited config.lua).
2. Restart the server.