MC Plugin PinataParty - Interactive Event! ✨ AIO Voting System ✨ [1.12.x - 1.20.x] 2.64.1-BETA

✨ A brand new type of vote party! (All in one voting plugin)

Natively built on 1.18.x but works on 1.12.x - 1.18.x
ABOUT


PinataParty is a plugin that summons a Pinata with a command or when a certain vote goal is reached just like other VoteParty plugins but this one is interactive due to players hitting a pinata to gain rewards!

FEATURES

• Config settings such as rewards (Including permission restricted rewards), llama characteristics, pathfinding, spawn locations, offline voting, max player hit damage, hit cooldown and more!
• Full regular voting rewards with offline queuing. Reward players even when they vote offline
• Cumulative vote rewards, reward players for voting every X times or a total X time.
• Pinata Abilities such as teleporting, knockback, baby transform, speed up and more! (Feel free to suggest new ones!)
• Particle Styles, make the pinata your pinata with different styles of particles.
• Pinata Pool where players can pay for a pinata instead of voting or as well (Can be disabled)
• Material Whitelist. Make only sticks for example work on the Pinata
• Boss Bars, show when a Pinata is active with how much health with a beautiful hex color-changing boss bar as well as a countdown for when the Pinata will spawn.
• Hit Damage permissions give certain players extra hit damage on the Pinata
• Regular plugin updates with bug fixes
• Highly efficient with performance in mind since the start and highly optimized, if you see any timings/heap reports with PinataParty being an issue, send me over the information and I will do my best.
• Placeholders support. Perfect for scoreboards or on your tab.
• Anti-Stuck protection. The Pinata will teleport back to its spawn location if it doesn't get hit or falls into the void
• Voting reminder. Remind players to vote when they forget!
• Restrict the Pinata to only recent voters. No more leeching.
• Async chunk loading. Won't lock the main thread when loading chunks for the Pinata
• Hex colour support for 1.16+
• Simple API for developers
• and many more...

Config.yml

COMPATIBILITY

NuVotifier For rewarding players on vote and auto-summon (I highly recommend not to use the normal Bukkit Votifier due to old code and exploits)
GlowAPI & PacketListenerAPI Make the Llama glow random colours
PlaceholderAPI For the placeholders
Vault + Eco Plugin like EssentialsX For /PinataPool

All dependencies are soft but you need them to enable certain features.
You don't need to use the voting feature since you can summon the Pinata with commands which can be used on other voting plugins.

For developers, there are a few events.
PinataSpawnEvent, PinataHitEvent, PinataDieEvent, PinataAbilityEvent (Using a AbilityType enum), PinataPoolDepositEvent and VoteReceivedEvent
PLACEHOLDERS

To use placeholders on Featherboard etc using
MVdWPlaceholderAPI, simply use the same placeholders but use
{placeholderapi_*} such as {placeholderapi_pinataparty_votes_left}

PinataParty placeholders:

• %pinataparty_votes_left% displays the number of votes before a pinata summons automatically.
• %pinataparty_votes_needed% displays the total amount of votes needed to summon a pinata.
• %pinataparty_current_votes% displays the current amount of votes.
• %pinataparty_is_active% displays true/false if at least one Pinata is active.
• %pinataparty_active_count% displays the current count of active Pinatas.

PinataPool placeholders:

• %pinataparty_money_left% displays the money left needed to summon a pinata.
• %pinataparty_money_needed% displays the total money needed to summon the pinata.
• %pinataparty_current_money% displays the current amount of money.

Player placeholders:

• %pinataparty_votes_total% displays the player's total amount of votes.
• %pinataparty_votes_queued% displays the player's total amount of queued votes.
• %pinataparty_votes_total_and_queued% displays the player's total amount of votes and queued votes in one number.
• %pinataparty_last_vote_time% displays the player's last vote time in Unix time.
• %pinataparty_next_vote_time% displays the player's next vote time in Unix time.
• %pinataparty_last_vote_time_formatted% displays the player's last vote time in a formatted time
• %pinataparty_next_vote_time_formatted% displays the player's next vote time in a formatted time
• %pinataparty_next_vote_time_countdown% displays a countdown for the player until they can vote again.

COMMANDS & PERMISSIONS

Commands:

• /pinataparty summon summons a party llama at your location.
• /pinataparty spawn <location> summons a party llama at a location saved in the config file.
• /pinataparty reload reloads the config file.
• /pinataparty killall kills all alive pinatas.
• /pinataparty testvote <player> send a "fake" vote to the player
• /pinataparty list list all the pinatas that are alive
• /pinataparty shows the help page.
• /pinatapool shows the current and total money pool
• /pinatapool <money> adds money to the pool to summon a party llama

Permissions:

• pinataparty.admin gains access to the pinataparty commands like reload, killall, summon etc.
• pinataparty.pool gains access to the pinatapool commands.
• pinataparty.update.notification get a message if there is an update on join.
• pinataparty.hitamount.(amount) the amount is the hit damage the player will do, no permission defaults to 1 (Make sure the max hit in config is the max permission you will give!)
• pinataparty.* get access to everything above.

HELP/HOW TO

If you need support/help then please contact me in a direct message here (recommended) or post on the discussion page here.

How to install:

Spigot/Paper or any fork:
Simply drop and drag the plugin's jar into the plugins folder of your server, feel free to edit the config.yml to fit your needs then make sure to give the permissions you want to your groups.