User Guide

The User Guide covers everything you need to configure and manage citizens in your Hytale world using the in-game UI — no coding required.

Topics

• Creating Citizens — Open the Citizens Manager, create a new citizen, configure its name, model, skin, group, scale, and permissions. Learn how to manage, clone, teleport to, and delete citizens from the Manage tab.
• Skin Customization — Use the in-game Skin Customizer to pick every individual cosmetic slot, use a player's skin, generate a random skin, or enable live skin updates.
• Messages & Interactions — Configure what a citizen says when interacted with. Set up colors, placeholders, delays, selection modes, and interaction triggers.
• Command Actions — Run server or player commands on interaction, with delays, interaction triggers, and the {SendMessage} shorthand.
• Behaviors — The central hub for a citizen's in-world behavior: attitude (passive/neutral/aggressive), damage, health, respawn, movement type, animations, and access to advanced configuration.
• Animations — Add animation behaviors with six trigger types: Default, On Interact, On Attack, Proximity Enter, Proximity Exit, and Timed. Configure animation slots and auto-stop.
• Movement & Patrol — Set a citizen to Idle, Wander, or Patrol. Create and manage patrol paths with waypoints, pause times, and loop modes.
• Health & Combat — Configure override health and damage values, and tune the detailed Detection Config and Combat Config parameters for hostile citizens.
• Death Configuration — Define item drops, messages to the killer, and commands triggered when a citizen dies.