AdvancedNPCs999
A comprehensive Minecraft plugin designed to empower server administrators with advanced control over Non-Player Characters (NPCs). Create, customize, and manage intelligent NPCs that enhance your server's environment and player interactions.
8580обновлён 15 сент. 2026 г.
УправлениеТехнологииУтилиты
Описание
Main Features
🧍 NPC Management
- Creation & Removal: Easily create new NPCs at your location and remove existing ones.
- Selection: Select the nearest NPC to manage its properties.
- Persistence: All NPCs are automatically saved and loaded, ensuring they remain across server restarts.
- Basic Control: Teleport, clone, spawn, despawn.
- Display Name: Customize NPC names, including support for color codes.
- Entity Type: Change the visual type of the NPC (e.g., player, zombie, villager).
- Ownership: Assign ownership to NPCs.
- Reset: Reset an NPC to default settings (name, skin, equipment, and all behaviors) while keeping the NPC.
- Teleport: Teleport to a specific NPC by name or ID.
🎭 Appearance
- Mojang Skin System: Apply any player's skin to an NPC by fetching it directly from Mojang's API.
/npc skin <player>: Fetches and applies a player's skin./npc skin update: Refreshes the selected NPC's skin./npc skin clear: Resets the NPC to a default skin./npc skin list: Shows all stored skins in the cache./npc skin refreshall: Refreshes all NPC skins from Mojang servers.
- Custom Names: Set display names with color codes.
- Equipment GUI: Open a graphical interface to equip NPCs with armor and items.
🧠 Behavior & AI
- Look at Player: Toggle whether an NPC automatically turns its head to look at nearby players.
- Pathfinding Patrols:
/npc path add: Add your current location as a waypoint for the selected NPC./npc path start: Command the NPC to begin patrolling its defined path./npc path stop: Halt the NPC's current patrol./npc path clear: Remove all waypoints from the NPC's path.
- Player Following:
/npc follow <player>: Make the NPC follow a specific player./npc follow off: Stop the NPC from following.
- Pose Control:
/npc sit: Make the selected NPC sit down./npc stand: Make the selected NPC stand up.
- Physics Control:
/npc gravity: Enable gravity for the NPC./npc fly: Disable gravity, allowing the NPC to float or fly.
- Automatic Respawn: NPCs automatically respawn in the world upon server startup.
💬 Interaction
- Dialogue System:
/npc text add <message>: Add lines of dialogue that the NPC will say when interacted with./npc text list: View all dialogue lines for the selected NPC./npc text clear: Remove all dialogue lines./npc text remove <index>: Remove a specific dialogue line by its number.
- Command Execution:
/npc cmdadd <command>: Add commands that the server will execute when a player interacts with the NPC. Use%player%as a placeholder for the interacting player's name./npc cmdremove <index>: Remove a specific command./npc cmdclear: Clear all commands.
- Interaction Triggers:
/npc trigger <type>: Define how players activate NPC interactions.right_click: Interact by right-clicking the NPC.left_click: Interact by left-clicking (attacking) the NPC.proximity: Interact when a player comes within a certain range of the NPC.
⚔️ Combat (Optional)
- Player Guarding:
/npc guard <player>: Command the NPC to guard a specific player./npc guard off: Disable guarding.
- Range Setting:
/npc range <blocks>: Set the follow or attack range for the NPC.
🧰 Utility
- List NPCs:
/npc list [page]: Display a paginated list of all active NPCs, showing their IDs and names.
- NPC Information:
/npc info: Show detailed information about the currently selected NPC.
- Save Data:
/npc save: Force the plugin to save all NPC and skin data immediately.
- Reload Plugin:
/npc reload: Reload the plugin's configuration, NPC data, and skin cache.
- Debug Mode:
/npc debug: Toggle debug messages (future feature).
Core Systems
Skin System
- Fetches player skins directly from Mojang's API using usernames.
- Extracts skin data (value and signature) and applies it to the NPC's appearance.
- Caches skin data locally in
skins.ymlto minimize API requests and improve performance. - All skin fetching operations are performed asynchronously to prevent server lag.
- Supports updating or clearing NPC skins via commands.
Persistence
- NPC Data: All NPC configurations (UUID, name, location, skin data, entity type, path points, equipment, behavior settings, interaction details) are stored persistently in
npcs.yml. - Skin Cache: Downloaded skin data is cached in
skins.yml. - Automatic Loading: All NPCs are automatically loaded and spawned when the plugin starts.
Command Handling
- A robust command system with clear subcommands for all NPC management tasks.
- Includes full tab completion for ease of use.
- Comprehensive error handling for invalid commands or missing selections.
Interaction Triggers
- Supports various methods for players to interact with NPCs: right-click, left-click, and proximity detection.
- When triggered, NPCs can display dialogue and execute server commands.
Pathfinding & Movement
- NPCs can be configured with patrol paths consisting of multiple waypoints.
- NPCs can be commanded to follow specific players.
Equipment Management
- A dedicated graphical user interface (GUI) allows server admins to visually equip NPCs with armor and items.
Commands
All commands start with /npc or /advnpcs.
/npc create <name>: Creates an NPC named<name>at your current location./npc remove: Removes the currently selected NPC./npc select: Selects the nearest NPC to your position./npc skin <player_name>: Sets the selected NPC's skin to that of<player_name>./npc skin update: Refreshes the selected NPC's skin from the cached username./npc skin clear: Resets the selected NPC to a default skin./npc skin list: Shows all stored skins in the cache./npc skin refreshall: Refreshes all NPC skins from Mojang servers./npc name <new_name>: Changes the selected NPC's display name. Supports color codes./npc equip: Opens an inventory GUI to equip the selected NPC./npc reset: Resets the selected NPC to default settings (name, skin, equipment, and all behaviors) while keeping the NPC./npc teleport <npc_name>: Teleports you to the specified NPC./npc tp <npc_name>: Alias for teleport command./npc look: Toggles whether the selected NPC looks at nearby players./npc path add: Adds your current location as a waypoint to the selected NPC's patrol path./npc path start: Starts the selected NPC patrolling its path./npc path stop: Stops the selected NPC's patrol./npc path clear: Clears all waypoints from the selected NPC's path./npc follow <player_name>: Makes the selected NPC follow<player_name>./npc follow off: Stops the selected NPC from following./npc sit: Makes the selected NPC sit./npc stand: Makes the selected NPC stand./npc gravity: Enables gravity for the selected NPC./npc fly: Disables gravity for the selected NPC, allowing it to float./npc text add <message>: Adds a dialogue line to the selected NPC./npc text list: Lists all dialogue lines for the selected NPC./npc text clear: Clears all dialogue lines for the selected NPC./npc text remove <index>: Removes the dialogue line at the specified<index>./npc cmdadd <command>: Adds a server command to be executed when the selected NPC is interacted with. Use%player%as a placeholder for the interacting player's name./npc cmdremove <index>: Removes the command at the specified<index>./npc cmdclear: Clears all commands for the selected NPC./npc trigger <type>: Sets the interaction trigger for the selected NPC (right_click,left_click,proximity)./npc guard <player_name>: Makes the selected NPC guard<player_name>./npc guard off: Stops the selected NPC from guarding./npc range <blocks>: Sets the follow/attack range for the selected NPC./npc list [page]: Displays a paginated list of all created NPCs./npc info: Shows detailed information about the currently selected NPC./npc save: Forces all NPC and skin data to be saved to disk./npc reload: Reloads the plugin's configuration, NPC data, and skin cache./npc debug: Toggles debug messages (currently not implemented).
Permissions
All permissions start with advnpcs..
advnpcs.admin: Grants access to all AdvNPCs commands (default: op).advnpcs.create: Allows players to create new NPCs (default: op).advnpcs.remove: Allows players to remove NPCs (default: op).advnpcs.skin: Allows players to manage NPC skins (default: op).advnpcs.behavior: Allows players to manage NPC behavior (default: op).advnpcs.dialogue: Allows players to manage NPC dialogue and commands (default: op).advnpcs.teleport: Allows players to teleport to NPCs (default: op).
Data Storage
plugins/AdvNPCs/npcs.yml: Stores all persistent NPC data, including their UUIDs, names, locations, skin data, entity types, path points, equipment, and behavior/interaction settings.plugins/AdvNPCs/skins.yml: Stores cached Mojang skin data (username, UUID, value, signature) to reduce API calls.
Usage Examples
/npc create Steve: Creates an NPC named "Steve" at your current location./npc select: Selects the nearest NPC./npc skin Notch: Sets the selected NPC's skin to Notch's skin./npc text add Hello, traveler!: Adds a dialogue line to the selected NPC./npc path add: Adds your current location to the selected NPC's path./npc path start: Makes the selected NPC start patrolling its path./npc follow Player123: Makes the selected NPC follow the player "Player123".
Последние версии
Все версии →release
AdvancedNPCs999 1.0.3 Full Over-Haul Update!
1.0.315 сент. 2026 г.54Minecraft: 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.11bukkit, paper, purpur, spigot
Что нового
### Added
* Added click and attack detection that works on every supported server version, so interactions always trigger
* Added name tags above NPCs with full colour code and hex colour support
* Added the ability to hide an NPC's name tag while keeping the NPC visible
* Added a separate display name for an NPC, so the name shown above it can differ from its internal name
* Added multi-line floating text above NPCs with an adjustable height
* Added clickable dialogue options that can continue a conversation, run a command, or display extra text
* Added a per-NPC interaction permission, so only players with that permission may interact
* Added a per-NPC allow list, so specific players can be granted access regardless of permissions
* Added interaction conditions: line of sight, sneaking required, a required item held, and a per-NPC cooldown
* Added a full editor menu that manages every NPC setting from one place
* Added equipment management for the off hand alongside the main hand and armour
* Added waypoint listing and removal
* Added three patrol styles: repeat, back and forth, and walk once then stop
* Added a separate pause and speed for patrol routes
* Added a particle preview that highlights an NPC's route
* Added automatic, timestamped backups of all NPC data with a configurable number kept
* Added manual backups, exporting NPCs to a file, importing NPCs from a file, and a one-step undo
* Added NPC health, configurable attack damage, and an invulnerability option
* Added a choice of what happens when an NPC is defeated: come back after a delay, or stay hidden
* Added an option to drop an NPC's equipment when it is defeated
* Added defeat and respawn announcements
* Added an option to give NPCs an actual fight when guarding, including attacking whatever threatens the guarded player
* Added PlaceholderAPI support, exposing NPC counts, names, positions, health, state and more
* Added a configurable message text system so every player facing message can be reworded, translated and coloured
* Added new configuration options for total NPC limits, maximum range, spawn delay on join, respawn delay, backup behaviour, backup retention and debug output
* Added a new permission set covering viewing, modifying, editing, saving, reloading, backups and debug output
* Added a fallback for the invisible entities used for floating text so they are never saved into the world
* Added a single download that runs on every supported server version, so there is no longer a choice to make when installing
### Fixed
* Fixed interactions never firing on some supported versions, which made right-click, left-click and proximity triggers unreliable
* Fixed guarding NPCs doing nothing at all; they now defend the guarded player and fight back
* Fixed the configured follow and patrol speeds being ignored in favour of fixed values
* Fixed the debug toggle doing nothing and the debug setting being missing from the configuration
* Fixed sitting never appearing; the pose was applied and then discarded before players could see it
* Fixed changing gravity rebuilding the NPC once for every player online
* Fixed resetting an NPC wiping its name
* Fixed cloning ignoring creation limits and permissions, allowing duplicate names, and leaving copies without an owner
* Fixed the fallback skin using an invalid signature, which could make NPCs render incorrectly
* Fixed NPCs with no owner escaping the creation limit
* Fixed the entity type command rejecting every value and reporting a misleading error
* Fixed NPCs turning their heads in the wrong direction
* Fixed names containing spaces being cut down to the first word
* Fixed most commands not checking permissions, which let any player change or delete NPCs they did not own
* Fixed ownership checks applying to only a single command
* Fixed the equip and clone permissions being declared but never enforced, and missing from the full access group
* Fixed the range command accepting zero, negative and absurd values
* Fixed interactions being spammable with no cooldown, allowing commands to be run repeatedly
* Fixed saving running at the same time as the game was changing data, which risked corrupt or partially written data
* Fixed shutdown overlapping with a background save
* Fixed patrol and wander tasks continuing to run after an NPC was removed
* Fixed movement tasks not restarting after a reload
* Fixed selection and proximity tracking never being cleaned up when players left the server
* Fixed an unloaded world causing errors when selecting or listing NPCs
* Fixed plugin startup failing when the command description was unavailable
* Fixed reloading leaving removed NPCs in memory and never restarting automatic saving
* Fixed the stored skin data never being created on a fresh installation
* Fixed reloading leaving behind duplicate NPCs
* Fixed NPCs walking through walls and into unloaded areas while patrolling or following
* Fixed following silently doing nothing whenever a patrol was already running
* Fixed skins being stored in two incompatible formats, so skins saved by either download could be ignored
* Fixed equipment being stored in a way that equipment saved by the other download could not be read
* Fixed skin cache entries being treated as different players depending on capitalisation, and never refreshing once stored
* Fixed a missing skin signature causing errors while loading stored skins
* Fixed one damaged NPC entry stopping that NPC from loading without a clear explanation
* Fixed cloning bypassing the duplicate name check
* Fixed names above NPCs being unreliable and colour codes never being shown
* Fixed NPCs being given fixed placeholder client details instead of consistent defaults
* Fixed clicking an unrelated entity being able to trigger an NPC interaction
* Fixed NPCs sometimes being shown twice or briefly at the wrong position when joining or changing worlds
* Fixed entities appearing that could not be removed after a very fast hide and show
* Fixed the plugin disabling itself on newer point releases of 1.21
* Fixed the packaged plugin reporting a version that did not match the release
* Fixed the download for older servers being packaged as a legacy plugin, which made newer servers convert it every time it loaded
* Fixed placeholder author and website details
* Fixed a malformed command usage line
* Fixed the plugin requiring one specific machine's Java installation to build
* Fixed the two downloads having drifted into different sets of behaviour, so improvements only reached one of them
* Fixed internal support failing causing a hard crash instead of a clear explanation and a safe degraded start
* Fixed stale build artefacts and crash reports being kept in the project
release
AdvancedNPCs999 1.0.2
1.0.219 янв. 2026 г.311Minecraft: 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.9bukkit, paper, purpur, spigot
Что нового
* Added New Commands: /npc wander /npc wander radius /npc wander speed <slow|normal|fast> /npc wander pause <0-60>
release
1.0.1(for 1.21.11)
1.0.17 янв. 2026 г.268Minecraft: 1.21.10, 1.21.11bukkit, paper, purpur, spigot
release
AdvancedNPCs999 1.0.1 More Commands
1.0.128 нояб. 2025 г.146Minecraft: 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.10bukkit, paper, purpur, spigot
Что нового
### Added
- `/npc skin list` - Shows all stored skins in the cache
- `/npc skin refreshall` - Refreshes all NPC skins from Mojang servers in bulk
- `/npc reset` - Resets an NPC to default settings (name, skin, equipment, and all behaviors) while keeping the NPC
- `/npc teleport <npc_name>` - Teleports you to the specified NPC
- `/npc tp <npc_name>` - Alias for the teleport command
- `advnpcs.teleport` permission - Allows players to teleport to NPCs
### Changed
- Improved skin management system with cache listing functionality
- Enhanced command tab completion with NPC name suggestions for teleport command
- Added comprehensive command help text for all new functionality
release
AdvancedNPCs999 1.0.0
1.0.028 окт. 2025 г.79Minecraft: 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.10bukkit, paper, purpur, spigot