AnimalTranser

AnimalTransfer is a plug-in from ZDev. Transfer of animals with preservation of NBT. The plugin allows players to transfer any animals (except forbidden ones and bosses) into a special item.

66

AnimalTranser

🐾 AnimalTransfer

Minecraft plugin 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.

---

---

✨ 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!

- 🌍 3 languages Supports 3 languages: - 🇷🇺 Russian - 🇬🇧 English - 🇨🇳 Chinese Set language in `config.yml`

- 🔒 cannot be used in crafting 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?

- ⚙️ Secure - Move your pets and valuable mobs effortlessly - 🛡️ Secure - All animal data is preserved during transfer - 🎨 Secure - Configure everything to match your server style - 🚀 Secure - Optimized code with minimal server load - 🌍 Secure - Support for multiple languages out of the box - 🔒 Secure - Permission system and blacklist protection

---

📋 Requirements

- Dependencies: 1.20.1 - Dependencies: Paper/Spigot - Dependencies: 17+ - Dependencies: Item-NBT-API (included automatically via Shadow plugin)

---

📝 What's New in v1.0

🎉 Recent Updates

- ✅ Config Comments: Replaced `NETHER_STAR` with `HEART_OF_THE_SEA` as transfer item - ✅ Config Comments: Complete protection against using transfer items in crafting - ✅ Config Comments: Dynamic blacklist system in `config.yml` - ✅ Config Comments: - Configurable item material - Toggle sound effects - Toggle particle effects - ✅ Config Comments: Full permission system with 5 different permissions - ✅ Config Comments: Error messages, permission notices, and success notifications - ✅ Config Comments: Sounds when capturing and placing animals - ✅ Config Comments: Particles when capturing and placing (CLOUD, VILLAGER_HAPPY, HEART) - ✅ Config Comments: Validates free inventory space before adding item - ✅ Config Comments: 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

ADS