BlockfolkNPCs that feel part of the world

Create, customize, route, script, and give AI-controlled behaviour to persistent fake-player NPCs on Paper.

Get started

Explore features

🧑‍🌾

Persistent NPC presets

Reusable definitions, multiple spawned instances, skins, equipment, names, and visual properties.

🧭

Routes & locations

Build walking loops in-world and save named global destinations for behaviour and AI actions.

⚙️

Behaviour routines

Compose ordered actions for interactions, proximity, combat, time, waypoints, and custom events.

⚔️

Configurable combat

Health, respawning, aggression, targets, alliances, loot, experience, and nearby boss bars.

✨

Optional AI control

OpenRouter-powered conversation and validated actions with configurable perception and memory.

🖱️

GUI driven

Administer the system in Minecraft instead of hand-authoring NPC data files.

What is Blockfolk?

Blockfolk is a fake-player NPC system for Paper 26.2 servers. Almost all day-to-day administration happens through inventory menus: create a preset, configure it, place one or more instances, then attach routes and behaviour.

The deterministic behaviour system works on its own. AI behaviour is an optional layer for servers that want contextual conversations and model-selected actions.

A quick look

A Blockfolk NPC responding to nearby chat

Start with installation and your first NPC, or use the sidebar to jump directly to a feature.