Pinata

Compatible with: Minecraft 1.19.4
Author: hubailmn

A powerful and customizable Pinata plugin for Paper-based Minecraft servers. Spawn loot-filled Pinatas, reward players, and create exciting in-game events!

🔧 Features

Fully customizable mob behavior and loot
Interactive GUI editor for Pinata settings
Force spawn Pinatas manually
Discord support (JDA or webhook)
Integrated with PlaceholderAPI

📥 Installation

Download the latest .jar.
Place the .jar file into your server’s plugins/ directory.
Restart or reload the server.
Edit the PinataConfig.yml to your liking and reload with /pinata reload.

📦 Dependencies

Make sure you have the following plugins installed:

(optional) PlaceholderAPI – Enables dynamic placeholders in messages
(optional) NoteBlockAPI (optional) – Adds Note Block sounds to the plugin (

💬 Commands

Command	Permission	Description
`/pinata`	`pinata.command.pinata`	Open the Pinata edit menu
`/pinata reload`	`pinata.command.reload`	Reload configs and cached data
`/pinata forceSpawn`	`pinata.command.forcespawn`	Force spawn the Pinata (ignore timer)

🔐 Permissions

Permission	Default	Description
`pinata.command.pinata`	OP	Access the Pinata GUI
`pinata.command.reload`	OP	Reload configuration
`pinata.command.forcespawn`	OP	Forcefully spawn a Pinata

PlaceholderAPI Support

This plugin hooks into PlaceholderAPI to provide dynamic placeholders for pinata starting time.

Placeholders

placeholder	Description
`%Pinata_stating_in%`	Displays the time remaining until the next Pinata event starts in HH:MM:SS format. Returns "Pinata is currently running!" if the event is active, or "No event scheduled" if no upcoming event is planned.

⚙️ Default Configuration

# pinata config

pinata:
  spawn-timer: 60              # Time in minutes between automatic spawns
  announce-before: 2           # Minutes before spawn to announce the event

discord:
  enable: false                # Enable Discord integration
  mode: Bot                    # Options: "Bot" or "Webhook"

  bot:
    token: "XXXX.XXXX.XXXX"    # Discord bot token
    channel-id: 123456789012345678  # Target Discord channel ID

  webhook:
    link: ""                   # Webhook URL (used if mode is "Webhook")

  embed:
    title: "🎉 Pinata Event"
    footer: "Pinata System"
    color: 0xF04747            # Embed color (decimal HEX)
    content: "<@&1192476543625203772>"
    message: |-
      A **Pinata** has spawned! Get ready to smash it!

      You have **2 minutes** to get there in time!

      Use `/pinata` to get the <@&1192476543625203772> role and get notified on future events!

      **Started by**: This event was automatically started by Console 🤖

```yml access transformers song: enabled: true name: - "Deltarune Ruder Buster.nbs" - "Deltarune Black Knife.nbs"

- "Megalovania Super Smash Bros Ultimate.nbs"

```

💬 Support & Community

Need help or want to suggest a feature?

Join our Discord server.