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.

---

---

✨ 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