XfeaturesDragonEgg

# 🥚 XfeaturesDragonEgg !(https://img.shields.io/badge/version-1.0.0--SNAPSHOT-blue.svg) !(https://img.shields.io/badge/minecraft-1.21%2B-brightgreen.svg) !(https://img.shields.io/badge/Java-25-orange.svg) !(https://img.shields.io/badge/license-MIT-yellow.svg) !(https://img.shields.io/discord/1252242781775335505?color=7289da&label=discord&logo=discord&logoColor=white) ## 📝 Description **XfeaturesDragonEgg** is a comprehensive utility plugin for Minecraft servers that introduces advanced tracking, protection, and visual enhancements for the highly coveted Dragon Egg. No more lost or stolen eggs! - 🛡️ **Container protection**: Prevent players from hiding the Dragon Egg in Ender Chests, Shulker Boxes, Bundles, Dispensers, Furnaces, and more. It can only be stored in standard Chests or Trapped Chests. - 📍 **Advanced tracking**: Always know where the Dragon Egg is! Track it in player inventories, chests, placed blocks, or even if it's dropped on the ground. - ✨ **Visual effects**: Players carrying the Dragon Egg emit a unique pink glowing effect and beautiful End Rod particles. - 🛡️ **Damage immunity**: The Dragon Egg (as a dropped item) is completely immune to fire, lava, explosions, cactus damage, and it will never despawn! ## ✨ Key features - **Container restriction**: Fully configurable list of blocked container types. - **Persistent tracking**: The egg's location and state are saved even after a server restart. - **Dynamic visual effects**: Unique aesthetics for the player possessing the Dragon Egg. - **Dropped item protection**: Comprehensive anti-damage and anti-despawn mechanics for the Dragon Egg item. - **Full message customization**: All notifications and interface text can be changed in the configuration. - **Easy management**: Intuitive commands for administrators to track the egg and reload configurations. ## 📋 Requirements - Spigot/Paper 1.21+ - Java 25 ## 🔧 Installation 1. Download the latest version of the plugin from the (https://github.com/XfeaturesDEV/XfeaturesDragonEgg/releases) section 2. Place the JAR file in the `plugins` folder of your server 3. Restart the server 4. Configure the configuration files as you see fit 5. Reload the plugin with the command `/dragonegg reload` <details> <summary> ## 🌍 Supported Languages </summary> XfeaturesDragonEgg supports multiple languages for users from around the world. You can change the plugin language using the command `/dragonegg language <language>`. ### Available Languages: - English (en) - Russian (ru) - German (de) - Polish (pl) - Italian (it) - Portuguese (pt) - Turkish (tr) - French (fr) - Spanish (es) - Lithuanian (lt) - Latvian (lv) - Estonian (et) - Arabic (ar) - Hindi (hi) - Chinese (Simplified) (cn) - Japanese (ja) - Korean (ko) ### Adding a New Language If you want to add a new language or improve an existing translation: 1. Copy the `messages-en.yml` file from the `resources/messages/` folder 2. Rename it to `messages-XX.yml`, where XX is your language code 3. Translate all strings to your language 4. Submit the translation via Pull Request or contact the developers We always welcome new translations and improvements to existing ones! </details> <details> <summary> ## ⚙️ Configuration </summary> After the first launch, the plugin will create the configuration file: ### config.yml Basic plugin settings: ```yaml # All available languages can be found here: # https://github.com/XfeaturesGroup/XfeaturesDragonEgg/tree/master/examples/messages # Language settings for the plugin language: "en" # Container protection protection: enabled: true # List of blocked container types # The egg can ONLY be placed in a normal CHEST or TRAPPED_CHEST blocked-containers: - ENDER_CHEST - SHULKER_BOX - BUNDLE - DISPENSER - DROPPER - FURNACE - BLAST_FURNACE - SMOKER - BREWING_STAND - HOPPER - BARREL - CRAFTER # Visual effects when carrying the egg effects: enabled: true # Player glowing effect (pink/purple color) glowing: enabled: true color: "LIGHT_PURPLE" # END_ROD particles around the player particles: enabled: true type: "END_ROD" count: 3 interval: 10 # Egg tracking tracking: enabled: true persistent: true ``` </details> ## 📜 Commands | Command | Description | Permissions | |---------|----------|-------| | `/dragonegg reload` | Reload configuration | `xfeatures.dragonegg.reload` | | `/dragonegg where` | Show the Dragon Egg location | `xfeatures.dragonegg.where` | | `/dragonegg help` | Show the help message | `xfeatures.dragonegg.use` | | `/dragonegg language <lang>` | Change plugin language | `xfeatures.dragonegg.language` | ## 🔒 Permissions - `xfeatures.dragonegg.use` - Access to the main DragonEgg command - `xfeatures.dragonegg.where` - Access to track the Dragon Egg location - `xfeatures.dragonegg.reload` - Access to the reload command - `xfeatures.dragonegg.language