home.md

-pizza pasta mandolino
\ No newline at end of file
+## Welcome to MythicEnchants! ✨
+
+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.
+
+<!-- TODO: when gitlab gets updated, import from getting-started/requirements.md -->
+## System Requirements
+
+| Requirement | Version |
+|-------------|---------|
+| **Server** | Paper 1.21+ (or compatible forks) |
+| **Java** | 17 or higher |
+| **Minecraft** | 1.21+ (for datapack features) |
+
+### Optional Dependencies
+- **MythicMobs** 5.9.1+ (for skill integration)
+- **PlaceholderAPI** (for placeholder support)
+
+## Key Features
+
+### ⚡ Custom Enchantment System
+Create unlimited custom enchantments with:
+- YAML-based configuration
+- 15+ trigger types (combat, block, movement, item, special)
+- JavaScript-like condition evaluation
+- 15+ action types (damage, heal, particles, sounds, effects)
+- Level-based value scaling
+- Conflict detection and rarity system
+
+### 🌟 Hardcoded Enchantments
+Pre-built, optimized enchantments ready to use:
+- **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
+Execute MythicMobs skills directly from enchantments for complex, cinematic effects.
+
+### 🔧 Developer API
+Comprehensive public API with 20+ methods for external plugin integration.
+
+## Documentation Index
+
+### Getting Started
+- 📥 [Installation Guide](getting-started/installation.md) - Get started in minutes
+- 🚀 [Quick Start](getting-started/quick-start.md) - Create your first enchantment
+- ⌨️ [Commands & Permissions](getting-started/commands-and-permissions.md) - All commands and permissions
+
+### Core Features
+- 🎨 [Custom Enchantments](/Enchantments.md) - Create custom enchantments with YAML
+- 🖼️ [Display Modes](/configurations/Display-Modes.md) - Hybrid, Vanilla, and Resource Pack modes
+- 🎭 [Anomaly Mode](ANOMALY_CUSTOMIZATION.md) - Conditional enchantments with placeholders <!-- TODO:UPDATE -->
+- 📋 [Offer Conditions](/enchantments/Offer-Conditions.md) - Control when enchantments appear
+- 🔒 [Exclusive Enchants](/enchantments/Exclusive-Enchants.md) - Permission-based enchantments
+- ⚗️ [Merge System](/configurations/Merge-System.md) - Combine enchantments to create new ones
+
+### Advanced Features
+- 🎮 [MythicMobs Integration](/compatibility/mythicmobs/Guide.md) - Complete MythicMobs guide
+- 💻 [Developer API](/API.md) - Public API for developers
+
+### Complete Reference
+- ⚡ [Triggers Reference](/enchantments/Triggers.md) - All 30+ trigger types explained
+- 🔧 [Conditions Reference](/enchantments/Offer-Conditions.md) - All available conditions
+- 🎯 [Actions System](/enchantments/Actions.md) - All available actions
+- 🔨 [Anvil Configuration](/configurations/Anvil-Configurations.md) - Global anvil cost controls
+
+---
+
+<div align="center">
+  <p><strong>Ready to get started?</strong></p>
+  <p>
+    <a href="getting-started/installation.md">Installation Guide →</a>
+  </p>
+</div>