HEROLL/HEROLL_OUTGAME_2.0.1/14-商店礼包与广告/01-模块设计文档.md

14 商店礼包与广告：原作模块设计

功能定位

管理常驻商品、每日商店、连续礼包、存钱罐、兑换和触发式促销。

功能流程

展示满足条件的商品 → 查看成本、限购与奖励 → 购买或兑换 → 获得即时奖励或每日奖励；部分礼包按顺序开放。

以上按原作配置关系整理功能步骤，具体条件与数值见下文及规则说明。

子功能构成

子功能	设计内容
商品与持续发放	价格、消费类型、购买次数、重置周期和平台商品标识分开保存；ItemId/ItemValue是商品内容，dailyItemId/dailyItemValue/dailyObtainDay描述每日发放内容。
每日商店候选与售价	Prob是候选权重参数，ItemID/ItemValue描述内容，ECostType/buyPrice描述消费，Sale保存折扣标记或值。
接力礼包顺序	relayPackageId分组，order定义档位顺序；isFree与freeItemId/freeItemCount区分免费档，productKey连接商品。
分组礼包内容	groupKey/index组织礼包档，各组itemID0至2与itemCount0至2记录礼包内的三组奖励位置。
存钱罐	每档有startValue/endValue以及winUpValue/loseUpValue；purchaseAvailableMinutes和cooldownMinutes分别给出购买窗口与冷却分钟数。
购买积分奖励	needPoint为积分门槛，rewardID/rewardCount给对应档奖励。
活动商品分组	ERefType/groupKey/targetStringId表示分组引用，shopProductStringId连接具体商品。
分组兑换	ECoolTimeType/exchangeCount描述次数配置，exchangeItemId/exchangeItemCount与rewardId/rewardCount分别描述兑换投入和产出。
促销入口排期	起止时间和clearStage描述展示条件，位置及排序控制入口布局，跳转字段描述目标功能。
商品触发条件	TriggerType、GoalString/GoalValue等字段保存触发条件；起止时间、持续时间、重开次数和重开间隔分别配置，ProductKey连接商品，IsUse标记配置使用。
插屏展示例外配置	showDay与exeptionRegions记录展示日序和区域例外原值，原字段拼写保留。

功能构成与规则关系

shopproductlist 分离 BuyPrice/Dollar、平台产品ID、ECostType、次数重置和每日发放；triggerinfo 给出触发条件、时段、重复开启及开关；dailyshoplist 用 Prob 描述刷新候选。

关键规则与数值

原作规则	数值	来源
存钱罐档1起止值、胜败增加和购买窗口分钟数	startValue=60；endValue=120；winUpValue=20；loseUpValue=10；purchaseAvailableMinutes=1440；cooldownMinutes=4320	E-pigbank / StringId=pigbank_1 / CSV记录4
每日商店重掷次数配置	Values=3	E-gameconfig / StringId=dailyShopRerollCount / CSV记录29

完整数值表

配置表	记录数	完整数据
shopproductlist	397	CSV
dailyshoplist	64	CSV
relaypackagedata	78	CSV
d3package	6	CSV
pigbank	4	CSV
dailypurchasereward	9	CSV
groupbmshop	80	CSV
groupexchangeshop	231	CSV
promotioninfo	2	CSV
triggerinfo	225	CSV
interstitialexeptionregion	1	CSV

规则说明 · 数值说明 · 字段字典 · 数组逐项明细

返回总纲

相关功能模块

模块	关联内容
资源背包与体力	统一道具类型、礼包内容、资源来源以及大厅到局内的资源映射。
通行证与赛季	负责通行证经验、任务、奖励轨道和赛季开放。
赛季活动与超级球	管理活动排期、活动任务、兑换时段、转盘及超级球奖池。