AT-PinataParty | Pinata Party 1.10.0
Smash the llama pinata with friends and earn coins, rewards, and rare items!
1.10.0
Latest
1
Compatibility
Changes
Hit counts that remember, so a quest can ask for ten hits and mean it.
📊 The Plugin Now Counts Hits
Every hit a player lands is remembered. The count keeps going up across piñatas, across parties and across restarts, and never resets on its own.
That is the piece that was missing for quests. "Hit the piñata 10 times" can now be spread over a whole evening, or a whole week, instead of having to happen before one piñata breaks.
Counting happens whether or not you have PlaceholderAPI installed, so the numbers are already there waiting if you add it later.
🔗 Placeholders
The counts are read back through PlaceholderAPI, which is what quest, scoreboard and menu plugins use to pull numbers out of other plugins.
| Placeholder | What it gives you |
%pinataparty_hits% |
Every hit the player has ever landed |
%pinataparty_hits_24h% |
Hits in the last 24 hours |
%pinataparty_hits_current% |
Hits on the piñatas that are up right now |
%pinataparty_progress_10% |
Reads 7/10 |
%pinataparty_progress_10_24h% |
The same, counting only the last 24 hours |
%pinataparty_remaining_10% |
How many hits are still needed to reach 10 |
%pinataparty_active% |
true while a party is running |
%pinataparty_pinatas% |
How many piñatas are up |
progress is the one for a quest line. It stops at the goal, so a player who has landed thirteen hits still reads 10/10 rather than 13/10. remaining is the same idea counting down, and stops at 0.
⏱ Any Time Window You Like
Anywhere you see 24h above, write your own: a number followed by a letter.
| Letter | Means | Example |
s |
seconds | %pinataparty_hits_90s% |
m |
minutes | %pinataparty_hits_30m% |
h |
hours | %pinataparty_hits_24h% |
d |
days | %pinataparty_hits_3d% |
w |
weeks | %pinataparty_hits_2w% |
A bare number means hours, so %pinataparty_hits_12% is the last twelve hours. progress and remaining take one on the end too:
%pinataparty_progress_10_24h% # 10 hits, today
%pinataparty_remaining_50_1w% # 50 hits, this week
%pinataparty_progress_5_current% # 5 hits, on the piñatas up right nowHits are filed under the hour they happened in, which is what keeps the stats file small. A window can therefore reach up to an hour further back than you asked for. For anything counted in hours or days you will never notice; a window of a few minutes will behave like an hour.
⚙️ New Settings
stats:
enabled: true
retention-days: 30
save-interval-seconds: 300| Key | What it does | Default |
enabled |
false stops counting entirely. Counts already on disk are left alone, and every placeholder reports 0 |
true |
retention-days |
How far back the recent-hit windows can reach. Older hits are dropped to keep the file small. The lifetime total is never reduced | 30 |
save-interval-seconds |
How often the counts are written to disk, in the background. Minimum 30 | 300 |
Set retention-days a little higher than the longest window you actually use. Asking for 30d on a seven day retention gives you seven days of hits, not thirty.
💾 The New stats.yml
A stats.yml now appears in the plugin folder. It holds the hit counts and there is nothing in it you need to edit by hand. Deleting it resets everyone to zero, which is the quickest way to start a fresh event.
It is written when the server shuts down, so a clean stop never loses anything. A crash can lose up to save-interval-seconds worth of hits.
📦 Install
Drop AT-PinataParty-1.10.0.jar into your plugins folder and restart. You need Spigot or Paper 1.19.4 or newer, on Java 17 or newer. PlaceholderAPI is optional, without it hits are still counted, there is just nowhere to show them yet.
Your config.yml gains the stats section on first start, with your own settings untouched.
Read the documentation | Join the Discord
Enjoying the plugin? A ⭐ review goes a long way!
