Changelog

v1.6.0 Major March 6, 2026
Added
  • Citizen Stick — Hit any citizen with the Citizen Stick to instantly open their edit screen.
  • Edit Closest Citizen button — Quickly open the edit screen for the nearest citizen without navigating the full list.
  • Attack other entities — Citizens can now be configured to attack non-player entities in addition to players.
  • Death reward chance — Each item drop entry now has an optional chance (0–100%) to control drop probability.
  • First-Time Interaction actions — Messages and commands can be set to trigger only the first time a player interacts with a citizen.
  • Group renaming — Citizen groups can now be renamed directly from the Manage tab.
  • Patrol path renaming — Patrol paths can now be renamed from the Patrol Paths manager.
  • Configurable Rotate Towards Player distance — Set the exact distance at which a citizen begins rotating to face nearby players.
  • Nametag Lines menu — Dedicated menu for managing multi-line nametag configuration.
  • Health regeneration — Citizens can be configured to regenerate health over time.
Improved
  • Improved overall UI layout and usability.
  • Enhanced support for advanced configuration options.
  • Rich message formatting — Citizen messages now support Bold, Italic, and Clickable Links.
  • New placeholders — {NpcX}, {NpcY}, and {NpcZ} are now available in messages and commands.
  • Improved death handling logic — respawning, drops, and death commands now trigger correctly when a citizen dies from non-player causes.
  • Improved internal handling of respawn timers and citizen lifecycle management.
  • Selection modes for commands and messages — Interaction Commands, Interaction Messages, and Death Commands now each support Random and Sequential execution modes.
  • Patrol Stick usage now requires the hycitizens.admin permission.
Fixed
  • Fixed citizens occasionally breaking (interactions, animations, patrolling, etc.).
  • Fixed several advanced options not saving properly.
  • Fixed citizen respawning logic triggering incorrectly when chunks reload.
  • Fixed "Hide NPC" not persisting when chunks reload.
  • Fixed multiple bugs affecting advanced options introduced in v1.5.
  • Fixed several edge cases.
Developer / API
  • Added CitizenDamageEvent — fires when a citizen takes damage.
  • Added CitizenAddEvent and CitizenRemoveEvent — fire when a citizen is added to or removed from the world.
v1.5.2 Patch February 28, 2026
Improvements & Additions
  • NPC + nametags now share one entity by default, and only use separate nametag entities when needed (hidden NPC, multi-line name, or non-zero nametag offset). This fixes nametags appearing to lag behind walking citizens.
  • Increased citizen max health and damage limit to 1,000,000.
  • When the plugin is first installed and creates the HyCitizensRoles asset pack, it now automatically enables it in the server's config.json when the DefaultModsEnabled is disabled.
  • Added "Patrol Stick" to make it easier to setup patrol routes.
  • Added scrollbar to Patrol Paths and Edit Paths menus.
  • Added "TP", "Move Up", and "Move Down" buttons in the Patrol Path edit menu.
  • Removed outdated and invalid roles.
  • General stability improvements
Bug Fixes
  • Fixed multiple issues that could cause in citizen duplication.
  • Fixed player crashes/disconnects when killing NPCs.
  • Fixed NPC desyncs / interactions stopping every so often.
  • Fixed NPCs disappearing occasionally when updating skin.
  • Fixed despawnCitizenNPC leaving citizens in a limbo state when the entity was already gone.
  • Fixed an issue where nametags would sometimes stop updating.
  • Fixed an issue when assigning NPC models.
  • Fixed an issue with the citizen death commands.
  • Fixed issue when assigning roles.
  • Fixed a nametag spawn lock getting permanently stuck when a citizen's name is empty, preventing all future nametag spawns for that citizen.
  • Fixed removeCitizen throwing a NullPointerException when the citizen ID was missing.
  • Fixed citizens' armor not applying the max health stat correctly.
  • Fixed "Live Skin Update" causing issues for random or customized skins.
  • Fixed re-spawning/saving a citizen briefly showing them as a "naked" player.
  • Fixed an issue where removing an entity from an unloaded world would not always despawn the NPC and nametag.
  • Fixed "F" key interactions breaking citizens.
  • Fixed a patrol move-target entity leak on the despawn path.
  • Fixed an issue where certain characters in names or text could cause interactions or messages to break.
  • Fixed an issue with the attack type auto-resolve button.
  • Fixed the Interactable component being added but never removed when F-key interaction is no longer applicable.
  • Fixed a chunk preload flow incorrectly accepting an invalid entity ref as resolved.
  • Fixed several crashes in the Skin Customizer UI.
  • Fixed user-provided patrol path names with special characters breaking HTML/event ID bindings.
  • and more!
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.