P E R F E C T NPC
The ultimate NPC system for Hytale servers
// WHY PERFECTNPC?
PerfectNPC brings your server world to life with custom NPCs that can sell items, give quests, display dialogues, equip armor and weapons, and rotate to face players. Every NPC is fully configurable through an in-game admin UI — no file editing required.
// FEATURES
- 4 NPC Types
Shopkeeper, Quest Giver, Dialogue, Ambient - Shop System
Configurable item list, prices, and stock. Buy and sell in the same UI. Category tabs for large shops. - Quest System
Four objective types tracked live: kill entities, collect items, break blocks, place blocks. Item and XP rewards. Per-player progress tracking. - Dialogue System
Multi-page dialogues with up to 6 answer choices per page. Multiline content with line breaks. Typewriter animation with configurable speed. Conditional branching, navigation buttons, and command execution on click. - NPC Equipment
Dress your NPCs with armor (helmet, chest, leggings, gloves) and weapons (main hand, off hand). Visible in-world. - Face-Me Rotation
NPCs rotate to face the nearest player automatically. - Chunk Spawning
NPCs auto-spawn when chunks load. No manual respawning needed after restarts. - Custom Models
Use any Hytale model with custom scale. Nameplate display. Frozen / idle animations. - Admin UI
Full in-game management panel via /pnpc. Create, configure, and manage all NPCs visually. - Multi-language
Plugin messages in 5 languages: EN, FR, ES, DE, IT.
// COMMANDS
| /pnpc | Open the NPC admin panel |
| /pnpc help | Show help |
// TECHNICAL DETAILS
- Platform: Hytale Server Plugin
- Java Version: 21
- Dependencies: None
- Languages: EN, FR, ES, DE, IT
- Data Storage: JSON
- Performance: Event-driven, chunk-based spawning
// CHANGELOG
v2.5 - Quality of Life update
- Multiline dialog content (Enter for a new line in the editor)
- All four quest objective types now fully tracked: KILL, COLLECT, BREAK, PLACE (previously only KILL was wired up)
- Typewriter animation now actually renders character by character at the configured speed (was UI-only before)
- Fixed client crash when navigating between admin tabs after saving (stale status label updates removed)
v2.4
- V2 admin UI: tab-based layout (Info, Dialog, Shop, Quest, Equip, Advanced)
- Equipment section to dress NPCs with armor and weapons
- Quest item collection check tick
v2.1
- Multi-page dialogues with up to 6 answers per page
- Quest system with objectives and rewards
- Shop with category tabs
// DOCUMENTATION
Full documentation and FAQ:
perfectplugins.github.io/wiki/perfectnpc
Developed by KatsuyaTV
Issues or feature requests? Discord ticket or DM.
