333 lines
12 KiB
Markdown
333 lines
12 KiB
Markdown
<!-- 语言 / Language -->
|
||
<h3 align="center">
|
||
<a href="README.md">🇨🇳 中文</a> · <a href="EN_README.md">🇺🇸 English</a>
|
||
</h3>
|
||
<blockquote align="center">
|
||
This project now supports English. Don't hesitate to give it a try!
|
||
</blockquote>
|
||
<p align="center">— ✦ —</p>
|
||
|
||
# 修仙世界模拟器 (Cultivation World Simulator)
|
||
|
||
|
||
[](https://space.bilibili.com/527346837)
|
||
|
||
[](https://discord.gg/shhRWmZR)
|
||
[](LICENSE)
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<p align="center">
|
||
<img src="assets/zh-CN/screenshot.gif" alt="游戏演示" width="100%">
|
||
</p>
|
||
|
||
> **一个AI驱动的修仙世界模拟器，旨在创造一个真正活着的、有沉浸感的仙侠世界。**
|
||
|
||
<p align="center">
|
||
<a href="https://hellogithub.com/repository/AI-Cultivation/cultivation-world-simulator" target="_blank">
|
||
<img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=d0d75240fb95445bba1d7af7574d8420&claim_uid=DogxfCROM1PBL89" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" />
|
||
</a>
|
||
</p>
|
||
|
||
## 📖 简介
|
||
|
||
这是一个 **AI 驱动的开放世界修仙模拟器**。
|
||
|
||
不同于传统的 RPG 扮演某个角色，在这里，**你将扮演“天道”（上帝）**。
|
||
你不需要亲自打怪升级，而是以上帝视角观察众生，在规则与 AI 共同编织的开放世界中，见证门派兴衰与天骄崛起。你可以静观沧海桑田，也可以降下天劫或魔改心灵，微妙地干预世界进程。
|
||
|
||
### ✨ 核心亮点
|
||
|
||
- 👁️ **扮演“天道” (上帝视角)**：你不是修士，而是掌控世界规则的**天道**。观察众生百态，体味苦辣酸甜。
|
||
- 🤖 **全员 AI 驱动**：每个 NPC 都独立基于LLM驱动，都有独立的性格、记忆、人际关系和行为逻辑。他们会根据即时局势做出决策，会有爱恨情仇，会结党营私，甚至会逆天改命。
|
||
- 🌏 **规则作为基石**：世界基于灵根、境界、功法、寿元等严谨的数值体系运行。AI 的想象力被限制在合理的修仙逻辑框架内，确保世界真实可信。
|
||
- 🦋 **涌现式剧情**：开发者也不知道下一秒会发生什么。没有预设剧本，只有无数因果交织出的世界演变。宗门大战、正魔之争、天骄陨落，皆由世界逻辑自主推演。
|
||
|
||
<table border="0">
|
||
<tr>
|
||
<td width="33%" valign="top">
|
||
<h4 align="center">宗门体系</h4>
|
||
<img src="assets/zh-CN/screenshots/宗门.png" width="100%" />
|
||
<br/><br/>
|
||
<h4 align="center">城市区域</h4>
|
||
<img src="assets/zh-CN/screenshots/城市.png" width="100%" />
|
||
<br/><br/>
|
||
<h4 align="center">生平经历</h4>
|
||
<img src="assets/zh-CN/screenshots/经历.png" width="100%" />
|
||
</td>
|
||
<td width="33%" valign="top">
|
||
<h4 align="center">角色面板</h4>
|
||
<img src="assets/zh-CN/screenshots/角色.png" width="100%" />
|
||
<br/><br/>
|
||
<h4 align="center">性格特质</h4>
|
||
<img src="assets/zh-CN/screenshots/特质.png" width="100%" />
|
||
<br/><br/>
|
||
<h4 align="center">自主思考</h4>
|
||
<img src="assets/zh-CN/screenshots/思考.png" width="100%" />
|
||
<br/><br/>
|
||
<h4 align="center">江湖绰号</h4>
|
||
<img src="assets/zh-CN/screenshots/绰号.png" width="100%" />
|
||
</td>
|
||
<td width="33%" valign="top">
|
||
<h4 align="center">洞府探秘</h4>
|
||
<img src="assets/zh-CN/screenshots/洞府.png" width="100%" />
|
||
<br/><br/>
|
||
<h4 align="center">长短期目标</h4>
|
||
<img src="assets/zh-CN/screenshots/目标.png" width="100%" />
|
||
<br/><br/>
|
||
<h4 align="center">丹药/法宝/武器</h4>
|
||
<img src="assets/zh-CN/screenshots/丹药.png" width="100%" />
|
||
<img src="assets/zh-CN/screenshots/法宝.png" width="100%" />
|
||
<img src="assets/zh-CN/screenshots/武器.png" width="100%" />
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
### 💭 为什么要做这个？
|
||
修仙网文中的世界很精彩，但读者永远只能观察到一隅。
|
||
|
||
修仙品类游戏要么是完全的预设剧本，要么依靠人工设计的简单规则状态机，有许许多多牵强和降智的表现。
|
||
|
||
在大语言模型出现后，让“每一个角色都是鲜活的”的目标变得似乎可以触达了。
|
||
|
||
希望能够创造出纯粹的、快乐的、直接的、活着的修仙世界的沉浸感。不是像一些游戏公司的纯粹宣传工具，也不是像斯坦福小镇那样的纯粹研究，而是能给玩家提供真实代入感和沉浸感的实际世界。
|
||
|
||
## 📞 联系方式
|
||
如果您对项目有任何问题或建议，欢迎提交 Issue 或 Pull Request。
|
||
欢迎给我的[B站账号](https://space.bilibili.com/527346837)留言！
|
||
也可以加入QQ群进行讨论：1071821688。进群问题的答案：肥桥今天吃什么
|
||
加入 Discord 社区：[https://discord.gg/shhRWmZR](https://discord.gg/shhRWmZR)
|
||
|
||
## 🚀 使用方法
|
||
|
||
### ⚙️ 运行步骤
|
||
|
||
#### 方式一：Docker Compose 一键部署（推荐）
|
||
|
||
如果你已经安装了 Docker，这是最简单的方式：
|
||
|
||
1. **克隆项目**
|
||
```bash
|
||
git clone https://github.com/AI-Cultivation/cultivation-world-simulator.git
|
||
cd cultivation-world-simulator
|
||
```
|
||
|
||
2. **启动服务（自动构建并运行）**
|
||
```bash
|
||
docker-compose up -d --build
|
||
```
|
||
|
||
#### 方式二：手动安装运行
|
||
|
||
1. 克隆项目到本地：
|
||
```bash
|
||
git clone https://github.com/AI-Cultivation/cultivation-world-simulator.git
|
||
cd cultivation-world-simulator
|
||
```
|
||
|
||
2. 安装依赖：
|
||
```bash
|
||
# 后端依赖
|
||
pip install -r requirements.txt
|
||
|
||
# 前端依赖 (需Node.js环境)
|
||
cd web && npm install
|
||
```
|
||
|
||
3. 配置LLM：
|
||
|
||
**推荐方式：在前端直接配置（支持快速填充预设）**
|
||
|
||
<img src="assets/zh-CN/llm_config.png" alt="前端LLM配置" width="100%">
|
||
|
||
也可以在 `static/local_config.yml` 中手动配置（OpenAI兼容格式）：
|
||
```yaml
|
||
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 (本地)" 预设即可。
|
||
|
||
4. 运行：
|
||
```bash
|
||
# 启动服务 (推荐开发模式，会自动启动前端)
|
||
python src/server/main.py --dev
|
||
```
|
||
浏览器会自动打开网页前端。
|
||
|
||
### 🌐 访问应用
|
||
|
||
无论使用哪种方式运行，启动后都可以通过以下地址访问：
|
||
|
||
前端：`http://localhost:8123`
|
||
后端 API：`http://localhost:8002`
|
||
|
||
|
||
## 📊 项目状态
|
||
|
||
|
||
|
||
## ⭐ Star History
|
||
|
||
如果你觉得这个项目有趣，请给我们一个 Star ⭐！这将激励我们持续改进和添加新功能。
|
||
|
||
<div align="center">
|
||
<a href="https://star-history.com/#4thfever/cultivation-world-simulator&Date">
|
||
<img src="https://api.star-history.com/svg?repos=4thfever/cultivation-world-simulator&type=Date" alt="Star History Chart" width="600">
|
||
</a>
|
||
</div>
|
||
|
||
## 👥 贡献者
|
||
|
||
<a href="https://github.com/4thfever/cultivation-world-simulator/graphs/contributors">
|
||
<img src="https://contrib.rocks/image?repo=4thfever/cultivation-world-simulator&max=100&columns=11" />
|
||
</a>
|
||
|
||
更多贡献细节请查看 [CONTRIBUTORS.md](CONTRIBUTORS.md)。
|
||
|
||
## 📋 功能开发进度
|
||
|
||
### 🏗️ 基础系统
|
||
- ✅ 基础世界地图、时间、事件系统
|
||
- ✅ 多样化地形类型（平原、山脉、森林、沙漠、水域等）
|
||
- ✅ 基于Web前端显示界面
|
||
- ✅ 基础模拟器框架
|
||
- ✅ 配置文件
|
||
- ✅ release 一键即玩的exe
|
||
- ✅ 菜单栏 & 存档 & 读档
|
||
- ✅ 灵活自定义LLM接口
|
||
- ✅ 支持mac os
|
||
- ✅ 多语言本地化
|
||
- ✅ 开始游戏页
|
||
- [ ] 安卓支持
|
||
- [ ] Mod支持
|
||
|
||
### 🗺️ 世界系统
|
||
- ✅ 基础tile地块系统
|
||
- ✅ 基础区域、修行区域、城市区域、宗门区域
|
||
- ✅ 同地块NPC交互
|
||
- ✅ 灵气分布与产出设计
|
||
- ✅ 世界事件
|
||
|
||
### 👤 角色系统
|
||
- ✅ 角色基础属性系统
|
||
- ✅ 修炼境界体系
|
||
- ✅ 灵根系统
|
||
- ✅ 基础移动动作
|
||
- ✅ 角色特质与性格
|
||
- ✅ 境界突破机制
|
||
- ✅ 角色间的相互关系
|
||
- ✅ 角色交互范围
|
||
- ✅ 角色Effects系统：增益/减益效果
|
||
- ✅ 角色功法
|
||
- ✅ 角色兵器 & 辅助装备
|
||
- ✅ 丹药
|
||
- ✅ 角色长短期记忆
|
||
- ✅ 角色的长短期目标，支持玩家主动设定
|
||
- ✅ 角色绰号
|
||
- [ ] 生活技能
|
||
- ✅ 铸造
|
||
- ✅ 炼丹
|
||
- [ ] 种植
|
||
- [ ] 饲养
|
||
- [ ] 技能可升级
|
||
- [ ] 凡人系统
|
||
|
||
### 🏛️ 组织系统
|
||
- [ ] 宗门系统
|
||
- ✅ 设定、功法、疗伤、驻地、行事风格
|
||
- ✅ 宗门特殊动作：合欢宗（双修），百兽宗（御兽）
|
||
- ✅ 宗门等阶
|
||
- [ ] 宗门意志ai
|
||
- [ ] 宗门任务
|
||
- [ ] 世家系统
|
||
- [ ] 朝廷系统（未定）
|
||
- [ ] 组织间关系网络
|
||
|
||
### ⚡ 动作系统
|
||
- ✅ 基础移动动作
|
||
- ✅ 动作执行框架
|
||
- ✅ 有明确规则的定义动作
|
||
- ✅ 长动作执行和结算系统
|
||
- ✅ 支持多月份持续的动作（如修炼、突破、游戏等）
|
||
- ✅ 动作完成时的自动结算机制
|
||
- ✅ 多人动作：动作发起与动作响应
|
||
- ✅ 影响人际关系的LLM动作
|
||
- ✅ 系统性的动作注册与运行逻辑
|
||
|
||
### 🎭 事件系统
|
||
- ✅ 天地灵气变动
|
||
- ✅ 多人大事件：
|
||
- ✅ 拍卖会
|
||
- ✅ 秘境探索
|
||
- [ ] 比武大会
|
||
- [ ] 宗门大比
|
||
- [ ] 突发事件
|
||
- [ ] 宝物/洞府出世
|
||
- [ ] 自然事件：
|
||
- [ ] 自然灾害
|
||
- [ ] 兽潮
|
||
|
||
### ⚔️ 战斗系统
|
||
- ✅ 优劣互克关系
|
||
- ✅ 胜率计算系统
|
||
|
||
### 🎒 物品系统
|
||
- ✅ 基础物品、灵石框架
|
||
- ✅ 物品交易机制
|
||
|
||
### 🌿 生态系统
|
||
- ✅ 动植物
|
||
- ✅ 狩猎、采集、材料系统
|
||
- [ ] 魔兽
|
||
|
||
### 🤖 AI增强系统
|
||
- ✅ LLM接口集成
|
||
- ✅ 角色AI系统（规则AI + LLM AI）
|
||
- ✅ 协程化决策机制，异步运行，多线程加速ai决策
|
||
- ✅ 长期规划和目标导向行为
|
||
- ✅ 突发动作响应系统（对外界刺激的即时反应）
|
||
- ✅ LLM驱动的NPC对话、思考、互动
|
||
- ✅ LLM生成小片段剧情
|
||
- ✅ 根据任务需求分别接入max/flash模型
|
||
- ✅ 小剧场
|
||
- ✅ 战斗小剧场
|
||
- ✅ 对话小剧场
|
||
- ✅ 小剧场不同文字风格
|
||
- ✅ 一次性选择（如是否要切换功法）
|
||
|
||
### 🏛️ 世界背景系统
|
||
- ✅ 注入基础世界知识
|
||
- ✅ 用户输入历史，动态生成功法、装备、宗门、区域信息
|
||
|
||
### ✨ 特殊
|
||
- ✅ 奇遇
|
||
- ✅ 天劫 & 心魔
|
||
- [ ] 夺舍 & 重生
|
||
- [ ] 机缘 & 因果
|
||
- [ ] 占卜 & 谶纬
|
||
- [ ] 男生女相 & 女生男相
|
||
- [ ] 角色隐秘 & 双面人
|
||
- [ ] 飞升上界
|
||
- [ ] 阵法
|
||
- [ ] 道途
|
||
- [ ] 世界秘密 & 世界法则 （可灵活自定义）
|
||
- [ ] 炼蛊
|
||
- [ ] 灭世危机
|
||
|
||
### 🔭 远期展望
|
||
- [ ] 历史/事件的小说化&图片化&视频化
|
||
- [ ] MCP agent化，修士自行调用工具 |