Skip to main content
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 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.

Create your first NPC

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.
  2. Import your own Blockbench model.
  3. Add animation, sound and movement.
  4. Change an NPC for one player.
  5. Manage NPCs in your application.
Installation covers dependencies and authentication. Troubleshooting helps with invisible models, missing animation and loading errors. Use the API reference 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.