HEROLL/HEROLL_OUTGAME_DEV_v1.0/06-宠物与成长/设计与规则.md

宠物与成长：原作设计与规则

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

1. 功能定位

宠物提供对局中的协助能力，并通过碎片和金币长期成长。冰冻蛙可以冰冻敌人，黑暗喵可处刑低生命敌人；具体效果模板和数值应一起读取，不能只显示宠物基础属性。限时成长活动是宠物系统中的独立进度。

2. 主要状态

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

状态	用途
宠物拥有状态	区分未解锁和已拥有
宠物等级	对应养成消耗与技能
碎片金币余额	支付养成投入
已开放技能	按宠物和等级区分
活动经验等级	独立于常规宠物等级

3. 功能规则

3.1 解锁和重复获得

宠物有解锁价格及重复转化字段。是否拥有即转化要读取该宠物标记；冰冻蛙的该标记为False，不能对所有宠物统一执行获得即转钻。

3.2 碎片成长

冰冻蛙碎片数组有20项，而金币数组有19项；原注释指出碎片数组第一项不使用。因此两数组不能直接按相同索引拼成升级表，也不能仅用最长数组长度确定最高等级。

3.3 技能开放

技能按宠物ID和开放等级配置。冷却、伤害和额外效果各自有基础值及增量；原作中文模板中的{B}等占位符暂保留，不擅自替换成某个字段。

3.4 成长活动

活动指定目标宠物、消费道具、事件池和时间。事件给出选择概率、奖励与经验，活动等级表负责经验需求及奖励，与常规碎片升级分开。

4. 操作流程

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

1. 打开宠物信息，显示拥有状态、等级、技能与成长消耗。
2. 常规升级读取该宠物的碎片与金币数组，并按已确认的索引规则定位。
3. 技能界面按等级条件展示相应技能条目。
4. 成长活动单独读取事件、经验和奖励，不写入普通宠物碎片等级。

5. 关键数值与计算

项目	数值	状态
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	原作配置确认
宠物满级转钻配置数组；品质映射待查	Values=5,10,20,40	原作配置确认

宠物解锁与成长（全表）

ID	名称/键	品质	基础冷却	冷却增量	unlockPrice
100	冰冻蛙	NORMAL	10.8	-0.2	1000
101	黑暗喵	NORMAL	9.8	-0.2	1000
102	狙击浣熊	NORMAL	11.8	-0.2	1000
103	暴怒鲨鱼	RARE	9.9	-0.1	1000
104	弓箭狐狸	RARE	4.95	-0.05	1000
105	枪手鸭	EPIC	6.9	-0.1	1000
106	地狱龙	EPIC	8.95	-0.05	1000
107	宝物啾	LEGEND	6.95	-0.05	1000
108	治癒兔	LEGEND	12.8	-0.2	1000
109	极光企鹅	NORMAL	19.8	-0.2	1000
110	骰子恐龙	LEGEND	1	0	1000
111	软呼呼护卫	LEGEND	1	0	1000
112	特务火腿	LEGEND	30	-1	1000
113	小丑猴	LEGEND	30	-1	1000
114	迷你海妖女王	LEGEND	30	-1	1000
115	火辣鸡	LEGEND	7.9	-0.1	1000
116	迷你军团长	MYTH	10	-0.1	1000
117	迷你神剑	MYTH	1	0	1000

宠物等级技能（节选前5条与末3条，完整116条见CSV）

ID	名称/键	petId	技能解锁等级	EPetSkill	skillValue
100	pet01_3	pet01	3	CooltimeReduce	0.5
101	pet01_5	pet01	5	ExtraValue	0.5
102	pet01_10	pet01	10	Skill_1	25
103	pet01_15	pet01	15	CooltimeReduce	0.5
104	pet01_20	pet01	20	ExtraValue	1
213	pet18_10	pet18	10	Skill_2	4
214	pet18_11	pet18	11	Skill_2	4
215	pet18_12	pet18	12	ExtraValue	0.3

6. 原作中文内容

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

来源表	ID	名称	效果/条件文本
pet	100	冰冻蛙	持续{B}秒冰冻敌人。
pet	101	黑暗喵	处刑生命值低于{B}%以下的敌人。
pet	102	狙击浣熊	狙击敌人，以20%机率造成300%伤害。
pet	103	暴怒鲨鱼	丢掷速度虽慢，但造成强大伤害的铁锚。
pet	104	弓箭狐狸	迅速地射出箭矢。
pet	105	枪手鸭	对敌人开枪。
pet	106	地狱龙	发射贯穿敌人的火球。
pet	107	宝物啾	以{B}%机率发现各种道具。
pet	108	治癒兔	恢復{A}%的勇士生命值。
pet	109	极光企鹅	发射贯穿敌人的光线，超可爱。
pet	110	骰子恐龙	骰点越高，发射越多核弹。
pet	111	软呼呼护卫	透过肉身保护勇士。
pet	112	特务火腿	获得点数。
pet	113	小丑猴	舞蹈时间！所有敌人跳起舞。
pet	114	迷你海妖女王	处刑生命值低于{B}%以下的所有敌人。
pet	115	火辣鸡	随机向1~3个敌人发射羽毛，造成<link='keyword_burn'><style=keyword>烧伤</style>。
pet	116	迷你军团长	每一楼层基本能力值增加{B}%
pet	117	迷你神剑	对1名敌人持续{B}秒插入<link='keyword_excalibur'><style=keyword>王者之剑</style>。
petskill	100	pet01_3	冷却时间减少{0}秒
petskill	101	pet01_5	冰冻敌人时间增加{0}秒

本节展示前20条中文内容；完整184条有名称或效果的记录见对应中文目录及中文文本对照。

7. 开发权威表

配置用途	权威原字段表	记录数	开发阅读表
宠物解锁与成长	pet.csv	18	中文目录
宠物等级技能	petskill.csv	116	中文目录
宠物成长活动入口	petgrowthdata.csv	2	中文目录
宠物成长事件	petgrowthevent.csv	50	中文目录
宠物成长等级奖励	petgrowthlevel.csv	26	中文目录

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

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

配置键	原值
petMaxConvertDia	5,10,20,40

8. 开发验收与禁止误写

输入	检查内容	预期
读取pet中StringId=pet01	查询本条配置并核对界面/配置输出	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
读取gameconfig中StringId=petMaxConvertDia	查询本条配置并核对界面/配置输出	Values=5,10,20,40

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

9. 当前待补充边界

碎片与金币的精确级别索引、效果模板占位符绑定、满级转化及技能成长公式尚待确认。

返回总纲 · 阅读规范