简体中文 · 繁體中文 · English · Tiếng Việt

— ✦ —

修仙世界模拟器 (Cultivation World Simulator)

你将作为“天道”，观察一个由规则系统与 AI 共同驱动的修仙世界模拟器自行演化。 全员 LLM 驱动、群像涌现叙事、支持 Docker 一键部署，也适合源码开发与二次创作。

📖 简介

这是一个 AI 驱动的修仙世界模拟器。 模拟器中，每一个修士都是独立的Agent，可以自由观测环境并做出决策。同时，为了避免AI的幻觉与过度发散，编入了复杂灵活的修仙世界观与运行规则。在规则与 AI 共同编织的世界中，修士Agent们与宗门意志相互博弈又合作，新的精彩剧情不断涌现。你可以静观沧海桑田，见证门派兴衰与天骄崛起，也可以降下天劫或魔改心灵，微妙地干预世界进程。

✨ 核心亮点

• 👁️ 扮演“天道”：你不是修士，而是掌控世界规则的天道。观察众生百态，体味苦辣酸甜。
• 🤖 全员 AI 驱动：每个 NPC 都独立基于LLM驱动，都有独立的性格、记忆、人际关系和行为逻辑。他们会根据即时局势做出决策，会有爱恨情仇，会结党营私，甚至会逆天改命。
• 🌏 规则作为基石：世界基于灵根、境界、功法、性格、宗门、丹药、兵器、武道会、拍卖会、寿元等元素共同组成的严谨体系运行。AI 的想象力被限制在合理又足够丰富的修仙逻辑框架内，确保世界真实可信。
• 🦋 涌现式剧情：开发者也不知道下一秒会发生什么。没有预设剧本，只有无数因果交织出的世界演变。宗门大战、正魔之争、天骄陨落，皆由世界逻辑自主推演。

宗门体系 城市区域 事件经历

角色面板 性格与装备 自主思考 江湖绰号

洞府探秘 角色信息 丹药/法宝/武器

🚀 快速开始

推荐方式

• 想改代码或调试：使用源码部署，并准备 Python 3.10+、Node.js 18+ 和可用的模型服务。
• 想直接体验：优先使用 Docker 一键部署。

首次启动说明

• 无论使用源码还是 Docker，首次进入后都需要先在设置页配置可用的模型预设（如 DeepSeek / MiniMax / Ollama），再开始新游戏。
• 开发模式下，前端页面通常会自动打开；如果没有自动打开，请访问启动日志中显示的前端地址。

方式一：源码部署（开发模式，推荐）

适合需要修改代码或调试的开发者。

1. 安装依赖并启动

   # 1. 安装后端依赖
   pip install -r requirements.txt
   
   # 2. 安装前端依赖 (需 Node.js)
   cd web && npm install && cd ..
   
   # 3. 启动服务 (自动拉起前后端)
   python src/server/main.py --dev

2. 配置模型 在前端设置页选择模型预设（如 DeepSeek / MiniMax / Ollama）后，即可开始新游戏。配置会自动保存到用户数据目录。

3. 访问前端 开发模式会自动拉起前端开发服务器，请访问启动日志中显示的前端地址，通常为 http://localhost:5173。

方式二：Docker 一键部署（未测试）

无需配置环境，直接运行即可：

git clone https://github.com/4thfever/cultivation-world-simulator.git
cd cultivation-world-simulator
docker-compose up -d --build

访问前端：http://localhost:8123

局域网/手机访问配置 (点击展开)

⚠️ 移动端 UI 暂未完全适配，仅供尝鲜。

1. 后端配置：推荐通过环境变量启动后端，例如 PowerShell 中执行 $env:SERVER_HOST='0.0.0.0'; python src/server/main.py --dev。如需改默认值，可编辑只读配置 static/config.yml 中的 system.host。
2. 前端配置：修改 web/vite.config.ts，在 server 块中添加 host: '0.0.0.0'。
3. 访问方式：确保手机与电脑在同一 WiFi 下，访问 http://<电脑局域网IP>:5173。

💭 为什么要做这个？

修仙网文中的世界很精彩，但读者永远只能观察到一隅。

修仙品类游戏要么是完全的预设剧本，要么依靠人工设计的简单规则状态机，有许许多多牵强和降智的表现。

在大语言模型出现后，让“每一个角色都是鲜活的”的目标变得似乎可以触达了。

希望能够创造出纯粹的、快乐的、直接的、活着的修仙世界的沉浸感。不是像一些游戏公司的纯粹宣传工具，也不是像斯坦福小镇那样的纯粹研究，而是能给玩家提供真实代入感和沉浸感的实际世界。

📞 联系方式

如果您对项目有任何问题或建议，欢迎提交 Issue。

• Bilibili: 点击关注
• QQ群: 1071821688 (入群答案：肥桥今天吃什么)
• Discord: 加入社区

