Waylee：新增武魂刻符配置（KFS×8 + WuhunWg×2 十表结构、技能链与启动校验）

2026-10-26T11:26:11Z

新增武魂刻符配置（KFS×8 + WuhunWg×2 十表结构、技能链与启动校验）

新页面

__NOTOC__
<div class="lua-reference">
<div class="lua-lead">
<div role="heading" aria-level="2" class="lua-h1">武魂刻符配置</div>
<div class="lua-sub">10 张表 · KFS×8 + WuhunWg×2 · 仅服务端读取</div>
</div>

武魂（物品如 10156001「灵玑瑶盘」一类）是带技能与扩展属性的成长装备，刻符（KFS）是它的属性/技能体系。十张表在 <code>Public/Config</code> 下，加载器 <code>Common/WuhunTables.h</code>（命名空间 <code>TLBBWuhun</code>），由 GameServer 启动时统一加载并校验（实现位于 <code>Server/GameServer/Server/Main/GameTable.cpp</code> 的 <code>InitWuhunTables</code>）。

== 加载与启动校验 ==
与龙纹、雕纹不同，武魂表'''列数是最低要求'''（少于下表拒绝，多于允许），行数只要求非空；首列主键只查重、不要求连续。任何一张加载失败或校验失败，GameServer 拒绝启动。

{| class="wikitable"
! scope="col" | 表
! scope="col" style="width:10%" | 最少列数
! scope="col" style="width:12%" | 当前数据行
! scope="col" | 用途
|-
| <code>KFSBase.txt</code> || 19 || 4 || 武魂基础定义：成长权重、技能位编号、各档属性区间。
|-
| <code>KFSAttrEx.txt</code> || 70 || 160 || 扩展属性库，主键 1..160；第 2 列是名称（如「冰攻击(1级)」），第 3 列指向升级后的另一条扩展属性（形成升级链）。
|-
| <code>KFSAttrExBook.txt</code> || 2 || 16 || 属性书：第 1 列物品编号，第 2 列必须指向 KFSAttrEx 里存在的行（学习后获得该扩展属性）。
|-
| <code>KFSAttrLevelUp.txt</code> || 26 || 121 || 扩展属性升级参数。
|-
| <code>KFSCompoudEx.txt</code> || 2 || 10 || 合成扩展参数。
|-
| <code>KFSLevelupExp.txt</code> || 2 || 120 || 等级→经验（第 1 列等级、第 2 列经验，样本 1 级=1500）。
|-
| <code>KFSSkillLevelup.txt</code> || 5 || 276 || 技能升级链：第 1 列当前技能、第 2 列下一形态技能、第 3 列材料、第 4 列费用、第 5 列=1 表示技能族根。
|-
| <code>KFSSlot.txt</code> || 6 || 10 || 技能槽开启：槽位、评分门槛、解锁材料与费用。
|-
| <code>WuhunWg.txt</code> || 19 || 6 || 武魂外观：第 2 列名称（如「灵玑瑶盘」）、第 3 列图标，行数不超过外观容量。
|-
| <code>WuhunWgLevel.txt</code> || 18 || 660 || 外观等级属性：主键 = 外观ID×10000 + 档位×100 + 等级（<code>VisualLevelKey</code>）。
|}

关联校验：<code>AttrExBook</code> 第 2 列必须在 <code>AttrEx</code> 存在；<code>AttrEx</code> 主键必须在 1..160，第 3 列非 0 时必须指向另一条 <code>AttrEx</code>；<code>WuhunWg</code> 行数不超过 <code>AppearanceCount</code>。

== 技能体系 ==
* 技能位数量按武魂等级：40 级 1 个、70 级 2 个、90 级 3 个（<code>SkillCountForLevel</code>）。
* <code>KFSSkillLevelup</code> 把技能串成族链：<code>SkillFamily</code> 从任意一阶沿第 2 列回溯到「第 5 列=1」的根技能，最多回溯 32 步。样本 1361→1362 表示技能 1361 升一级变成 1362，花材料 20310117 与 10000 费用。

== 属性计算 ==
角色属性重算时（实现位于 <code>Obj_Human_Calc.cpp</code>），武魂提供两部分：力/灵/体/定/身五项基础属性（<code>BaseAttribute</code>，按物品编号与刻符信息算）和各技能槽的扩展属性（<code>ExtraAttribute</code>，每槽最多遍历 64 项属性，大于 0 才计入）。

== 修改清单 ==
* 加扩展属性：KFSAttrEx 加行（主键 ≤160、升级链指对），需要书学习就在 KFSAttrExBook 加一行。
* 调升级经验只改 KFSLevelupExp；它是两列小表，没有连续主键校验，但等级断档会让对应等级查不到经验。
* 加技能进阶：KFSSkillLevelup 加一行链接两阶技能，根技能行第 5 列必须为 1。
* 加外观：WuhunWg 加行 + WuhunWgLevel 按 id×10000+档×100+级补属性行；外观总数受 <code>AppearanceCount</code> 限制。

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

工程参考/武魂刻符配置 - 版本历史

Waylee：​新增武魂刻符配置（KFS×8 + WuhunWg×2 十表结构、技能链与启动校验）

Waylee：新增武魂刻符配置（KFS×8 + WuhunWg×2 十表结构、技能链与启动校验）