修仙文字游戏

一个基于Web的沉浸式修仙主题文字游戏。

游戏特色

• 🎮 完整的修仙体系（炼气→筑基→金丹→元婴→化神→渡劫→大乘）
• 👥 深度的NPC关系系统（师徒、朋友、敌对、爱慕等）
• 🏛️ 家族管理和建设系统
• 🧪 炼丹制器系统
• 🗺️ 世界探索和随机事件
• 💾 自动存档和手动存档系统

技术架构

• 前端: HTML5 + CSS3 + Vanilla JavaScript (ES6+)
• 数据存储: LocalStorage
• 模块化设计: ES6 Modules
• 事件驱动: 自定义事件系统
• 状态管理: 集中式状态管理

开发进度

✅ 已完成 - 阶段一：基础框架搭建

• 项目目录结构
• 基础HTML页面
• CSS样式框架
• JavaScript模块化架构
• 游戏引擎核心
• 事件系统
• 状态管理器
• 存档管理器
• UI管理器

🚧 进行中 - 阶段二：玩家系统实现

• 角色创建系统
• 角色属性管理
• 物品和背包系统

📋 计划中 - 阶段三：修仙系统核心

• 境界体系
• 修炼系统
• 功法技能
• 炼丹制器

📋 计划中 - 阶段四：社交系统实现

• NPC系统
• 人物关系系统
• 家族系统

📋 计划中 - 阶段五：世界和事件系统

• 游戏世界
• 事件系统
• 战斗系统

📋 计划中 - 阶段六：游戏完善和优化

• 游戏平衡
• 用户体验优化
• 数据完善
• 测试和发布

如何运行

1. 克隆或下载项目到本地
2. 使用现代浏览器打开 index.html
3. 由于使用ES6模块，需要通过HTTP服务器运行：

# 使用Python内置服务器
python -m http.server 8000

# 或使用Node.js
npx serve .

# 然后访问 http://localhost:8000

项目结构

web-text-game/
├── index.html              # 主页面
├── assets/                 # 静态资源
│   ├── css/               # 样式文件
│   ├── images/            # 图片资源
│   └── sounds/            # 音频资源
├── src/                    # 源代码
│   ├── core/              # 核心系统
│   │   ├── GameEngine.js  # 游戏引擎
│   │   ├── EventSystem.js # 事件系统
│   │   ├── StateManager.js # 状态管理
│   │   └── SaveManager.js # 存档管理
│   ├── entities/          # 游戏实体
│   ├── systems/           # 游戏系统
│   ├── ui/                # UI管理
│   ├── world/             # 世界系统
│   └── data/              # 游戏数据
├── openspec/              # OpenSpec规格文档
└── docs/                  # 项目文档

开发说明

代码规范

• 使用ES6+语法
• 采用模块化设计
• 遵循事件驱动架构
• 完整的错误处理
• 详细的代码注释

核心类说明

GameEngine

游戏的核心引擎，负责主循环、时间管理和系统协调。

EventSystem

事件系统，支持优先级、一次性监听器、事件历史记录等功能。

StateManager

状态管理器，支持状态历史、撤销重做、状态验证等功能。

SaveManager

存档管理器，支持自动存档、手动存档、快速存档等功能。

UIManager

UI管理器，负责界面切换、用户交互、消息显示等功能。

贡献指南

1. Fork 项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

联系方式

开发者: jamesenh

项目链接: https://github.com/yourusername/web-text-game

---

开发者: jamesenh 创建日期: 2025-10-14 版本: v0.1.0