🍬 sSugarDrop | The Ultimate Party Plugin
Transform your Minecraft server into a nonstop celebration with sSugarDrop — a customizable piñata event plugin for Paper servers.
Create interactive party events where players can hit a piñata, break it, and receive custom rewards with holograms, animations, sounds, particles, Discord reminders, and a complete visual editor.
✨ Features
- 🎉 Fully customizable piñata events
- 🎁 Reward editor GUI with item chances
- 📦 Multiple reward pages support
- 🌎 Multiple piñatas/drops support
- 💎 Complete visual editor with submenus
- 🎨 Drag & drop piñata material editor
- 🔄 Reset buttons for editor sections
- 🪄 Custom holograms with PlaceholderAPI support
- 🎆 Custom effects with particles and sounds
- 🔔 Discord webhook reminders before events
- ⏰ Configurable reminder time
- ⚡ Lightweight and optimized
- 🧹 Cleanup tools for old or stuck holograms
- 🛠️ YAML-based configuration system
- 🔁 Hot reload support
🎮 Main Commands
Requires Administrator or OP permissions.
Piñata Management
/ssugardrop create <name>Creates a new piñata/drop./ssugardrop delete <name>Deletes an existing piñata/drop./ssugardrop setlocation <name>Sets the piñata location to the block you are looking at./ssugardrop edit <name>Opens the visual editor and rewards menu./ssugardrop listDisplays all created drops./ssugardrop force <name/all>Force starts one drop or all drops./ssugardrop reset <name/all>Resets daily event limits./ssugardrop fire <name> <amount>Manually launches rewards from a drop./ssugardrop reloadReloads plugin files, drops, effects, language files, holograms, and Discord settings./ssugardrop cleanup allCleans old holograms and regenerates active displays./ssugardrop hardcleanupRemoves stuck or legacy plugin entities.
🎁 Visual Reward Editor
Managing rewards has never been easier.
Use:
/ssugardrop edit <name>
Inside the editor you can:
- ➕ Add rewards by placing items directly into the GUI
- 📄 Manage rewards with multiple pages
- 🎲 Configure custom drop chances
- ⚙️ Edit event settings through visual submenus
- 🎨 Change the piñata material with a selector or drag & drop
- 🔢 Adjust numeric values using GUI buttons
- 🔄 Reset sections back to default values
- 💎 Create unique event experiences for your players
⚙️ Configuration
When a piñata is created, the plugin automatically generates a configuration file for it.
Each piñata/drop can be customized through the visual editor or YAML files.
Event Settings
config:
enabled: true
display_name: "My Drop"
interval_minutes: 60
max_daily_events: 3
needed_players: 10
required_hits: 25
broadcast_message: ""
You can customize:
- Event name
- Automatic event interval
- Minimum players required
- Required hits to break the piñata
- Daily event limits
- Start broadcast messages
Piñata Settings
pinata:
material: DRAGON_EGG
scale: 1.0
hitbox_width: 1.25
hitbox_height: 1.25
You can customize:
- Piñata material
- Visual size
- Interaction hitbox width
- Interaction hitbox height
Animation Settings
animation:
spin_speed: 0.095
bob_speed: 0.115
bob_height: 0.28
swing_radius: 0.13
wobble: 0.22
scale_pulse: 0.035
You can customize:
- Rotation speed
- Floating speed
- Floating height
- Swing movement
- Wobble effect
- Scale pulse effect
Launch Settings
launch_settings:
float_height: 3.0
final_rise_height: 4.0
final_rise_ticks: 20
spread_radius: 3.0
amount_to_drop: 20
You can customize:
- Number of rewards launched
- Reward scatter radius
- Piñata floating height
- Final rise animation height
- Final rise animation duration
🔔 Discord Webhook Reminders
sSugarDrop now includes a patched Discord webhook reminder system for v2.2.2.
You can send an automatic Discord embed before a SugarDrop event starts.
Example Discord Config
discord:
enabled: true
webhook_url: "YOUR_DISCORD_WEBHOOK_HERE"
send_reminder: true
notify_before_seconds: 60
send_on_start: false
send_on_complete: false
reminder_embed:
title: "📦 DROP IN %time% | %drop_name%"
description: |
**Attention adventurers!**
The drop event **%drop_name%** will start in **%time%**.
Get ready for the reward rain.
📍 **Location:**
`%world%` - [X: %x%, Y: %y%, Z: %z%]
color: 65450
footer: "sSugarDrop - Powered by SpectStudio"
image_url: ""
Discord Placeholders
%drop_name%- Shows the SugarDrop event name%world%- Shows the event world%x%- Shows the X coordinate%y%- Shows the Y coordinate%z%- Shows the Z coordinate%time%- Shows the remaining time before the event starts
🪄 Hologram Support
sSugarDrop supports customizable holograms with internal placeholders and PlaceholderAPI support.
Display information like:
- ⏳ Remaining time
- 👥 Online players
- 📍 Event status
- 👊 Current hits
- 🎯 Required hits
- 🎁 Reward information
- 🔄 Daily event limits
🎆 Effects System
Create more exciting events with custom final effects.
Effects can include:
- Particles
- Sounds
- Custom display items
- Preview settings
- Custom lore and names
Effects can be configured through effects.yml and selected directly from the visual editor.
🧹 Cleanup Tools
sSugarDrop includes cleanup commands to remove old or stuck hologram/display entities.
These commands are useful after updating from older versions or if a hologram was left behind.
/ssugardrop cleanup all
/ssugardrop hardcleanup
🚀 Quick Start
- Download the plugin.
- Place it inside your
/pluginsfolder. - Start your server.
- Run:
/ssugardrop create MyPinata
- Look at the block where you want the piñata and run:
/ssugardrop setlocation MyPinata
- Configure rewards and settings with:
/ssugardrop edit MyPinata
- Optional: configure Discord reminders in the config.
Done. Your server party system is ready 🎉
⚠️ Requirements
- Paper 1.20+ recommended
- Java 17+
- PlaceholderAPI optional, but recommended for advanced holograms
- Discord webhook optional, only required for Discord reminders
💬 Support
Need help, found a bug, or want to suggest features?
Join our Discord community and get support directly from the developers.
🌟 Spect Studios
Crafting premium Minecraft experiences.
