🔧 EnchantOnce — Enchanting & Repair Overhaul

A minimalistic mod that reworks enchanting and repairing: fixed XP costs, enchant extraction, book copying, and full gear duplication — all using vanilla mechanics.

🎯 Who is this mod for?

EnchantOnce is perfect for players who enjoy using enchantments but would prefer to spend less in-game time grinding XP and repeating enchanting rituals. It’s designed for those who value efficiency, clarity, and a smoother experience when working with enchanted gear.

---

📌 Features

🛠️ Flat Repair Cost

• Repairing any damaged item always costs 2 experience levels — no matter how many times it's been repaired.
• The "Too Expensive" limitation is removed entirely.

🔄 Repair with Materials

Repair tools and gear using base materials, instead of combining duplicate items.

Item	Repair Material	Amount Repaired
Shield	Any Planks	½ durability
Shears	Iron Ingot	Full durability
Bow, Fishing Rod	String	¼ durability
Crossbow	String	¼ durability
Flint & Steel	Flint	Full durability
Trident	Prismarine Shard	¼ durability
Brush	Feather	¼ durability
Elytra	Phantom Membrane	Full durability

➡ Only works if the item is damaged. The material is consumed.

---

📖 Duplicate Enchanted Books

Copy enchanted books using blank books.

• Place one enchanted book in the left slot and up to 4 normal books in the right.
• Output: up to 5 copies of the enchanted book (original + up to 4 more).
• XP cost depends on the enchantments:
  • Calculated from the minimum enchantment cost values.
  • Curses are ignored in the cost.
  • Total cost = (number of new copies) × (combined cost of enchantments).
  • Minimum cost per copy is always 1 level.

This system prevents XP farming via book copying + grindstone trickery.

---

📚 Extract Enchantments

Move all enchantments from any enchanted item to a single enchanted book.

• Place the item in the left anvil slot, and a book in the right.
• The item must be completely intact (no damage).
• Output is one enchanted book with all enchantments.
• The item is destroyed in the process.
• XP cost: 1 level.

---

🧬 Clone Enchanted Items

Create a perfect duplicate of any enchanted item.

• Place the enchanted item in the left slot and an unenchanted item of the same type in the right.
• Both items must be completely intact (no damage).
• Output: a copy with the same enchantments.
• XP cost: 25 levels.

---

⚖️ Vanilla Enchantment Combination Change

The vanilla enchantment level increase mechanic has been intentionally disabled.

In vanilla Minecraft, combining two enchanted books or items with the same enchantment level increases the resulting enchantment level. This behavior makes sense in vanilla, because enchanted books and items are effectively single-use and cannot be duplicated.

EnchantOnce introduces the ability to duplicate enchanted books and clone enchanted items. Without adjusting vanilla behavior, this would allow players to reach maximum enchantment levels simply by repeatedly cloning and combining items.

To preserve balance and prevent enchantment scaling:

• Combining two books or items with the same enchantment level no longer increases the resulting enchantment level.
• The highest existing level is preserved instead.

This change is intentional and required for compatibility with the mod’s duplication mechanics.

---

🔻 Downgrade Enchanted Books (Flint)

Lower enchantment levels on enchanted books using Flint.

• Place an enchanted book in the left anvil slot and Flint in the right.
• All non-curse enchantments have their level decreased by 1.
• Enchantments that reach their minimum level are removed.
• Curse enchantments are never modified.
• If no enchantment can be downgraded, the operation is cancelled.

Cost:

• XP: 1 level
• Material: 1 Flint

This provides a controlled way to adjust enchantment strength without relying on random rerolling or grindstone abuse.

---

✅ Compatibility

• Compatible with vanilla items and most modded gear that follows NeoForge standards.
• Fully supports custom items from my The Block of Angel mod.
• No custom blocks, items, or GUIs — purely vanilla mechanics.

---

💡 Philosophy

You're not meant to re-grind enchantments forever.
You earned them — keep them. This mod respects your time and your progress.

---

🧪 Testing Command (Creative / Admin)

(Version 1.1.0 or later)

EnchantOnce includes a small utility command intended for testing, debugging, and experimentation with enchanting and repair mechanics.

⌨️ /damageMainHandGear

Artificially sets the damage value of the item held in the player’s main hand.

• Who can use it: server operators (permission level 2)
• How it is used: typed as a command while playing in the world
• Works in singleplayer and when typed by a player on a server
• Does not work from the dedicated server console or via automation (command blocks or functions)
• Works only if you are holding a damageable item in your main hand

Syntax

/damageMainHandGear
/damageMainHandGear <damage>

Behavior

• Without arguments, the item is damaged to maximum possible value minus 1
  (i.e. the item becomes almost broken, but not destroyed).
• With <damage> argument:
  • Sets the exact damage value.
  • The value is automatically clamped to a valid range:
    • Minimum: 0
    • Maximum: maxDurability - 1

Examples

/damageMainHandGear

→ Sets the held item to near-broken state.

/damageMainHandGear 10

→ Sets item damage to 10.

Notes

• If the player is not holding a damageable item, the command does nothing.
• Intended strictly for testing and development; it has no gameplay purpose in survival progression.

---

🛠️ Installation and Technical Information

Installation

• Make sure you have Minecraft 1.20.5 - 1.21.11 with NeoForge or Forge installed.
• Download the mod .jar file.
• Place it into your mods folder.
• Launch the game and enjoy your adventure!

Technical Details

• Developer: Sergey Pekarchik
• Supported NeoForge versions: 1.20.5 - 1.21.11
• Supported Forge versions: 1.20.6 - 1.21.5 (no plans to support later versions)

---

🧩 Related Mods

EnchantOnce is fully compatible with the following mods by the same author:

• 🧭 Compass Cleaner — adds a minimalist recipe to reset a Lodestone Compass to a regular Compass.
  Ideal for tidying up obsolete compasses after you lose or remove their lodestone targets.

• 🌟 Pouch & Paper — introduces compact forms of tradeable resources for easier storage and trading:
  • paper (stackable and block form),
  • ink and glow ink (bottled),
  • leather (bundled),
  • seeds (in pouches),
  • feathers (as compact packs).
  Includes the Burnt Paper Block — crafted by setting a Paper Block on fire. It attracts creepers and repels bees, perfect for traps and moody builds.

• 🌟 The Block of Angel An exploration-focused mod that rewards curiosity and reduces repetitive grind — while keeping the core survival balance intact. Perfect for players who want each discovery to matter. Start with almost nothing — earn every shortcut.
  This mod transforms Minecraft into a world of meaningful adventure and artifact-driven progression. No grind, no farms — just clever tools, dangerous dungeons, and rewards you must conquer.

  • Progression-focused gameplay: leather armor, stone weapons, and real survival.
  • Unique tools: magnetic rods, precision builders, instant crop planters.
  • Legendary gear: 6 armor sets, powerful weapons, and upgrade paths.
  • Angel Block & Rod: sacred artifacts that protect and purify your world.
  • No custom UIs — pure, immersive gameplay.

  Ideal for adventurers who want to explore, survive, and earn their power — not dig tunnels forever.

---

☕ Support Development

If you enjoy the mod and would like to support future updates and new features, you can support me here:
Buy me a coffee on Ko-fi!

Your support means a lot and helps me dedicate more time to creating new content and improving the mod! ❤️

---