HyCitizens - Interactable NPCs & Holograms

Important

• First restart after installing will trigger a one-time automatic shutdown (expected).

• NPCs must be respawned (click “Save”) for new features to apply. Their chunk must be loaded.

• Patrolling is Part 1/2 — functional but improvements are coming.

• Developer API docs are outdated (v1.4–1.5 not included). Full documentation site launching soon.

• Upcoming updates will focus on polish, improvements, and fixes.

Skin & Cosmetic Menu

• Fully custom human NPCs

• Local skin fetching (if player online)

• Fallback skin prevents invisible NPCs

Custom Behavior System

NPCs now support configurable: • Behavior, movement, combat & interactions

• Health, damage, drops

• Death messages & commands

• Developer death callback event

Patrolling

• Waypoint-based patrol paths

• Path editing system

Limitations: • No combat

• No reaction to attacks

• Editing UI needs improvement

New Interaction System

• “F” works while wandering

• Separate left-click & “F” actions

• Fixed creative mode issues

• Optional delays between commands/messages

• Right-click still unsupported (engine limitation)

Movement

• Custom wander radius

• API movement control

• TP now goes to actual NPC position

Backend & Performance

• Async citizen loading

• Improved stability

• Reworked damage handling

• Improved skin fetching

Improvements

• Alphabetical citizen list

• Command aliases: /citizen /hycitizens /hycitizen

Fixes

• Command order issues

• Hologram API functions

• Console warnings on join

• Rare data.json wipe

• Skin change bugs

• NPC/nametag duplication

• Special character name issues

Developer Additions

• Death callback

• Movement API control

• Async improvements

Known Issues

• Attack animations not customizable

• Patrolling NPCs can’t fight or react (for now)

Consider supporting HyCitizen's Development: https://ko-fi.com/electrogames