Installation
Requirements, the install steps, and what the plugin folder looks like after the first start.
AT-PinataParty is free and has no required dependencies. Drop the jar in, restart, and you can summon a piñata straight away.
Requirements
| Requirement | Notes |
|---|---|
| Spigot or Paper | Both work. Paper only matters if you want the FancyHolograms backend. |
| Minecraft 1.19.4 or newer | The plugin uses display entities that older versions do not have. |
| Java 17 or newer | Java 21 is only needed if you use FancyHolograms. |
| Internet access on first start | The plugin fetches one small library from Maven Central so it can migrate your config file on future updates. |
Install it
Stop the server
Shut it down fully. Do not use a reload, since plugins added during a reload often misbehave.
Drop in the jar
Put the plugin jar into your plugins folder. Use the shaded jar, which is the one named after the plugin. If you also see a file starting with original-, ignore it.
Start the server
On the first start the plugin writes its own folder with a config file and a messages file. Watch the console for the startup banner, which tells you which hologram backend it picked.
Summon one
/pp summon arenaA countdown runs, then the piñata appears and everyone gets a message. Hit it a few times to check your rewards fire.
What the folder looks like
config.yml holds the piñata settings, spawn points and rewards. The lang folder holds every line of text players see, one file per language, see Languages. The ArrowStats folder is written by the anonymous stats reporting and is shared with any other plugin that uses it, see Metrics and update checks.
Optional hologram plugins
The floating text above the piñata works out of the box with a built in backend, so nothing extra is needed. If you already run DecentHolograms or FancyHolograms, the plugin can use those instead. See Holograms for which one to pick.
FancyHolograms needs Paper and Java 21. On Java 17 the plugin will not load that backend at all, and falls back to another one. This is deliberate, not a bug.
Updating
Replace the jar and restart. Your config.yml and the bundled language files are updated in place, so new settings and new messages are added with their defaults and your own values are kept. Your spawn points and your own reward entries are left alone.
A language file you wrote yourself is never rewritten, so an update cannot overwrite your translation. The trade-off is that new messages have to be copied across from lang/en_US.yml by hand.
The plugin also tells you in the console when a newer version is out, and admins get a note when they join. Turn that off with update-notifier: false.