🐾 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