Initial import of HEROLL source and design documents

HEROLL_OUTGAME_2.0.1/02-资源背包与体力/01-模块设计文档.md

@@ -0,0 +1,57 @@
+# 02 资源背包与体力：原作模块设计
+
+## 功能定位
+
+统一道具类型、礼包内容、资源来源以及大厅到局内的资源映射。
+
+## 功能流程
+
+获得道具或资源 → 查看用途与来源 → 使用、开启道具组或兑换 → 形成奖励或带入局内的资源。
+
+以上按原作配置关系整理功能步骤，具体条件与数值见下文及规则说明。
+
+## 子功能构成
+
+| 子功能 | 设计内容 |
+| --- | --- |
+| 道具与资源定义 | 每种道具以Id/StringId识别。ERewardType和refStringId说明内容类型与引用；isStackable、selectCount和useRandom分别描述堆叠、选择数量及随机使用标记。 |
+| 道具包内容 | itemIds、itemCounts和weights按位置记录道具、数量与权重；sameItem作为独立配置保留，不能省略权重为0的项。 |
+| 资源获取途径 | itemID/itemGroup指向目标资源，跳转字段和unlockKey描述获取入口与开放条件。 |
+| 局外资源带入映射 | ELobbyAsset与EAsset构成大厅资源到使用资源的映射，defaultValue与boostValue是两种效果档。 |
+| 局外事件奖励 | when区分触发场景，itemID、itemCount和prob保存奖励候选及对应数量、概率参数。 |
+
+## 功能构成与规则关系
+
+item 用 ERewardType/refStringId 描述奖励语义，itemgroup 存放并列 itemIds/itemCounts/weights；itemsource 记录来源跳转与 unlockKey。lobbyticket 将 ELobbyAsset 映射到 EAsset，并区分 defaultValue/boostValue。
+
+## 关键规则与数值
+
+| 原作规则 | 数值 | 来源 |
+| --- | --- | --- |
+| 入场体力需求配置 | Values=5 | E-gameconfig / StringId=needEnergy / CSV记录25 |
+| 基础体力上限配置 | Values=40 | E-gameconfig / StringId=maxEnergy / CSV记录27 |
+| 体力恢复配置数组；计时单位及数组位置需消费函数 | Values=600,1 | E-gameconfig / StringId=chargeEnergy / CSV记录26 |
+| VIP额外体力上限配置 | Values=20 | E-gameconfig / StringId=vipAddMaxEnergy / CSV记录73 |
+
+## 完整数值表
+
+| 配置表 | 记录数 | 完整数据 |
+| --- | --- | --- |
+| item | 799 | [CSV](./03-表格/item.csv) |
+| itemgroup | 48 | [CSV](./03-表格/itemgroup.csv) |
+| itemsource | 29 | [CSV](./03-表格/itemsource.csv) |
+| lobbyticket | 3 | [CSV](./03-表格/lobbyticket.csv) |
+| outgamereward | 12 | [CSV](./03-表格/outgamereward.csv) |
+
+[规则说明](./02-规则说明.md) · [数值说明](./03-数值说明.md) · [字段字典](./03-表格/字段字典.csv) · [数组逐项明细](./03-表格/数组逐项明细.csv)
+
+[返回总纲](../00-局外系统模块总纲.md)
+
+## 相关功能模块
+
+| 模块 | 关联内容 |
+| --- | --- |
+| [巡逻挂机](../12-巡逻挂机/01-模块设计文档.md) | 按已通关进度配置离线巡逻与快速巡逻奖励。 |
+| [抽卡与保底](../13-抽卡与保底/01-模块设计文档.md) | 统一抽卡按钮、消费、候选奖励、权重和保底配置。 |
+| [商店礼包与广告](../14-商店礼包与广告/01-模块设计文档.md) | 管理常驻商品、每日商店、连续礼包、存钱罐、兑换和触发式促销。 |
+