sSugarDrop

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： bukkit paper purpur spigot

标签： decoration magic utility

? 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

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

/ssugardrop setlocation MyPinata

6. Configure rewards and settings with:

/ssugardrop edit MyPinata

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