Sueta

CPinata - Fun & Interactive Piñatas ✨ Fully Customizable Dro

1.2.0

A free pinata minecraft plugin.

·Plugin

ECPinata – Piñata Event for Minecraft 1.20+ (BETA)

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
    ECPinata.jar
    from the Releases section of the repository.
  2. Place it in your server's
    /plugins
    folder.
  3. Restart the server.
  4. Customize the settings in
    config.yml
    to your liking.

⚙️ Configuration

piñata:
  entity_type: CAMEL
  name_format: "&dPiñata Party &7| &b{hits} hits"
  color_hit: "&b"
  speed: 0.2
on_hit:
  0:
    chance: 100
    command: "eco give %player 100"
  1:
    chance: 50
    command: "minecraft:give %player diamond 1"
on_winning_hit:
  0:
    chance: 100
    command: "minecraft:give %player netherite_block 1"
  • entity_type
    : any valid entity (CAMEL, COW, PIG, etc.)
  • name_format
    : name with color and
    {hits}
    placeholder
  • color_hit
    : color for the per-player hit counters
  • speed
    : movement speed (0 = stationary, 0.2 = normal, 0.5 = fast)

Commands & Permissions

CommandDescriptionPermission
/pinataShow helpecpinata.help
/pinata spawnSpawn a piñata at your locationecpinata.spawn
/pinata killKill all active piñatasecpinata.kill
/pinata voteSimulate a vote (for testing)ecpinata.vote
/pinata locationSet the default spawn locationecpinata.location
/pinata reloadReload the configurationecpinata.reload

PlaceholderAPI

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

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

Similar projects

Plugin →