# 商店礼包与广告：原作设计与规则

版本：HEROLL 2.0.1 原作还原文档 v1.0。

## 1. 功能定位

局外商店包括常驻商品、每日随机商店、接力礼包、分组兑换、购买积分和存钱罐。它们共用资源与商品目录，但消费、限购、刷新和奖励持续方式不同。

## 2. 主要状态

下面是开发阅读所需的概念状态，属于开发映射，不要求与原作内部字段同名。

| 状态 | 用途 |
| --- | --- |
| 商品标识与可见状态 | 关联具体商品或触发入口 |
| 购买次数与周期 | 按商品分别记录 |
| 每日商店槽位 | 记录当前候选 |
| 接力档位 | 记录礼包顺序 |
| 存钱罐累计值 | 记录胜败增加 |

## 3. 功能规则

### 3.1 商品购买

每件商品分别读取消费类型、价格、限购数和重置周期。商品价格字段与美元参考字段分开，不将两者相乘或当作自动换算。一次性内容和每日发放内容也分开。

### 3.2 每日商店

候选有各自权重和售价。每日重掷次数配置为3；没有证据支持直接套用局内商店3、5、7的刷新价格链。

### 3.3 接力与兑换

接力礼包按礼包组和顺序组织，免费档与商品档分开。兑换同时有投入道具、数量、产出及兑换次数周期，不能只显示奖励而忽略投入。

### 3.4 存钱罐

档1从60累计到120，胜利增加20、失败增加10；购买窗口1440分钟、冷却4320分钟。各档数值不同，应切换到对应档行。

## 4. 操作流程

以下顺序用于拆解功能；涉及未确认的结算时机，以本章末尾具体缺口为准。

1. 按商品类别选择对应目录，读取开放或触发条件。
2. 展示价格、内容、次数与周期；每日发放额外展示持续天数。
3. 接力商品按当前档定位，兑换商品显示投入产出。
4. 存钱罐按当前档展示进度、购买时限与冷却。

## 5. 关键数值与计算

| 项目 | 数值 | 状态 |
| --- | --- | --- |
| 存钱罐档1起止值、胜败增加和购买窗口分钟数 | startValue=60；endValue=120；winUpValue=20；loseUpValue=10；purchaseAvailableMinutes=1440；cooldownMinutes=4320 | 原作配置确认 |
| 每日商店重掷次数配置 | Values=3 | 原作配置确认 |

### 存钱罐（全表）

| ID | 名称/键 | startValue | endValue | winUpValue | loseUpValue | purchaseAvailableMinutes | cooldownMinutes |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 1 | 特务H.A.M的提议(S) | 60 | 120 | 20 | 10 | 1440 | 4320 |
| 2 | 特务H.A.M的提议(M) | 140 | 250 | 30 | 15 | 1440 | 4320 |
| 3 | 特务H.A.M的提议(L) | 350 | 650 | 75 | 40 | 1440 | 4320 |
| 4 | 特务H.A.M的提议(XL) | 1000 | 2000 | 200 | 120 | 1440 | 4320 |

### 接力礼包顺序（节选前5条与末3条，完整78条见CSV）

| ID | 名称/键 | relayPackageId | order | 免费标记 | freeItemId | freeItemCount |
| --- | --- | --- | --- | --- | --- | --- |
| 100 | firstRelay_0 | firstRelay | 0 | True | 100,101 | 3000,10 |
| 101 | firstRelay_1 | firstRelay | 1 | False |  |  |
| 102 | firstRelay_2 | firstRelay | 2 | True | 90010 | 1 |
| 103 | firstRelay_3 | firstRelay | 3 | False |  |  |
| 104 | firstRelay_4 | firstRelay | 4 | True | 90009 | 1 |
| 175 | summer2026Relay_9 | summer2026Relay | 9 | False | 101 | 800 |
| 176 | summer2026Relay_10 | summer2026Relay | 10 | True | 142 | 200 |
| 177 | summer2026Relay_11 | summer2026Relay | 11 | True | 90032 | 1 |

## 6. 原作中文内容

中文名称和效果使用原作文本；{0}、{B}等占位符未确认绑定时保留，文字不能代替参数公式。

