HandyCommands

Overview

Mod Name: HandyCommands Game Version: Minecraft 1.20.1 Mod Loader: Forge Mod Type: Utility / Command Enhancement

HandyCommands is a lightweight Forge helper mod designed to improve vanilla Minecraft convenience through a set of practical commands and mechanics. It is tailored for vanilla survival, server administration, and map-making scenarios. No dependencies are required – just install and play.

Most new commands are grouped under the /handycommands node. Use /handycommands help at any time to view the full feature list.

Features

Enchantment Level Cap Removal

The vanilla /enchant command strictly limits enchantment levels to the default maximum (usually 1–5). This mod removes that restriction, allowing any enchantment to be raised up to level 255.

/enchant <target> <enchantment> <level>

Example: /enchant @s minecraft:fortune 255

Technical implementation:

Mixin redirects the getMaxLevel() call inside EnchantCommand.enchant().

Fixes the byte overflow issue when storing enchantments (vanilla casts level to byte, making >127 become negative).

Fixes enchantment display names (vanilla only supports Roman numerals I–X; above 10, Arabic numerals are shown).

Custom Entity Selectors: @i and @!

Adds two new convenient entity selectors alongside @a, @e, @p, @r, and @s:

@i – selects all item entities (dropped items)

Example: /kill @i (clears all dropped items on the ground)

Example: /tp @i[distance=..10] ~ ~ ~ (teleports dropped items within 10 blocks)

@! – selects all non‑player entities

Example: /kill @! (kills all non‑player entities)

Example: /effect give @! minecraft:glowing (applies glowing to all non‑player entities)

Both selectors support standard selector arguments (distance, sort, limit, type, etc.) and provide Tab completion when typing @ in chat.

Chunk Forceload Management: /handycommands chunk

Allows players to directly set the current chunk as forceloaded, without needing to specify coordinates using the vanilla /forceload command.

/handycommands chunk true – forceload the current chunk

/handycommands chunk false – remove forceload from the current chunk

/handycommands chunk list – list all forceloaded chunk coordinates

Once forceloaded, the chunk remains loaded even when the player moves away (redstone machinery, mob farms, crop growth, etc., continue to work). A semi‑transparent blue highlight box appears above the chunk as a visual indicator.

Permission level: 0 (available to all players)

Unbreakable Item Tag: /handycommands unbreakable

Quickly adds the Unbreakable:1b tag to the item in hand, making it indestructible. Vanilla requires complex NBT operations; this command simplifies it.

/handycommands unbreakable – the held item becomes permanently unbreakable

Permission level: 2 (requires cheats enabled)

Damage Mitigation Analysis: /handycommands mitigation

Shows detailed breakdown of all damage mitigation sources currently affecting the player, calculating the final damage reduction percentage according to Minecraft 1.20.1 damage formula.

/handycommands mitigation – overview (shows both physical and magical mitigation)

/handycommands mitigation physical – only physical damage reduction

/handycommands mitigation magic – only magical damage reduction

Mitigation sources:

Armour value and armour toughness – physical damage reduction

Protection enchantments (EPF) – reduce both physical and magic damage

Resistance potion effect – reduces both physical and magic damage

Physical damage calculation order (vanilla triple multiplication): Raw damage → armour reduction (with toughness correction) → protection enchantment reduction → resistance reduction → final damage

Magical damage order (armour is skipped): Raw damage → protection enchantment reduction → resistance reduction → final damage

Armour reduction formula: f = min(20, max(armor/5, armor - dmg/(2+toughness/4))) / 25

Protection enchantment: 4% per level, EPF cap of 20 (80% max)

Resistance: 20% per level

Reference damage used for calculation: 10.0 (equal to an iron sword swing)

Permission level: 0 (available to all players, even in survival)

Help Command: /handycommands help

View the full list of features with brief Chinese descriptions in‑game.

/handycommands help

Permission level: 0 (all players)

Potion Giving: /handycommands potion give

Gives a custom potion with a specified effect directly, no brewing stand needed.

/handycommands potion give <effect> <seconds> [level]

Example: /handycommands potion give minecraft:luck 60 – gives a 60‑second Luck I potion

Example: /handycommands potion give minecraft:strength 120 4 – gives a 120‑second Strength V potion

Effect parameter uses Minecraft registry names (e.g., minecraft:speed, minecraft:strength)

Time in seconds, minimum 1 second

Level is optional, defaults to I (lowest)

Level can exceed 255 (only for this command; does not affect vanilla brewing or other mods)

Tab completion for all registered potion effects

The obtained potion is a standard drinkable item

Permission level: 2 (requires cheats / operator privileges)

Potion Effect Addition: /handycommands potion additional

Adds an extra potion effect to a potion already in hand, combining with vanilla potions or those created by /handycommands potion give.

/handycommands potion additional <effect> <seconds> [level]

Example: With a Speed potion in hand, /handycommands potion additional minecraft:luck 60 – the potion now has both Speed and Luck I

Example: /handycommands potion additional minecraft:strength 120 9 – adds Strength X (120 seconds) to the held potion

Only works on potion bottles (regular, splash, lingering) and Witch's Brew (from Goety)

Effect parameter uses Minecraft registry names

Time in seconds, minimum 1 second

Level optional, defaults to I

Level can exceed 255 (only for this command)

Tab completion for all registered effects

The new effect is appended, not replacing existing ones