# CustomNPCs
\n*A powerful, configurable NPC plugin for Paper servers.*<\/p>\n
<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### \ud83c\udfa8 Appearance
\n– **Names longer than 16 characters** \u2014 break vanilla’s character limit
\n– **MiniMessage color support** \u2014 gradients, rainbow names, hex colors, and more
\n– **Fully customizable skins** \u2014 use any player skin or custom texture
\n– **Armor & item display** \u2014 equip NPCs with any gear you can imagine
\n– **Multiline Holograms** \u2014 Create NPCs with as many hologram lines as you’d like<\/p>\n
### \u26a1 Interaction Actions
\nTrigger powerful actions when players interact with an NPC:<\/p>\n
| Action | Description |
\n|—|—|
\n| Send Message | Send a custom chat message to the player |
\n| Display Title | Show a title\/subtitle on screen |
\n| Action Bar | Display text in the action bar |
\n| Play Sound | Play any in-game sound |
\n| Run Command | Execute a command as the player or console |
\n| BungeeCord \/ Velocity | Send the player to another server |
\n| Teleport | Teleport the player anywhere |
\n| Give \/ Remove XP | Modify player experience |
\n| Give \/ Remove Potion Effect | Apply or clear potion effects |<\/p>\n
*Each action has a configurable delay and cooldown!*<\/p>\n
### \ud83e\udde0 Behavior
\n– **Look at players** \u2014 NPCs track nearby players naturally
\n– **Configurable idle direction** \u2014 set a default look direction when not tracking
\n– **Flexible persistence** \u2014 choose between session-only NPCs (cleared on restart) or fully persistent NPCs that survive restarts
\n– **Conditional Actions** \u2014 Execute specific actions under certain circumstances<\/p>\n
—<\/p>\n
## \ud83c\udf0d Translations<\/p>\n
CustomNPCs supports multiple languages! If you speak a language other than English and want to contribute, join the translation effort on Crowdin:<\/p>\n
\ud83d\udc49 **Translate on Crowdin**<\/p>\n
Don’t see your language listed? Send `@foxikle` a DM on Discord or open a ticket in the support server to request it.<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Developer API<\/p>\n
Integrate CustomNPCs into your own plugins with the provided API.<\/p>\n
| Resource | Link |
\n|—|—|
\n| Maven Repository | repo.foxikle.dev |
\n| GitHub Wiki | github.com\/Foxikle\/CustomNPCs\/wiki |
\n| Plugin Wiki | docs.foxikle.dev |
\n| Javadocs | Javadoc (1.7.8) |<\/p>\n
—<\/p>\n
## \ud83d\udcca Statistics<\/p>\n
<\/p>\n
—<\/p>\n
## \ud83d\udc1b Support & Bug Reports<\/p>\n
Encounter a bug or need help? Here’s where to go:<\/p>\n
– **Discord** \u2014 Fastest way to get support
\n– **GitHub Issues** \u2014 For confirmed bugs and feature requests<\/p>\n
—<\/p>\n
## \u2764\ufe0f Support the Project
\nIf CustomNPCs has been useful to you, consider supporting development!<\/p>\n
Patreon \u00b7 PayPal \u00b7 GitHub Sponsors<\/p>\n
—<\/p>\n
*CustomNPCs is open source. Contributions, translations, and feedback are always welcome.*<\/p>\n","protected":false},"excerpt":{"rendered":"
A simple, lightweight, intuitive NPC plugin.<\/p>\n","protected":false},"featured_media":53184,"template":"","meta":{"_minecraft_slug":"customnpcs","_minecraft_project_id":"ptXUpAzg","_minecraft_author":"Foxikle","_minecraft_license":"MIT","_minecraft_downloads":49769,"_minecraft_follows":130,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"customnpcs.zip","_minecraft_size_bytes":86304295,"_minecraft_version_count":47,"_minecraft_updated_at":"2026-05-15T22:19:30.379651Z","_minecraft_date_created":"2023-07-02T21:44:28.830480Z","_minecraft_date_modified":"2026-03-01T14:25:34.240808Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/customnpcs","_minecraft_icon_attachment_id":53184,"_minecraft_imported_at":"2026-06-02T22:59:24+00:00","_minecraft_import_hash":"8c96a27e0b6c6e2bce92424845513627","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,873,127,92],"mod_loader":[132],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-53183","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-library","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n