Minecraft Plugin · Available

BotchedNPCs

Bring your server to life with NPCs that wander, patrol, and follow players, wearing any skin you like and carrying their own floating holograms.

Discuss on the forum
Website downloads
0
BotchedNPCs artwork
Platform
Paper
Minecraft
1.21.8+
Player skins
Paper 1.21.9+
Requires
Nothing else
Overview

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.

Highlights

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.

Everything included

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
Setup

Get started

  1. Place BotchedNPCs-2.3.1.jar in your server’s plugins folder.
  2. Start or restart the server.
  3. Create your first NPC with /bnpc.
  4. Set its skin, movement mode, and hologram text.
  5. Add waypoints if you want it to walk a patrol route.
Compatibility

Requirements

AreaSupport
Server softwarePaper
Mob-shaped NPCsPaper 1.21.8 and newer
Player skinsPaper 1.21.9 and newer
DependenciesNone (Citizens not required)
Updates

Latest version

Buying the plugin gets you every version below, plus future updates. Sign in with Discord and they are always in My purchases.

v2.3.1Latest

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
  • BotchedNPCs-2.3.1.jarUniversal build · Java 21 · 247.1 KBIncluded with purchase
Earlier versions (4)
v2.3.0

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.yml with clickable replies
v2.2.1

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 wander and /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 /guide or /bnpc guide
  • From 2.1.1: paid action chains finish after a rejoin and are refunded if the server stops mid-wait
  • BotchedNPCs-2.2.1.jarUniversal build · Java 21 · 170.9 KBIncluded with purchase
v2.1.0

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 list and paged clickable help
  • BotchedNPCs-2.1.0.jarUniversal build · Java 21 · 143.5 KBIncluded with purchase
v1.0.0

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 /bnpc won’t clash with /npc
  • BotchedNPCs.jarPlugin jarIncluded with purchase