原创 开源 工具 MythicFixOffhand 2026-04-11

插件介绍​

这是“修复补丁”，不是“重做系统”
MythicFixOffhand 的目标很明确：把 MMOItems 某些武器本来只在主手生效的数值，补丁式地注册到副手上。

MythicFixOffhand 是一个面向 Paper 1.20+ 的 MMOItems 兼容修复插件，依赖 MythicLib 与 MMOItems。它会监听玩家副手物品变化，并在副手拿着指定的 MMOItems 武器时，读取该物品的数值属性，再以副手来源的形式挂到玩家属性映射里。

源码层面上，它并没有修改 MMOItems 本体，也不是重新实现一套双持系统，而是把满足条件的副手武器属性以 OFF_HAND + HAND_ITEM 的方式注册为临时修饰符。副手物品被拿下、切换世界、退出游戏或条件不再满足时，这些修饰符会被自动移除。

说人话：把“本来主手才吃到的 MMOItems 武器数值”，在副手再补挂一遍。

适合双持职业
如果你的服里有双刀、短剑副手、法器副手之类玩法，这个插件就是补上副手数值生效缺口的。

适合定向放行
你可以只放行某几个武器，也可以整类放行，比如全部 SWORD 或全部 DAGGER。

主要功能​

指定物品副手生效：通过 类型:物品ID 精确控制哪些 MMOItems 武器可以在副手生效。
整类武器副手生效：可以直接放行整个类型，比如所有 SWORD、DAGGER。
白名单 / 黑名单模式：whitelist-mode: true 时仅配置项生效，false 时则相反。
自动监听副手变化：切换主手栏位、F 键互换主副手、进服、退服、切世界时都会重新检查。
自动注册数值属性：遍历 MMOItems 的数值属性并注册为副手修饰符，无需手动一项项写。
调试模式：可输出当前副手物品、匹配结果、添加或移除的属性数量，方便排错。
管理命令：支持重载、查看列表、动态添加/删除放行物品，以及直接检查当前副手属性。
当前实现只处理 数值型属性。也就是说，它主要补的是攻击、暴击、生命、防御这类数值，不是把所有技能触发器都完整复制到副手。

命令列表​

主命令：/mythicfixoffhand，别名：/mfo

命令 说明 权限​

/mfo reload 重载配置文件并重新读取放行列表 mythicfixoffhand.admin
/mfo list 显示当前白名单/黑名单模式、已启用物品和类型 mythicfixoffhand.admin
/mfo add <类型> <物品ID> 动态添加一个允许副手生效的 MMOItems 物品 mythicfixoffhand.admin
/mfo remove <类型> <物品ID> 从配置中移除一个允许副手生效的物品 mythicfixoffhand.admin
/mfo stats 查看当前副手物品的 MMOItems 类型、ID、数值属性与是否已启用 mythicfixoffhand.admin
/mfo check 和 /mfo stats 行为一致，作为别名保留 mythicfixoffhand.admin
按源码实现，当前版本所有子命令都会先检查 mythicfixoffhand.admin，包括 stats 和 check。