传奇盛大皓月套装DB适配3K引擎：StdItems字段映射、套装触发与客户端外观同步

皓月套装是热血传奇后期终极装备体系之一，标准版本需要等级300，包含武器、衣服、项链、护腕、戒指、头盔、腰带、靴子、斗笠、面巾、勋章等部位。集齐3件可触发套装效果，等级越高套装加成越强。 3K引擎使用StdItems.DB管理物品数据，盛大皓月套装数据迁移到3K引擎时，需要重点处理StdMode映射、属性字段对应、特殊属性Shape/AniCount绑定和套装触发配置。

一、StdItems.DB字段映射

StdItems.DB中每个装备对应一行数据，字段顺序不能错乱。皓月套装常见字段如下：

Idx：物品编号，必须连续递增，不能断号。新增皓月装备时建议从当前版本最大Idx之后开始添加。

Name：物品名称，需与客户端素材名称、掉落文件名称完全一致。例如皓月战刃、皓月战甲、皓月项链（战）等。

StdMode：物品类型代码。武器填5或6，男衣服填10，女衣服填11，项链填19、20或21，戒指填22或23，手镯填24或26，头盔填15，腰带填64，鞋子填62，勋章填30，斗笠和面巾根据当前引擎版本对应字段设置。

Weight：物品重量。皓月套装属于高阶装备，重量可适当提高，例如武器15至30，衣服20至40，首饰1至5。

Looks：物品外观编号，决定客户端显示外观。需与客户端PAK或WIL素材编号一致。

Need：需要条件类型，0表示需要等级，1表示需要攻击力，2表示需要魔法力，3表示需要道术。

NeedLevel：需要等级数值。皓月套装标准版本为300级，可根据版本平衡下调至45、50或60级。

Price：物品价格，影响NPC出售价格。

DuraMax：持久上限。武器通常40至60，衣服50至70，首饰7至15。

AC、AC2：防御属性。衣服、头盔、腰带、靴子使用AC和AC2表示物理防御上下限。

MAC、MAC2：魔御属性。衣服、头盔、腰带、靴子使用MAC和MAC2表示魔法防御上下限。

DC、DC2：攻击属性。武器、项链、护腕、戒指、衣服等部位使用DC和DC2表示攻击上下限。

MC、MC2：魔法属性。法师武器、项链、护腕、戒指等部位使用MC和MC2表示魔法上下限。

SC、SC2：道术属性。道士武器、项链、护腕、戒指等部位使用SC和SC2表示道术上下限。

二、皓月战士套装DB配置示例

以战士皓月套装为例，各部位属性配置如下：

皓月战刃：StdMode填5，DC填32，DC2填95，Need填0，NeedLevel填300。准确+9和幸运+7需通过Shape或AniCount字段实现，具体取决于当前引擎版本对武器附加属性的解析规则。

皓月战甲：StdMode填10，AC填12，AC2填30，MAC填12，MAC2填30，DC填17，DC2填24。麻痹抗性+50需通过Shape或AniCount绑定特殊属性代码。

皓月项链（战）：StdMode填19或20，DC填14，DC2填22。幸运+2在StdMode=19时通常由MAC2字段表示。

皓月战盔：StdMode填15，AC填0，AC2填10，MAC填3，MAC2填12，DC填11，DC2填23。

皓月护腕（战）：StdMode填24或26，DC填15，DC2填24。

皓月战戒：StdMode填22或23，DC填19，DC2填30。

皓月腰带（战）：StdMode填64，AC填0，AC2填10，MAC填3，MAC2填12，DC填11，DC2填23。

皓月战靴：StdMode填62，AC填0，AC2填10，MAC填3，MAC2填12，DC填11，DC2填23。

皓月斗笠（战）：StdMode根据当前版本设置，AC填4，AC2填4，MAC填4，MAC2填4，DC填8，DC2填17。

皓月面巾（战）：StdMode根据当前版本设置，AC填4，AC2填4，MAC填4，MAC2填4，DC填8，DC2填17。

皓月战勋：StdMode填30，DC填14，DC2填22。

三、皓月道士和法师套装配置

道士套装将攻击属性替换为道术属性。皓月宝扇SC填32，SC2填45；皓月道袍SC填15，SC2填22；皓月项链（道）SC填13，SC2填20；皓月护腕（道）SC填13，SC2填22；皓月道戒SC填18，SC2填28；皓月道勋SC填13，SC2填20。防具部位的AC、MAC属性与战士套装相近，但数值略有差异。

法师套装将攻击属性替换为魔法属性。皓月权杖MC填32，MC2填45；皓月魔衣MC填15，MC2填22；皓月项链MC填13，MC2填20；皓月护腕（法）MC填13，MC2填22；皓月魔戒MC填18，MC2填28；皓月法勋MC填13，MC2填20。

四、特殊属性Shape和AniCount配置

皓月套装中的准确+9、幸运+7、麻痹抗性+50、暴击等级20等特殊属性，需要通过Shape或AniCount字段实现。

麻痹抗性通常通过Shape字段绑定特殊属性代码。部分引擎使用139表示防麻痹，具体代码需以当前引擎说明为准。

幸运属性在项链上通常由MAC2字段表示（StdMode=19时），在武器上可能需要通过Shape或AniCount实现。

准确属性在项链上通常由AC2字段表示（StdMode=20时），在武器上可能需要通过Shape或AniCount实现。

暴击等级20属于合击版本特有属性，需要通过AniCount绑定脚本触发，或使用引擎提供的自定义属性系统实现。

五、套装效果触发配置

皓月套装3件触发LV1，5件触发LV2，8件触发LV3。 套装效果通常通过QFunction-0.txt脚本实现。

[@CheckHaoYueSuit]
IF
CHECKITEM 皓月战甲 1
CHECKITEM 皓月战盔 1
CHECKITEM 皓月战靴 1
ACT
SENDMSG 7 已激活皓月套装LV1效果，主属性+10，合击威力+1000。
BREAK

套装属性也可通过SetItem.NPC文本文件配置，具体方式取决于当前引擎版本。

六、客户端素材同步

皓月套装装备外观需要客户端PAK或WIL素材支持。Looks字段编号必须与客户端素材编号一致，否则装备显示为默认外观或不显示。

武器、衣服、首饰、头盔、腰带、靴子、斗笠、面巾、勋章等部位的外观素材需分别放入对应客户端资源文件中。新增自定义外观时，建议从当前版本最大外观编号之后开始添加，避免与已有素材冲突。

七、常见问题排查

装备属性异常：检查StdMode是否选错，同类装备应复制同类型行修改。

装备不显示：检查Looks编号是否与客户端素材一致，客户端是否有对应PAK或WIL文件。

套装不触发：检查QFunction-0.txt脚本中物品名称是否与StdItems.DB一致，脚本段编号是否正确。

特殊属性无效：检查Shape或AniCount字段是否被当前引擎支持，特殊属性代码是否正确。

需要等级不生效：检查Need和NeedLevel字段是否填写正确，Need=0表示需要等级。

数据库报错：检查Idx是否连续，新增行是否出现空号。

盛大皓月套装数据迁移到3K引擎时，核心在于StdMode映射正确、属性字段对应准确、特殊属性通过Shape或AniCount绑定、客户端素材同步到位。修改StdItems.DB后需在M2引擎中重载数据库，修改脚本后需重新加载NPC配置。