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

版本：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></link>。 |
| pet | 116 | 迷你军团长 | 每一楼层基本能力值增加{B}% |
| pet | 117 | 迷你神剑 | 对1名敌人持续{B}秒插入<link='keyword_excalibur'><style=keyword>王者之剑</style></link>。 |
| petskill | 100 | pet01_3 | 冷却时间减少{0}秒 |
| petskill | 101 | pet01_5 | 冰冻敌人时间增加{0}秒 |

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

## 7. 开发权威表

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

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

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

| 配置键 | 原值 |
| --- | --- |
| 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. 当前待补充边界

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

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