Home

NpcAPI (Paper)

A simple API to create and manage customizable Minecraft NPCs on Paper.

What you get

• Create and manage NPCs (NPC)
• Customize appearance/behavior via NpcOption
• React to interactions via NpcInteractEvent / NPC#setClickEvent(...)
• Persist NPCs to disk via NPC#save() and auto-load via NpcApi initialization
• Let NPCs walk using PathfindingUtils + NPC#walkTo(...)
• Placeholder support (if PlaceholderAPI is installed) for dynamic names/skins

Requirements

• Java 21+
• Paper 1.21.x (this repo targets Paper dev bundle 1.21.11-R0.1-SNAPSHOT)

Pages

• Installation
• Quickstart
• NPC Basics
• Options
• Skins
• Events
• Pathfinding & Walking
• Persistence & Loading
• Troubleshooting