HandyCommands

概述

模组名称：HandyCommands
游戏版本：Minecraft 1.20.1
模组加载器：Forge
模组类型：实用工具 / 命令增强

HandyCommands 是一款轻量级 Forge 辅助模组，通过一系列实用命令和机制提升原版 Minecraft 的便利性。它适用于原版生存、服务器管理和地图制作场景。无需安装前置库——安装后即可游玩。

大多数新增命令都归在 /handycommands 命令节点下。随时使用 /handycommands help 查看完整功能列表。

功能

移除附魔等级上限

原版 /enchant 命令会严格限制附魔等级，不得超过默认上限（通常为 1–5 级）。本模组移除了这项限制，允许将任意附魔提升至 255 级。

/enchant

示例：/enchant @s minecraft:fortune 255

技术实现：

通过 Mixin 重定向 EnchantCommand.enchant() 中的 getMaxLevel() 调用。

修复存储附魔时的字节溢出问题（原版会将等级转换为字节，导致 >127 时变为负数）。

修复附魔显示名称（原版仅支持罗马数字 I–X；超过 10 级时会显示阿拉伯数字）。

自定义实体选择器：@i 和 @!

新增两个便捷的实体选择器，可与 @a、@e、@p、@r 和 @s 一起使用：

@i – 选择所有物品实体（掉落物）

示例：/kill @i（清除地面上的所有掉落物）

示例：/tp @i[distance=..10] ~ ~ ~（传送 10 格范围内的掉落物）

@! – 选择所有非玩家实体

示例：/kill @!（杀死所有非玩家实体）

示例：/effect give @! minecraft:glowing（使所有非玩家实体获得发光效果）

这两个选择器都支持标准选择器参数（distance、sort、limit、type 等），并且在聊天框中输入 @ 时会提供 Tab 补全。

区块强制加载管理：/handycommands chunk

允许玩家直接将当前区块设为强制加载，无需像使用原版 /forceload 命令那样指定坐标。

/handycommands chunk true – 强制加载当前区块

/handycommands chunk false – 取消强制加载当前区块

/handycommands chunk list – 列出所有强制加载区块的坐标

区块设为强制加载后，即使玩家离开，该区块也会保持加载（红石装置、刷怪塔、作物生长等仍会继续运作）。区块上方会出现一个半透明的蓝色高亮框作为视觉提示。

权限等级：0（所有玩家均可使用）

物品不可破坏标签：/handycommands unbreakable

快速为手持物品添加 Unbreakable:1b 标签，使其不会损坏。原版需要进行复杂的 NBT 操作，而此命令让操作变得简单。

/handycommands unbreakable – 使手持物品永久不会损坏

权限等级：2（需要启用作弊）

伤害减免分析：/handycommands mitigation

详细显示当前影响玩家的所有伤害减免来源，并根据 Minecraft 1.20.1 的伤害公式计算最终伤害减免百分比。

/handycommands mitigation – 概览（显示物理和魔法伤害减免）

/handycommands mitigation physical – 仅显示物理伤害减免

/handycommands mitigation magic – 仅显示魔法伤害减免

伤害减免来源：

护甲值和护甲韧性 – 减少物理伤害

保护附魔（EPF）– 减少物理和魔法伤害

抗性药水效果 – 减少物理和魔法伤害

物理伤害计算顺序（原版三重乘算）：
原始伤害 → 护甲减伤（含韧性修正）→ 保护附魔减伤 → 抗性减伤 → 最终伤害

魔法伤害计算顺序（跳过护甲）：
原始伤害 → 保护附魔减伤 → 抗性减伤 → 最终伤害

护甲减伤公式：f = min(20, max(armor/5, armor – dmg/(2+toughness/4))) / 25

保护附魔：每级减伤 4%，EPF 上限为 20（最多减伤 80%）

抗性：每级减伤 20%

计算所用的参考伤害：10.0（相当于铁剑挥击造成的伤害）

权限等级：0（所有玩家均可使用，包括生存模式）

帮助命令：/handycommands help

在游戏中查看完整功能列表及简要中文说明。

/handycommands help

权限等级：0（所有玩家）

给予药水：/handycommands potion give

直接给予带有指定效果的自定义药水，无需酿造台。

/handycommands potion give [level]

示例：/handycommands potion give minecraft:luck 60 – 给予一瓶持续 60 秒的幸运 I 药水

