CustomNPCs
A powerful, configurable NPC plugin for Paper servers.
Looking for contributors!
If you're interested in contributing to the project, please reach out! I'm looking for help maintaining the project <3
✨ Features
🎨 Appearance
- Names longer than 16 characters — break vanilla's character limit
- MiniMessage color support — gradients, rainbow names, hex colors, and more
- Fully customizable skins — use any player skin or custom texture
- Armor & item display — equip NPCs with any gear you can imagine
- Multiline Holograms — Create NPCs with as many hologram lines as you'd like
⚡ Interaction Actions
Trigger actions when players interact with an NPC:
| Action | Description |
|---|---|
| Send Message | Send a custom chat message to the player |
| Display Title | Show a title/subtitle on screen |
| Action Bar | Display text in the action bar |
| Play Sound | Play any in-game sound |
| Run Command | Execute a command as the player or console |
| BungeeCord / Velocity | Send the player to another server |
| Teleport | Teleport the player anywhere |
| Give / Remove XP | Modify player experience |
| Give / Remove Potion Effect | Apply or clear potion effects |
| Follow Preset Path | Walk in a pre-recorded path |
Each action has a configurable delay and cooldown!
🧠 Behavior
- Look at players — NPCs track nearby players naturally
- Configurable idle direction — set a default look direction when not tracking
- Flexible persistence — choose between session-only NPCs (cleared on restart) or fully persistent NPCs that survive restarts
- Conditional Actions — Execute specific actions under certain circumstances
🌍 Translations
CustomNPCs supports multiple languages! If you speak a language other than English and want to contribute, join the translation effort on Crowdin:
Don't see your language listed? Send @foxikle a DM on Discord or open a ticket in the support server to request it.
🛠️ Developer API
Integrate CustomNPCs into your own plugins with the provided API.
| Resource | Link |
|---|---|
| GitHub Wiki | github.com/Foxikle/CustomNPCs/wiki |
| Plugin Wiki | docs.foxikle.dev |
| Javadocs | Javadoc (1.8.0) |
📊 Statistics
🐛 Support & Bug Reports
Encounter a bug or need help? Here's where to go:
- Discord — Fastest way to get support
- GitHub Issues — For confirmed bugs and feature requests
❤️ Support the Project
If CustomNPCs has been useful to you, consider supporting development!
Patreon · PayPal · GitHub Sponsors
CustomNPCs is open source. Contributions, translations, and feedback are always welcome.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Bug Fixes 1.8.2 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
paper
|
Download |
|
CustomNPCs 1.8.1 1.8.1 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
paper
|
Download |
|
CustomNPCs 1.8.0 1.8.0 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
paper
|
Download |
|
CustomNPCs 1.7.10 1.7.10 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
paper
|
Download |
|
CustomNPCs 1.7.10-pre2 1.7.10-pre2 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
paper
|
Download |
|
CustomNPCs 1.7.10-pre1 1.7.10-pre1 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2
|
paper
|
Download |
|
CustomNPCs 1.7.9 1.7.9 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
paper
|
Download |
|
CustomNPCs 1.7.8 1.7.8 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
paper
|
Download |
|
CustomNPCs 1.7.7 1.7.7 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
|
paper
|
Download |
|
CustomNPCs 1.7.6 1.7.6 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
paper
|
Download |
|
CustomNPCs 1.7.5 1.7.5 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
|
paper
|
Download |
|
CustomNPCs 1.7.5-pre8 1.7.5-pre8 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
|
paper
|
Download |
|
CustomNPCs 1.7.5-pre7 1.7.5-pre7 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
|
paper
|
Download |
|
CustomNPCs 1.7.5-pre6 1.7.5-pre6 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
|
paper
|
Download |
|
CustomNPCs 1.7.5-pre5 1.7.5-pre5 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
|
paper
|
Download |
|
CustomNPCs 1.7.5-pre4 1.7.5-pre4 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7
|
paper
|
Download |
|
CustomNPCs 1.7.5-pre3 1.7.5-pre3 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7
|
paper
|
Download |
|
CustomNPCs 1.7.5-pre2 1.7.5-pre2 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5
|
paper
|
Download |
|
CustomNPCs 1.7.5-pre1 1.7.5-pre1 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5
|
paper
|
Download |
|
CustomNPCs 1.7.4 1.7.4 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4
|
paper
|
Download |
|
CustomNPCs 1.7.3 1.7.3 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4
|
paper
|
Download |
|
CustomNPCs 1.7.2 1.7.2 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4
|
paper
|
Download |
|
CustomNPCs 1.7.1 -- HOTFIX 1.7.1 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4
|
paper
|
Download |
|
CustomNPCs 1.7 1.7 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4
|
paper
|
Download |
|
CustomNPCs 1.7-pre12 (Hotfix) 1.7-pre12 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3
|
paper
|
Download |
|
CustomNPCs 1.7-pre11 1.7-pre11 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3
|
paper
|
Download |
|
CustomNPCs 1.7-pre10 1.7-pre10 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3
|
paper
|
Download |
|
CustomNPCs 1.7-pre9 1.7-pre9 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3
|
paper
|
Download |
|
CustomNPCs 1.7-pre8 1.7-pre8 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3
|
paper
|
Download |
|
CustomNPCs 1.7-pre3 1.7-pre3 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1
|
paper
|
Download |
|
CustomNPCs 1.7-pre2 1.7-pre2 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6
|
paper
|
Download |
|
CustomNPCs 1.7-pre1 1.7-pre1 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6
|
paper
|
Download |
|
CustomNPCs 1.6.1 1.6.1 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4
|
paper
|
Download |
|
CustomNPCs 1.6.1-pre2 1.6.1-pre2 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4
|
paper
|
Download |
|
CustomNPCs 1.6.1-pre1 1.6.1 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4
|
paper
|
Download |
|
CustomNPCs - 1.6.0 1.6 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4
|
paper
|
Download |
|
CustomNPCs 1.6-pre5 1.6-pre5 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4
|
paper
|
Download |
|
CustomNPCs 1.6-pre4 1.6-pre4 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4
|
paper
|
Download |
|
CustomNPCs 1.6-pre3 1.6-pre3 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4
|
paper
|
Download |
|
CustomNPCs 1.6-pre2 1.6-pre2 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4
|
paper
|
Download |
|
CustomNPCs 1.6-pre1 1.6-pre1 |
1.20.3, 1.20.4
|
paper
|
Download |
|
CustomNPCs 1.5.2 1.5.2 |
1.20.2
|
paper
|
Download |
|
CustomNPCs 1.5.2-pre3 1.5.2-pre3 |
1.20.2
|
paper
|
Download |
|
CustomNPCs 1.5.2-pre2 1.5.2-pre2 |
1.20.2
|
paper
|
Download |
|
CustomNPCs 1.5.2-pre1 1.5.2-pre1 |
1.20.2
|
paper
|
Download |
|
CustomNPCs 1.5.1 - Bug Fix 1.5.1 |
1.20.2
|
paper
|
Download |
|
1.5 |
1.20.2
|
paper
|
Download |
|
CustomNPCs 1.4.2 1.4.2 |
1.20, 1.20.1
|
paper
|
Download |
|
CustomNPCs 1.4.1 1.4.1 |
1.20, 1.20.1
|
paper
|
Download |
|
Conditional Actions! (1.4) 1.4 |
1.20, 1.20.1
|
paper
|
Download |
|
CustomNPCs 1.3.2 1.3.2 |
1.20, 1.20.1
|
paper
|
Download |
|
CustomNPCs 1.3.1 1.3.1 |
1.20, 1.20.1
|
paper
|
Download |
|
1.3 |
1.20, 1.20.1
|
paper
|
Download |