HEROLL/HEROLL_OUTGAME_DEV_v1.0/02-资源背包与体力/设计与规则.md

资源背包与体力：原作设计与规则

版本：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条有名称或效果的记录见对应中文目录及中文文本对照。

7. 开发权威表

配置用途	权威原字段表	记录数	开发阅读表
道具与资源定义	item.csv	799	中文目录
道具包内容	itemgroup.csv	48	中文目录
资源获取途径	itemsource.csv	29	中文目录
局外资源带入映射	lobbyticket.csv	3	中文目录
局外事件奖励	outgamereward.csv	12	中文目录

执行规则 · 状态字段 · 验收样例 · 字段字典 · 关联全局配置

全局键按模块名称关联收录；其具体含义优先以正文已确认的规则为准。

配置键	原值
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. 当前待补充边界

体力恢复数组的单位及索引、道具组抽取是否有放回仍待确认。

返回总纲 · 阅读规范