示例：/handycommands potion give minecraft:strength 120 4 – 给予一瓶持续 120 秒的力量 V 药水

效果参数使用 Minecraft 注册名（例如：minecraft:speed、minecraft:strength）

时间以秒为单位，最短 1 秒

等级为可选参数，默认为 I（最低等级）

等级可以超过 255（仅限此命令；不会影响原版酿造或其他模组）

支持为所有已注册的药水效果提供 Tab 补全

获得的药水是标准的可饮用物品

权限等级：2（需要启用作弊或拥有管理员权限）

添加药水效果：/handycommands potion additional

为手持的药水额外添加一种效果，可与原版药水或通过 /handycommands potion give 创建的药水效果叠加。

/handycommands potion additional [level]

示例：手持速度药水时，输入 /handycommands potion additional minecraft:luck 60 – 药水现在同时具有速度和幸运 I 效果

示例：/handycommands potion additional minecraft:strength 120 9 – 为手持药水添加持续 120 秒的力量 X 效果

仅适用于药水瓶（普通、喷溅、滞留）和 Witch’s Brew（来自 Goety）

效果参数使用 Minecraft 注册名

时间以秒为单位，最短 1 秒

等级为可选参数，默认为 I

等级可以超过 255（仅限此命令）

支持为所有已注册的效果提供 Tab 补全

新效果会追加，不会替换已有效果

权限等级：2（需要启用作弊）

无限饮用药水：/handycommands potion unbreakable

为手持药水添加“无限饮用”属性，使其在生存模式下可以反复饮用而不会被消耗。

/handycommands potion unbreakable

示例：手持速度药水时，该药水会变为可无限饮用。

适用于药水瓶（普通、喷溅、滞留）和 Witch’s Brew（来自 Goety）

使用后药水不会消失，并会留在物品栏中

可与 /handycommands potion give 和 /handycommands potion additional 配合使用

对已经具有无限饮用属性的药水再次执行时会显示提示

权限等级：2（需要启用作弊）

自定义药水名称：/handycommands potion name

为手持药水设置自定义显示名称，支持颜色和文本格式。

/handycommands potion name [colour] [style]

示例：/handycommands potion name Soul gold bold – 药水会显示为金色粗体的“灵魂·药水”

示例：/handycommands potion name Strength red – 显示为红色的“力量·药水”

必须指定名称；颜色和样式为可选参数

只有指定颜色后才能使用样式

支持 Minecraft 的 16 种标准颜色（金色、红色、蓝色、绿色等）

支持 5 种样式（粗体、斜体、下划线、删除线、混淆）

适用于药水瓶（普通、喷溅、滞留）和 Witch’s Brew（来自 Goety）

颜色和样式支持 Tab 补全

权限等级：2（需要启用作弊）

给予女巫酿造物：/handycommands potion brew give

（需要安装 Goety 模组）

给予指定效果的女巫酿造物。

/handycommands potion brew give [level]

示例：/handycommands potion brew give minecraft:luck 60 – 给予一瓶持续 60 秒的幸运 I 级药水

示例：/handycommands potion brew give minecraft:strength 120 4 – 给予一瓶持续 120 秒的力量 V 级药水

效果使用 Minecraft 注册表名称

时间以秒为单位，最短为 1 秒

等级为可选项，默认为 I 级

等级可以超过 255（仅限此命令）

所有已注册效果均支持 Tab 补全

如果未安装 Goety，命令会显示错误，但不会导致游戏崩溃

获得的女巫酿造物还可以使用 /handycommands potion additional/unbreakable/name 进一步修改

权限等级：2（需要启用作弊）

测试生物召唤：/handycommands summon

生成标准化的空白测试目标，用于伤害测试场景。所有生成的生物都没有 AI、武器和药水效果——仅保留其基础类型（亡灵、节肢动物、非敌对），用于测试伤害类别。

/handycommands summon smite – 召唤一只僵尸（亡灵）

/handycommands summon bane_of_arthropods – 召唤一只蜘蛛（节肢动物）

/handycommands summon villager – 召唤一名村民（非敌对）

可选属性参数（省略时默认为 0）：

/handycommands summon smite

示例：/handycommands summon smite 20 50 – 召唤一只护甲值为 20、物理抗性为 50% 的僵尸（其他属性为 0）

