Atlas Enchants

# AtlasEnchants AtlasEnchants brings an RPG-style custom enchantment system to Minecraft. It adds 22 unique enchantments spread across six rarity tiers, plus special crafting stations and items that let players discover, apply, remove, and upgrade enchantments. Originally built for a private SMP, it bridges the gap between vanilla gameplay and deep, progression-driven enchanting. All enchantments, items, messages, sounds, and menus are fully customizable through YAML files. --- ## Features - 22 custom enchantments for weapons, armor, tools, and fishing rods - 6 rarity tiers (Divine, Godly, Legendary, Epic, Rare, Trash) with configurable drop weights - Custom enchant books found in loot, fishing, and trades - Drag-and-drop enchantment application onto gear - Enchantment upgrade system (10 books of one rarity into 1 of the next) - Craftable enchanting stations with custom recipes - Special items with unique mechanics - Full GUI system for browsing, guides, and upgrading - Anti-exploit tracking of player-placed blocks - Fully configurable messages, sounds, colors, and stats --- ## Commands The base command is `/atlasenchants` with aliases `/aenchants` and `/ae`. | Command | Description | Permission | |--------|------------|------------| | `/ae guide` | Open the plugin guide GUI | `atlasenchants.guide` | | `/ae list` | Browse all enchantments by rarity | `atlasenchants.enchantlist` | | `/ae upgrade` | Open the enchant upgrade menu | `atlasenchants.upgrade` | | `/ae help` | Show all commands | `atlasenchants.help` | | `/ae reload` | Reload all config files | `atlasenchants.reloadconfig` | | `/ae give...` | Admin give commands for enchants and special items | `atlasenchants.give*` | --- ## How It Works - Custom enchant books are found in loot chests, caught while fishing with **Poseidon's Bait**, or bought from a Wandering Trader via the **Oracle of Enchantment** - Players apply enchantments by dragging a book onto a compatible item - Enchantments respect item compatibility and blacklists (some can't coexist) - The **Altar of Circe** generates random enchant books from a placed station - The **Circe's Anvil** upgrades 10 matching books into 1 book of the next rarity - The **Oblivion Shard** removes a random enchantment, with a chance to return it as a book This creates a full loop of finding, applying, upgrading, and reworking enchantments. --- ## Rarity Tiers | Tier | Default Drop Weight | |------|--------------------| | Divine | 1% | | Godly | 15% | | Legendary | 20% | | Epic | 25% | | Rare | 40% | | Trash | Crafting only | --- ## Example Enchantments - **Leech** – Convert damage dealt into healing - **Fearsight** – See nearby entities glowing through walls - **Vein Seeker** – Mine an entire ore vein in one break - **Tree Hugger** – Fell an entire tree in one swing - **Decapitate** – Chance to drop mob and player heads - **Freezing Shot** – Arrows freeze enemies in place - **Asclepius** – Gain extra heart containers while worn You can fully edit, disable, or rebalance every enchantment. --- ## Special Items - **Oblivion Shard** – Removes a random enchantment from an item - **Oracle of Enchantment** – Lectern book that opens the enchant browser - **Altar of Circe** – Crafting station that generates random enchant books - **Circe's Anvil** – Upgrade station for combining books into higher tiers - **Scrap of Circe's Weave** – Crafting material obtained by washing enchanted gear in a cauldron - **Circe's Ember** – Crafting material found in loot --- ## Configuration Everything is configurable through three YAML files: - `enchantments.yml` – enchant stats, rarities, recipes, and special items - `settings.yml` – messages, sounds, spawn chances, and global settings - `menus.yml` – GUI layouts, colors, and button positions You can easily expand the system by adding new enchantments and adjusting drop weights. --- ## Additional Features - GUI-based enchant browsing, guides, and crafting recipe displays - Configurable spawn chances for books and special items - Anti-exploit protection against self-placed block farming - Placeholder support for messages and lore --- ## Dependencies - PlaceholderAPI *(optional)* - WorldGuard *(optional)* --- ## Notes - Designed for SMP servers but works on any server type - Requires Spigot 1.20.6+ and Java 21 - Every enchantment, item, and message is fully configurable and expandable --- ## Support For help or suggestions, join the Discord: https://discord.gg/f9swPR7NnV --- AtlasEnchants turns enchanting into a rewarding, RPG-style progression system where every drop, craft, and upgrade matters.