> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humalike.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI NPC for FiveM

> Add persistent, voice-enabled AI characters to a FiveM server.

HumaLike adds voice-enabled AI characters to FiveM. NPCs can hold conversations,
remember players, react to events in the world, move with players, enter vehicles,
and perform gameplay actions.

The released `humalike` resource runs standalone. Optional integrations add
framework identity, jobs, inventory, dispatch, roleplay events, and target UI
without modifying the resource.

<CardGroup cols={2}>
  <Card title="Install in minutes" icon="rocket" href="/ai-npc/quickstart">
    Register a server, install the resource, and create your first NPC.
  </Card>

  <Card title="Open the dashboard" icon="gauge" href="https://humalike.ai/ai-npc">
    Manage servers, NPCs, voices, worlds, and usage.
  </Card>

  <Card title="Configure your server" icon="sliders" href="/ai-npc/configuration">
    Select integrations and customize labels, injuries, and gameplay behavior.
  </Card>

  <Card title="Build a bridge" icon="bridge" href="/ai-npc/integrations/custom-bridge">
    Connect a custom framework without editing HumaLike.
  </Card>
</CardGroup>

## NPC types

| Type        | How it appears                                                                      | Best for                                                             |
| ----------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| **Static**  | HumaLike creates and maintains a persistent ped at configured coordinates.          | Named characters, businesses, quest characters, and fixed locations. |
| **Ambient** | HumaLike assigns a character to a compatible population ped already created by GTA. | A living population distributed naturally around players.            |

Both types use the same conversation, memory, voice, and action systems.

## What the resource handles

* NPC spawning, binding, movement, actions, injuries, and world observations.
* WebRTC proximity voice, vehicle audio, and direct conversation targeting.
* Automatic framework and inventory discovery.
* Built-in interaction prompts with optional `ox_target` and `qb-target` support.
* Versioned provider APIs for custom server integrations.

## Requirements

* A current FXServer build with OneSync enabled.
* A publicly reachable server callback address.
* A HumaLike AI NPC account and server license.
* A working player microphone for voice conversations.

No roleplay framework, voice resource, target resource, or inventory resource is
required for standalone use.

## Next

* [Quickstart](/ai-npc/quickstart) — talk to your first NPC.
* [Installation](/ai-npc/installation) — production installation and updates.
* [Framework compatibility](/ai-npc/frameworks) — ESX, QBCore, Qbox, and standalone.
* [NPC turns](/npc-turns) — plans, metering, and the free trial.
