promotional bannermobile promotional banner

HyCitizens - Interactable NPCs & Holograms

HyCitizens is a plugin that lets you create and manage NPCs (citizens), with full in-game controls and optional API support for developers.

File Details

HyCitizens-1.5.2.jar

  • R
  • Feb 28, 2026
  • 1.24 MB
  • 1.0K
  • Early Access

File Name

HyCitizens-1.5.2.jar

Supported Versions

  • Early Access

Improvements & Additions:

  • NPC + Nametags are now the same entity unless the citizen's name uses multiple lines or has an 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!