HyCitizens - Interactable NPCs & Holograms

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!

For dialogs and quests, check out the official QuestLines addon for HyCitizens.

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.