199 lines
6.0 KiB
Markdown
199 lines
6.0 KiB
Markdown
# 修仙世界模拟器 (Cultivation World Simulator)
|
||
|
||
一个基于规则和AI驱动的修仙世界模拟器，旨在创造一个真正活着的、有沉浸感的仙侠世界。
|
||
|
||
## 简介
|
||
|
||
修仙世界模拟器是一个结合传统游戏规则系统和现代AI技术的仿真项目。通过建立完整的修仙世界模型，包括地形、角色、修炼体系、人际关系等要素，创造一个可以自主运行、充满生机的虚拟修仙世界。
|
||
|
||
项目的核心理念是：**先建立可信的规则体系作为"世界模型"基础，再接入AI使世界生动起来**。
|
||
|
||
## 截图预览
|
||
|
||
|
||
|
||
## 功能开发进度
|
||
|
||
### 🏗️ 基础系统
|
||
- ✅ 基础世界地图系统
|
||
- ✅ 多样化地形类型（平原、山脉、森林、沙漠、水域等）
|
||
- ✅ 时间系统（年月日历）
|
||
- ✅ 前端显示界面（pygame）
|
||
- ✅ 基础模拟器框架
|
||
- ✅ 项目文档（README）
|
||
- [ ] 配置文件系统（config）
|
||
- [ ] Web前端支持（从pygame切换）
|
||
- [ ] ECS并行工具（后期考虑）
|
||
|
||
### 🗺️ 地块系统
|
||
- ✅ 基础tile地块系统
|
||
- [ ] 同tile内NPC相互交互
|
||
- [ ] 乡村和城镇的机制
|
||
- [ ] 灵气分布与产出设计
|
||
- [ ] 地块间移动（move_to_region action）
|
||
|
||
### 👤 角色系统
|
||
- ✅ 角色基础属性系统
|
||
- ✅ 修炼境界体系
|
||
- ✅ 灵根系统
|
||
- ✅ 基础移动动作
|
||
- [ ] 动态的突破成功概率
|
||
- [ ] 角色关系系统
|
||
- [ ] 性格系统设计
|
||
- [ ] 角色特殊能力
|
||
- [ ] 角色称号&绰号
|
||
- [ ] 战斗相关
|
||
- [ ] 属性点分配
|
||
- [ ] 技能系统（功法）
|
||
- [ ] 装备系统
|
||
- [ ] 法宝系统
|
||
- [ ] 阵法
|
||
- [ ] 技能学习系统：
|
||
- [ ] 可学习技能
|
||
- [ ] 个人技（灵活融入代码）
|
||
- [ ] 生活技能
|
||
- [ ] 凡人角色支持
|
||
- [ ] 角色突破机制
|
||
|
||
### 🏛️ 组织系统
|
||
- [ ] 宗门系统
|
||
- [ ] 世家系统
|
||
- [ ] 朝廷系统（待定）
|
||
- [ ] 组织间关系网络
|
||
|
||
### ⚡ 动作系统
|
||
- ✅ 基础移动动作
|
||
- [ ] 有明确规则的定义动作
|
||
- [ ] 影响人际关系的LLM动作
|
||
- [ ] 动作执行框架
|
||
|
||
### 🎭 事件系统
|
||
- [ ] 世界范围大事件：
|
||
- [ ] 拍卖会
|
||
- [ ] 秘境探索
|
||
- [ ] 比武大会
|
||
- [ ] 规则发起事件
|
||
- [ ] NPC发起事件
|
||
- [ ] 自然事件：
|
||
- [ ] 自然灾害
|
||
- [ ] 天灾
|
||
- [ ] 战争
|
||
- [ ] 兽潮
|
||
|
||
### ⚔️ 战斗系统
|
||
- [ ] 战斗方式设计
|
||
- [ ] 优劣互克关系
|
||
- [ ] 胜率计算系统
|
||
- [ ] 战斗规则引擎
|
||
|
||
### 🎒 物品系统
|
||
- [ ] 基础物品框架
|
||
- [ ] 物品属性系统
|
||
- [ ] 物品交易机制
|
||
|
||
### 🌿 生态系统
|
||
- [ ] 魔兽系统
|
||
- [ ] 动植物生态
|
||
- [ ] 生物间相互关系
|
||
|
||
### 🤖 AI增强系统
|
||
- [ ] 角色AI系统（规则AI + LLM接口预留）
|
||
- [ ] LLM驱动的NPC对话
|
||
- [ ] 智能决策系统
|
||
- [ ] 动态剧情生成
|
||
- [ ] NPC观测空间设计
|
||
- [ ] NPC之间关系交互
|
||
- [ ] LLM接口集成
|
||
|
||
### 🏛️ 世界背景系统
|
||
- [ ] 上古历史生成
|
||
- [ ] 世界观设定
|
||
- [ ] 背景故事框架
|
||
|
||
## 使用方法
|
||
|
||
### 环境要求
|
||
- Python 3.8+
|
||
- pygame
|
||
- PyYAML
|
||
|
||
### 运行步骤
|
||
1. 克隆项目到本地：
|
||
```bash
|
||
git clone https://github.com/your-username/cultivation-world-simulator.git
|
||
cd cultivation-world-simulator
|
||
```
|
||
|
||
2. 安装依赖（如需要的话）：
|
||
```bash
|
||
pip install pygame pyyaml
|
||
```
|
||
|
||
3. 运行模拟器：
|
||
```bash
|
||
python src/tools/run.py
|
||
```
|
||
|
||
### 基本操作
|
||
- 启动后会自动生成随机地图
|
||
- 可以观察角色在世界中的移动和行为
|
||
- 按ESC退出程序
|
||
|
||
## 项目背景
|
||
|
||
从小一直是修仙网文的读者，从最早的蜀山仙侠传，到比较新的赤心巡天，修仙网文陪伴了我非常多的时间。
|
||
|
||
作为游戏AI行业的从业者，对LLM这两年的进步感触很深。我认为，现在的LLM智能水平，已经足够支持起来一些仙侠风格的世界模拟了。
|
||
|
||
但是，纯粹只有LLM为NPC提供决策和对话能力是不够的。首先，要有可信的规则打底，作为修仙世界的"世界模型"。之后，才是接入LLM，使其生动起来。
|
||
|
||
我希望能够创造出纯粹的、快乐的、直接的、活着的修仙世界的沉浸感。不是像一些游戏公司的纯粹宣传工具，也不是像斯坦福小镇那样的纯粹研究，而是能给玩家提供真实代入感和沉浸感的实际世界。
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
cultivation-world-simulator/
|
||
├── src/ # 核心源代码
|
||
│ ├── classes/ # 核心数据类
|
||
│ │ ├── avatar.py # 角色系统
|
||
│ │ ├── world.py # 世界模型
|
||
│ │ ├── tile.py # 地图系统
|
||
│ │ └── ... # 其他核心类
|
||
│ ├── front/ # 前端显示模块
|
||
│ │ └── front.py # pygame界面
|
||
│ ├── sim/ # 模拟引擎
|
||
│ │ ├── simulator.py # 核心模拟器
|
||
│ │ └── event.py # 事件系统
|
||
│ ├── tools/ # 工具脚本
|
||
│ │ ├── run.py # 主程序入口
|
||
│ │ └── create_map.py # 地图生成工具
|
||
│ └── utils/ # 实用工具
|
||
│ └── strings.py # 字符串处理
|
||
├── assets/ # 游戏资源
|
||
│ ├── tiles/ # 地形贴图
|
||
│ ├── males/ # 男性角色头像
|
||
│ └── females/ # 女性角色头像
|
||
├── configs/ # 配置文件
|
||
├── tests/ # 测试代码
|
||
└── README.md # 项目说明
|
||
```
|
||
|
||
## 技术架构
|
||
|
||
- **前端显示**: pygame (计划未来支持Web)
|
||
- **模拟引擎**: 自研事件驱动模拟器
|
||
- **世界模型**: 基于规则的确定性系统
|
||
- **AI集成**: 预留LLM接口，支持混合决策
|
||
|
||
## 贡献指南
|
||
|
||
欢迎对修仙世界模拟器项目的贡献！无论是代码、创意还是测试反馈都非常宝贵。
|
||
|
||
## 许可证
|
||
|
||
本项目采用 [LICENSE](LICENSE) 文件中指定的许可证。
|
||
|
||
## 联系方式
|
||
|
||
如果您对项目有任何问题或建议，欢迎提交 Issue 或 Pull Request。
|