🍬 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 list Displays 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 reload Reloads plugin files, drops, effects, language files, holograms, and Discord settings.

• /ssugardrop cleanup all Cleans old holograms and regenerates active displays.

• /ssugardrop hardcleanup Removes 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

1. Download the plugin.
2. Place it inside your /plugins folder.
3. Start your server.
4. Run:

/ssugardrop create MyPinata

1. Look at the block where you want the piñata and run:

/ssugardrop setlocation MyPinata

1. Configure rewards and settings with:

/ssugardrop edit MyPinata

1. 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.

https://discord.gg/n7eCaRc8UX