?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
sSugarDrop

sSugarDrop

Transform your drops into a reward party! Make your events more dynamic and easier for your users.s.

34
0
34
0

Compatibility

Minecraft: Java Edition

26.1.x
1.21.x
1.20.x

Platforms

Links

Join Discord server
Donate on PayPal

Tags

Creators

Details

Licensed Proprietary
Published 5 months ago

🍬 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