?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
Pinata

Pinata

Pinata event plugin for your servers

15downloads
1follower
15downloads
1follower

Compatibility

Minecraft: Java Edition

1.21.1

Platforms

Tags

Creators

Details

Licensed MIT
Published last week
Updated 6 days ago

PinataLlama 🦙🎉

PinataLlama is a configurable piñata event plugin for Paper 1.21.1 and Java 21. Host community events with multiple piñata types, configurable rewards, live event displays, and persistent player statistics.

✨ Features

  • 🦙 Multiple Piñata Types: Configure different health, duration, display name, particle effect, knockback, and spit chance for each type. The default configuration includes Classic, Golden, and Fast piñatas.
  • ⚔️ Contribution & Rankings: Track player hits during an event and show live rankings. A configurable per-player hit interval helps limit rapid repeated hits. Player and projectile hits are supported.
  • 🎁 Configurable Rewards: Set separate rewards for the top three and for players who reach the participation hit threshold. Supported reward types:
    • Money: Requires Vault and a compatible economy provider.
    • Items: Give configured items to online players.
    • Commands: Run configured console commands with %player%, %uuid%, and %rank% placeholders. Only use commands from a trusted configuration.
  • 🤝 Tie Rules: Choose FIRST_HIT to give tied rankings to the player who reached the score first, or SHARE to share podium rewards among tied players.
  • 🎲 Random Bonus Drops: Optionally award a configured bonus reward at hit intervals, with a configurable chance.
  • 📊 Persistent Statistics: Save total hits, events participated in, and event wins between server restarts.
  • 🏆 Winner Leaderboard & Event History: Show the all-time winner leaderboard and the latest 20 event results.
  • ⏸️ Event Controls: Start, cancel, finish, pause, or resume an event. Configure a cooldown between events.
  • 📍 Event Location & Area: Save a spawn location, keep the piñata within a configurable radius, and let players teleport to the active event.
  • 📣 Live Displays: Optional boss bar, nearby-player action bar, and configurable countdown announcements.
  • ⚙️ Configurable: Customize event settings, piñata types, rewards, tie handling, displays, cooldowns, and more in config.yml.

📌 Commands & Permissions

Command Description Permission
/pinata Displays the player command help. pinata.use
/pinata yardim Displays the player command help. (yardım is also accepted.) pinata.use
/pinata durum Shows active event health, time, type, participant count, and current leader; shows cooldown when no event is active. pinata.use
/pinata top Shows the active event hit rankings, or the all-time hit leaderboard when no event is active. pinata.use
/pinata kazananlar Shows the all-time event winner leaderboard. pinata.use
/pinata odul Shows configured podium and participation rewards. (ödül is also accepted.) pinata.use
/pinata istatistik [player] Shows your saved statistics or another player's statistics. pinata.use
/pinata katkim Shows your hits, active-event rank, and participation reward progress. (katkım is also accepted.) pinata.use
/pinata gecmis Shows recent event history. (geçmiş is also accepted.) pinata.use
/pinata katil Teleports you to the active event location. (katıl is also accepted.) pinata.use
/pinataadmin Displays the administration command help. Alias: /pa. pinata.admin
/pinataadmin basla [type] [health] [seconds] Starts an event. Arguments are optional; without a type, the default health and duration are used. pinata.admin
/pinataadmin iptal Cancels the active event without podium rewards. pinata.admin
/pinataadmin bitir Ends the active event and distributes rewards. pinata.admin
/pinataadmin duraklat Pauses the active event. pinata.admin
/pinataadmin devam Resumes a paused event. pinata.admin
/pinataadmin turlar Lists configured piñata types. pinata.admin
/pinataadmin ayarla can <value> Changes the default event health. pinata.admin
/pinataadmin ayarla sure <seconds> Changes the default event duration. pinata.admin
/pinataadmin ayarla katilim <hits> Changes the participation reward hit threshold. pinata.admin
/pinataadmin ayarla bekleme <seconds> Changes the cooldown between events. pinata.admin
/pinataadmin ayarla vurusaraligi <milliseconds> Changes the per-player hit interval. pinata.admin
/pinataadmin ayarla alan <radius> Changes the piñata's allowed area radius. pinata.admin
/pinataadmin konum Saves your current location as the event spawn location. pinata.admin
/pinataadmin yenidenyukle Reloads config.yml. pinata.admin

Permission Defaults

  • pinata.use — granted to everyone by default.
  • pinata.admin — granted to server operators by default.

📥 Installation

  1. Use a Paper 1.21.1 server running Java 21.
  2. If you want to use money rewards, install Vault and a compatible economy plugin.
  3. Put PinataLlama-1.8.0.jar in your server's plugins folder.
  4. Start or restart the server to generate plugins/PinataLlama/config.yml.
  5. Edit the configuration and set podium rewards, participation rewards, piñata types, and event settings.
  6. In-game, set the event spawn location with /pinataadmin konum.
  7. Start an event with /pinataadmin basla or choose a type with /pinataadmin basla altin.

Money rewards require Vault and a registered economy provider. Item rewards require the recipient to be online. Configured command rewards run as the server console, so only use commands from a trusted configuration.