🇨🇳 中文 · 🇺🇸 English

— ✦ —

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

一个AI驱动的修仙世界模拟器，旨在创造一个真正活着的、有沉浸感的仙侠世界。

简介

修仙世界模拟器是一个结合传统游戏规则和大语言模型的模拟器。通过建立完整的修仙世界规则，创造一个可以自主运行、充满生机、有沉浸感和涌现式剧情的虚拟修仙世界。

项目的核心理念是：先建立可信的规则体系作为"世界模型"基础，再接入AI使世界生动起来。

技术架构

• 前端显示: 基于Web的高性能展示
• 模拟引擎: 自研事件驱动模拟器
• 世界模型: 基于规则的确定性系统
• AI集成: LLM接口生成动作、决策、小剧场

项目背景

从小一直是修仙网文的读者，从最早的蜀山仙侠传，到比较新的赤心巡天，修仙网文陪伴了我非常多的时间。

作为游戏AI行业的从业者，对LLM这两年的进步感触很深。我认为，现在的LLM智能水平，已经足够支持起来一些仙侠风格的世界模拟了。

但是，纯粹只有LLM为NPC提供决策和对话能力是不够的。首先，要有可信的规则打底，作为修仙世界的"世界模型"。之后，才是接入LLM，使其生动起来。

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

欢迎大家提出意见或者建议，喜欢的话可以点个star~也可以去我的B站账号观看本项目的介绍视频。

功能开发进度

🏗️ 基础系统

• ✅ 基础世界地图、时间、事件系统
• ✅ 多样化地形类型（平原、山脉、森林、沙漠、水域等）
• ✅ 基于Web前端显示界面
• ✅ 基础模拟器框架
• ✅ 配置文件
• ✅ release 一键即玩的exe
• ✅ 菜单栏 & 存档 & 读档

🗺️ 世界系统

• ✅ 基础tile地块系统
• ✅ 基础区域、修行区域、城市区域、宗门区域
• ✅ 同地块NPC交互
• ✅ 灵气分布与产出设计
• ✅ 世界事件
• [ ] 动态世界观设定、地图、历史、宗门、名人生成

👤 角色系统

• ✅ 角色基础属性系统
• ✅ 修炼境界体系
• ✅ 灵根系统
• ✅ 基础移动动作
• ✅ 角色特质与性格
• ✅ 境界突破机制
• ✅ 角色间的相互关系
• ✅ 角色交互范围
• ✅ 角色Effects系统：增益/减益效果
• ✅ 角色功法
• ✅ 角色兵器 & 辅助装备
• ✅ 角色长短期记忆
• ✅ 角色的长短期目标，支持玩家主动设定
• ✅ 角色绰号
• [ ] 角色之间的相性
• [ ] 技能学习系统：
  • [ ] 可学习技能
  • [ ] 生活职业（丹药、阵法、种植、铸造etc）
• [ ] 凡人角色
• [ ] 天骄系统（更强能力，更强AI）

🏛️ 组织系统

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

⚡ 动作系统

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

🎭 事件系统

• [ ] 世界范围大事件：
  • [ ] 拍卖会
  • [ ] 秘境探索
  • [ ] 比武大会
  • [ ] 天地灵气变动
• [ ] 突发事件
  • [ ] 宝物/洞府出世
• [ ] 自然事件：
  • [ ] 自然灾害
  • [ ] 兽潮

⚔️ 战斗系统

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

🎒 物品系统

• ✅ 基础物品、灵石框架
• [ ] 物品交易机制
• [ ] 经济系统

🌿 生态系统

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

🤖 AI增强系统

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

🏛️ 世界背景系统

• [ ] 背景故事框架
• [ ] 世界观生成
• [ ] 上古历史生成

特殊

• ✅ 奇遇
• ✅ 天劫 & 心魔
• [ ] 飞升上界
• [ ] 道途
• [ ] 夺舍 & 重生
• [ ] 阵法
• [ ] 机缘
• [ ] 可灵活自定义的世界法则
• [ ] 占卜 & 谶纬
• [ ] 男生女相 & 女生男相
• [ ] 角色隐秘/双面人
• [ ] 世界秘密

🔭 远期展望

• [ ] ECS并行工具
• [ ] 历史/事件的小说化&图片化&视频化
• [ ] MCP化，修士自行调用工具

使用方法

运行步骤

1. 克隆项目到本地：

   git clone https://github.com/your-username/cultivation-world-simulator.git
   cd cultivation-world-simulator
   

2. 安装依赖：

   pip install -r requirements.txt
   

3. 配置LLM： 在 static/config.yml 中配置LLM参数：

    llm:
      key: "your-api-key-here"     # 你的API密钥
   

   具体支持的模型请参考 litellm文档

4. 运行： 需要同时启动后端和前端。

   # 在项目根目录
   python src/server/main.py
   

   浏览器会自动打开网页前端。

贡献者

• Aku, 世界观\玩法设计与讨论

许可证

本项目采用 LICENSE 文件中指定的许可证。

联系方式

如果您对项目有任何问题或建议，欢迎提交 Issue 或 Pull Request。 也欢迎给我的B站账号留言！