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.
