Citizens & NPCs

Citizens & NPCs

Mod: kyuubisoft-core.jar | Config: configs/kyuubisoft_core/citizens.json

The Citizens system lets you spawn and manage custom NPCs across your Hytale server. Citizens have custom skins, dialog trees, animations, world map markers and can interact with the quest and achievement systems.

Features

• Custom NPCs — Spawn NPCs with unique skins, equipment, names and attitudes
• Dialog System — Multi-node dialog trees with choices, conditions and macros
• Proximity Detection — NPCs react when players approach (animations, dialog)
• World Map Markers — Show NPCs on the world map with quest status indicators
• F-Key Interaction — Players interact with NPCs using the interact key
• Animations — Idle, wander, emote and custom animation support
• Multi-World — NPCs work across all server worlds
• Quest Integration — NPCs serve as quest givers with offer/active/complete states

Quick Start

1. The Core mod JAR includes the citizen system — install it in mods/
2. Default citizens generate in configs/kyuubisoft_core/citizens.json
3. Use /kscitizen list to see all spawned NPCs
4. Add new citizens to the JSON config and /kscitizen reload

Commands

Command	Description
/kscitizen list [group]	List all citizens
/kscitizen create <id>	Create a new citizen at your position
/kscitizen remove <id>	Remove a citizen
/kscitizen tp <id>	Teleport to a citizen
/kscitizen respawn <id>	Respawn a single citizen
/kscitizen respawnall	Despawn and respawn all citizens
/kscitizen reload	Reload citizen configs
/kscitizen info <id>	Show citizen details
/kscitizen marker <id> [type]	Set/remove quest marker
/kscitizen viewer	Open NPC viewer admin page
/kscitizen wprecord <id>	Start waypoint recording
/kscitizen wpadd	Add waypoint at current position
/kscitizen wpundo	Remove last waypoint
/kscitizen wpdone	Stop recording and save

Documentation

import DocCardList from ‘@theme/DocCardList’;