适用于 Minecraft 1.20.1, 1.21.1 的 CustomNPCs 插件

CustomNPCs

A powerful, configurable NPC plugin for Paper servers.

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:

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

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 - github.com/Foxikle/CustomNPCs/wiki Plugin Wiki - docs.foxikle.dev Javadocs - Javadoc (1.8.0)

📊 Statistics

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