PerfectNPCs + SHOP + QUEST v2.6

PerfectNPC v2.6
2026-05-26

Big update. Full admin UI redesign, new NPC presets, and Hytale Update 5 compatibility.

New: NPC presets

• Pick a ready made template when you create an NPC instead of starting from scratch.
• 6 presets included: Blank, Trader, Quest Giver, Guard, Banker, Lore.
• Choosing a preset spawns the NPC and pre fills its setup so it is usable right away.

Redesigned admin interface

• Brand new flat design that matches the rest of the Perfect plugins.
• Slim sidebar with live search, a "New NPC" button, duplicate, and quick actions (Move, Face, Respawn, Delete).
• NPC header with name and status badges (Entity, Shop, Quest, Dialog pages).
• Horizontal tab bar with 6 tabs (Info, Dialog, Shop, Quest, Equipment, Advanced), each with clear icons.
• Every section is now laid out in clean cards so settings are easier to find.

Stability
* Cleaner internal logging and removal of old unused menus for a lighter, more reliable plugin.

Hytale Update 5

• Updated and recompiled for Hytale Update 5 (Pre-Release 5).
• Fixed the red "Target Version" warning in the mod manager.

Compatibility
* Your existing NPCs, shops, quests and configs are preserved. No data reset.

How to update:

• Stop your server.
• Replace the old PerfectNPC jar with this one.
• Start your server.

v2.5 - Quality of Life update

• Multiline dialog content: press Enter for a new line in the Dialog editor's content field
• Quest objectives now fully tracked: BREAK_BLOCK, PLACE_BLOCK and COLLECT_ITEM (previously only KILL_ENTITY worked)
• Typewriter animation: was configurable in the UI but never rendered, now properly types out the dialog content character by character at the configured speed
• Fixed: client crash when navigating between admin tabs after saving (caused by stale status label updates)

v2.4 - Feature Update & UI Improvements

• Added interaction commands: NPCs can now execute commands as console when a player interacts (bypasses player permissions). Configure up to 3 commands in the Advanced tab. Supports {player} and {npc} placeholders.
• Added currency shop: Shop items can now use PerfectEconomy currency instead of item ingredients. Set a currency price in the item editor (0 = use ingredients).
• Added custom quest IDs: Quest IDs can now be renamed via the admin UI. Includes a RENAME button next to the ID field. Player progress is automatically migrated.
• Added daily/weekly quests: Quests can now reset on a daily or weekly basis. Toggle the reset mode (NONE/DAILY/WEEKLY) in the quest editor.
• Added NPC search: Search bar in the sidebar to filter NPCs by name.
• Added animation filter: Search field to filter the animation list in the Advanced tab.
• Fixed shop item selection crash: Removed dynamic Style.TextColor on Labels which caused client disconnects.
• Fixed animation pagination scroll reset: Changing animation pages no longer resets the scroll position.
• Improved save feedback: Status messages now show [OK] prefix and auto-clear after 3 seconds.
• Sidebar now shows [CMD] indicator when interaction commands are configured on the selected NPC.

New Feature: Shop Sell System​

• Shop items can now be marked as Buyable and/or Sellable independently in the admin editor
• Buyable (checked by default): player can purchase the item with ingredients
• Sellable: player can sell the item back and receive ingredients in return
• Sell Command: optional server command executed on sell instead of returning ingredients (supports {player} placeholder, executed once per unit sold)
• Admins can configure buy-only, sell-only, or both on each item
• BUY button hidden when item is not buyable, SELL button hidden when not sellable

New Feature: Quantity Selector​

• Replaced the old BUY x1 / BUY x10 / BUY ALL buttons with a unified quantity selector
• Controls: [MIN] [-10] [-] quantity [+] [+10] [MAX] (range 1-64)
• Both BUY and SELL use the selected quantity
• Ingredient costs and item quantity update in real-time when changing the amount

New Feature: Purchase/Sell Notifications​

• Toast notification appears on successful purchase (green, "Item Purchased")
• Toast notification appears on successful sell (yellow, "Item Sold")
• Displayed in addition to the existing status label in the shop UI
• Translated in all 6 languages

Shop Item Editor (Admin)​

• New Buyable checkbox (green, checked by default)
• New Sellable checkbox (red)
• New Sell Cmd text field for custom sell commands
• All labels fully translated (Quantity, Item Settings, Category, Max Buys, Weight, Daily Shop, Ingredients, etc.)

