— ✦ —
# 修仙世界模拟器 (Cultivation World Simulator) 一个AI驱动的修仙世界模拟器，旨在创造一个真正活着的、有沉浸感的仙侠世界。 ## 简介 修仙世界模拟器是一个结合传统游戏规则和大语言模型的模拟器。通过建立完整的修仙世界规则，创造一个可以自主运行、充满生机、有沉浸感和涌现式剧情的虚拟修仙世界。 项目的核心理念是：**先建立可信的规则体系作为"世界模型"基础，再接入AI使世界生动起来**。 ### 技术架构 - **前端显示**: pygame (未来可能支持Web) - **模拟引擎**: 自研事件驱动模拟器 - **世界模型**: 基于规则的确定性系统 - **AI集成**: LLM接口生成动作、决策、小剧场 ## 项目背景 从小一直是修仙网文的读者，从最早的蜀山仙侠传，到比较新的赤心巡天，修仙网文陪伴了我非常多的时间。 作为游戏AI行业的从业者，对LLM这两年的进步感触很深。我认为，现在的LLM智能水平，已经足够支持起来一些仙侠风格的世界模拟了。 但是，纯粹只有LLM为NPC提供决策和对话能力是不够的。首先，要有可信的规则打底，作为修仙世界的"世界模型"。之后，才是接入LLM，使其生动起来。 我希望能够创造出纯粹的、快乐的、直接的、活着的修仙世界的沉浸感。不是像一些游戏公司的纯粹宣传工具，也不是像斯坦福小镇那样的纯粹研究，而是能给玩家提供真实代入感和沉浸感的实际世界。 欢迎大家提出意见或者建议，喜欢的话可以点个star~也可以去[我的B站账号](https://space.bilibili.com/527346837)观看本项目的介绍视频。  ## 功能开发进度 ### 🏗️ 基础系统 - ✅ 基础世界地图系统 - ✅ 多样化地形类型（平原、山脉、森林、沙漠、水域等） - ✅ 时间系统（年月时间戳） - ✅ 前端显示界面（pygame） - ✅ 基础模拟器框架 - ✅ 项目文档（README） - ✅ 配置文件系统（config） - [ ] 单独release打包好的exe文件 - [ ] Web前端支持（后期考虑） - [ ] ECS并行工具（后期考虑） - [ ] 玩家自定义prompt（后期考虑） ### 🗺️ 世界系统 - ✅ 基础tile地块系统 - ✅ 基础区域、修行区域、城市区域、宗门区域 - ✅ 同地块NPC交互 - ✅ 灵气分布与产出设计 - [ ] 动态世界观设定、地图、历史、宗门、名人生成 ### 👤 角色系统 - ✅ 角色基础属性系统 - ✅ 修炼境界体系 - ✅ 灵根系统 - ✅ 基础移动动作 - ✅ 角色性格 - ✅ 境界突破机制 - ✅ 角色间的相互关系 - ✅ 角色交互范围 - ✅ 角色Buffs系统：增益/减益效果 - ✅ 法宝 - [ ] 角色之间的相性 - [ ] 角色特殊能力 - [ ] 角色绰号 - [ ] 战斗相关 - [ ] 属性点分配 - [ ] 技能系统（功法） - [ ] 装备系统 - [ ] 技能学习系统： - [ ] 可学习技能 - [ ] 个人技（灵活融入代码） - [ ] 生活职业（丹药、阵法、种植、铸造etc，配合特殊prompt和信息空间） - [ ] 凡人角色支持 - [ ] 天骄系统（更强能力，更强AI） ### 🏛️ 组织系统 - [ ] 宗门系统 - ✅ 设定、功法、疗伤、驻地、行事风格 - ✅ 宗门特殊动作：合欢宗（双修），百兽宗（御兽） - [ ] 宗门意志ai、宗门任务、接引新人 - [ ] 宗门等阶：不同称谓、能力、动作 - [ ] 世家系统 - [ ] 朝廷系统（不确定） - [ ] 组织间关系网络 ### ⚡ 动作系统 - ✅ 基础移动动作 - ✅ 动作执行框架 - ✅ 有明确规则的定义动作(Defined Action) - ✅ 长动作执行和结算系统 - ✅ 支持多月份持续的动作（如修炼、突破、游戏等） - ✅ 动作完成时的自动结算机制 - ✅ 多人动作：动作发起与动作响应 - ✅ 影响人际关系的LLM动作(LLM Action) - ✅ 系统性的动作注册与运行逻辑 - [ ] 更丰富的角色动作 ### 🎭 事件系统 - [ ] 世界范围大事件： - [ ] 拍卖会 - [ ] 秘境探索 - [ ] 比武大会 - [ ] 突发事件 - [ ] 宝物/洞府出世 - [ ] 突发事件的小说化&CG化&影视化 - [ ] 自然事件： - [ ] 自然灾害 - [ ] 兽潮 ### ⚔️ 战斗系统 - [ ] 战斗方式设计（灵根影响技能与战斗风格） - [ ] 优劣互克关系 - ✅ 胜率计算系统（简单） ### 🎒 物品系统 - ✅ 基础物品、灵石框架 - [ ] 物品交易机制 - [ ] 经济系统 ### 🌿 生态系统 - ✅ 动植物 - ✅ 狩猎、采集、材料系统 - [ ] 魔兽系统 ### 🤖 AI增强系统 - ✅ LLM接口集成 - ✅ 角色AI系统（规则AI + LLM AI） - ✅ 协程化决策机制，异步运行，多线程加速ai决策 - ✅ 长期规划和目标导向行为 - ✅ 突发动作响应系统（对外界刺激的即时反应） - ✅ LLM驱动的NPC对话、思考、互动 - ✅ LLM生成小片段剧情 - ✅ 根据任务需求分别接入max/flash模型 - ✅ 小剧场 - ✅ 战斗小剧场 - ✅ 对话小剧场 - ✅ 小剧场不同文字风格 - [ ] NPC观测空间设计 - [ ] 一次性选择（如是否要切换功法） - [ ] 长期记忆/刻骨铭心的记忆 ### 🏛️ 世界背景系统 - [ ] 背景故事框架 - [ ] 世界观生成 - [ ] 上古历史生成 ### 特殊 - ✅ 奇遇 - [ ] 道途 - [ ] 夺舍 & 重生 - [ ] 阵法 - [ ] 机缘 - [ ] 天劫 & 心魔 - [ ] 可灵活自定义的世界法则 - [ ] 占卜 & 谶纬 - [ ] 男生女相 & 女生男相 ## 使用方法 ### 运行步骤 1. 克隆项目到本地： ```bash git clone https://github.com/your-username/cultivation-world-simulator.git cd cultivation-world-simulator ``` 2. 安装依赖： ```bash pip install -r requirements.txt ``` 3. 配置LLM： 在 `static/config.yml` 中配置LLM参数： ```yaml llm: model_name: "qwen-plus" # 或其他litellm支持的模型名称 key: "your-api-key-here" # 你的API密钥 base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1" ``` 具体支持的模型请参考 [litellm文档](https://docs.litellm.ai/docs/providers) 4. 运行模拟器： ```bash python -m src.run.run ``` ## 贡献者 - Aku, 世界观\玩法设计与讨论 ## 许可证 本项目采用 [LICENSE](LICENSE) 文件中指定的许可证。 ## 联系方式 如果您对项目有任何问题或建议，欢迎提交 Issue 或 Pull Request。 也欢迎给我的[B站账号](https://space.bilibili.com/527346837)留言！