Project Overview

This open-source Cultivation World Simulator uses AI agent workflows to create a dynamic, emergent Xianxia world. It targets users seeking an immersive simulation by allowing them to play as a divine overseer ("天道" or God), observing AI-driven NPCs interact and evolve organically, leading to unpredictable, emergent storylines.

How It Works

The simulator places the user in a "God" perspective, observing a world governed by numerical systems (spirit roots, cultivation realms, lifespans) and AI logic. Each Non-Player Character (NPC) is powered by an LLM, possessing independent personalities, memories, relationships, and decision-making capabilities. This AI-driven approach ensures emergent gameplay, where events unfold organically without pre-scripted narratives, driven by AI agent interactions and simulation rules.

Quick Start & Requirements

• Installation: Clone the repository, install Python backend dependencies (pip install -r requirements.txt), and Node.js frontend dependencies (cd web && npm install).
• LLM Configuration: Via local_config.yml or frontend settings, supporting OpenAI-compatible APIs and local Ollama. Requires API keys.
• Running: Launch the development server with python src/server/main.py --dev.

Highlighted Details

• "God" Perspective: Players act as the world's overseer ("天道"), influencing events rather than controlling a single character.
• Fully AI-Driven NPCs: Every NPC is an LLM agent with unique traits, memories