+ ๐จ๐ณ ไธญๆ ยท ๐บ๐ธ English +
+โ โฆ โ
+ +# Cultivation World Simulator + +An AI-augmented, rules-driven cultivation world simulator aimed at creating a truly living and immersive xianxia world. + +## Overview + +Cultivation World Simulator combines traditional deterministic rule systems with modern AI. It models terrains, characters, cultivation system, relationships, and more, to form an autonomous, vibrant virtual world. + +Core idea: **Build a credible rule-based world model first, then plug in AI to bring it to life.** + +### Tech Stack + +- **Frontend Rendering**: pygame (Web support in the future) +- **Simulation Engine**: custom event-driven simulator +- **World Model**: rule-based deterministic systems +- **AI Integration**: LLM-generated actions, decisions, micro-stories + +## Background + +I have been a long-time reader of xianxia novels, from classics to modern works. As a game AI practitioner, I believe todayโs LLM capabilities are sufficient to support a xianxia-style world simulation. + +However, LLM-only NPC decision/dialogue is not enough. A credible rule system must ground the world as the โworld modelโ, and then AI makes it vivid. + +I aim to create a pure, joyful, direct, living sense of immersion. Not a mere marketing demo, nor purely academic like โStanford Townโ, but a world that players can actually feel and inhabit. + +If you like this project, consider starring it. You can also watch an intro video on my Bilibili: [`link`](https://space.bilibili.com/527346837). + + + +## Development Progress + +### ๐๏ธ Foundation +- โ World map basics +- โ Diverse terrain types (plain, mountain, forest, desert, water, etc.) +- โ Time system (year-month timestamps) +- โ Frontend UI (pygame) +- โ Simulation framework +- โ Project documentation (README) +- โ Config system +- [ ] Standalone release (packaged exe) +- [ ] Web frontend (later) +- [ ] ECS parallel toolkit (later) +- [ ] Player-configurable prompts (later) + +### ๐บ๏ธ Tile System +- โ Basic tile mechanics +- โ Normal, cultivate, city, sect regions +- โ Same-tile NPC interactions +- โ Qi distribution and yields + +### ๐ค Character System +- โ Core attributes +- โ Cultivation realms +- โ Spiritual roots +- โ Basic movement actions +- โ Personality +- โ Breakthrough system +- โ Relationships +- โ Perception radius +- [ ] Special abilities +- [ ] Epithets/nicknames +- [ ] Buff system: buffs/debuffs, state mgmt +- [ ] Combat-related + - [ ] Attribute points allocation + - [ ] Skill system (techniques) + - [ ] Equipment system + - [ ] Artifacts system +- [ ] Skill learning + - [ ] Learnable skills + - [ ] Personal techniques (flexible integration) + - [ ] Life professions (alchemy, formations, farming, forging, etc., with tailored prompts and info space) +- [ ] Mortals support +- [ ] Prodigies (stronger abilities and AI) + +### ๐๏ธ Organizations +- [ ] Sect system + - โ Settings, techniques, healing, base, styles + - โ Special sect action: Hehuan Sect (dual cultivation) + - [ ] Sect artifacts, sect will AI, tasks, recruiting + - [ ] Sect tiers: different titles, abilities, actions +- [ ] Clans +- [ ] Court/Empire (TBD) +- [ ] Inter-organization relations + +### โก Action System +- โ Basic movement +- โ Action execution framework +- โ Defined actions (rule-complete) +- โ Long-duration actions and settlement + - โ Multi-month actions (cultivate, breakthrough, play, etc.) + - โ Auto-settlement upon completion +- โ Multiplayer actions: initiator + responder flow +- โ LLM actions that affect relationships +- โ Systematic action registration and runtime logic +- [ ] Richer actions + +### ๐ญ Event System +- [ ] World-scale events: + - [ ] Auctions + - [ ] Secret realm exploration + - [ ] Martial tournaments +- [ ] Sudden events + - [ ] Treasure/cave emergence + - [ ] Novelized/CG/film-style presentations +- [ ] Natural events: + - [ ] Natural disasters + - [ ] Beast tides + +### โ๏ธ Combat +- [ ] Combat design (roots influence skills and styles) +- [ ] Advantages and counters +- โ Win-rate estimation (simple) + +### ๐ Items +- โ Basic items and spirit stones +- [ ] Trading mechanics +- [ ] Economy system + +### ๐ฟ Ecology +- โ Animals and plants +- โ Hunting, gathering, materials +- [ ] Beasts/monsters + +### ๐ค AI Enhancements +- โ LLM interface integration +- โ Character AI (rules AI + LLM AI) +- โ Coroutine decision making, async, multithreaded speedups +- โ Long-term planning and goal-driven behavior +- โ Reactive responses to external stimuli +- โ LLM-driven NPC dialogue, thinking, interaction +- โ LLM-generated micro-stories +- โ Use different models (max/flash) per task needs +- โ Micro-theaters + - โ Battle micro-theaters + - โ Dialogue micro-theaters + - โ Multiple writing styles +- [ ] NPC observation space design +- [ ] One-off choices (e.g., switch techniques or not) +- [ ] Long-term memories / unforgettable memories + +### ๐๏ธ World Lore +- [ ] Lore framework +- [ ] Worldbuilding +- [ ] Ancient history generation + +### Specials +- [ ] Fortuitous encounters +- [ ] Paths/Daos +- [ ] Possession & Rebirth +- [ ] Formations +- [ ] Opportunities +- [ ] Tribulations & Heart devils +- [ ] Flexible world rules +- [ ] Divination & Omens +- [ ] Male-female traits inversion + +## Usage + +### Run Steps +1. Clone the repo: + ```bash + git clone https://github.com/your-username/cultivation-world-simulator.git + cd cultivation-world-simulator + ``` + +2. Install dependencies: + ```bash + pip install -r requirements.txt + ``` + +3. Configure LLM: + Edit `static/config.yml`: + ```yaml + llm: + model_name: "gpt-3.5-turbo" # or another model supported by LiteLLM + key: "your-api-key-here" # your API key + ``` + See the LiteLLM docs: [`link`](https://docs.litellm.ai/docs/providers) + +4. Run the simulator: + ```bash + python -m src.run.run + ``` + +### Basic Operations +- A random map is generated at startup +- Observe characters moving and acting in the world +- Press ESC to quit + +## Contributing + +Contributions are welcome! + +## License + +This project is licensed as specified in [`LICENSE`](LICENSE). + +## Contact + +Open an issue or pull request if you have questions or suggestions. + + diff --git a/README.md b/README.md index 2eb4ca3..5fa3bb7 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,9 @@ + ++ ๐จ๐ณ ไธญๆ ยท ๐บ๐ธ English +
+โ โฆ โ
+ # ไฟฎไปไธ็ๆจกๆๅจ (Cultivation World Simulator) ไธไธชๅบไบ่งๅๅAI้ฉฑๅจ็ไฟฎไปไธ็ๆจกๆๅจ๏ผๆจๅจๅ้ ไธไธช็ๆญฃๆดป็็ใๆๆฒๆตธๆ็ไปไพ ไธ็ใ