Initial import of HEROLL source and design documents
This commit is contained in:
toshiocn
@@ -0,0 +1,131 @@
|
||||
# 资源背包与体力：原作设计与规则
|
||||
|
||||
版本：HEROLL 2.0.1 原作还原文档 v1.0。
|
||||
|
||||
## 1. 功能定位
|
||||
|
||||
局外资源承担长期养成、入场和购买等用途。金币、钻石、体力、碎片和票券不能仅按显示图标合并成一种余额；奖励除了普通道具，还可能指向宠物、装备或其他内容类型。
|
||||
|
||||
## 2. 主要状态
|
||||
|
||||
下面是开发阅读所需的概念状态，属于开发映射，不要求与原作内部字段同名。
|
||||
|
||||
| 状态 | 用途 |
|
||||
| --- | --- |
|
||||
| 资源ID及数量 | 同一种资源的库存 |
|
||||
| 奖励类型与引用 | 确定奖励应进入哪种内容 |
|
||||
| 道具组选择状态 | 确定礼包候选或选择结果 |
|
||||
| 大厅资源映射 | 记录带入局内的资源及数量 |
|
||||
|
||||
## 3. 功能规则
|
||||
|
||||
### 3.1 资源身份
|
||||
|
||||
使用数值ID或字符串键识别资源，中文名称只用于显示。解析奖励时同时保留奖励类型与奖励ID，宠物ID不能直接按普通道具ID解释。
|
||||
|
||||
### 3.2 体力
|
||||
|
||||
基础体力上限为40，主线入场体力需求配置为5，VIP额外上限配置为20。恢复配置原数组为600、1；其计时单位与两项含义没有调用证据时不直接写成运行公式。
|
||||
|
||||
### 3.3 道具组与选择
|
||||
|
||||
一个道具组可包含多项道具、数量和权重。对应数组按位置关联，数量为0、空值与权重0不是同一含义。道具是否随机使用、选择数量与后续选择组按道具配置分别读取。
|
||||
|
||||
### 3.4 带入局内
|
||||
|
||||
大厅票券存在普通值与增强值两档。它把局外资产映射到局内资产，而不是把所有局外库存复制进对局。
|
||||
|
||||
## 4. 操作流程
|
||||
|
||||
以下顺序用于拆解功能；涉及未确认的结算时机，以本章末尾具体缺口为准。
|
||||
|
||||
1. 从奖励来源得到奖励类型、内容ID和数量。
|
||||
2. 依据类型找到目标道具或养成对象；若为道具组，继续解析组内内容。
|
||||
3. 使用资源时读取对应功能的消耗项；库存数据按资源ID区分。
|
||||
4. 进入对局时只转换大厅映射表指定的资产。
|
||||
|
||||
## 5. 关键数值与计算
|
||||
|
||||
| 项目 | 数值 | 状态 |
|
||||
| --- | --- | --- |
|
||||
| 入场体力需求配置 | Values=5 | 原作配置确认 |
|
||||
| 基础体力上限配置 | Values=40 | 原作配置确认 |
|
||||
| 体力恢复配置数组；计时单位及数组位置需消费函数 | Values=600,1 | 原作配置确认 |
|
||||
| VIP额外体力上限配置 | Values=20 | 原作配置确认 |
|
||||
|
||||
### 局外资源带入映射（全表）
|
||||
|
||||
| ID | 名称/键 | EAsset | ELobbyAsset | defaultValue | boostValue |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| 1 | START_GEAR | START_GEAR | LOBBY_START_GEAR | 1 | 2 |
|
||||
| 2 | GOODTILE | GOODTILE | LOBBY_GOODTILE | 1 | 2 |
|
||||
| 3 | LOOP_POINT | LOOP_POINT | LOBBY_LOOP_POINT | 10 | 15 |
|
||||
|
||||
## 6. 原作中文内容
|
||||
|
||||
中文名称和效果使用原作文本；{0}、{B}等占位符未确认绑定时保留，文字不能代替参数公式。
|
||||
|
||||
| 来源表 | ID | 名称 | 效果/条件文本 |
|
||||
| --- | --- | --- | --- |
|
||||
| item | 100 | 金币 | 越多越强的力量象徵。 |
|
||||
| item | 101 | 鑽石 | 所有冒险家都想要的宝石。 |
|
||||
| item | 105 | 骰子 | 骰动这个正方体，将带给你意想不到的未来。 |
|
||||
| item | 106 | 骨头 | 可成长宠物的碎片。 |
|
||||
| item | 107 | potion | 补充药水。 |
|
||||
| item | 108 | point | 可于商店使用的红宝石。 |
|
||||
| item | 109 | 能量 | 为了上楼的必备力量。 |
|
||||
| item | 111 | 鲷鱼烧 | 精灵村传统甜点 |
|
||||
| item | 112 | 弹珠 | 于文物弹珠台使用，可获得文物碎片。 |
|
||||
| item | 113 | 超级弹珠 | 于文物弹珠台使用，可获得极多文物碎片。 |
|
||||
| item | 114 | 勇士星星 | 赠予克服挑战勇士的证物。 |
|
||||
| item | 117 | 地板碎片 | 强化地板的碎片 |
|
||||
| item | 118 | 倍率奖励 | 结束游戏后，所获得的奖励将以倍率发放。 |
|
||||
| item | 119 | 攻击卷轴 | 可注入力量。 |
|
||||
| item | 120 | 防禦卷轴 | 可注入毅力。 |
|
||||
| item | 121 | 生命值卷轴 | 可注入活力。 |
|
||||
| item | 122 | 命中卷轴 | 可注入集中力。 |
|
||||
| item | 123 | 转盘票券 | 只要运气够好，可透过票券获得货币。 |
|
||||
| item | 124 | 随机卷轴 | 获得一个随机卷轴。 |
|
||||
| item | 125 | 文物碎片 | 可召唤各种世界勇士文物。 |
|
||||
|
||||
本节展示前20条中文内容；完整754条有名称或效果的记录见对应中文目录及[中文文本对照](./中文文本对照.csv)。
|
||||
|
||||
## 7. 开发权威表
|
||||
|
||||
| 配置用途 | 权威原字段表 | 记录数 | 开发阅读表 |
|
||||
| --- | --- | --- | --- |
|
||||
| 道具与资源定义 | [item.csv](./item.csv) | 799 | [中文目录](./item-中文目录.csv) |
|
||||
| 道具包内容 | [itemgroup.csv](./itemgroup.csv) | 48 | [中文目录](./itemgroup-中文目录.csv) |
|
||||
| 资源获取途径 | [itemsource.csv](./itemsource.csv) | 29 | [中文目录](./itemsource-中文目录.csv) |
|
||||
| 局外资源带入映射 | [lobbyticket.csv](./lobbyticket.csv) | 3 | [中文目录](./lobbyticket-中文目录.csv) |
|
||||
| 局外事件奖励 | [outgamereward.csv](./outgamereward.csv) | 12 | [中文目录](./outgamereward-中文目录.csv) |
|
||||
|
||||
[执行规则](./执行规则.csv) · [状态字段](./状态字段.csv) · [验收样例](./验收样例.csv) · [字段字典](./字段字典.csv) · [关联全局配置](./关联全局配置.csv)
|
||||
|
||||
全局键按模块名称关联收录；其具体含义优先以正文已确认的规则为准。
|
||||
|
||||
| 配置键 | 原值 |
|
||||
| --- | --- |
|
||||
| needEnergy | 5 |
|
||||
| chargeEnergy | 600,1 |
|
||||
| maxEnergy | 40 |
|
||||
| ingameDiaAdj | 25 |
|
||||
| dailyIngameDiaLimit | 100 |
|
||||
| vipAddMaxEnergy | 20 |
|
||||
|
||||
## 8. 开发验收与禁止误写
|
||||
|
||||
| 输入 | 检查内容 | 预期 |
|
||||
| --- | --- | --- |
|
||||
| 读取gameconfig中StringId=needEnergy | 查询本条配置并核对界面/配置输出 | Values=5 |
|
||||
| 读取gameconfig中StringId=maxEnergy | 查询本条配置并核对界面/配置输出 | Values=40 |
|
||||
| 读取gameconfig中StringId=chargeEnergy | 查询本条配置并核对界面/配置输出 | Values=600,1 |
|
||||
| 读取gameconfig中StringId=vipAddMaxEnergy | 查询本条配置并核对界面/配置输出 | Values=20 |
|
||||
|
||||
验收样例覆盖已经确认的值；流程中的未知分支不能以本表通过代替规则确认。数值表内的空值、0和-1分别保留；升级数组不默认使用玩家等级作为索引。
|
||||
|
||||
## 9. 当前待补充边界
|
||||
|
||||
体力恢复数组的单位及索引、道具组抽取是否有放回仍待确认。
|
||||
|
||||
[返回总纲](../局外玩法设计文档_HEROLL_原作_v1.0.md) · [阅读规范](../文档规范与阅读说明.md)
|
||||
Reference in New Issue
Block a user