Initial import of HEROLL source and design documents

2026-10-26 16:05:39 +08:00
commit fdb55672c1
1846 changed files with 290692 additions and 0 deletions
@@ -0,0 +1,54 @@
+# 06 宠物与成长：原作模块设计
+
+## 功能定位
+
+负责宠物获取、重复转化、碎片升级、技能开放与限时成长活动。
+
+## 功能流程
+
+解锁宠物 → 收集碎片与金币 → 升级 → 开放等级技能；成长活动另按事件获得经验和阶段奖励。
+
+以上按原作配置关系整理功能步骤，具体条件与数值见下文及规则说明。
+
+## 子功能构成
+
+| 子功能 | 设计内容 |
+| --- | --- |
+| 宠物解锁与成长 | 品质、启用与重复转化字段描述获取状态；needPiece和needGold分别保存成长消耗数组，冷却、伤害及附加属性各有基础与增量字段。needPiece首项在原注释中标为未使用。 |
+| 宠物等级技能 | petId关联宠物，isUse与skillUnlockLevel描述启用和开放等级；EPetSkill与skillValue/subValues/extraValues共同定义技能参数。 |
+| 宠物成长活动入口 | petId标识目标宠物，useItemId/useItemCount描述活动消费，seasonStartDay/seasonDay/seasonEndDay保留活动时间配置。 |
+| 宠物成长事件 | eventId/eventKey组织事件，类型、权重、品质和事件参数构成候选；选择结果文本、选择概率及奖励经验分别配置。 |
+| 宠物成长等级奖励 | 按eventKey/level记录needXp、repeatMaxCount和奖励，不同成长活动不合并经验需求。 |
+
+## 功能构成与规则关系
+
+pet 给出 needPiece/needGold 数组、解锁价格、重复转化字段和战斗基础/增量参数；petskill 按 petId 与 skillUnlockLevel 配置技能；成长活动用 eventKey 关联事件权重、经验和等级奖励。pet 的 needPiece 注释指出数组首项为未使用值。
+
+## 关键规则与数值
+
+| 原作规则 | 数值 | 来源 |
+| --- | --- | --- |
+| pet01升级、重复转化与冷却原值；needPiece首项为未使用值 | needPiece=1,2,4,6,8,10,15,20,30,40,50,60,80,100,120,140,160,180,190,200；needGold=1000,2000,4000,6000,8000,10000,15000,20000,30000,40000,60000,80000,100000,120000,140000,160000,180000,200000,250000；ifOwnAutoConvert=False；convertItemId=101；convertCount=5；baseCoolTime=10.8；plusCoolTime=-0.2 | E-pet / StringId=pet01 / CSV记录4 |
+| 宠物满级转钻配置数组；品质映射待查 | Values=5,10,20,40 | E-gameconfig / StringId=petMaxConvertDia / CSV记录32 |
+
+## 完整数值表
+
+| 配置表 | 记录数 | 完整数据 |
+| --- | --- | --- |
+| pet | 18 | [CSV](./03-表格/pet.csv) |
+| petskill | 116 | [CSV](./03-表格/petskill.csv) |
+| petgrowthdata | 2 | [CSV](./03-表格/petgrowthdata.csv) |
+| petgrowthevent | 50 | [CSV](./03-表格/petgrowthevent.csv) |
+| petgrowthlevel | 26 | [CSV](./03-表格/petgrowthlevel.csv) |
+
+[规则说明](./02-规则说明.md) · [数值说明](./03-数值说明.md) · [字段字典](./03-表格/字段字典.csv) · [数组逐项明细](./03-表格/数组逐项明细.csv)
+
+[返回总纲](../00-局外系统模块总纲.md)
+
+## 相关功能模块
+
+| 模块 | 关联内容 |
+| --- | --- |
+| [抽卡与保底](../13-抽卡与保底/01-模块设计文档.md) | 统一抽卡按钮、消费、候选奖励、权重和保底配置。 |
+| [Raid讨伐](../21-Raid讨伐/01-模块设计文档.md) | 管理讨伐门票、赛季预设、试用宠物、分数奖励与最高分档。 |
+