CustomNPCs
No reviews yet
A simple, lightweight, intuitive NPC plugin.
Does not follow a specific thematic focus apart from vanilla Minecraft.
Used for mods with little to no gameplay elements.
Introduces new non-player characters with various roles and behaviors.
Includes tools and features for server management.
Provides a framework or library for other mods to use.
Paper is a fork of Spigot that adds its own plugin API on top of the Bukkit API. All Spigot plugins are compatible with paper, not all paper plugins are compatible with Spigot.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
Modrinth
Compatibility
Supported Environments
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
About
Description
CustomNPCs
A powerful, configurable NPC plugin for Paper servers.
✨ 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.
Screenshots
Gallery
-
Banner A simple banner for the plugin!
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers