Changelog

v1.5.1 Patch February 23, 2026
⚠️

Note: If you are having issues with citizens spawning after updating to v1.5, try updating your HytaleServer.jar, even if it's already on the latest version.

Fixed
  • Fixed an issue where you couldn't open "Advanced settings" in the behavior menu
  • Fixed an issue with non-citizens reacting to interactions
  • Fixed an error in the patrol menu
  • Fixed an issue with the interaction listener for the Developer API — also fixes compatibility with the NPC Trading plugin
  • Fixed an issue with using apostrophes in citizen names
Improved
  • Added setForceFKeyInteractionText() to the Developer API
v1.5.0 Major February 23, 2026
⚠️

Important: After installing this update, the server will perform a one-time automatic shutdown on first restart — this is expected. NPCs must be respawned (click "Save") for some new features to apply; their chunk must be loaded.

Added
  • Skin & Cosmetic Menu — Fully customizable human NPCs with a dedicated skin/cosmetic menu
  • Local skin fetching — Player skin is now fetched locally if the player is online, with a fallback skin to prevent invisible NPCs
  • Custom Behavior System — Fully configurable behavior, movement, attacks, interaction logic, and combat configuration per citizen
  • Configurable health & damage — Set citizen health and damage values independently
  • Death configuration — Configurable item drops, messages, and commands executed on citizen death
  • Death callback event — Developer API callback fired when a citizen dies
  • Patrolling system — Citizens can follow waypoint-based patrol paths with a built-in path editing system (Work in progress — no combat support yet)
  • Redesigned interaction system — "F" key now works while citizens are wandering; left-click and "F" interactions can have separate actions; optional delays between commands and messages
  • Custom wander radius — No longer limited to predefined radius values
  • Movement API control — Developers can now control citizen movement via the API
  • Command aliases — Added /citizen, /hycitizens, and /hycitizen as aliases
Improved
  • Citizens are now loaded asynchronously for better performance
  • Reworked damage handling — replaced hacky knockback prevention with a proper solution
  • Improved skin fetching logic and overall stability
  • "TP" button now teleports to the actual NPC position, falling back to stored position if needed
  • Citizens are now listed in alphabetical order
Fixed
  • Fixed commands not executing in the correct order
  • Fixed updateCitizenHologram() and updateSpawnedCitizenHologram() in the Developer API
  • Fixed console exceptions and warnings when players join
  • Fixed rare issue where data.json could be emptied
  • Fixed changing a citizen's player skin after creation
  • Fixed NPC and nametag duplication bug
  • Fixed issues using special characters such as < and > in citizen names
  • Fixed creative mode preventing "F" key interactions
v1.4.2 Patch February 17, 2026
Fixed
  • Fixed breaking changes introduced by the latest Hytale update
v1.4.1 Patch February 8, 2026
Improved
  • Added a 1-block radius option for wandering
Fixed
  • Fixed an issue with Rotate Towards Player for non-player entities
  • Fixed proximity animations not playing for citizens without Rotate Towards Player enabled
  • Fixed an issue with the Player entity
  • Fixed an issue with citizen knockback
  • Fixed death message incorrectly displaying "Template" as the killer
v1.4.0 Major February 8, 2026
Added
  • Walking citizens — Citizens can now walk around
  • Nametag-only mode — Option to spawn a floating nametag without an NPC body
  • Search bar — Quickly find citizens in the management UI
  • Citizen groups — Organize citizens into groups
  • Behavior modes — Passive, Neutral, and Aggressive citizen behavior types
  • Combat system — Citizens can now take damage, die, and respawn
  • Random Player Skin button — Assign a random player skin with one click
  • Dynamic model/entity selector — Now fetches models dynamically, including custom models from other mods
  • Editable commands & messages — Commands and messages can now be edited after creation
  • Dedicated messages menu — New messages system with support for sending all at once, sequential order, and random order
  • Animation support — Citizens now support animations (a third-party animation mod is recommended)
Improved
  • Improved stored data formatting
  • Improved general stability and usability
  • Knockback is now properly cancelled when citizen damage is disabled
  • Improved offline player skin fetching
Fixed
  • Fixed major bug causing chunks to stop ticking and potential world corruption
  • Fixed NPC health resetting after armor changes
  • Fixed NPC rotation issues for non-player NPCs
  • Fixed double citizen spawning
  • Fixed hologram update behavior causing disappearance and flickering
  • Fixed "Rotate Towards Player" UI option visibility
  • Fixed inconsistent rotate/look-at-player behavior after server restart
  • Fixed multi-line nametag issues when citizen scaling is applied
  • Fixed rare issues with the stored data file
  • Fixed knockback not cancelling correctly when damage is disabled
  • Fixed stored data cleanup not fully removing citizen data on deletion
v1.3.2 Patch February 3, 2026
⚠️

Critical: Always shut down your server using /stop or your hosting panel's Stop button to avoid potential problems introduced by the chunk workaround in this release.

Added
  • Update notifications — Staff members now receive automatic messages when a new update is available
Fixed
  • Critical: Resolved an issue where NPCs with player skins could break chunks, which in rare cases had the potential to corrupt them. A workaround has been implemented for this Hytale-side issue.
v1.3.1 Patch February 1, 2026
Fixed
  • Fixed an issue preventing citizens from spawning
v1.3.0 Minor February 1, 2026
Added
  • "F" key interactions — Players can now press F to interact with citizens (survival mode only)
  • Entity selector list — New dropdown for easier NPC model selection
  • Multi-line nametags — Citizen nametags now support multiple lines
  • Clone button — Duplicate an existing citizen from the Citizens Manager menu
  • TP button — Teleport to a citizen's location directly from the Citizens Manager menu
Improved
  • Improved overall UI and usability
  • Fixed various issues and console warnings/errors
  • Fixed name display issue with the EyeSpy mod
Breaking Changes (Developer API)
  • Creating a citizen now requires a list of hologram UUIDs instead of a single UUID — update any code using the CitizenData constructor accordingly
v1.2.0 Minor January 31, 2026
Added
  • {CitizenName} placeholder — Use the citizen's name dynamically in commands and messages
  • Hide nametags — Option to hide a citizen's nametag entirely
  • Nametag offset — Ability to set a custom vertical offset for nametags
  • Always look at player — Option to make NPCs always rotate to face the nearest player
  • Armor & held item — Ability to set a citizen's armor and item held in hand
Improved
  • Citizens no longer take knockback damage from weapons
  • Performance improvements for citizens in unloaded chunks
  • Removed the "Commands" button from the citizen creation page
  • Other small improvements
v1.1.0 Minor January 30, 2026
Added
  • Player skin support — Citizens can now be assigned player skins
Improved
  • General improvements to stability and usability
v1.0.0 Initial Release January 30, 2026
Added
  • Core citizen system — Create, configure, and spawn NPC citizens in Hytale worlds
  • Citizens management UI — In-game UI to create, edit, and delete citizens
  • /citizens command — Root command for all citizen management
  • Available on CurseForge, BuiltByBit, HytalePlaza, and GitHub

Have questions? Join our Discord community or check out the GitHub repository.