Перейти к содержимому
Mineforgian

CustomNPCs

A simple, lightweight, intuitive NPC plugin.

53K загрузок134 подписчиковMITpaper

Обновлён 16 июня 2026 г. · опубликован 30 июня 2023 г.

  • Banner

CustomNPCs

A powerful, configurable NPC plugin for Paper servers.

Paper


✨ 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 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

  • 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.

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:


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

Версии

ВерсияКаналИграЗагрузчикиДатаСкачать
1.7.10-pre2Бета26.1, 26.1.1, 26.1.2, 26.2paper16 июня 2026 г..jar (578 КБ)
1.7.10-pre1Бета1.21.11, 26.1, 26.1.1, 26.1.2paper17 мая 2026 г..jar (561 КБ)
1.7.9Релиз1.21.8, 1.21.9, 1.21.10, 1.21.11paper1 марта 2026 г..jar (587 КБ)
1.7.8Релиз1.21.8, 1.21.9, 1.21.10, 1.21.11paper11 декабря 2025 г..jar (587 КБ)
1.7.7Релиз1.21.7, 1.21.8, 1.21.9, 1.21.10paper14 октября 2025 г..jar (568 КБ)
1.7.6Релиз1.21.6, 1.21.7, 1.21.8, 1.21.9paper1 октября 2025 г..jar (568 КБ)
1.7.5Релиз1.21.5, 1.21.6, 1.21.7, 1.21.8paper4 августа 2025 г..jar (552 КБ)
1.7.5-pre8Бета1.21.5, 1.21.6, 1.21.7, 1.21.8paper4 августа 2025 г..jar (552 КБ)
1.7.5-pre7Бета1.21.5, 1.21.6, 1.21.7, 1.21.8paper4 августа 2025 г..jar (552 КБ)
1.7.5-pre6Бета1.21.5, 1.21.6, 1.21.7, 1.21.8paper29 июля 2025 г..jar (551 КБ)
1.7.5-pre5Бета1.21.5, 1.21.6, 1.21.7, 1.21.8paper25 июля 2025 г..jar (546 КБ)
1.7.5-pre4Бета1.21.4, 1.21.5, 1.21.6, 1.21.7paper9 июля 2025 г..jar (546 КБ)
1.7.5-pre3Бета1.21.4, 1.21.5, 1.21.6, 1.21.7paper4 июля 2025 г..jar (546 КБ)
1.7.5-pre2Бета1.21.2, 1.21.3, 1.21.4, 1.21.5paper15 июня 2025 г..jar (530 КБ)
1.7.5-pre1Бета1.21.2, 1.21.3, 1.21.4, 1.21.5paper17 мая 2025 г..jar (502 КБ)

Показаны последние 15 из 49 версий. Все версии — на Modrinth.

Ченджлог

1.7.10-pre2Бета26.1.1, 26.1.2, 26.2 · 16 июня 2026 г.

Added support for 26.2

1.7.10-pre1Бета26.1, 26.1.1, 26.1.2 · 17 мая 2026 г.

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
1.7.9Релиз1.21.9, 1.21.10, 1.21.11 · 1 марта 2026 г.

Fix NullPointerException on player Join/Leave when a world was loaded after the server's initial start by @webhead1104

1.7.8Релиз1.21.9, 1.21.10, 1.21.11 · 11 декабря 2025 г.

Changes:

  • 1.21.11 support
  • Fixed some typos
  • Updated German and Russian translations
  • Added the Modrinth link to the update message.
1.7.7Релиз1.21.8, 1.21.9, 1.21.10 · 14 октября 2025 г.

This release adds support for Minecraft version 1.21.10

1.7.6Релиз1.21.7, 1.21.8, 1.21.9 · 1 октября 2025 г.
  • This update adds support for 1.21.9
  • Updated a few dependencies
1.7.5Релиз1.21.6, 1.21.7, 1.21.8 · 4 августа 2025 г.

New Features:

  • 1.21.5 - 1.21.8 support
  • NPC Poses
    • There are 6 possible poses: Standing, Sitting, Crouching, Swimming, Dying, and Sleeping.
  • NPC Nudging
    • Nudging is way to move NPCs a little bit at a time to precisely position them. Crouching while scrolling increases the move increment from .05 blocks per slot to .25 blocks per slot scrolled over.
  • Native Multi-line Holograms
    • Your existing names are automatically converted to the new system
  • The Ability to flip NPCs upside down
    • This option is accessed in the extra settings menu (Top right comparator)
  • The ability to add cooldowns to actions
    • The configuration of them is very similar to configuring delay. There is no message for an action being on cooldown.

Bug Fixes

  • Fixed the UUID being visible with a teamless approach, which is much more tolerant to other plugins
  • Fixed being able to supply textual input to multiple actions at once
  • Fixed the sleeping percentage not being respected if it was changed after the server started
  • Fixed Elytras not being able to be equiped in the chest slot
  • Fixed problems with clicking items in the equipment menu
  • Changed the default NPC name to "An unnamed NPC"
  • NPC nametags follow a lot smoother
  • NPCs no longer have a visible armor stand riding them in spectator mode
  • NPCs now ignore spectators and do not look at them
  • Fixed importing skins from URLS
  • Fixed some issues with the commands library
  • Fixed errors with menus on latest paper versions
  • Fixed some issues with dependency downloading at runtime (Thanks paper!)

Developer Changes

  • The NPC#moveTo(Location) was renamed to NPC#teleport(Location) as moveTo is reserved for other movement related features coming later :)
  • The Settings class now has a method to import a player's skin directly from a player object
  • NPCs no longer have "names", but rather an array of "lines". The get/set name methods are now deprecated and just affect the top line.
  • Poses can be changed in the settings object
  • Added a "facing" system, to be more consistent with how NPC yaw and pitch are handled.
  • Custom actions should call the Action#activateCooldown(UUID) in ther perform method.
1.7.5-pre8Бета1.21.6, 1.21.7, 1.21.8 · 4 августа 2025 г.

Fixed the upside down button not working (whoops!)

Полная история изменений — на Modrinth.

Комментарии

Загружаем…