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	List all citizens
/kscitizen create	Create a new citizen
/kscitizen remove <id>	Remove a citizen
/kscitizen teleport <id>	Teleport to a citizen
/kscitizen respawn	Respawn all citizens
/kscitizen reload	Reload citizen configs
/kscitizen info <id>	Show citizen details
/kscitizen marker	Toggle world map markers

Documentation

📄️ Getting Started

Install and set up NPC citizens on your server

🗃️ Configuration

4 items

🗃️ Reference

2 items