CustomNPCs

# CustomNPCs A powerful, configurable NPC plugin for Paper servers.

!(https://cdn.jsdelivr.net/gh/intergrav/devins-badges/assets/compact/supported/paper_vector.svg)

## ✨ 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](https://crowdin.com/project/customnpcs)

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 | (https://github.com/Foxikle/CustomNPCs/wiki) | | Plugin Wiki | (https://docs.foxikle.dev/) | | Javadocs | (https://javadoc.io/doc/dev.foxikle/customnpcs) |

## 📊 Statistics

[!(https://bstats.org/signatures/bukkit/CustomNPCs.svg)](https://bstats.org/plugin/bukkit/CustomNPCs/18898)

## 🐛 Support & Bug Reports

Encounter a bug or need help? Here's where to go:

• (https://discord.foxikle.dev)** — Fastest way to get support
• (https://github.com/Foxikle/CustomNPCs/issues/new/choose)** — For confirmed bugs and feature requests

## ❤️ Support the Project If CustomNPCs has been useful to you, consider supporting development!

(https://www.patreon.com/foxikle) · (https://paypal.me/foxikledev) · (https://github.com/sponsors/Foxikle)

CustomNPCs is open source. Contributions, translations, and feedback are always welcome.