-
Install and start
ox_lib3.x. -
Copy the
ncore_npc_profolder intoresources/[ncore](create the[ncore]folder if you do not have one yet). -
Add these lines to
server.cfg, after your framework, inventory, target and any other nCore resources:server.cfgset onesync on ensure ox_lib ensure ncore_npc_pro -
Admin tools: grant the ace in
server.cfg, and every player ingroup.admingets the F12 admin panel and the dev commands, with debug mode off:server.cfgadd_ace group.admin ncore_npc_pro.dev allowDebug mode (debug visuals, and the admin tools for every player) ships off. Turn it on only on a staging server and remove the line again before going live:
server.cfgsetr ncore_npc_pro:debug trueThe convar wins over
Config.debuginshared/config.lua, so you do not need to edit the config.falseforces debug off. -
Optional: to keep NPC memory and reputation in MySQL instead of FiveM's KVP store, ensure
oxmysqlbeforencore_npc_proand setConfig.persistence.backend = 'sql'inshared/config.lua. The tables insql/ncore_npc_pro.sqlare created automatically on start. If you switch from KVP later, existing trust, memory, errands and bounty board data are copied into MySQL once, the first time each one is loaded and has no MySQL row. Switching back from MySQL to KVP copies nothing. -
Restart the server and check the console for the
[ncore_npc_pro bridge]line showing the detected framework, inventory, notify and target.
Important#
- Required:
ox_lib3.0+. On Qbox, a resource namedox_inventoryis also required.ncore_inventoryships one, a Qbox compatibility layer for ncore_inventory. - Optional, detected automatically:
qbx_core/qb-core/es_extended(standalone works without a framework),ncore_inventoryor your framework's inventory resource,ox_target/qb-target(without one, the built-in look-at + E interaction is used),ncore_hud, ox_lib or the framework's notifications,ncore_chat,ncore_touchgrassandoxmysql. - Do not rename the
ncore_npc_profolder. - Keep OneSync on; server-side robbery validation depends on it.
- If you run a police job or dispatch resource, check the console on start. NPC Pro stops forcing GTA's police and dispatch settings while one from
Config.engine_police.step_aside_foris running and prints a line naming it. Add your resource to that list if it is not there, or setConfig.engine_police.force_on = trueto keep NPC Pro in charge. - The ace
ncore_npc_pro.devis the only permission for the F12 admin panel and its actions; the server checks it again on every admin action that reaches it. Players without it get nothing on F12. Every player opens the player menu (dialog layout) with/npcpro. - More console output while you set it up:
setr ncore_npc_pro:verbose_server_log 1. Remove it again on a live server.
