Waylee：新增重楼配置（Effect/Type/Decor 三表结构与启动校验）

2026-10-26T11:23:46Z

新增重楼配置（Effect/Type/Decor 三表结构与启动校验）

新页面

__NOTOC__
<div class="lua-reference">
<div class="lua-lead">
<div role="heading" aria-level="2" class="lua-h1">重楼配置</div>
<div class="lua-sub">3 张表 · ChongLouEffect / ChongLouType / ChonglouDecor · 神器外观与特效</div>
</div>

重楼是神器外观系统：15 种部位样式（kind）、6 个可视槽（甲、链、肩、戒、符、腰带），每种样式挂一个特效定义，装备映射决定哪件神器触发哪类。三张表在 <code>Public/Config</code> 下，加载器 <code>Common/ChongLouTables.h</code>，由 GameServer 启动时加载并校验。

== 加载与启动校验 ==
* ChongLouEffect.txt：10 列，行数不固定但必须非空；列类型依次为整、整、'''字符串'''、整、整、'''字符串'''、'''字符串'''、整、整、整。
* ChongLouType.txt：2 列全整型。
* ChonglouDecor.txt：6 列，类型为整、'''字符串'''、'''字符串'''、整、'''字符串'''、'''字符串'''。
* 全部表首列 ID 必须为正且不重复；Effect 的 ID 不超过 65535。

业务校验（<code>Valid</code>）：Effect、Type、Decor 三表都不能为空；15 个 kind 每个都必须有'''默认效果'''（style=0、quantity=0 的一行）；每个 Effect 第 5 列指向的 Decor 必须存在。

== ChongLouEffect.txt · 特效定义（10 列）==
{| class="wikitable"
! scope="col" style="width:8%" | 列
! scope="col" style="width:18%" | 内容
! scope="col" | 说明
|-
| 1 || 效果 ID || 正整数，≤65535，主键。
|-
| 2 || 部位 kind || 0..14。kind 到可视槽的映射写死在 <code>SlotForKind</code>（15 项表）。
|-
| 3 || 装备名 || 字符串，如「重楼甲」。
|-
| 4 || 风格 style || 0..2，0 是默认风格。
|-
| 5 || 装饰 ID || 指向 ChonglouDecor 的行，必须存在。
|-
| 6 || 图标 || 字符串，不能为空，如 <code>ChongLouEffect1_1</code>。
|-
| 7 || 名称 || 字符串，不能为空，如「默认风格」。
|-
| 8 || 关联物品 || 数量大于 0 时必须是合法物品编号；数量为 0 时可填 -1。
|-
| 9 || 数量 || ≥0。
|-
| 10 || requirement || 必须为 0（当前版本保留）。
|}

== ChongLouType.txt · 装备映射（2 列）==
{| class="wikitable"
! scope="col" style="width:8%" | 列
! scope="col" | 说明
|-
| 1 || 神器物品编号（如 10413102）。
|-
| 2 || 部位 kind（0..14）。
|}
<code>EquipmentKind(item)</code> 按此表反查：这件神器属于哪个重楼部位。新神器加入系统在这里登记。

== ChonglouDecor.txt · 特效装饰（6 列）==
{| class="wikitable"
! scope="col" style="width:8%" | 列
! scope="col" style="width:18%" | 内容
! scope="col" | 说明
|-
| 1 || 装饰 ID || 正整数，主键；Effect 第 5 列指向这里。
|-
| 2 || 绑点 || 字符串，如「身体中心点」。
|-
| 3 || 特效名 || 字符串，如 <code>buff_重楼遁甲</code>。
|-
| 4 || attach || 整型挂载标志。
|-
| 5 || 简版特效 || 字符串，低画质用。
|-
| 6 || 名称 || 字符串，可含多个部位名（顿号分隔）。
|}

== 修改清单 ==
* 加新外观：Effect 加行（kind/style 归位、decor 指向已有或新增 Decor 行）；如新部位还要动 <code>SlotForKind</code> 与 <code>DefaultEffect</code> 代码。
* 新增神器进系统：只加 ChongLouType 一行。
* 特效资源名（第 3、5 列）对应客户端特效资源，改名要两端同步。

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

工程参考/重楼配置 - 版本历史

Waylee：​新增重楼配置（Effect/Type/Decor 三表结构与启动校验）

Waylee：新增重楼配置（Effect/Type/Decor 三表结构与启动校验）