COWMODSКаталог модов

CustomNPCs

A simple, lightweight, intuitive NPC plugin.

Автор: Foxikle61 тыс.137обновлён 29 авг. 2026 г.
ДекорБиблиотекиУтилиты

Описание

CustomNPCs

A powerful, configurable NPC plugin for Paper servers.

Paper


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:

ActionDescription
Send MessageSend a custom chat message to the player
Display TitleShow a title/subtitle on screen
Action BarDisplay text in the action bar
Play SoundPlay any in-game sound
Run CommandExecute a command as the player or console
BungeeCord / VelocitySend the player to another server
TeleportTeleport the player anywhere
Give / Remove XPModify player experience
Give / Remove Potion EffectApply or clear potion effects
Follow Preset PathWalk 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.

ResourceLink
GitHub Wikigithub.com/Foxikle/CustomNPCs/wiki
Plugin Wikidocs.foxikle.dev
JavadocsJavadoc (1.8.0)

📊 Statistics

bStats


🐛 Support & Bug Reports

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


❤️ 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.

Галерея

Banner

Последние версии

Все версии →
release

Bug Fixes

1.8.2
29 авг. 2026 г.2,9 тыс.Minecraft: 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2paper
Скачать
Что нового
## What's Changed - Fixed flipped codec mapping causing NPCs pitch and yaw to be flipped - Fixed removing items from an NPC breaking the config - Fixed issues with Mineskin initialization preventing downloading Skins from URLs - Fixed NPCs spawning at 0,0,0 if their pose was set to SITTING and their location was far away - Fixed default settings corruption causing new npcs created to be clones of other NPCs
release

CustomNPCs 1.8.1

1.8.1
9 авг. 2026 г.1,2 тыс.Minecraft: 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2paper
Скачать
Что нового
# What's changed? - Fixed the wrong config key being the default for the storage section - Fixed the storage provider never being initialized on the very first launch of the plugin - Fixed the default config being 1 behind the latest, which fixed the aforementioned bug TY to Katsumii for reporting these <3 Cheers! \~ Foxikle
release

CustomNPCs 1.8.0

1.8.0
14 июл. 2026 г.1,4 тыс.Minecraft: 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2paper
Скачать
Что нового
# What's Changed - New storage options: - Local Storage (Default): Stores data in a file on the server. - MySQL: Stores data in a SQL Database (Good if you already have one) - MongoDB: Stores data in a MongoDB document (Ideal) - Conditional Injection (Api only for now): Ensure certain conditions are met prior to spawning the NPC - Support for PluginUpdater - Removed support for very old NPC file versions (<1.6- no known users of the plugin this old) - new command to import data into a storage provider: `/npc movedata <conflict-resolution> - new config fixer to fix NPCs with 0 hologram lines - added support for empty hologram lines with `%empty%` - the update checker now runs once per hour instead of only on startup # Fixes - Fixed being able to make NPCs have 0 config lines # Api Changes - Removed deprecated methods `NPCApi#initialize`, `NPC#setPostion`, `NPC#setLegacyActions` `Settings#direction`, `LegacyAction` - Reworked action serialization, [read the wiki for details](https://docs.foxikle.dev/docs/api/Writing-Custom-Actions). - Moved some action condition classes around, most notably `Condition#SelectionMode` is now `Selector` - Settings now has a builder - Equipment now uses `null` for empty slots, not `AIR`. Setting a slot to air will now set it to null. - CustomNPCs is now in maven central! You no longer need to (and shouldn't) https://repo.foxikle.dev. It will be taken down soon. ## IMPORTANT NOTE: Any preset walking paths created before this release are sadly incompatible, and need to be re-recorded. This was because of some glaring issues with storage efficiency that I needed to address. I am sorry for the inconvenience if that effected you. According to my analytics, there are no current uses of the action, though. Cheers! Foxikle <3
release

CustomNPCs 1.7.10

1.7.10
8 июл. 2026 г.430Minecraft: 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2paper
Скачать
Что нового
## What's Changed - 26.1 and 26.2 support - Added the new FollowPresetPath Action! - This action allows an NPC to follow a pre-recorded path. It has an option to enable "looping", which will make it teleport to the beginning of the path and start again automatically. It is planned to have the action start on NPC load, as to not need a player interaction to start it. - Upgrade adventure to version 5 - Reworked the commands to use vanilla Brig - **Removed support for 1.20-1.20.4** - This is due to obfuscation changes which make maintaining these versions more burdensome than they are worth. Very few users use this version, so I felt it was the correct decision for the long term longevity of the project. - Fixed a couple of misc bugs - NPCs can have now empty hologram lines with `%empty%` - Added a tip to inform players they can Sneak + Click NPCs to open the edit dialog - NPCs can no longer have 0 hologram lines. - Added a config fixer to recover NPCs who have 0 config lines, as that prevented the NPC from loading. (/npc fixconfig lines) - Fixed the NPC skin not being updated when changed on versions 1.21.9-26.2 **Full Changelog**: https://github.com/Foxikle/CustomNPCs/compare/v1.7.9...v1.7.10 If you have experience speaking a language other than English and are willing to donate your time to improve the plugin, please consider becoming a translator. You can reach out to @foxikle on Discord for more details. In exchange for helping me with the project, you get access to preview builds and exclusive development content. Cheers <3
beta

CustomNPCs 1.7.10-pre2

1.7.10-pre2
16 июн. 2026 г.931Minecraft: 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2paper
Скачать
Что нового
Added support for 26.2
beta

CustomNPCs 1.7.10-pre1

1.7.10-pre1
17 мая 2026 г.1,4 тыс.Minecraft: 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2paper
Скачать
Что нового
## What's Changed - 26.1 support - Added the new FollowPresetPath Action! - This action allows an NPC to follow a pre-recorded path. It has an option to enable "looping", which will make it teleport to the beginning of the path and start again automatically. It is planned to have the action start on NPC load, as to not need a player interaction to start it. - Upgrade adventure to version 5 - Reworked the commands to use vanilla Brig - **Removed support for 1.20-1.20.4** - This is due to obfuscation changes which make maintaining these versions more burdensome than they are worth. Very few users use this version, so I felt it was the correct decision for the long term longevity of the project. - Fixed a couple of misc bugs
release

CustomNPCs 1.7.9

1.7.9
1 мар. 2026 г.5,2 тыс.Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Скачать
Что нового
Fix NullPointerException on player Join/Leave when a world was loaded after the server's initial start by @webhead1104
release

CustomNPCs 1.7.8

1.7.8
11 дек. 2025 г.5 тыс.Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Скачать
Что нового
Changes: - 1.21.11 support - Fixed some typos - Updated German and Russian translations - Added the Modrinth link to the update message.
release

CustomNPCs 1.7.7

1.7.7
14 окт. 2025 г.3 тыс.Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10paper
Скачать
Что нового
This release adds support for Minecraft version 1.21.10
release

CustomNPCs 1.7.6

1.7.6
1 окт. 2025 г.851Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9paper
Скачать
Что нового
- This update adds support for 1.21.9 - Updated a few dependencies