This project now supports English. Don't hesitate to give it a try!
— ✦ —
一个AI驱动的修仙世界模拟器，旨在创造一个真正活着的、有沉浸感的仙侠世界。
这是一个 AI 驱动的开放世界修仙模拟器。
不同于传统的 RPG 扮演某个角色，在这里，你将扮演“天道”（上帝）。 你不需要亲自打怪升级，而是以上帝视角观察众生，在规则与 AI 共同编织的开放世界中，见证门派兴衰与天骄崛起。你可以静观沧海桑田，也可以降下天劫或魔改心灵，微妙地干预世界进程。
- 👁️ 扮演“天道” (上帝视角)：你不是修士，而是掌控世界规则的天道。观察众生百态，体味苦辣酸甜。
- 🤖 全员 AI 驱动：每个 NPC 都独立基于LLM驱动，都有独立的性格、记忆、人际关系和行为逻辑。他们会根据即时局势做出决策，会有爱恨情仇，会结党营私，甚至会逆天改命。
- 🌏 规则作为基石：世界基于灵根、境界、功法、寿元等严谨的数值体系运行。AI 的想象力被限制在合理的修仙逻辑框架内，确保世界真实可信。
- 🦋 涌现式剧情：开发者也不知道下一秒会发生什么。没有预设剧本，只有无数因果交织出的世界演变。宗门大战、正魔之争、天骄陨落，皆由世界逻辑自主推演。
|
|
|
修仙网文中的世界很精彩，但读者永远只能观察到一隅。
修仙品类游戏要么是完全的预设剧本，要么依靠人工设计的简单规则状态机，有许许多多牵强和降智的表现。
在大语言模型出现后，让“每一个角色都是鲜活的”的目标变得似乎可以触达了。
希望能够创造出纯粹的、快乐的、直接的、活着的修仙世界的沉浸感。不是像一些游戏公司的纯粹宣传工具，也不是像斯坦福小镇那样的纯粹研究，而是能给玩家提供真实代入感和沉浸感的实际世界。
如果您对项目有任何问题或建议，欢迎提交 Issue 或 Pull Request。
欢迎给我的B站账号留言！
也可以加入QQ群进行讨论：1071821688。进群问题的答案：肥桥今天吃什么
加入 Discord 社区：https://discord.gg/shhRWmZR
如果你已经安装了 Docker，这是最简单的方式：
-
克隆项目
git clone https://github.com/AI-Cultivation/cultivation-world-simulator.git cd cultivation-world-simulator -
启动服务（自动构建并运行）
docker-compose up -d --build
-
克隆项目到本地：
git clone https://github.com/AI-Cultivation/cultivation-world-simulator.git cd cultivation-world-simulator -
安装依赖：
# 后端依赖 pip install -r requirements.txt # 前端依赖 (需Node.js环境) cd web && npm install
-
配置LLM：
推荐方式：在前端直接配置（支持快速填充预设）
也可以在
static/local_config.yml中手动配置（OpenAI兼容格式）：llm: base_url: https://api.deepseek.com # API地址 key: your-api-key-here # 你的API密钥 model_name: deepseek-chat # 智能模型名称 fast_model_name: deepseek-chat # 快速模型名称 mode: default # 运行模式 (default/normal/fast)
本地部署 (Ollama)： 也支持对接本地 Ollama，在前端选择 "Ollama (本地)" 预设即可。
-
运行：
# 启动服务 (推荐开发模式，会自动启动前端) python src/server/main.py --dev浏览器会自动打开网页前端。
无论使用哪种方式运行，启动后都可以通过以下地址访问：
前端：http://localhost:8123
后端 API：http://localhost:8002
支持从局域网内的其他设备（如手机、平板）访问游戏。
⚠️ 注意：移动端 UI 目前未做适配优化，体验可能不佳。详见 Issue #130。
配置步骤：
-
在
static/local_config.yml中添加：system: host: "0.0.0.0" # 允许局域网访问
-
如果使用开发模式（
--dev），还需在web/vite.config.ts的server配置中添加：server: { host: '0.0.0.0', // 添加这一行 proxy: { ... } }
-
启动服务器后，在手机浏览器访问：
http://<电脑局域网IP>:5173 # 开发模式 http://<电脑局域网IP>:8002 # 生产模式 -
查看电脑局域网 IP：
# macOS ipconfig getifaddr en0 # Linux hostname -I # Windows ipconfig
💡 确保手机和电脑连接同一个 WiFi，且防火墙已放行对应端口。
如果你觉得这个项目有趣，请给我们一个 Star ⭐！这将激励我们持续改进和添加新功能。
更多贡献细节请查看 CONTRIBUTORS.md。
- ✅ 基础世界地图、时间、事件系统
- ✅ 多样化地形类型（平原、山脉、森林、沙漠、水域等）
- ✅ 基于Web前端显示界面
- ✅ 基础模拟器框架
- ✅ 配置文件
- ✅ release 一键即玩的exe
- ✅ 菜单栏 & 存档 & 读档
- ✅ 灵活自定义LLM接口
- ✅ 支持mac os
- ✅ 多语言本地化
- ✅ 开始游戏页
- ✅ BGM & 音效
- Mod支持
- ✅ 基础tile地块系统
- ✅ 基础区域、修行区域、城市区域、宗门区域
- ✅ 同地块NPC交互
- ✅ 灵气分布与产出设计
- ✅ 世界事件
- ✅ 角色基础属性系统
- ✅ 修炼境界体系
- ✅ 灵根系统
- ✅ 基础移动动作
- ✅ 角色特质与性格
- ✅ 境界突破机制
- ✅ 角色间的相互关系
- ✅ 角色交互范围
- ✅ 角色Effects系统：增益/减益效果
- ✅ 角色功法
- ✅ 角色兵器 & 辅助装备
- ✅ 丹药
- ✅ 角色长短期记忆
- ✅ 角色的长短期目标，支持玩家主动设定
- ✅ 角色绰号
- 生活技能
- ✅ 铸造
- ✅ 炼丹
- 种植
- 饲养
- 技能可升级
- ✅ 凡人
- 宗门
- ✅ 设定、功法、疗伤、驻地、行事风格
- ✅ 宗门特殊动作：合欢宗（双修），百兽宗（御兽）等
- ✅ 宗门等阶
- 道统
- 世家
- 朝廷
- 组织意志AI
- 组织任务、资源、机能
- 组织间关系网络
- ✅ 基础移动动作
- ✅ 动作执行框架
- ✅ 有明确规则的定义动作
- ✅ 长动作执行和结算系统
- ✅ 支持多月份持续的动作（如修炼、突破、游戏等）
- ✅ 动作完成时的自动结算机制
- ✅ 多人动作：动作发起与动作响应
- ✅ 影响人际关系的LLM动作
- ✅ 系统性的动作注册与运行逻辑
- ✅ 天地灵气变动
- ✅ 多人大事件：
- ✅ 拍卖会
- ✅ 秘境探索
- 比武大会
- 宗门传道大会
- 突发事件
- 宝物/洞府出世
- 自然事件：
- 自然灾害
- 兽潮
- ✅ 优劣互克关系
- ✅ 胜率计算系统
- ✅ 基础物品、灵石框架
- ✅ 物品交易机制
- ✅ 动植物
- ✅ 狩猎、采集、材料系统
- 魔兽
- ✅ LLM接口集成
- ✅ 角色AI系统（规则AI + LLM AI）
- ✅ 协程化决策机制，异步运行，多线程加速ai决策
- ✅ 长期规划和目标导向行为
- ✅ 突发动作响应系统（对外界刺激的即时反应）
- ✅ LLM驱动的NPC对话、思考、互动
- ✅ LLM生成小片段剧情
- ✅ 根据任务需求分别接入max/flash模型
- ✅ 小剧场
- ✅ 战斗小剧场
- ✅ 对话小剧场
- ✅ 小剧场不同文字风格
- ✅ 一次性选择（如是否要切换功法）
- ✅ 注入基础世界知识
- ✅ 用户输入历史，动态生成功法、装备、宗门、区域信息
- ✅ 奇遇
- ✅ 天劫 & 心魔
- 夺舍 & 重生
- 机缘 & 因果
- 占卜 & 谶纬
- 角色隐秘 & 阴谋
- 飞升上界
- 阵法
- 世界秘密 & 世界法则
- 蛊
- 灭世危机
- 开宗立派/自立世家
- 历史/事件的小说化&图片化&视频化
- MCP agent化，修士自行调用工具