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

# NPCs for your Minestom server

> Add a model to your server, animate it, and give individual players their own NPC experience.

Use the NPC library to put animated models in a Minestom world. An NPC can greet nearby
players, turn its head, move, or show a different animation to one player.
You can use it from Java or Kotlin in your own server. Grounds services are not required.

## Start with one visible NPC

The [first NPC guide](https://docs.grounds.gg/reference/libraries/npc/getting-started.md) gives you a small finished
model and its resourcepack. Add the library to your project, load the files, and place the
NPC in an existing instance. You do not need Blockbench or the model compiler to start.

> [card] [Create your first NPC](https://docs.grounds.gg/reference/libraries/npc/getting-started.md)
>
> Place a two-part bot in your own Minestom server using the supplied example files.

## How the pieces fit together

The **server content** describes the NPC's parts, positions and animations. Your server
loads it and creates the display entities.

The **resourcepack** supplies the graphics that Minecraft uses to draw those entities.
Players need the matching pack to see the model correctly. Loading a model on the server
does not send its pack to players.

The **model** is the reusable definition. An **NPC handle** controls one instance of that
model in the world. You can create several NPCs from the same loaded model.

## Continue with your own NPCs

1. [Create your first NPC](https://docs.grounds.gg/reference/libraries/npc/getting-started.md).
2. [Import your own Blockbench model](https://docs.grounds.gg/reference/libraries/npc/importing.md).
3. [Add animation, sound and movement](https://docs.grounds.gg/reference/libraries/npc/shared-npcs.md).
4. [Change an NPC for one player](https://docs.grounds.gg/reference/libraries/npc/personal-presentations.md).
5. [Manage NPCs in your application](https://docs.grounds.gg/reference/libraries/npc/integration.md).

[Installation](https://docs.grounds.gg/reference/libraries/npc/installation.md) covers dependencies and authentication.
[Troubleshooting](https://docs.grounds.gg/reference/libraries/npc/troubleshooting.md) helps with invisible models,
missing animation and loading errors. Use the [API reference](https://docs.grounds.gg/reference/libraries/npc/api-reference.md)
when you need exact types or units.

The guides use **NPC 2.0.0**, Java 25 and public Minestom `2026.10.07-26.2`.
Build integration, source builds and verification tools are covered separately in
[advanced workflows](https://docs.grounds.gg/reference/libraries/npc/advanced.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.