工程参考/兽魂与珍兽装备配置

兽魂与珍兽装备配置

16 张表 · 珍兽装备 8 + 兽魂 5 + 兽魂外观 2 + 幻化灵性 2 · 仅服务端读取

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

加载与启动校验（比一般表严格）

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

珍兽装备：PetEquipBase.txt（104 列，904 行）

装备模板主表。已确认的列位（0 起算，实现位于 Common/PetSoulTableColumns.h）：

列（0 起）	内容	说明
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 条（MaxExtensions）。

其余珍兽装备表

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

兽魂五张表

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

兽魂外观两张表

表	列数	样本行	内容与要点
Exterior_Poss.txt	14	19	兽魂附体外观：第 6 列名称（如「飞羚」）、第 7 列资源（如 PetSoulEquip1_5）、第 8 列费用、第 9 列物品。
Exterior_RanSe.txt	13	104	兽魂染色：第 11 列风格名（如「天青风格【普通】」）、第 12 列花费、第 13 列资源（如 PetSoulColor_12）。

幻化与灵性（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。查询按「原珍兽 + 当前资质上限」落区间。

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

修改清单

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