mirror of
https://github.com/motajs/template.git
synced 2026-10-07 21:10:18 +08:00
76 lines
2.7 KiB
Markdown
76 lines
2.7 KiB
Markdown
# Requirements: 魔塔游戏引擎（mota-ts）
|
||
|
||
**Defined:** 2026-09-07
|
||
**Core Value:** 引擎能完整跑通一部魔塔——开局到结局，存档、战斗、地图、事件、剧情全链路可玩。
|
||
|
||
## v1 Requirements
|
||
|
||
Requirements for the engine's completion. Each maps to roadmap phases.
|
||
|
||
### 事件系统（Event）
|
||
|
||
- [x] **EVT-01**: 引擎提供事件系统的数据/序列化接口，支持 blockly 式低代码定义（编辑器在外部项目）
|
||
- [x] **EVT-02**: 事件系统能驱动简单场景的事件流程（踩踏触发链路；对话、开门依赖 A2 内建函数清单，延后到收尾工作）
|
||
- [x] **EVT-03**: 事件系统定位为初学者抽象，仅覆盖简单场景，不为复杂场景追求通用表达
|
||
|
||
### 寻路（Pathfinding）
|
||
|
||
- [x] **PATH-01**: 引擎支持自动寻路
|
||
- [x] **PATH-02**: 移动端通过点击地图触发自动寻路移动
|
||
|
||
### 数据端（Data）
|
||
|
||
- [ ] **DATA-01**: 数据端（L0–L3）接口实现完成——用户设计的接口全部落地，数据层各系统（地图/角色/敌人/flag/战斗/触发器/存档/回放）可用，并可在 Node 环境独立运行回放验证
|
||
|
||
### 渲染适配与双布局（Render）
|
||
|
||
- [ ] **REND-01**: 渲染端适配新数据层接口
|
||
- [ ] **REND-02**: 渲染端同时支持移动端与桌面端布局
|
||
|
||
### Legacy 移植（Legacy）
|
||
|
||
- [ ] **LEGACY-01**: 删除被新接口覆盖的 legacy 系统
|
||
- [ ] **LEGACY-02**: 将仍需要的 legacy 内容迁移到新接口；无新接口覆盖时才新增接口（设计由用户把控）
|
||
|
||
### 测试（Testing）
|
||
|
||
- [ ] **TEST-01**: 为核心系统（数据层等）补齐单元测试
|
||
|
||
## Out of Scope
|
||
|
||
Explicitly excluded. Documented to prevent scope creep.
|
||
|
||
| Feature | Reason |
|
||
|---------|--------|
|
||
| 可视化编辑器（blockly UI） | 位于独立项目，不在本仓库 |
|
||
| 复杂场景的通用事件表达能力 | 事件系统定位为初学者抽象，避免为表达力过度设计 |
|
||
| 收尾工作的提前规划 | 随测试逐步发现，执行期处理 |
|
||
|
||
## Traceability
|
||
|
||
Which phases cover which requirements. Updated during roadmap creation.
|
||
|
||
| Requirement | Phase | Status |
|
||
|-------------|-------|--------|
|
||
| EVT-01 | Phase 1 | Complete |
|
||
| EVT-02 | Phase 1 | Complete |
|
||
| EVT-03 | Phase 1 | Complete |
|
||
| PATH-01 | Phase 2 | Complete |
|
||
| PATH-02 | Phase 2 | Complete |
|
||
| DATA-01 | Phase 3 | Pending |
|
||
| REND-01 | Phase 4 | Pending |
|
||
| REND-02 | Phase 4 | Pending |
|
||
| LEGACY-01 | Phase 5 | Pending |
|
||
| LEGACY-02 | Phase 5 | Pending |
|
||
| TEST-01 | Phase 6 | Pending |
|
||
|
||
**Coverage:**
|
||
|
||
- v1 requirements: 11 total
|
||
- Mapped to phases: 11
|
||
- Unmapped: 0 ✓
|
||
|
||
---
|
||
*Requirements defined: 2026-09-07*
|
||
*Last updated: 2026-09-07 after initial definition*
|