Performance​

• Fixed NPC idle animation restore blocking the world thread (500ms per NPC). Now runs asynchronously.

Bug Fixes​

• Fixed multiple cmd.set() calls targeting non-existent UI element IDs causing client disconnects
• Fixed shop quantity parsing for slider float values

PerfectNPC v2.2 — Patch Notes​

Full Localization (i18n)​

The entire plugin is now fully translated when switching language with /pnpc lang. Supported: EN, FR, DE, ES, IT, PT.

Dialog Page (player-facing):

• All default button labels translated: Previous, Next, Close, Custom Button 1/2
• Error messages: "NPC not found", "No dialog content available", "Requirements Not Met", "Interaction Finished"
• Default dialog messages: prerequisite failure, already completed
• "Press F to interact" hint text

Shop Page (player-facing):

• Title, hint text, item details header, quantity label
• Buy buttons: BUY x1, BUY x10, BUY ALL, CLOSE
• Status messages: purchase confirmation, inventory full, not enough ingredients

Quest Log (player-facing):

• Close button

Admin UI (/pnpc menu):

• Sidebar: + NEW, DUP, SECTIONS, MOVE TO ME, FACE BODY, SPAWN/CHANGE ENTITY, DELETE NPC, CLOSE
• Section tabs: Info, Dialog, Shop, Quests, Equipment, Advanced
• Info section: all field labels (NPC Name, Hint Text, Nameplate, Flags, Attitude, Quest Marker, Entity)
• Equipment section: Helmet, Chest, Leggings, Gloves, Main Hand, Off Hand, SAVE button, PICK buttons
• Quest section: Quest, Name, Desc labels, + NEW, DEL, WIZARD buttons, SAVE button, objectives header
• Advanced section: Proximity (Range, Enter/Exit Cmd, Message), Particles (Spawn/Despawn FX), Animation (Detected, Selected), SAVE button
• Dialog section: all toggle labels, save button
• All status messages (Saved, NPC moved, respawned, error, etc.)

+130 translation keys added across 6 languages.

Performance Fix​

• Fixed NPC idle animation restore blocking the world thread for 500ms per NPC. With multiple NPCs, this caused multi-second server freezes on chunk load. The delay now runs asynchronously.

PerfectNPC v2.1.1 — Patch Notes​

Bug Fixes

• Fixed "CHANGE" button on the NPC Info page not responding when clicked
• Fixed tooltip toggle (on/off) causing client crashes due to UpdateItems packet being sent at runtime

Localization

• Added full translation support for the admin UI across all 6 languages (EN, FR, DE, ES, IT, PT)
• Translated 50+ hardcoded strings including: section headers, flags, attitudes, quest markers, dialog settings, shop labels, pagination, and advanced settings
• Affected pages: Admin Panel, Shop, Quest Log, Entity Picker, Item Picker, NPC List, Shop Editor

PerfectNPC v2.1.1 — Hotfix for Hytale Update 4

Compatibility fix for Hytale Update 4 (2026.03.26).

Changes:

• Fixed crash caused by removed NPCEntity.setInventorySize() method
• Fixed crash caused by changed Inventory.setActiveHotbarSlot() signature
• NPC equipment display (weapons/armor) is temporarily disabled and will return in the next patch once the new API is fully mapped

If you experience any other issues with Update 4, please reach out via DM.

PerfectNPC v2.1 — Patch Notes​

Fixed: NPCs Running in Place After Relog​

NPCs would lose their Frozen state and Idle animation when a player disconnected nearby and reconnected. Instead of standing still, they would play the default run animation in place.

Root cause: When Hytale unloads a chunk (last player leaves the area), it strips plugin-applied ECS components — Frozen, ActiveAnimation, Interactions, Nameplate, and equipment. The NPCInteractionRestoreSystem only fires on initial entity creation, not on chunk reload. The NPCChunkManager was already detecting chunk load/unload transitions every 2 seconds, but only tracked NPC presence without actually restoring anything.

Fix: The chunk manager now calls addInteractionToEntity() on the world thread whenever it detects a chunk has transitioned from unloaded to loaded for an NPC. This re-applies all plugin components:

• Frozen state
• Idle animation
• Invulnerable flag
• Interaction hint (F to interact)
• Nameplate text
• Equipment (armor & weapons)

Server log now prints "Chunk loaded — restored interactions for NPC: <name>" for visibility.