Logo
MINECRAFTBIBLE
Items
Items

All game items

Blocks
Blocks

Building blocks

Mobs
Mobs

Creatures & monsters

Biomes
Biomes

World biomes

Structures
Structures

Generated structures

Recipes
Recipes

Crafting guides

Advancements
Advancements

Achievements

Loot Tables
Loot Tables

Drop rates

Tags
Tags

Item groupings

All Versions
View all data →
Capes
Cape ArchiveNEW

Browse rare Minecon capes, OptiFine capes, and custom capes from players worldwide

Browse

Player Database
Player DatabasePopular

Search any player

Skin Browser
Skin Browser

Browse & download skins

Cape Gallery
Cape GalleryNEW

Minecon & OptiFine capes

Seed Vault
Seed Vault

Curated seeds

Learn

Guides
GuidesNew

Tutorials & tips

Blog
Blog

News & updates

Community

Community Hub
Community HubHub

Posts, discussions & more

All Versions
View community →
Seed Analyzer
Seed Analyzer

World seed analysis

Loot Explorer
Loot Explorer

Drop rates

Crafting Calculator
Crafting Calculator

Material planning

Enchant Calculator
Enchant Calculator

Probability math

Redstone Lab
Redstone Lab

Signal timing

Trading Profit
Trading Profit

Villager ROI

All Versions
View all tools →
Mods
Mods

Browse all mods

Plugins
Plugins

Server plugins

Resource Packs
Resource Packs

Textures & sounds

Shaders
Shaders

Visual enhancements

Datapacks
Datapacks

World logic

Scanner
Mod Intelligence

Scan & analyze any mod

All Versions
View all mods →
Loading...
IntroductionIntroductionVersion HistoryVersion HistoryGuidesGuidesBlog & NewsBlog & News
ItemsItemsBlocksBlocksMobsMobsRecipesRecipesBiomesBiomesStructuresStructuresAdvancementsAdvancementsLoot TablesLoot TablesTagsTags
ModsModsPluginsPluginsResource PacksResource PacksShadersShadersDatapacksDatapacks

MinecraftBible

The Ultimate Wiki

Logo
MINECRAFTBIBLE

The ultimate Minecraft reference. Every item, block, mob, and recipe documented with precision.

Community

  • Player Database
  • Skin Browser
  • Cape Gallery
  • Community Hub
  • Seed Vault

Database

  • Items
  • Blocks
  • Mobs
  • Recipes
  • Biomes
  • Structures

Tools

  • Seed Analyzer
  • Mod Intelligence
  • Crafting Calculator
  • Enchant Calculator

Mods & Packs

  • Mods
  • Plugins
  • Resource Packs
  • Shaders
  • Datapacks

© 2026 MinecraftBible. Not affiliated with Mojang or Microsoft.

PrivacyTermsContact
AdvancedNPCs999
PluginLicenseRef-All-Rights-Reserved

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.

345
Downloads
0
Followers
3 months ago
Updated
📦
4
Versions
managementtechnologyutilitybukkitpaperpurpurspigot
Download Latestv1.0.2View on Modrinth

📖About AdvancedNPCs999

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.yml to 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".

👥 Team & Contributors

No authors recorded.

⚙️ Compatibility

Environment
🖥️ Server-side
Loaders
bukkitpaperpurpurspigot
Minecraft Versions
1.211.21.11.21.21.21.31.21.41.21.51.21.61.21.7+4 more

🔗 Links

Modrinth Page