chore: initial commit
This commit is contained in:
70
Docs/DesignSpec/README.md
Normal file
70
Docs/DesignSpec/README.md
Normal file
@@ -0,0 +1,70 @@
|
||||
# 泽灵(Zeling)· 系统设计规范文档集
|
||||
|
||||
> **定位**:本文档集是**引擎无关的系统设计规范**,描述游戏的功能需求、行为契约与数据模型。
|
||||
> **读者**:任何引擎的开发者、设计师、产品经理。
|
||||
> **不包含**:特定语言的代码、引擎插件名称、运行时 API 调用。
|
||||
> **区别于**:
|
||||
> - `Docs/Design/` — Unity 实现文档(与 Animancer、Cinemachine 等深度绑定)
|
||||
> - `Docs/Architecture/` — Unity 代码架构文档(asmdef、命名空间、Inspector)
|
||||
>
|
||||
> 本文档集可作为用任何引擎(Godot、Unreal、自研)重实现该游戏的**权威规范**。
|
||||
|
||||
---
|
||||
|
||||
## 导航索引
|
||||
|
||||
| 序号 | 文档 | 一句话描述 |
|
||||
|:----:|------|-----------|
|
||||
| — | **[设计规范与符号约定](./00_DesignConventions.md)** | 文档写法、数据类型符号、状态机符号、接口定义格式 |
|
||||
| 01 | [系统架构总览](./01_SystemArchitecture.md) | 设计哲学、系统全景图、模块边界、通信模式 |
|
||||
| 02 | [事件与消息系统](./02_EventMessaging.md) | 观察者模式约定、事件目录、发布/订阅契约 |
|
||||
| 03 | [玩家系统规范](./03_PlayerSystem.md) | 玩家实体构成、资源模型、状态机、输入契约 |
|
||||
| 04 | [战斗系统规范](./04_CombatSystem.md) | 伤害数据包、命中/受击管线、状态效果、连击 |
|
||||
| 05 | [移动系统规范](./05_MovementSystem.md) | 移动参数、跳跃模型、冲刺、墙壁力学 |
|
||||
| 06 | [形态系统规范](./06_FormSystem.md) | 三形态模型、切换契约、资源适配、武器联动 |
|
||||
| 07 | [敌人系统规范](./07_EnemySystem.md) | 敌人实体、AI 行为模型、Boss 系统、掉落 |
|
||||
| 08 | [世界系统规范](./08_WorldSystem.md) | 房间/场景模型、切换流程、存档点、可交互物 |
|
||||
| 09 | [进程系统规范](./09_ProgressionSystem.md) | 能力解锁、进度门控、Boss 进程、完成度 |
|
||||
| 10 | [UI 系统规范](./10_UISystem.md) | HUD 元素、屏幕状态机、数据绑定契约 |
|
||||
| 11 | [音频系统规范](./11_AudioSystem.md) | 自适应音乐分层、SFX 事件模型、音频区域 |
|
||||
| 12 | [经济系统规范](./12_EconomySystem.md) | 货币模型、商店契约、掉落模型、平衡参数 |
|
||||
| 13 | [存档系统规范](./13_SaveSystem.md) | 完整数据 Schema、存取契约、版本迁移 |
|
||||
| 14 | [叙事系统规范](./14_NarrativeSystem.md) | 故事节点、世界状态注册、NPC 对话版本 |
|
||||
|
||||
---
|
||||
|
||||
## 阅读建议
|
||||
|
||||
```
|
||||
入门阅读(了解全局):
|
||||
00_DesignConventions → 01_SystemArchitecture → 02_EventMessaging
|
||||
|
||||
核心玩法:
|
||||
03_PlayerSystem → 04_CombatSystem → 05_MovementSystem → 06_FormSystem
|
||||
|
||||
世界与敌人:
|
||||
07_EnemySystem → 08_WorldSystem → 09_ProgressionSystem
|
||||
|
||||
支撑系统:
|
||||
10_UISystem / 11_AudioSystem / 12_EconomySystem
|
||||
|
||||
持久化与叙事:
|
||||
13_SaveSystem / 14_NarrativeSystem
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 核心设计词汇表
|
||||
|
||||
| 术语 | 含义 |
|
||||
|------|------|
|
||||
| **系统(System)** | 一组紧密相关的行为和数据的逻辑单元,有明确输入/输出边界 |
|
||||
| **数据模型(Data Model)** | 描述一类信息的字段结构,不含行为逻辑 |
|
||||
| **行为契约(Behavioral Contract)** | 系统对外承诺的操作接口与结果保证 |
|
||||
| **事件(Event)** | 系统间一次性的状态通知,携带有限载荷 |
|
||||
| **配置数据(Config Data)** | 设计时填写、运行时只读的参数表 |
|
||||
| **运行时状态(Runtime State)** | 游戏运行中动态变化的数据 |
|
||||
| **门控(Gate)** | 要求玩家满足条件才能通过的进度锁 |
|
||||
| **形态(Form)** | 玩家可切换的战斗风格实例(天魂/地魂/命魂)|
|
||||
| **房间(Room)** | 游戏世界最小独立场景单元 |
|
||||
| **频道(Channel)** | 事件的具名发布通路,类型安全 |
|
||||
Reference in New Issue
Block a user