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.
Similar projects
Plugin →VeinMiner
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
99.3MSueta
Simple Voice Chat
A working voice chat in Minecraft!
76.8MSueta
Chunky
Pre-generates chunks, quickly and efficiently
18.4MSueta
VeinMiner Enchantment
Veinminer Addon - Adds vineminer enchantment to enchanting tables. Only tools with the enchantment can veinmine
18MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
WorldEdit
A Minecraft Map Editor... that runs in-game! With selections, schematics, copy and paste, brushes, and scripting. Use it in creative, or use it temporarily in survival.
11.6MSueta