113 lines
2.9 KiB
Markdown
113 lines
2.9 KiB
Markdown
# 战斗系统
|
||
|
||
## 概述
|
||
|
||
P31 新增。分为两个独立功能：**战斗 HUD**（战斗中显示）和**战斗结算**（胜利后弹出）。
|
||
|
||
---
|
||
|
||
## BattleHUD — 战斗中显示的角色属性
|
||
|
||
配置在 `SceneNode.battleHUD`。
|
||
|
||
```json
|
||
{
|
||
"battleHUD": [
|
||
{
|
||
"label": "主角",
|
||
"labelKey": "battle.hud.player",
|
||
"portrait": "images/player.jpg",
|
||
"stats": [
|
||
{ "variable": "player_hp", "label": "HP", "labelKey": "stat.hp", "max": 100 },
|
||
{ "variable": "player_mp", "label": "MP", "labelKey": "stat.mp", "max": 50 },
|
||
{ "variable": "score", "label": "连击", "labelKey": "stat.combo" }
|
||
]
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
| stat 字段 | 说明 |
|
||
|-----------|------|
|
||
| `variable` | 变量名，值随 effect 实时变化 |
|
||
| `label` | 显示标签（回退值） |
|
||
| `labelKey` | i18n key |
|
||
| `max` | 最大值，有则为进度条，无则为纯数字 |
|
||
| `style` | 强制 `"bar"` 或 `"number"`。没配时根据有无 `max` 自动 |
|
||
|
||
进度条颜色根据百分比自动变化：100-50% 绿色 / 50-25% 橙色 / 25-0% 红色。
|
||
|
||
---
|
||
|
||
## BattleResult — 胜利结算面板
|
||
|
||
配置在 `SceneNode.battleResult`。视频播放完后自动弹出。
|
||
|
||
```json
|
||
{
|
||
"battleResult": {
|
||
"title": "击退成功！",
|
||
"titleKey": "battle.result.victory",
|
||
"stats": [
|
||
{ "label": "勇气", "labelKey": "stat.courage", "variable": "courage", "max": 100 },
|
||
{ "label": "QTE 成功", "labelKey": "stat.qte_succeeded", "variable": "qte_succeeded" }
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| `title` | 结算标题（回退值） |
|
||
| `titleKey` | 标题 i18n key |
|
||
| `stats` | 统计项数组。`variable` / `label` / `labelKey` / `max` |
|
||
|
||
### 关键规则
|
||
|
||
- 战败场景**不配** `battleResult`——战败直接走视频叙事
|
||
- 结算面板关闭后自动跳转到 `nextScene` 或第一项 `choice` 目标
|
||
- stats 数量随意增减，面板自动适配
|
||
|
||
---
|
||
|
||
## 完整模板
|
||
|
||
```json
|
||
{
|
||
"id": "combat",
|
||
"videoUrl": "combat/video.mp4",
|
||
"battleHUD": [ ... ],
|
||
"qte": {
|
||
"successScene": "combat_router",
|
||
"failScene": "defeat",
|
||
"effects": {
|
||
"success": [{ "type": "add", "target": "enemy_hp", "value": -25 }],
|
||
"fail": [{ "type": "add", "target": "player_hp", "value": -20 }]
|
||
}
|
||
},
|
||
"nextScene": "combat_router"
|
||
},
|
||
{
|
||
"id": "combat_router",
|
||
"keyMoment": false,
|
||
"nextScene": [
|
||
{ "conditions": [{ "variable": "enemy_hp", "op": "<=", "value": 0 }], "targetScene": "victory" },
|
||
{ "conditions": [{ "variable": "player_hp", "op": "<=", "value": 0 }], "targetScene": "defeat" },
|
||
{ "targetScene": "combat" }
|
||
]
|
||
},
|
||
{
|
||
"id": "victory",
|
||
"videoUrl": "victory/video.mp4",
|
||
"battleResult": { "title": "胜利！", "stats": [ ... ] },
|
||
"nextScene": "next_chapter"
|
||
},
|
||
{
|
||
"id": "defeat",
|
||
"videoUrl": "defeat/video.mp4",
|
||
"keyMoment": true,
|
||
"onEnter": [{ "type": "set", "target": "player_dead", "value": 1 }],
|
||
"nextScene": "game_over"
|
||
}
|
||
```
|