The xPinataParty plugin introduces a fun, interactive event where a pinata (Llama) spawns in a set location. Players hit the pinata multiple times until it breaks, rewarding participants with loot, fireworks, and sound effects. The plugin tracks player contributions, awarding the top hitter with an exclusive prize.

Dependences:

Vault
PlaceholderAPI
LuckPerms
Discord SRV


Key Features

✅ Vibrant Holograms – Displays animated text above the pinata.
✅ Dynamic Movement – The pinata shifts position when hit.
✅ Custom Loot System – Fully configurable rewards for hits and breaking the pinata.
✅ Timed Auto-Spawn – Schedule pinata events automatically.
✅ Exciting Visual Effects – Fireworks, particles, and sounds for different actions.
✅ Health System – Pinata requires multiple hits to break.
✅ Boss Bar Integration – Real-time RGB health display for players.
✅ Leaderboard Tracking – Monitors player hits and rewards the top contributor.
✅ Flexible Spawn Options – Supports fixed or randomized locations.
✅ Permission-Based Control – Restrict event management to authorized players.
✅ Custom Event Announcements – Auto-broadcasts event start, progress, and completion.
✅ Pinata Protection – Prevents players from using hacks (e.g., KillAura) to hit the pinata unfairly.
✅ Tiered Pinatas – Bronze, Silver, and Gold pinatas with increasing difficulty and better rewards.
✅ Pinata Boss Mode – A rare, powerful pinata that spawns with special effects and extreme rewards.
✅ Event Cooldowns & Scheduling – Automate and limit how often pinata events occur.
✅ Custom Messages & Titles – Unique event messages, action bar notifications, and holograms.
✅ GUI Menu for Configuration – In-game settings to customize event behavior.
✅ Player Participation Rewards – Even non-top hitters get tiered rewards.
✅ PlaceholderAPI Support – Display stats in other plugins (e.g., leaderboards, scoreboard).
✅ Discord Webhook Integration – Announce events and winners on Discord.
✅ Auto Pinata Mode – Automatically summon pinatas based on a configurable time interval.
✅ Custom Placeholder for Timer – Display countdown timer on scoreboard using PlaceholderAPI.

Commands & Permissions

/pinata summon Spawns the pinata at the configured location. xpinata.admin
/pinata destroy Immediately ends the current event. xpinata.admin
/pinata loot View or edit the loot pool. xpinata.admin
/pinata setlocation Defines the default spawn location. xpinata.admin
/pinata stats Displays the leaderboard of top hitters. xpinata.use
/pinata schedule <seconds> Schedules automatic pinata spawning. xpinata.admin


Permission Description


xpinata.use Allows participation in the pinata event.
xpinata.admin Grants full control over pinata event management.


How It Works?

1️⃣ Starting the Event
- An admin uses /pinata summon to begin.
- A colorful llama pinata spawns with particles, lightning effects, and sounds.
- If Auto Pinata Mode is enabled, the pinata spawns at regular intervals automatically.

2️⃣ Player Interaction
- Players hit the pinata, which:
- Takes damage.
- Moves slightly after each hit.
- Triggers sounds and particles.
- Updates the boss bar health.

- Hitting the pinata can grant random rewards.

3️⃣ Breaking the Pinata
- When its health reaches zero:
- Fireworks explode.
- Loot drops randomly.
- The top contributor gets a special prize.
- A "Pinata Destroyed!" message is broadcasted.

4️⃣ Ending the Event
- After breaking, the pinata disappears.
- The event stops automatically or via /pinata destroy.
- If Auto Pinata Mode is enabled, the next pinata countdown starts immediately.


Configuration (config.yml)

Fine-tune the plugin settings to fit your server’s needs.

yaml
pinata:
entity: "LLAMA" # Type of pinata entity
health: 100 # Number of hits needed to break the pinata
spawn-location: "world,100,65,200" # Default spawn location
effects:
fireworks: true # Enable fireworks on destruction
particles: "HEART" # Particle effect on hit
sounds:
summon: "ENTITY_LIGHTNING_BOLT_THUNDER" # Sound on summon
hit: "ENTITY_LLAMA_HURT" # Sound on hit
destroy: "ENTITY_GENERIC_EXPLODE" # Sound on destruction
rewards:
- "minecraft:iron_ingot 3" # Drop 3 iron ingots
- "minecraft:diamond 1" # Drop 1 diamond
- "minecraft:golden_apple 1" # Drop 1 golden apple
leaderboard:
enabled: true # Enable leaderboard tracking
top-reward: "minecraft:netherite_ingot 1" # Special reward for top hitter
bossbar:
enabled: true # Enable boss bar display
color: "RGB" # Use RGB colors for health bar
auto-pinata:
enabled: true # Enable automatic pinata spawning
interval: 600 # Time in seconds between each auto spawn
placeholder: "%xpinata_timer%" # Custom placeholder for displaying timer on scoreboard


Supported Versions
This plugin is compatible with the following Minecraft versions:
✅ 1.20.1, 1.20.2, 1.20.4, 1.20.6
✅ 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4


Credits :
Author : GodXPro
Discord : godxpro.exe