🐾 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.

---

---

✨ 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