What is BotchedNPCs?
BotchedNPCs is a standalone NPC plugin for Paper servers. Place stationary shopkeepers and guides, or give NPCs real movement with Minecraft pathfinding so they wander an area, walk a patrol route, pace back and forth, or follow players around.
Give player-shaped NPCs any skin from a PNG, an image link, or a Minecraft username, or use mob shapes instead. Every NPC can carry its own formatted hologram text that moves with it. Routes, settings, and holograms are saved by the plugin and rebuilt after every restart.
What you can do
Real movement
Idle, wander, patrol, ping-pong, and follow modes powered by Minecraft pathfinding.
Any skin
Use a PNG file, a direct image link, or a Minecraft username. Skins are signed and cached on your server.
NPC holograms
Formatted floating text that follows its NPC and is rebuilt from plugin data, not left behind as world entities.
Standalone
No Citizens required. The /bnpc command avoids clashing with other NPC plugins.
Features
- Stationary and moving NPCs in player or mob shapes
- Idle, wander, patrol, ping-pong, and follow movement modes
- Patrol routes built from waypoints you set in-game
- Custom skins from PNG files, image links, or Minecraft usernames
- Skins signed through MineSkin and cached on your server
- Formatted hologram lines attached to each NPC
- Adjustable speed, wander radius, pause time, and name display
- Everything saved by the plugin and restored after restarts
- Works on its own, with no Citizens or other dependencies
Get started
- Place BotchedNPCs-2.3.1.jar in your server’s plugins folder.
- Start or restart the server.
- Create your first NPC with
/bnpc. - Set its skin, movement mode, and hologram text.
- Add waypoints if you want it to walk a patrol route.
Requirements
| Area | Support |
|---|---|
| Server software | Paper |
| Mob-shaped NPCs | Paper 1.21.8 and newer |
| Player skins | Paper 1.21.9 and newer |
| Dependencies | None (Citizens not required) |
Latest version
Buying the plugin gets you every version below, plus future updates. Sign in with Discord and they are always in My purchases.
Quest Log style
Works with Paper 1.21.8 – 26.3
- The Quest Log uses the shared Botched panel style and shows how many quests are active
- Included with purchase
Earlier versions (4)
Quests and discussions
Works with Paper 1.21.8 – 26.3
- Quests in
quests.yml: kill, gather, talk and fish steps, rewards, repeatable quests and quest chains - Branching conversations in
discussions.ymlwith clickable replies
Wandering NPCs that face where they walk
Works with Paper 1.21.8 – 26.3
- NPCs face the way they walk, so no more moonwalking
- NPCs can wander within a set radius:
/bnpc mode wanderand/bnpc radius <1-64> /bnpc move <npc>moves an NPC’s home to where you stand- From 2.2.0: player and staff guide books with
/guideor/bnpc guide - From 2.1.1: paid action chains finish after a rejoin and are refunded if the server stops mid-wait
- Included with purchase
Vault costs and safer settings
Works with Paper 1.21.8 – 26.3
- Cost click actions work with any Vault economy, not just BotchedEconomy
- NaN and Infinity are refused in coordinates and timings
- From 2.0.0: talking NPCs, greetings, click actions, per-player cooldowns, equipment, glow, scale, poses and per-waypoint pauses
/bnpc copy, clickable/bnpc listand paged clickable help
- Included with purchase
First release
Works with Paper 1.21.8+ (player skins need 1.21.9+)
- Stationary and mobile NPCs that wander, patrol, ping-pong, or follow players
- Player NPCs with custom skins from PNG files, image links, or Minecraft usernames
- Floating holograms attached to each NPC
- Standalone: no Citizens needed, and
/bnpcwon’t clash with/npc
- Included with purchase
Screens










