SuperAPI AI 工具集

msw-costume

智能体与模型

查看项目

更新于 10-15 21:40

技能介绍

用途:管理 MSW 中角色与实体的外观装扮(costume),支持查询(get)与应用(set),可作用于 DefaultPlayer,也可作用于地图中的 NPC、怪物等所有实体。

主要能力:以 MOD.Core.CostumeManagerComponent 为核心,通过 17 个字符串属性(Custom*Equip)表达装备槽,与引擎枚举 MapleAvatarItemCategory 对应,如 CustomBodyEquip→Body、CustomHairEquip→Hair、CustomCapEquip→Cap、CustomCoatEquip→Coat、CustomLongcoatEquip→Longcoat、CustomPantsEquip→Pants、CustomOneHandedWeaponEquip→OneHandedWeapon、CustomTwoHandedWeaponEquip→TwoHandedWeapon、CustomSubWeaponEquip→SubWeapon 等。另有 UseCustomEquipOnly(是否忽略账号默认装扮)、DefaultEquipUserId(复制指定用户装备后叠加自定义)、EquippedItems(只读)。

使用方式:编辑工作区文件——DefaultPlayer 改 ./Global/DefaultPlayer.model 的 Values;地图实体改 ./map/{地图名}.map 中该实体的 @components;仅引用自定义模型时改对应 .model。保存后调用 msw-maker-mcp 的 refresh 工具同步。装扮字符串须为物品 RUID(通常 32 位十六进制),不能猜测,应经 msw-search 及 references/avatar.md 等检索获得。

限制:Longcoat 与 Coat+Pants、TwoHandedWeapon 与 OneHandedWeapon+SubWeapon、Shield 与 SubWeapon 存在槽位互斥,需避免冲突;空字符串表示解除该槽位;部分场景的地图可能为二进制格式,编辑方式可能不同。最新支持与具体价格、平台信息暂未提供。