You can download the mod/plugin from CurseForge!
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.



