> For the complete documentation index, see [llms.txt](https://arctic-development.gitbook.io/arctic-development/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://arctic-development.gitbook.io/arctic-development/scripts/npc-manager.md).

# NPC Manager

The **NPC Manager Script** for FiveM is the one-stop solution for managing NPCs via in game, this script supports client sided changing, as well a global sided changing, This script has built in discord logging via webhooks (Optional) and has Ace Permissions!

***

<figure><img src="/files/7zh66Nef7GwSoeKKYldi" alt=""><figcaption></figcaption></figure>

1. [VeniceNotify](https://forum.cfx.re/t/codem-advancednotifysystem/4812202)
2. [OkOkNotify](https://forum.cfx.re/t/okoknotify-standalone-paid/3907758)
3. [Ox\_lib](https://github.com/overextended/ox_lib)
4. Chat
5. GTA

***

<figure><img src="/files/SpMscVNMZqsjkgvXax7q" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/M0oaP67fNCndmMQ4vx9S" alt=""><figcaption><p>In Game Preview</p></figcaption></figure>

<div align="center"><figure><img src="/files/6k3oD3DOsqbX3gAUiGDF" alt=""><figcaption><p>Preview For the Client / Global NPC Traffic / Ped Density</p></figcaption></figure></div>

<figure><img src="/files/YajWl1tGyRwM7pDKQXtm" alt=""><figcaption><p>Manage AI Emergency Service Menu</p></figcaption></figure>

<figure><img src="/files/n9aKcB4pmDesOUgQAckG" alt=""><figcaption><p>Global NPC Updates Discord Logging</p></figcaption></figure>

<figure><img src="/files/37E4Sn2skDmQzZHyHKXR" alt=""><figcaption><p>Emergency Service Toggle On Discord logging</p></figcaption></figure>

<figure><img src="/files/iaDN7ZW7xTsTwvzPMHUk" alt=""><figcaption><p>Wanted Level System Toggle On Discord Logging</p></figcaption></figure>

<figure><img src="/files/3pCSfgYepynuey43WX7G" alt=""><figcaption><p>Emergency Service Toggle Off Discord logging</p></figcaption></figure>

<figure><img src="/files/kGjOBIIVkqcEQBw6d07k" alt=""><figcaption><p>Wanted Level System Toggle On Discord Logging</p></figcaption></figure>

***

```lua
Config = {
-----------------------------------------------------------------------------------------------------
-- Default NPC Configurations
-----------------------------------------------------------------------------------------------------
pedFrequency = 1.0, -- Default Pedestrian Density
trafficFrequency = 1.0, -- Default Traffic Density
-----------------------------------------------------------------------------------------------------
-- Notification Configurations
-----------------------------------------------------------------------------------------------------
NotifyType = 'Ox_lib', -- Options: VeniceNotify, OkOkNotify, ADNotify, Ox_lib, Chat, GTA
notifyTime = 10000, -- Default notification time in milliseconds
-----------------------------------------------------------------------------------------------------
-- ACE Permission Configurations
-----------------------------------------------------------------------------------------------------
UseAcePermission = false, -- Enable/Disable ACE permissions
npcPermission = "", -- ACE permission for the NPC command
globalChangePermission = "", -- ACE permission for the Global NPC Change
globalwantedlevelPermission = "", -- ACE permission for the Global Wanted Level Change
-----------------------------------------------------------------------------------------------------
-- Discord Role Locking Configurations
-----------------------------------------------------------------------------------------------------
UseDiscordRoleLocking = true, -- Enable/Disable Discord role-based permissions via Badger Perms API
DiscordRoleMenuPermission = "DISCORDROLEID", -- Discord role ID for NPC menu access
DiscordRoleGlobalPermission = "DISCORDROLEID", -- Discord role ID for global config changes
DiscordRoleGlobalWantedLevelPermission = "1399219782422761632", -- Discord role ID for global wanted level changes
-----------------------------------------------------------------------------------------------------
-- Discord Logging Configurations
-----------------------------------------------------------------------------------------------------
WebHookLogging = true, -- Enable/Disable Discord WebHook Logging
WebHookURL = "Your webhook link" -- The URL for the Discord webhook
}

return Config
```

{% hint style="success" %}
Downloads

\[PAID | Open Source] [Official Store Link](https://arcticdevlabs.com/package/script?script=NPC-Manager)
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://arctic-development.gitbook.io/arctic-development/scripts/npc-manager.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.