ECPinata allows server administrators to summon a living piñata (default: camel) that players must hit multiple times to receive random or special rewards. Perfect for events, voting milestones, and celebrations!

✨ Key Features

• ✅ Compatible with Minecraft 1.20+ (Paper, Purpur, Spigot)
• Fully customizable rewards, entity type, and piñata name
• ⚔️ Each player must hit the piñata multiple times to kill it
• Custom rewards for each hit and final blow
• ️ Color and formatting support in the dynamic piñata name
• Ability to change the entity type from config
• Adjustable movement speed for the piñata
• ♻️ Commands with autocomplete and permission support
• PlaceholderAPI compatible (custom expansion)

Installation

1. Download
   Code (Text):

   ECPinata.jar
   from the Releases section of the repository.
2. Place it in your server's
   Code (Text):

   /plugins
   folder.
3. Restart the server.
4. Customize the settings in
   Code (Text):

   config.yml
   to your liking.

⚙️ Configuration

• Code (Text):

  entity_type
  : any valid entity (CAMEL, COW, PIG, etc.)
• Code (Text):

  name_format
  : name with color and
  Code (Text):

  {hits}
  placeholder
• Code (Text):

  color_hit
  : color for the per-player hit counters
• Code (Text):

  speed
  : movement speed (0 = stationary, 0.2 = normal, 0.5 = fast)

Commands & Permissions

Command	Description	Permission
/pinata	Show help	ecpinata.help
/pinata spawn	Spawn a piñata at your location	ecpinata.spawn
/pinata kill	Kill all active piñatas	ecpinata.kill
/pinata vote	Simulate a vote (for testing)	ecpinata.vote
/pinata location	Set the default spawn location	ecpinata.location
/pinata reload	Reload the configuration	ecpinata.reload

PlaceholderAPI

If PlaceholderAPI is installed, ECPinata will automatically register its own custom expansion.
Available Placeholders:

Placeholder	Description
Code (Text): %ecpinata_votes_so_far%	Shows the current number of accumulated votes.
Code (Text): %ecpinata_votes_needed%	Shows the total number of votes required to spawn a piñata.
Code (Text): %ecpinata_votes_left%	Shows how many votes are left before the piñata spawns.
Code (Text): %ecpinata_pinata_exists%	Returns a text indicating whether a piñata is active (based on your messages file).
Code (Text): %ecpinata_pinata_count%	Shows the current number of active piñatas in the world.