DuskPinatas

DuskPinatas is a configurable pinata plugin designed for Paper and Folia 26.2. Players unlock pinata commands by equipping a complete custom armor set. They can then place rewards inside a safe inventory menu and launch a flying pinata head into the sky.

After ascending exactly 10 blocks, the pinata displays a color-changing holographic countdown, produces circular particle effects, plays configurable sounds, and finally launches every stored reward into the air.

Features

• Native Paper and Folia scheduler support.
• Complete PDC-protected armor sets.
• Multiple pinata configurations using individual YAML files.
• Custom armor materials, names, lore, and model data.
• Custom pinata heads, including player-head texture URLs.
• Configurable commands, aliases, and permissions for every armor set.
• 54-slot reward menu with automatic shift-click transfers.
• Configurable menu buttons and return sounds.
• Flying and rotating pinata head with a fixed 10-block ascent.
• Holographic countdown that changes from green to yellow, orange, and red.
• Circular particle effects around the flying head.
• Configurable launch, countdown, and explosion sounds.
• Global launch and ten-second warning messages.
• Automatic item returns when the menu is cancelled or closed.
• Durable reward recovery after disconnects, failures, or server shutdowns.
• Global limits, per-player limits, cooldowns, and item limits.
• Fully customizable MiniMessage formatting.

Commands

• /pinata
• /duskpinatas give <player> <armor_id>
• /duskpinatas create <name>
• /duskpinatas reload

Administrative command alias: /dpinatas

Permissions

• duskpinatas.admin

Every pinata definition can also use its own configurable permission.

Installation

1. Download DuskPinatas-1.0.jar.
2. Place it inside your server's plugins directory.
3. Start or restart the server.
4. Configure global settings in plugins/DuskPinatas/config.yml.
5. Configure individual pinatas inside plugins/DuskPinatas/pinatas/.

Requirements

• Paper or Folia 26.2
• Java 25 or newer

DuskPinatas is built to protect player rewards. Every item placed inside a pinata is returned, securely stored for recovery, or released into the world exactly once.