Enchant Filter

A lightweight Forge mod for Minecraft 1.20.1 that gives you full control over what enchantments can appear in the game.
Perfect for servers and packs where certain enchantments (like *Mending* or *Swift Sneak*) break balance.

Features

- Enchanting Table Filtering

undefined
- Removes banned enchantments from the table.
- If all options are banned, rerolls the pool on lower/higher levels (configurable).
- If still no valid options, the slot shows as empty.

- Loot & Anvil Filtering

- Strips banned enchantments from generated loot tables.
- If an item has both allowed and banned enchants, only removes the banned ones.
- Works on anvils too — banned books or items won't keep the disallowed enchantments.

Villager Trade Filtering

- Prevents any villagers from offering banned enchantments as trades.
- Works dynamically: if you update the banned list and reload configs, villagers will no longer sell those books.
- If all enchantments a librarian could offer are banned, that trade slot will simply not generate.

- Configurable via TOML

- Located in `config/enchant_filter-common.toml`.
- Allows you to list banned enchantments as resource locations, e.g.:

[general]
bannedEnchantments = ["minecraft:mending", "minecraft:swift_sneak"]

- Option to reroll enchantment pool on empty result:

fallbackLowerLevels = true

- Debug Logging
- When enabled, logs filtered enchantments and fallback attempts directly to console.

🛠️ Installation

1. Download the latest Forge 1.20.1.
2. Drop the mod JAR into your `mods/` folder.
3. Launch the game once to generate the default config file.
4. Edit `config/enchant_filter-common.toml` to your liking.

⚠ Known Issues & Limitations

- Mixin Conflicts:
Mods that also inject into `EnchantmentHelper.getAvailableEnchantmentResults` may conflict.
If you see missing options or crashes at startup, check mod logs for mixin conflicts.

- Modpacks:
Works fine server-side, but clients need the mod too to avoid ghost enchantments in UI.

- UnionLib / Antique Atlas:
These mods have been observed to crash unrelated screens in some packs; not caused by Enchant Filter.

- Mappings:
Built against official (MojMap) mappings for 1.20.1. Will not work on different mappings (e.g., Yarn).

📝 License

This project is licensed under the MIT License

💡 Troubleshooting

No enchantments showing in the table
→ Verify your banned list is not blocking *all* enchantments.
→ Set `debugLogging = true` and check console to see which enchantments are being removed.

Still seeing banned enchants in loot
→ Some mods override vanilla loot generation completely. Our global loot modifier may not run in that case.

🤝 Contributing / Feedback

Found a bug or have a feature request?
Leave feedback on CurseForge.