---

⭐ Star History

如果你觉得这个项目有趣，请给我们一个 Star ⭐！这将激励我们持续改进和添加新功能。

👥 贡献者

更多贡献细节请查看 CONTRIBUTORS.md。

📋 功能开发进度

🏗️ 基础系统

• ✅ 基础世界地图、时间、事件系统
• ✅ 多样化地形类型（平原、山脉、森林、沙漠、水域等）
• ✅ 基于Web前端显示界面
• ✅ 基础模拟器框架
• ✅ 配置文件
• ✅ release 一键即玩的exe
• ✅ 菜单栏 & 存档 & 读档
• ✅ 灵活自定义LLM接口
• ✅ 支持mac os
• ✅ 多语言本地化
• ✅ 开始游戏页
• ✅ BGM & 音效
• 更多玩家可操作项

🗺️ 世界系统

• ✅ 基础tile地块系统
• ✅ 基础区域、修行区域、城市区域、宗门区域
• ✅ 同地块NPC交互
• ✅ 灵气分布与产出设计
• ✅ 世界事件
• ✅ 天地人榜
• 更大更美观地图 & 随机地图

👤 角色系统

• ✅ 角色基础属性系统
• ✅ 修炼境界体系
• ✅ 灵根系统
• ✅ 基础移动动作
• ✅ 角色特质与性格
• ✅ 境界突破机制
• ✅ 角色间的相互关系
• ✅ 角色交互范围
• ✅ 角色Effects系统：增益/减益效果
• ✅ 角色功法
• ✅ 角色兵器 & 辅助装备
• ✅ 丹药
• ✅ 角色长短期记忆
• ✅ 角色的长短期目标，支持玩家主动设定
• ✅ 角色绰号
• ✅ 生活技能
  • ✅ 采集、狩猎、采矿、种植
  • ✅ 铸造
  • ✅ 炼丹
• ✅ 凡人
• 化神境界

🏛️ 组织

• ✅ 宗门
  • ✅ 设定、功法、疗伤、驻地、行事风格
  • ✅ 宗门特殊动作：合欢宗（双修），百兽宗（御兽）等
  • ✅ 宗门等阶
  • ✅ 道统
  • 宗门任务
• 世家
• ✅ 朝廷
• ✅ 组织意志AI
• ✅ 组织任务、资源、机能
• ✅ 组织间关系网络

⚡ 动作系统

• ✅ 基础移动动作
• ✅ 动作执行框架
• ✅ 有明确规则的定义动作
• ✅ 长动作执行和结算系统
  • ✅ 支持多月份持续的动作（如修炼、突破、游戏等）
  • ✅ 动作完成时的自动结算机制
• ✅ 多人动作：动作发起与动作响应
• ✅ 影响人际关系的LLM动作
• ✅ 系统性的动作注册与运行逻辑

🎭 事件系统

• ✅ 天地灵气变动
• ✅ 多人大事件：
  • ✅ 拍卖会
  • ✅ 秘境探索
  • ✅ 天下武道会
  • ✅ 宗门传道大会
• 突发事件
  • 宝物/洞府出世
  • 天灾

⚔️ 战斗系统

• ✅ 优劣互克关系
• ✅ 胜率计算系统

🎒 物品系统

• ✅ 基础物品、灵石框架
• ✅ 物品交易机制

🌿 生态系统

• ✅ 动植物
• ✅ 狩猎、采集、材料系统
• 魔兽

🤖 AI增强系统

• ✅ LLM接口集成
• ✅ 角色AI系统（规则AI + LLM AI）
• ✅ 协程化决策机制，异步运行，多线程加速ai决策
• ✅ 长期规划和目标导向行为
• ✅ 突发动作响应系统（对外界刺激的即时反应）
• ✅ LLM驱动的NPC对话、思考、互动
• ✅ LLM生成小片段剧情
• ✅ 根据任务需求分别接入max/flash模型
• ✅ 小剧场
  • ✅ 战斗小剧场
  • ✅ 对话小剧场
  • ✅ 小剧场不同文字风格
• ✅ 一次性选择（如是否要切换功法）

🏛️ 世界背景系统

• ✅ 注入基础世界知识
• ✅ 用户输入历史，动态生成功法、装备、宗门、区域信息

✨ 特殊

• ✅ 奇遇
• ✅ 天劫 & 心魔
• 夺舍 & 重生
• 机缘 & 因果
• 占卜 & 谶纬
• 角色隐秘 & 阴谋
• 飞升上界
• 阵法
• 世界秘密 & 世界法则
• 蛊
• 灭世危机
• 开宗立派/自立世家/成为皇帝

🔭 远期展望

• 历史/事件的小说化&图片化&视频化
• Skill agent化，修士自行规划、分析、调用工具、决策
• 将自己的Claw配入修仙世界