示例：/handycommands summon villager 0 0 30 5 15 – 召唤一名护甲值为 0、物理抗性为 0、魔法抗性为 30%、Iron Spells 魔法抗性为 5、Goety 魔法抗性为 15% 的村民

召唤生物的属性：

生命值可在配置文件中设置（默认值为 10000），不受原版 1024 上限限制

没有 AI（不会移动或攻击）

没有武器，也没有药水效果

可以设置五种防御属性（均为可选项，默认值为 0）：

原版护甲：1 = 1 点护甲值

原版抗性：1 = 减少 1% 物理伤害（与护甲效果相乘）

原版魔法抗性：1 = 减少 1% 魔法伤害

Iron Spells 魔法抗性：1 = 固定减少 1 点魔法伤害

Goety 魔法抗性：1 = 减少 1% 魔法伤害

不会自然消失；会在玩家当前位置生成

权限等级：2（需要启用作弊）

物品耐久度修改：/handycommands durability

直接修改手持物品的耐久度数值，允许数值超过原始上限。

/handycommands durability

示例：/handycommands durability 10000 – 将钻石剑的耐久度设为 10000（原版上限为 1561）

示例：/handycommands durability 1 – 将耐久度设为 1（几乎损坏）

数值必须 ≥ 0（设为 0 会使物品几乎损坏）

数值可以超过物品的原始最大耐久度——无需 Unbreakable 标签

仅适用于具有耐久度的物品（工具、武器、盔甲、盾牌等）

不具备耐久度的物品（方块、食物）会显示错误

权限等级：2（需要启用作弊）

彩蛋命令：/handycommands gxyy

一个隐藏的彩蛋命令——在游戏中探索它的效果。

/handycommands gxyy

权限等级：2（单人游戏中需要启用作弊）

配置文件

位置：.minecraft/config/handycommands-common.toml

maxEnchantLevel = 255（范围：1–255）

bypassAllEnchantLimits = true

true = 完全绕过限制，允许任意等级

false = 允许的上限为 max（原版上限，maxEnchantLevel）

summonSmiteHealth = 10000（僵尸测试目标生命值）

summonBaneOfArthropodsHealth = 10000（蜘蛛测试目标生命值）

summonVillagerHealth = 10000（村民测试目标生命值）

bypassHealthCap = true

true = 移除原版 1024 点生命值上限，允许使用自定义生命值

false = 保留原版 1024 点上限（兼容其他修改生命值上限的模组）

常见问题

问：255 级附魔会破坏游戏平衡吗？
答：默认上限为 255，但服务器管理员可以在配置中调低 maxEnchantLevel。对于生存服务器，我们建议设置较低的数值（例如 10–20）。

问：能否在命令方块中使用 @i 和 @! 选择器？
答：可以。这两种自定义选择器可用于所有支持实体选择器的场景，包括命令方块和数据包函数。

问：大量强制加载的区块会影响性能吗？
答：会。每个强制加载的区块都会占用服务器资源。请仅在必要时使用（例如红石装置、刷怪塔），并及时移除。使用 /handycommands chunk list 查看当前强制加载的区块。高亮框仅用于视觉显示，对性能的影响可以忽略不计。

问：/handycommands mitigation 的计算准确吗？
答：该公式严格遵循 Minecraft 1.20.1 原版的伤害减免逻辑（参见 LivingEntity.getDamageAfterArmorAbsorb 及相关源代码）。数值基于 10.0 点基准伤害；实际游戏中的百分比可能会因伤害数值不同而略有差异（尤其是在韧性较高时）。如果其他模组修改了伤害公式，显示的百分比可能与实际效果不符。

问：测试生物可以设置自定义生命值吗？生命值能超过 1024 吗？
答：可以。在配置中调整 summonSmiteHealth、summonBaneOfArthropodsHealth 和 summonVillagerHealth 即可。本模组使用 Mixin 绕过原版 1024 点生命值上限，生命值最高可达 Integer.MAX_VALUE（约 21 亿）。如果你安装了另一个也会修改生命值上限的模组，请将 bypassHealthCap = false，以避免冲突。更改后请重启游戏。

问：为什么 /handycommands chunk 没有与 Xaero’s World Map 集成？
答：Xaero 集成功能已在一次更新中移除；本模组现在仅使用内置的 3D 世界高亮功能。