129 lines
4.0 KiB
Markdown
129 lines
4.0 KiB
Markdown
# 开发任务清单
|
||
|
||
## 项目概述
|
||
Roguelike 游戏服务端开发任务追踪
|
||
|
||
## 当前项目规划
|
||
|
||
### 1. 世界系统初始化 ✅
|
||
- [x] 服务器启动时初始化游戏世界
|
||
- [x] 世界配置参数
|
||
- 世界尺寸: 800x800
|
||
- 出生区域: 距离中心点 200 范围内
|
||
- [x] 世界数据结构设计
|
||
- 地图管理
|
||
- 坐标系统
|
||
|
||
### 2. 玩家系统 ✅
|
||
- [x] 玩家登录流程(统一接口)
|
||
- [x] 查找已有角色
|
||
- [x] 若无角色,服务端自动注册
|
||
- [x] 服务端自动创建角色
|
||
- [x] 服务端自动分配随机出生点(出生区域内)
|
||
- [x] 返回角色信息给客户端
|
||
- [x] 玩家数据结构
|
||
- [x] 角色ID
|
||
- [x] 位置坐标
|
||
- [x] 生命值(初始10点)
|
||
- [x] 出生点记录
|
||
|
||
### 3. 游戏机制
|
||
- [x] 移动系统 ✅
|
||
- [x] 移动指令协议
|
||
- [x] 位置验证
|
||
- [x] 位置同步广播
|
||
- [ ] 战斗系统
|
||
- [ ] 攻击指令协议
|
||
- [ ] 伤害计算
|
||
- [ ] 生命值管理
|
||
- [ ] 死亡判定
|
||
- [ ] 复活系统
|
||
- [ ] 死亡处理
|
||
- [ ] 出生点复活
|
||
- [ ] 生命值重置
|
||
|
||
### 4. 协议定义
|
||
- [x] PtlLogin - 登录协议(服务端自动处理注册和创角) ✅
|
||
- [x] PtlMove - 移动协议 ✅
|
||
- [x] MsgPlayerJoin - 玩家加入广播 ✅
|
||
- [x] MsgPlayerMove - 玩家移动广播 ✅
|
||
- [ ] PtlAttack - 攻击协议
|
||
- [ ] MsgPlayerDeath - 玩家死亡广播
|
||
- [ ] MsgPlayerRespawn - 玩家复活广播
|
||
- [ ] MsgPlayerAttack - 玩家攻击广播
|
||
|
||
## 开发进度
|
||
|
||
### 已完成
|
||
- [x] 项目初始化
|
||
- [x] 基础消息发送 (ApiSend.ts)
|
||
- [x] **世界系统初始化** (2025-12-14)
|
||
- [x] 世界配置文件 (world.config.ts)
|
||
- [x] 位置坐标模型 (Position.ts)
|
||
- [x] 世界数据模型 (World.ts)
|
||
- [x] 数学工具函数 (math.ts)
|
||
- [x] 世界管理器 (WorldManager.ts)
|
||
- [x] 服务器启动时初始化世界
|
||
- [x] **玩家系统** (2025-12-14)
|
||
- [x] 玩家数据模型 (Player.ts)
|
||
- [x] 玩家管理器 (PlayerManager.ts)
|
||
- [x] 登录协议定义 (PtlLogin.ts)
|
||
- [x] 登录API实现 (ApiLogin.ts)
|
||
- [x] 自动注册和创角流程
|
||
- [x] 出生点分配逻辑
|
||
- [x] 在线玩家管理
|
||
- [x] **移动系统** (2025-12-14)
|
||
- [x] 移动协议定义 (PtlMove.ts)
|
||
- [x] 移动广播协议 (MsgPlayerMove.ts)
|
||
- [x] 玩家加入广播协议 (MsgPlayerJoin.ts)
|
||
- [x] 广播工具函数 (broadcast.ts)
|
||
- [x] 移动API实现 (ApiMove.ts)
|
||
- [x] 位置验证和边界检查
|
||
- [x] 登录时广播玩家加入
|
||
- [x] **架构重构：从HTTP API到WebSocket消息** (2025-12-18)
|
||
- [x] 删除旧的API实现 (src/api目录)
|
||
- [x] 删除旧的API协议 (PtlLogin.ts, PtlMove.ts, PtlSend.ts)
|
||
- [x] 创建消息协议文件 (MsgReq*/MsgRes*)
|
||
- [x] 创建消息处理器 (src/msg目录)
|
||
- [x] 更新服务器配置为消息监听模式
|
||
- [x] 重新生成serviceProto.ts文件
|
||
- [x] 修复所有消息名称映射问题
|
||
|
||
### 进行中
|
||
- 等待下一阶段开发...
|
||
|
||
### 待办事项
|
||
- 按照上述规划顺序实施开发
|
||
|
||
## 重要架构说明
|
||
|
||
### 🚨 消息协议设计规范 (2025-12-18更新)
|
||
**本项目使用WebSocket服务器，后续所有接口设计必须使用消息（Message）方式，而非API方式！**
|
||
|
||
#### 消息命名规范：
|
||
- 请求消息：`MsgReq{功能名}.ts` (如：MsgReqLogin.ts)
|
||
- 响应消息：`MsgRes{功能名}.ts` (如：MsgResLogin.ts)
|
||
- 广播消息：`Msg{事件名}.ts` (如：MsgPlayerMove.ts)
|
||
|
||
#### 消息处理器位置：
|
||
- 文件位置：`src/msg/MsgReq{功能名}.ts`
|
||
- 处理函数：使用 `MsgCall<MsgReq{功能名}>` 参数
|
||
- 响应方式：`call.conn.sendMsg('Res{功能名}', response)`
|
||
- 注册方式：`server.listenMsg('Req{功能名}', handler)`
|
||
|
||
#### 协议文件生成：
|
||
- 使用 `npm run proto` 自动生成 `serviceProto.ts`
|
||
- 禁止直接修改 `serviceProto.ts` 文件
|
||
- 协议文件会自动去掉 "Msg" 前缀进行注册
|
||
|
||
## 技术栈
|
||
- TSRPC 框架
|
||
- TypeScript
|
||
- Node.js
|
||
|
||
## 备注
|
||
- 本文档由 AI 助手维护
|
||
- 更新日期: 2025-12-18
|
||
- 开发过程中会根据实际情况调整任务优先级和细节
|
||
- **重要**：项目已从HTTP API架构迁移到WebSocket消息架构，请严格按照消息协议规范开发
|