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 `: 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