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 -->
## System Requirements
## 🌟 The Latest and Greatest
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 |
|-------------|---------|
| **Server** | Paper 1.21+ (or compatible forks) |
| **Java** | 17 or higher |
| **Minecraft** | 1.21+ (for datapack features) |
## 🚀 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.
### Optional Dependencies
-**MythicMobs** 5.9.1+ (for skill integration)
-**PlaceholderAPI** (for placeholder support)
MythicEnchants is built using features introduced in 1.21, so no versions below that will ever be supported.
## 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!
-**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
### 📚 Manage Enchantments
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.
### 🎮 MythicMobs Integration
Execute MythicMobs skills directly from enchantments for complex, cinematic effects.
### 🔧 Developer API
Comprehensive public API with 20+ methods for external plugin integration.
### ⚡ Create Custom Enchantments
Standalone or Mythic-based, utilize triggers to apply effects to conditional targets.
## 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
- 📥 [Installation Guide](getting-started/installation) - Get started in minutes
- 🚀 [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
- ⚗️ [Merge System](/configurations/Merge-System) - Combine enchantments to create new ones
### 🌟 Hardcoded Enchantments
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.
- 💻 [Developer API](/API) - Public API for developers
### 📦 Datapack Integration
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.
### Complete Reference
- ⚡ [Triggers Reference](/enchantments/Triggers) - All 30+ trigger types explained
- 🔧 [Conditions Reference](/enchantments/Offer-Conditions) - All available conditions
- 🎯 [Actions System](/enchantments/Actions) - All available actions
- 🔨 [Anvil Configuration](/configurations/Anvil-Configurations) - Global anvil cost controls
\ No newline at end of file
### 🔧 [Developer API](/info/API)
Comprehensive public API with 20+ methods for external plugin integration.
