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:
👉 Translate 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.
Cara memasang CustomNPCs
A server on Paper
The plugin runs on the server core for Minecraft 1.20–26.2; players do not need to install anything.
File goes into the plugins folder
Download the file customnpcs-1.8.2-all.jar (607 KB) and put it into the server’s plugins folder.
Restart the server
On startup the plugin creates its own settings folder in plugins.
Use the “To server” button
On Millida Hosting, the button at the top of the page uploads the file to your server and restarts it for you.
Versi
Dengan dependensi
| Minecraft | Loader | File | Tindakan |
|---|---|---|---|
| 26.2 | Paper | 26.2607 KB 13 | |
| 26.1 | Paper | 26.1607 KB 1 | |
| 1.21.11 | Paper | 1.21.11607 KB 4 | |
| 1.21 | Paper | 1.21607 KB 1 | |
| 1.20.1 | Paper | 1.20.1587 KB 3 |
Ulasan
Jadilah yang pertama menilai CustomNPCs




