Background

HyCitizens - Interactable NPCs & Holograms

ModsHyCitizens - Interactable NPCs & Holograms
HyCitizens - Interactable NPCs & Holograms

HyCitizens - Interactable NPCs & Holograms

CurseForge
Mobs\CharactersUtilityLibrary

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

You can download the mod/plugin from CurseForge!

Join us on Discord
Star on GitHub
Support me on Ko-fi

HyCitizens is a full in-game NPC (Citizen) management plugin that allows you to create interactive NPCs for your server.
Everything can be configured directly in-game through a clean UI, with an optional developer API for full control and integration.


Command: /citizens

User and Developer Documentation: https://hycitizens.com/docs

Features

Citizen / NPC System

Create and manage Citizens (NPCs) that can be placed anywhere in your world.

Each Citizen supports:

  • Custom name
  • Custom position
  • Custom rotation
  • Custom entity type / model id
  • Visible/hidden nametags and NPCs
  • Player models and skins
  • Armor and an item in hand
  • Custom scale
  • Custom hit actions
  • Animations
  • Walking around
  • Passive, Neutral, and Aggressive behavior
  • Persistent saving/loading (Citizens stay after restarts)
  • Trading with players (This requires the NPC Trading plugin)
  • AND MORE!

In-Game Management UI

Use:

/citizens

This opens the Citizens UI, where you can:

  • Create new Citizens
  • Edit existing Citizens
  • Delete Citizens
  • Update Citizen properties instantly

No configuration files required to use the plugin.


Interactions (Hit Actions)

Citizens can be configured to run actions when a player hits/interacts with them.

Command Actions

You can add one or more commands to a Citizen that will run when the NPC is hit.

Each command supports:

  • Running as the Player
  • Running as the Server
  • Optional permission requirement before running

Permissions

Citizens can require a permission before they can be used.

If a permission is set:

  • Players without the permission will be blocked
  • A custom “no permission” message can be shown

Messages

Citizens can also send messages to the player when hit/interacted with.


Saving / Persistence

Citizens are stored automatically and restored when the server restarts.


Discord / Support

If you would like to join the community, suggest features, report bugs, or need some help, join the Discord community! https://discord.gg/Snqz9E58Dr


Support HyCitizens

Want to support HyCitizens? You can donate at Ko-fi or share HyCitizens with your friends!


Credits

This plugin has been made possible by HyUI.

Credits

This plugin has been made possible by HyUI.

📸Gallery

Screenshot 2026-03-02 040616.png
Screenshot 2026-03-02 040616.png
Screenshot 2026-03-02 040340.png
Screenshot 2026-03-02 040340.png
Screenshot 2026-03-02 040343.png
Screenshot 2026-03-02 040343.png
HyCitizens - Interactable NPCs & Holograms - Hytale Mod | Hytale Wiki