How to Use the Pinata Plugin
Using the Pinata plugin is quick and simple. Follow these steps:
Step 1: Set the Pinata Spawn Location
First, stand at the location where you want the pinata to appear and run:
/pinata setspawn
This command saves your current position as the pinata spawn location in the config.
Step 2: Spawn the Pinata
After setting the spawn location, use:
/pinata spawn
A pinata (llama) will spawn exactly at the location you previously set.
[*]Interactive Pinatas
Players can hit the pinata to receive rewards, adding an exciting and dynamic element to the gameplay.
Each hit can display effects, animations, particles, sounds, and even hologram messages!
[*]Voting Rewards & Auto Summon
Pinatas can automatically spawn when your server reaches a voting goal (NuVotifier & VotifierPlus support).
Great for boosting player engagement on voting sites.
[*]Full Drop System (Percentage-Based)
Reward players dynamically:
→ Configurable item drops with % chances
→ Configurable command drops with % chances
→ Multi-tier loot system
→ Perfect for crate keys, coins, boosters, etc.
[*]Advanced Movement AI
Pinata behaves like a real interactive event mob:
→ Walks around naturally
→ Moves within a configurable radius
→ Automatically returns to its spawn point
→ Smooth, fluid movement (no teleport spam)
[*]Animations and Behavior System
Pinata now performs random fun behaviors:
→ Random dancing
→ Random spins (360° rotations)
→ Random sitting / resting
→ Random hologram speech
→ Random jumps with landing effects
→ Smooth rainbow-color transitions
→ Particle trails while moving
[*]Hologram Message System
Pinata displays floating hologram texts during the event.
Great for humor, server themes, and player interaction. Fully customizable in config.
[*]Rage Mode (Random Boss Mode Activation)
Every X–Y seconds the Pinata may enter a special rage mode:
→ Increased movement speed
→ Red aura particles
→ Flame bursts
→ Boss-like sounds
→ Custom name prefix (e.g. "[RAGE] Pinata")
→ Timed duration
Fully configurable.
[*]Full Visual Effect System
Customize every aspect of the visual effects:
→ Confetti explosions
→ Color fireworks
→ Helix spiral effects
→ Mini-explosions
→ Ring effects
→ Rainbow Mode
→ Heart, spark, and magic particles
→ Unique movement particle trails
All effects are toggleable and intensities can be changed per feature.
[*]Action Bar Health Display
Players can see real-time pinata HP in their action bar while attacking it.
[*]Pinata Parties (Multi-Pinata Events)
Spawn multiple pinatas at once for huge party events!
[*]Fully Customizable
Every single feature can be enabled/disabled:
→ Speed
→ Movement
→ Behaviors
→ Drops
→ Effects
→ Rage
→ Holograms
→ Sounds
→ Messages
voteSystemEnabled: true ## Enable or disable the voting system
customVoteCommand: "give %player% diamond 1"
## A custom command that runs when a player votes.
## "%player%" will be replaced with the voter's name.
broadcastmessageVoteEnable: true
## Enable or disable the broadcast message when someone votes.
broadcastVote:
- "&aPlayer &e%player% &ahas voted and received a reward!"
- "&bJoin and vote to earn rewards!"
## List of messages broadcasted to all players when someone votes.
## Use "%player%" to display the player's name.
customVoteItems:
item1:
material: "DIAMOND" ## Item type (Minecraft material name)
amount: 2 ## Number of items to give
item2:
material: "GOLDEN_APPLE"
amount: 1
item3:
material: "IRON_SWORD"
amount: 1
enchants:
DAMAGE_ALL: 3 ## Sharpness 3
UNBREAKING: 2 ## Unbreaking 2
## Custom items that players will receive after voting.
## You can specify the material type, amount, and enchantments.
