AT-PinataParty | Pinata Party 1.10.0

📋 Overview

A piñata spawns and your players swarm it. Every swing has a chance to register, the required hits scale with how many players are online, and the final break sets off a firework finale with rewards for everyone who joined in. Perfect for restarts, milestones, vote parties, or just keeping spawn alive.

Everything is config-driven: the mob, the spawn points, the hit chances, the reward pools, the fireworks, and every message. Floating hit counters are built in, so there is no hologram plugin to install unless you want one.

▶ Showcases

English by ElixirNode


Hindi by ItzJatinOG

🧩 Dependencies

No required dependencies. Drop it in and go, floating text included. Two optional plugins each add something:

• Vault (optional) plus an economy plugin enables money rewards. Item and command rewards work without it. Get it here
• DecentHolograms or FancyHolograms (optional) are auto-detected if you already run one. The built-in styles need neither

🎉 The Party

Run one piñata at a time or as many as you like, with a configurable maximum. Break rewards only go to players who actually hit it, so leechers miss out.

📍 Spawn Points

Define unlimited spawn points across your worlds, each a fixed spot or a random point inside a 2D or full 3D zone. Save one with /pp setspawn <name> while standing where you want it.

Set the spot once, the party always knows where to land.

🎉 Instant Summons

/pp summon <location> starts a party at a saved spawn, and /pp summonhere starts one wherever you are standing. Good for spontaneous events or a quick staff test.

One command in, full server chaos out.

💬 Floating Text, Zero Setup

A live hit counter over the piñata is built right in. Pick a style with pinata.hologram.provider and you are done:

• native floating text that follows the piñata on any server, 1.19.4 and newer
• native-display a crisper text-display style that glides smoothly on 1.20.2 and newer

No DecentHolograms or FancyHolograms required. Already run one? Set decentholograms, fancyholograms, or auto and they hook in automatically. none turns floating text off entirely.

🎁 Three Reward Pools

• Hit rewards roll on every registered swing
• Last-hit rewards pay out something extra for the swing that breaks it
• Break rewards go to everyone who joined in, and only to players who actually hit it

Any pool can run any command, so money, points, crate keys or items all work. Add min-rewards and max-rewards to a pool and it hands out a random number of different rewards each time, never repeating one, with chance acting as a weight against the other entries. Leave those keys out and the pool rolls each entry as a straight percentage instead.

⚡ Commands When a Party Starts

party-start-commands fires the moment the piñata spawns. The once list runs a single time, and the per-player list runs for every player online with %player% filled in. %location% gives the spawn point name in both.

party-start-commands:
  once:
    - "broadcast &d&lPINATA PARTY &fhas started at &e%location%&f!"
  per-player:
    - "effect give %player% speed 30 1"

Broadcasts sent this way arrive without another plugin putting its own label in front of them.

🎨 Colour Your Way

Every message, hologram line, and the piñata's own name:

🌍 Three Languages Built In

English, French and Spanish ship in a lang folder. Set language: en_US, fr_FR or es_ES, and plain names or bare codes work too. Add your own file for anything else.

Language files carry a version and are kept up to date the same way config.yml is, so new messages appear in your file on update rather than showing as "Message not found".

⚡ Up and Running in 3 Steps

1. Drop the jar in plugins/ and restart
2. Stand where you want the party and run /pp setspawn main
3. Launch it with /pp summon main and watch the chaos

⌨️ Commands

🔐 Permissions

• pinataparty.admin access to all Pinata Party commands (default: op)

🎛 Fully Configurable

• config.yml the mob, hit multipliers, chance percentages, cooldowns, spawn points, knockback, fireworks, reward pools, hologram provider and the active piñata limit
• lang/ every player-facing message, one file per language
• Every key is documented in the file itself with valid values, formulas and placeholders
• Updates keep your work. New keys and their comments merge in while your own values stay exactly as you set them
• Update notice tells the console and any admin who joins when a newer version is out. Switch it off with update-notifier: false

🧪 Requirements

• Minecraft: 1.19.4 and newer
• Server software: Spigot, Paper, Purpur, Pufferfish
• Java: 17 or higher (Java 21 or higher for FancyHolograms on Paper)
• Dependencies: none required

📈 Metrics

This plugin collects anonymous usage stats through bStats and ArrowStats. Opt out anytime in plugins/bStats/config.yml and plugins/ArrowStats/config.yml.

Full setup and configuration guides are in the documentation. Questions, feedback, or feature ideas? Join the Discord for support and updates.
Read the documentation | Click here to join the Discord

Smash the llama. Win big.

Enjoying Pinata Party? A ⭐ review keeps the Free Plugin Series going!