Anvil Enchantment Ordering Guide

Now with Modded Items & Enchantments support!

| 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. - Modded Items: Items sharing the same enchantments are grouped into a single button with a cycling icon. - Modded Enchantments: Modded enchant names are highlighted in cyan when selected. - 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.

| 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). - Show Mod Button in Phase 1: When enabled, a button appears in Phase 1 to switch between vanilla and modded items. - Show Mod Button in Phase 2: When enabled, a button appears in Phase 2 to show or hide modded enchantments.

| 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:

* Leaving a rating/review * Sharing it with friends * Reporting any bugs you find

| GALLERY | |-|

A. Phase 1 (with tooltip)

B. Phase 2 (with selected, unselected, and greyed out enchantments)

C. Phase 3 (with tooltip, and grey/gold frames)