AnimalTranser

# 🐾 AnimalTransfer **AnimalTransfer** is a powerful **Minecraft plugin** (Paper/Spigot 1.20.1) that allows you to easily transfer animals between locations while preserving all their important data. 🧩 The plugin handles **capturing and transferring animals** with full NBT data preservation. 🎯 Simply **right-click** on an animal to capture it, then use the item on a block to spawn it at a new location. --- (https://img.shields.io/badge/Join-Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/53HpgxpzrX) --- ## ✨ Key Features - 🚀 **Animal Transfer** Right-click any animal to capture it into a special item, then place it anywhere on your server! - 💾 **Full Data Preservation** All animal data is preserved: - ❤️ Health - 🎒 Inventory - 🤝 Taming status - 🏷️ Custom names - 📊 All NBT data - 🚫 **Blacklist System** Configure which entities cannot be transferred through `config.yml`. Protect your server from dangerous mob transfers! - 🌍 **Localization** Supports **3 languages**: - 🇷🇺 Russian - 🇬🇧 English - 🇨🇳 Chinese Set language in `config.yml` - 🔒 **Craft Protection** Transfer items **cannot be used in crafting**, preventing abuse and duplication! - ⚙️ **Flexible Configuration** Customize the plugin to your needs: - 🎯 Item type for transfer (HEART_OF_THE_SEA, NETHER_STAR, EGG, etc.) - 🔊 Sound effects (enable/disable) - ✨ Particle effects (enable/disable) - 📋 Blacklist entities - 🔑 **Permission System** Full control over plugin usage: - `animaltransfer.use` - Basic permission (default: everyone) - `animaltransfer.pickup` - Pick up animals (default: everyone) - `animaltransfer.useitem` - Use transfer item (default: everyone) - `animaltransfer.bypass.blacklist` - Bypass blacklist (default: OP) - `animaltransfer.admin` - All admin permissions (default: OP) - 🎨 **Visual & Audio Effects** - 🔊 Sound effects when capturing and placing animals - ✨ Particle effects (clouds, happy villagers, hearts) - 📢 ActionBar notifications --- ## 🛠️ Configuration ### Settings in `config.yml`: settings: item_material: HEART_OF_THE_SEA # Item type for transfer play_sounds: true # Enable sound effects show_particles: true # Enable particle effects allow_blacklist: false # Allow blacklisted mobs blacklist: - WITHER_SKELETON - WITHER - ENDER_DRAGON # ... and more--- ## 💡 Why use AnimalTransfer? - ⚙️ **Easy Management** - Move your pets and valuable mobs effortlessly - 🛡️ **Data Safety** - All animal data is preserved during transfer - 🎨 **Customization** - Configure everything to match your server style - 🚀 **Performance** - Optimized code with minimal server load - 🌍 **Multilingual** - Support for multiple languages out of the box - 🔒 **Secure** - Permission system and blacklist protection --- ## 📋 Requirements - **Minecraft:** 1.20.1 - **API:** Paper/Spigot - **Java:** 17+ - **Dependencies:** Item-NBT-API (included automatically via Shadow plugin) --- ## 📝 What's New in v1.0 ### 🎉 Recent Updates - ✅ **Item Change:** Replaced `NETHER_STAR` with `HEART_OF_THE_SEA` as transfer item - ✅ **Craft Blocking:** Complete protection against using transfer items in crafting - ✅ **Blacklist Configuration:** Dynamic blacklist system in `config.yml` - ✅ **Extended Settings:** - Configurable item material - Toggle sound effects - Toggle particle effects - ✅ **Permission System:** Full permission system with 5 different permissions - ✅ **New Messages:** Error messages, permission notices, and success notifications - ✅ **Audio Effects:** Sounds when capturing and placing animals - ✅ **Visual Effects:** Particles when capturing and placing (CLOUD, VILLAGER_HAPPY, HEART) - ✅ **Inventory Check:** Validates free inventory space before adding item - ✅ **Error Handling:** Detailed error messages in all supported languages - ✅ **Config Comments:** Permission descriptions in configuration file ### 🔧 Technical Improvements - ✅ Code optimization and removed unused imports - ✅ Dynamic blacklist loading from config - ✅ Material validation - ✅ Improved NBT data handling - ✅ Permission checks before every action - ✅ Safe location handling for particles --- **Created with ❤️ by ZDev**