Waylee：新增兽魂与珍兽装备配置（16 张表的结构、列类型校验与启动约束）

2026-10-26T14:01:49Z

新增兽魂与珍兽装备配置（16 张表的结构、列类型校验与启动约束）

←上一版本		2026年10月26日 (一) 22:01的版本
第85行：		第85行：
	\|-		\|-
	\| <code>PetEquipSuitUp.txt</code> \|\| 21 \|\| 540 \|\| 套装升阶：第 2 列来源物品、第 9 列成功率（0..100）、第 19 列目标物品、第 21 列字符串。来源与目标的装备位必须一致。		\| <code>PetEquipSuitUp.txt</code> \|\| 21 \|\| 540 \|\| 套装升阶：第 2 列来源物品、第 9 列成功率（0..100）、第 19 列目标物品、第 21 列字符串。来源与目标的装备位必须一致。
			\|-
			\| <code>PetEquipSlotCost.txt</code> \|\| 7 \|\| 480 \|\| 珍兽装备打孔费用样本：费用索引、金钱、物品、数量，再一组备用。'''当前检索未发现读取方'''——服务端打孔读的是另一个表 <code>SlotCost.txt</code>（<code>InitSlotCostTBL</code>），不要混淆。
	\|}		\|}

Waylee：新增兽魂与珍兽装备配置（16 张表的结构、列类型校验与启动约束）

2026-10-26T13:43:01Z

新增兽魂与珍兽装备配置（16 张表的结构、列类型校验与启动约束）

新页面

__NOTOC__
<div class="lua-reference">
<div class="lua-lead">
<div role="heading" aria-level="2" class="lua-h1">兽魂与珍兽装备配置</div>
<div class="lua-sub">16 张表 · 珍兽装备 8 + 兽魂 5 + 兽魂外观 2 + 幻化灵性 2 · 仅服务端读取</div>
</div>

兽魂（物品号 706xxxxx 一类）是珍兽位的成长装备；配它的是整套珍兽装备（套装、强化、洗练、升阶）。十六张表由两个加载器在 GameServer 启动时统一加载：'''珍兽装备与兽魂''' 14 张走 <code>PetSoul</code>（实现位于 <code>Common/PetSoulRules.h</code>），'''幻化与灵性''' 2 张走 <code>PetHoly</code>（实现位于 <code>Common/PetHolyRules.h</code>）。客户端不读这些表。

== 加载与启动校验（比一般表严格）==
* '''列数必须精确相等'''（不是“至少”），列的类型也逐列校验：整型列读 <code>iValue</code>、字符串列读 <code>pString</code>，类型行写错直接启动失败。哪些列是字符串写在 <code>PetSoulRules.h</code> 的 <code>StringColumn</code>（如 PetEquipBase 的第 11、13、19、20 列）。
* 首列主键必须 ≥0 且不重复（'''允许 0'''，与多数表要求正数不同）。
* <code>Valid()</code> 的硬性关联：
** 14 张表每一张都必须非空；
** PetSoulBase 每一行的装备位必须等于兽魂位（第 6 槽）、品质必须有对应扩展条数、第 11 列技能必须在 PetSoulSkill 里存在；
** 每个兽魂的 1..100 级在 PetSoulLevelupInfo 里都要有行，且该行第 4–8 列非负；
** PetSoulExtension 的 23 个扩展类型逐个存在，第 2 列非负，各档位的下限/上限非降；
** PetSoulEquipSuitUp 每一行的来源与目标装备位必须相同且有效，成功率 0..100。

== 珍兽装备：PetEquipBase.txt（104 列，904 行）==
装备模板主表。已确认的列位（'''0 起算'''，实现位于 <code>Common/PetSoulTableColumns.h</code>）：

{| class="wikitable"
! scope="col" style="width:12%" | 列（0 起）
! scope="col" style="width:24%" | 内容
! scope="col" | 说明
|-
| 0 || 装备 ID || 主键，样本 70100000 段。
|-
| 1 || 物品类 || 必须等于 7 才算珍兽装备。
|-
| 2 || 品质 || 生效品质只有 1、2、4、5、6；等于 7 或 3 都取不到。
|-
| 5 || 装备位 || 品质 6 表示兽魂位（还要求 PetSoulBase 有对应行）；其余必须在 0..4。
|-
| 7 || 规则号 ||
|-
| 8 || 套装号 || 关联 PetEquipSetAttr。
|-
| 10 / 12 || 名称 / 说明 || 字符串列。
|-
| 11 || 需求等级 ||
|-
| 18 / 19 || 图标 / 提示 || 字符串列。
|-
| 20 || 有无资质 || 0/1。
|-
| 21 || 有无星级 || 0/1。
|-
| 22–27 || 六项基础属性 ||
|-
| 28–86 || 属性权重 ||
|-
| 87 || 属性段 ||
|-
| 88–89 || 属性条数上下限 ||
|-
| 90–91 || 资质上下限 ||
|-
| 95–99 || 五项契合标志 || 顺序为力量、灵气、体力、定力、身法。
|-
| 100 || 契合缩放 ||
|-
| 101–103 || 分解材料 / 数量 / 成功率 ||
|}

扩展条数按品质：品质 0 → 4 条、1 → 5 条、2 或 3 → 6 条，其他品质 0 条（<code>MaxExtensions</code>）。

