CustomNPCs

CustomNPCs

*A powerful, configurable NPC plugin for Paper servers.*

---

✨ Features

🎨 Appearance

- Multiline Holograms — break vanilla's character limit - Multiline Holograms — gradients, rainbow names, hex colors, and more - Multiline Holograms — use any player skin or custom texture - Multiline Holograms — equip NPCs with any gear you can imagine - Multiline Holograms — Create NPCs with as many hologram lines as you'd like

⚡ Interaction Actions

Trigger powerful 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 |

*Each action has a configurable delay and cooldown!*

🧠 Behavior

- Conditional Actions — NPCs track nearby players naturally - Conditional Actions — set a default look direction when not tracking - Conditional Actions — 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 | |---|---| | Maven Repository | repo.foxikle.dev | | GitHub Wiki | github.com/Foxikle/CustomNPCs/wiki | | Plugin Wiki | docs.foxikle.dev | | Javadocs | Javadoc (1.7.8) |

---

📊 Statistics

bStats

---

🐛 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.*