The standalone installment to the Mythic ecosystem for complete enchantment management, adjusting vanilla enchantment behaviors, custom enchantment creation, conditional enchantment outcomes, enchantments amongst loot tables, and so much more!
MythicEnchants is a powerful, UX-focused custom enchantment plugin that brings unlimited possibilities to your Minecraft server through a **datapack-first approach** for full vanilla compatibility.
MythicEnchants reaches its full potential when paired with [dependencies](/info/setup#dependencies) such as MythicMobs, but can operate as a standalone manager for enchantment creation and customization.
<!-- TODO: when gitlab gets updated, import from getting-started/requirements.md -->
## 🌟 The Latest and Greatest
## System Requirements
Thanks to Minecraft introducing data-driven enchantment registration in 1.21, custom enchantments can finally be introduced without hacky lore-text displays or unstable packet modifications (the best tools available before this).
| Requirement | Version |
## 🚀 First Getting Started
|-------------|---------|
If you're new to MythicEnchants, be sure to review the [setup steps](/info/setup) for requirements, initial startup, and datapack/resourcepack steps.
| **Server** | Paper 1.21+ (or compatible forks) |
| **Java** | 17 or higher |
| **Minecraft** | 1.21+ (for datapack features) |
### Optional Dependencies
MythicEnchants is built using features introduced in 1.21, so no versions below that will ever be supported.
-**MythicMobs** 5.9.1+ (for skill integration)
-**PlaceholderAPI** (for placeholder support)
## Key Features
### ⚠️ Enchants Require Restarts!
Since these enchantments are running through a datapack, adding new enchantments requires a full restart to register them; this is also why the initial setup requires a *second* restart. Adjusting enchantment behavior can refresh on reload, but core data-driven values such as loot tables likely require a restart. If in doubt, restart after you're done configuring for best results!
MythicEnchants can customize vanilla and custom enchantments, where they spawn in loot tables, how they appear in the enchantment table, and how they interact with one another.
-**Life-Mending**: Repairs items when you regenerate health
-**Soulbound**: Prevents items from dropping on death
### 📦 Datapack Integration
- Auto-generates Minecraft 1.20.5+ datapacks
- Seamless installation to configured worlds
- Full vanilla enchantment system integration
- Enchanting table, anvil, and grindstone support
### 🎮 MythicMobs Integration
### ⚡ Create Custom Enchantments
Execute MythicMobs skills directly from enchantments for complex, cinematic effects.
Standalone or Mythic-based, utilize triggers to apply effects to conditional targets.
### 🔧 Developer API
Comprehensive public API with 20+ methods for external plugin integration.
## Documentation Index
### 🐲 Mythic Ecosystem
MythicEnchants can also be configured with a Mythic-flavored YML config, and provides additional Mythic mechanic elements. MythicMobs can also have their enchant effectiveness configured, such as making a Spider-type mob that is not effected by Bane of Arthropods!
### Getting Started
### 🌟 Hardcoded Enchantments
- 📥 [Installation Guide](getting-started/installation) - Get started in minutes
Several built-in enchantments for unique or complex behaviors that would be difficult or unperformant to build with typical triggers, such as **Soulbound** preserving its enchanted item from dropping on death, and returning it to the player on respawn.
- 🚀 [Quick Start](getting-started/quick-start) - Create your first enchantment
- ⌨️ [Commands & Permissions](getting-started/commands-and-permissions) - All commands and permissions
### Core Features
- 🎨 [Custom Enchantments](/Enchantments) - Create custom enchantments with YAML
MythicEnchants auto-generates its datapack and resourcepack elements, and automatically installs/manages the datapack in configured worlds. This is also what makes support for vanilla crafting, such as the anvil or grindstone, seamless and data-driven.
- 💻 [Developer API](/API) - Public API for developers
### Complete Reference
### 🔧 [Developer API](/info/API)
- ⚡ [Triggers Reference](/enchantments/Triggers) - All 30+ trigger types explained
Comprehensive public API with 20+ methods for external plugin integration.
- 🔧 [Conditions Reference](/enchantments/Offer-Conditions) - All available conditions
\ No newline at end of file
- 🎯 [Actions System](/enchantments/Actions) - All available actions
- 🔨 [Anvil Configuration](/configurations/Anvil-Configurations) - Global anvil cost controls