== 其余珍兽装备表 ==
{| class="wikitable"
! scope="col" | 表
! scope="col" style="width:10%" | 列数
! scope="col" style="width:10%" | 样本行
! scope="col" | 内容与要点
|-
| <code>PetEquipFuse.txt</code> || 8 || 6 || 契合融合参数，样本 <code>1 1 1600 6 6 6</code>。
|-
| <code>PetEquipItemAptRate.txt</code> || 7 || 255 || 资质概率。
|-
| <code>PetEquipItemEnhance.txt</code> || 12 || 45 || 强化参数，样本 <code>0 0 1 100 7500 0</code>。
|-
| <code>PetEquipItemSegValue.txt</code> || 59 || 300 || 属性段基值。
|-
| <code>PetEquipSetAttr.txt</code> || 20 || 135 || 套装属性；第 2 列是套装名（字符串，样本「苍狼啸月·勇」），第 8 列起每三列一组、组内第一列是字符串。
|-
| <code>PetEquipSuitUp.txt</code> || 21 || 540 || 套装升阶：第 2 列来源物品、第 9 列成功率（0..100）、第 19 列目标物品、第 21 列字符串。来源与目标的装备位必须一致。
|}

== 兽魂五张表 ==
{| class="wikitable"
! scope="col" | 表
! scope="col" style="width:10%" | 列数
! scope="col" style="width:10%" | 样本行
! scope="col" | 内容与要点
|-
| <code>PetSoulBase.txt</code> || 28 || 27 || 兽魂模板：第 2 列品质、第 3 列生命上限、第 5–9 列各阶集中度消耗、第 11 列技能（必须在 PetSoulSkill 存在）、第 12–16 列出战模型、第 18–22 列附体模型、第 24 列玉石、第 25 列图鉴序、第 28 列外观；第 26、27 列是字符串。
|-
| <code>PetSoulExtension.txt</code> || 17 || 23 || 23 个扩展类型 × 6 档：第 2 列非负，第 3 列起每两列一档（下限、上限），下限非降。
|-
| <code>PetSoulLevelCost.txt</code> || 21 || 100 || 升级/返还消耗：第 2 列起每品质两列材料，第 3 列起每品质两列铜钱，第 10 列起每品质一列返还。
|-
| <code>PetSoulLevelupInfo.txt</code> || 8 || 2700 || 每兽魂每级一行：第 2 列兽魂、第 3 列等级；第 4–8 列必须非负。100 级 × 27 个兽魂正好 2700 行。
|-
| <code>PetSoulSkill.txt</code> || 56 || 26 || 兽魂技能；第 23、38、39、40 列及第 55 列起是字符串。
|}

== 兽魂外观两张表 ==
{| class="wikitable"
! scope="col" | 表
! scope="col" style="width:10%" | 列数
! scope="col" style="width:10%" | 样本行
! scope="col" | 内容与要点
|-
| <code>Exterior_Poss.txt</code> || 14 || 19 || 兽魂附体外观：第 6 列名称（如「飞羚」）、第 7 列资源（如 <code>PetSoulEquip1_5</code>）、第 8 列费用、第 9 列物品。
|-
| <code>Exterior_RanSe.txt</code> || 13 || 104 || 兽魂染色：第 11 列风格名（如「天青风格【普通】」）、第 12 列花费、第 13 列资源（如 <code>PetSoulColor_12</code>）。
|}

== 幻化与灵性（PetHoly 两表）==
=== PetHuanhuaTable.txt（5 列，4351 行）===
珍兽幻化。列为编号、原珍兽、目标形态、费用、保留位。约束：第 1 列必须等于第 2 列、目标形态不能为 0（可为 -1）、费用 ≥0、保留位必须为 0。相关常量：幻化丹 30502005、元宝幻化丹 30502006、碎片 20310115（10 个合一个）、合成花费 20000 铜。

=== PetLingXing.txt（24 列，13615 行）===
灵性加成。列为编号、原珍兽、资质下限、资质上限，随后 10 级加成（第 5–14 列）与 10 级成功率（第 15–24 列）。约束：资质区间不允许重叠（同区间同值的别名行保留首条，冲突值拒绝）；加成逐级非降；成功率 0..100。查询按「原珍兽 + 当前资质上限」落区间。

灵性与幻化的花费不在这两表里，写死在 <code>PetHolyRules.h</code>：升级费 <code>{10000, 12000, 14400, …}</code> 十级、快速费另一组十级；成功率判定为 <code>1 ≤ roll ≤ percent ≤ 100</code>。

== 修改清单 ==
* 加珍兽装备：PetEquipBase 加行，物品类必须是 7、品质取 1/2/4/5/6，装备位按品质填；套装升阶在 PetEquipSuitUp 加行并保证来源目标同位。
* 加兽魂：PetSoulBase 加行，同时在 PetSoulSkill 登记技能、在 PetSoulLevelupInfo 补满 1..100 级、在 PetSoulExtension 配好扩展类型，否则 Valid 失败。
* 调扩展条数：改品质定义（MaxExtensions 是代码不是表）。
* 十六张表的列数与列类型都是启动硬校验，动结构前先备份并本地启动验证。

[[Category:工程参考]]
</div>

工程参考/兽魂与珍兽装备配置 - 版本历史

Waylee：​新增兽魂与珍兽装备配置（16 张表的结构、列类型校验与启动约束）

Waylee：​新增兽魂与珍兽装备配置（16 张表的结构、列类型校验与启动约束）

Waylee：新增兽魂与珍兽装备配置（16 张表的结构、列类型校验与启动约束）

Waylee：新增兽魂与珍兽装备配置（16 张表的结构、列类型校验与启动约束）