| 来源表 | ID | 名称 | 效果/条件文本 |
| --- | --- | --- | --- |
| shopproductlist | 1 | 足够的金币 |  |
| shopproductlist | 2 | 充裕的金币 |  |
| shopproductlist | 3 | 大量的金币 |  |
| shopproductlist | 4 | 足够的鑽石 |  |
| shopproductlist | 5 | 充裕的鑽石 |  |
| shopproductlist | 6 | 大量的鑽石 |  |
| shopproductlist | 7 | 足够的地板碎片 |  |
| shopproductlist | 8 | 充裕的地板碎片 |  |
| shopproductlist | 9 | 大量的地板碎片 |  |
| shopproductlist | 10 | 足够的骨头 |  |
| shopproductlist | 11 | 充裕的骨头 |  |
| shopproductlist | 12 | 大量的骨头 |  |
| shopproductlist | 14 | 强敌迴避票券 |  |
| shopproductlist | 15 | 逃狱票券 |  |
| shopproductlist | 16 | 好的开始 |  |
| shopproductlist | 17 | 足够的能量 |  |
| shopproductlist | 18 | 充裕的能量 |  |
| shopproductlist | 19 | 大量的能量 |  |
| shopproductlist | 20 | VIP月费 |  |
| shopproductlist | 21 | 新手礼包1 |  |

本节展示前20条中文内容；完整390条有名称或效果的记录见对应中文目录及[中文文本对照](./中文文本对照.csv)。

## 7. 开发权威表

| 配置用途 | 权威原字段表 | 记录数 | 开发阅读表 |
| --- | --- | --- | --- |
| 商品与持续发放 | [shopproductlist.csv](./shopproductlist.csv) | 397 | [中文目录](./shopproductlist-中文目录.csv) |
| 每日商店候选与售价 | [dailyshoplist.csv](./dailyshoplist.csv) | 64 | [中文目录](./dailyshoplist-中文目录.csv) |
| 接力礼包顺序 | [relaypackagedata.csv](./relaypackagedata.csv) | 78 | [中文目录](./relaypackagedata-中文目录.csv) |
| 分组礼包内容 | [d3package.csv](./d3package.csv) | 6 | [中文目录](./d3package-中文目录.csv) |
| 存钱罐 | [pigbank.csv](./pigbank.csv) | 4 | [中文目录](./pigbank-中文目录.csv) |
| 购买积分奖励 | [dailypurchasereward.csv](./dailypurchasereward.csv) | 9 | [中文目录](./dailypurchasereward-中文目录.csv) |
| 活动商品分组 | [groupbmshop.csv](./groupbmshop.csv) | 80 | [中文目录](./groupbmshop-中文目录.csv) |
| 分组兑换 | [groupexchangeshop.csv](./groupexchangeshop.csv) | 231 | [中文目录](./groupexchangeshop-中文目录.csv) |
| 促销入口排期 | [promotioninfo.csv](./promotioninfo.csv) | 2 | [中文目录](./promotioninfo-中文目录.csv) |
| 商品触发条件 | [triggerinfo.csv](./triggerinfo.csv) | 225 | [中文目录](./triggerinfo-中文目录.csv) |
| 插屏展示例外配置 | [interstitialexeptionregion.csv](./interstitialexeptionregion.csv) | 1 | [中文目录](./interstitialexeptionregion-中文目录.csv) |

[执行规则](./执行规则.csv) · [状态字段](./状态字段.csv) · [验收样例](./验收样例.csv) · [字段字典](./字段字典.csv) · [关联全局配置](./关联全局配置.csv)

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

| 配置键 | 原值 |
| --- | --- |
| shopRerollCost | 3,2 |
| dailyShopRerollCount | 3 |
| specialShopTabUnlockStage | 1 |
| ingameShopSpitoWeight | 3,5,10 |
| DeokjaShopCoinNeed | 1000, 500, 20000 |
| chargeShopAddProbability | 10 |
| vipAddMaxEnergy | 20 |

## 8. 开发验收与禁止误写

| 输入 | 检查内容 | 预期 |
| --- | --- | --- |
| 读取pigbank中StringId=pigbank_1 | 查询本条配置并核对界面/配置输出 | startValue=60；endValue=120；winUpValue=20；loseUpValue=10；purchaseAvailableMinutes=1440；cooldownMinutes=4320 |
| 读取gameconfig中StringId=dailyShopRerollCount | 查询本条配置并核对界面/配置输出 | Values=3 |

验收样例覆盖已经确认的值；流程中的未知分支不能以本表通过代替规则确认。数值表内的空值、0和-1分别保留；升级数组不默认使用玩家等级作为索引。

## 9. 当前待补充边界

触发条件优先级、每日候选筛选和刷新操作的精确消耗尚待确认。

[返回总纲](../局外玩法设计文档_HEROLL_原作_v1.0.md) · [阅读规范](../文档规范与阅读说明.md)