Anvil Enchantment Ordering Guide

FEATURES

In-game Panel: Opens from a guide button on the anvil, no separate menus or commands needed.
Item & Enchantment Picker: Choose your item type and select exactly which enchantments and levels you want.
Two Optimization Modes: Optimize for Least XP/Levels or Least Prior Work Penalty, your choice.
Optimal Merge Path: Choose between two views:
- Tree View: A scrollable, pannable merge tree showing every step in the optimal order. Hover any node to see its enchantments, merge cost, prior work penalty, and total cost on the final node.
- List View: A clean scrollable numbered list showing each merge step with its enchantments, cost, and prior work penalty.
Inventory Matching: If you already have a matching item in your inventory (correct type, exact enchantments, exact prior work penalty), the frame displays your actual item instead of a generic icon.
Incompatibility Handling: Mutually exclusive enchants (e.g. Sharpness/Smite/Bane, etc.) are automatically grouped with prev/next cycling so you never select a conflicting combination.
Configurable: Supports Auto-detect Item, Auto-fill Mode, Allow Incompatible Enchantments, and Phase 3 View Mode via Mod Menu. See the Configuration section below.

HOW TO USE

Open any Anvil.
Click the guide button on the left side of the anvil GUI to open the panel.
Phase 1: Select your item type from the grid. Use the toggle at the bottom to switch between optimization modes.
Phase 2: Click the level buttons for each enchantment you want, then click Calculate.
Phase 3: Read the merge tree from top to bottom. Each step tells you exactly which two items to combine and what it will cost.
Click the back arrow at any phase to go back, or click the guide button again to close the panel.

CONFIGURATION

Requires Mod Menu and Cloth Config. The following settings are available in the mod's config screen:

Auto-detect Item: When enabled, placing an item in the anvil's left slot automatically advances the panel to Phase 2 with that item pre-selected.
Auto-fill Mode: Controls whether enchantment levels are pre-filled when entering Phase 2. Options:
- Off: Nothing is pre-filled, select levels manually.
- Max Levels: Automatically selects the maximum level for every applicable enchantment.
- From Inventory: Scans your inventory for enchanted books and pre-selects the highest level found for each enchantment.
Allow Incompatible Enchantments: When enabled, mutually exclusive enchantments each get their own independent row and can all be selected simultaneously.
Phase 3 View Mode: Choose between Tree View (the default pannable merge tree) and List View (a scrollable numbered list of merge steps).

ACKNOWLEDGEMENTS

The enchantment merge optimization logic used in this mod is based on the work found at https://github.com/iamcal/enchant-order. A sincere thank you to the author iamcal for allowing the use of their logic in this mod.

REQUIREMENTS

Fabric Loader
Fabric API
Cloth Config API
Mod Menu (recommended for easy in-game configuration)

CLIENT-SIDE ONLY

All functionality is done client-side and is compatible with vanilla servers.

FREE & OPEN SOURCE

This is a completely free project. I'm not asking for donations or "buy me a coffee" contributions. If you enjoy the mod, the best way to support it is by: