EIZZOs-NPCs

# EIZZOs-NPCs **Packet-Based NPC System** with intelligent movement, branching dialogue, combat mechanics, and per-player state tracking. --- ## 🎯 Features ### 🤖 Advanced NPC System - **Packet-Based Rendering** - Client-side NPCs using network packets (not server entities) - **Per-Player State** - Each player has unique NPC health, position, and dialogue progress - **35+ Configurable Properties** - Customize everything from tracking range to rewards - **Visual Editor GUI** - In-game NPC management with chat-based property editing ### 🎭 Dialogue System - **Branching Conversations** - Multi-node dialogue trees with clickable choices - **Action Sequences** - Messages, sounds, waits, teleports, rewards in dialogue - **One-Time Tokens** - Secure choice validation prevents command exploitation - **Dialogue Once Mode** - Track viewed nodes per player, skip seen content ### ⚔️ Combat & Tracking - **Three Tracking Modes** - NONE (static), STILL (rotate only), FOLLOW (pathfind) - **Hostile NPCs** - Attack players within range with weapon scaling - **Intelligent Pathfinding** - Navigate obstacles, jump over blocks, avoid collisions - **Per-Player Health** - Killing an NPC for one player doesn't affect others ### 🎨 Customization - **Full Skin Support** - Mojang API (usernames) or PNG file uploads via Mineskin - **Equipment System** - Armor and hand items with full NBT support - **Sound Effects** - Custom interaction sounds per NPC - **Debug Visualization** - Particle grid showing tracking ranges ### 💰 Reward Integration - **Vault Economy** - Give money on NPC kills - **EIZZOs-Tokens** - Award custom tokens (soft dependency) - **Reward Limits** - Optional per-player claim caps - **Custom Messages** - Configurable reward notifications --- ## 📝 Commands | Command | Permission | Description | |---------|-----------|-------------| | `/npc` | `eizzo.npcs.admin` | Open NPC list GUI | | `/npc help` | - | Show help menu | | `/npc debug` | `eizzo.npcs.admin` | Toggle debug particles (8-block cube visualization) | | `/npc create <id> <name>` | `eizzo.npcs.admin` | Create new NPC at your location | | `/npc list` | `eizzo.npcs.admin` | Open NPC list GUI | | `/npc delete <id>` | `eizzo.npcs.admin` | Permanently delete NPC | | `/npc set <id> <property> <value>` | `eizzo.npcs.admin` | Set NPC properties (see below) | | `/npc tp <id> ` | `eizzo.npcs.admin` | Teleport NPC to your location or coords | | `/npc addcmd <id> <command>` | `eizzo.npcs.admin` | Add interaction command/action | | `/npc clearcmds <id>` | `eizzo.npcs.admin` | Clear all commands from NPC | | `/npc dialog <id> <node> ` | Admin/Token | Execute dialogue node (console use requires player arg) | ### NPC Set Properties | Property | Type | Description | |----------|------|-------------| | `name` | String | Display name (supports MiniMessage) | | `type` | EntityType | Mob type (VILLAGER, ZOMBIE, SKELETON, PLAYER, etc.) | | `skin` | String | Player username or PNG filename in skins/ folder | | `trackingmode` | NONE/STILL/FOLLOW | Tracking behavior | | `trackingrange` | Double | Detection range in blocks | | `hostile` | true/false | Attacks players in range | | `cape` | true/false | Show cape for PLAYER type NPCs | | `collision` | true/false | Players can collide with NPC | | `npccollision` | true/false | NPCs collide with other NPCs | | `flying` | true/false | No gravity, 3D movement | | `returntospawn` | true/false | Returns to spawn when player leaves range | | `nametag` | true/false | Nametag visibility | | `sound` | Sound key or "none" | Sound on interaction (e.g., `ui.button.click`) | | `godmode` | true/false | Takes no damage | | `respawndelay` | Integer | Ticks before respawn after death (20 = 1 second) | | `runmode` | op/console/player | Command execution mode | | `location` | world x y z yaw pitch | Manual location setting | --- ## 🔐 Permissions | Permission | Description | |-----------|-------------| | `eizzo.npcs.admin` | Full access to all NPC commands and editor GUIs | **Note:** All commands except `/npc help` require admin permission. Dialogue execution requires either a valid session token OR admin permission. --- ## 🛠️ Configuration ### Main Config (`config.yml`) ```yaml config-version: 1.1 tracking: max-range: 50.0 # Server-side culling range (cube) database: type: "sqlite" # "sqlite" or "mysql" host: "localhost" port: 3306 database: "minecraft" username: "root" password: "" pool-size: 10 # MySQL only logging: dialogue-to-console: true # Log dialogue executions rewards: enabled: true max-amount: 1000.0 # Maximum reward per kill use-vault: true # Enable Vault economy use-eizzos-tokens: false # Enable EIZZOs-Tokens vault-message: "<green>+ ${amount} <gray>(NPC Kill)" token-message: "<gold>+ {amount} {currency} <gray>(NPC Kill)" ``` ### Database - **Default:** SQLite at `plugins/EIZZOs-NPC