HyCitizens is a full in-game NPC (Citizen) management plugin that allows you to create interactive NPCs and holograms 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:

Over 150 configurable options
Custom name
Custom position
Custom rotation
Custom entity type / model id
Visible/hidden nametags
Visible/hidden NPCs (for holograms/floating text)
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)
Markers on map
Can use models for nametags
Daily schedules/routines
Can follow other citizens around
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.

HyCitizens - Interactable NPCs & Holograms