sSugarDrop v2.2.2

sSugarDrop Update 2.2.2 - Discord Webhook Reminder Patch​

This update adds Discord webhook support for upcoming drop events, allowing servers to notify players before a SugarDrop event starts.

Discord Webhook System​

• Added Discord webhook support for SugarDrop event notifications.
• Added configurable Discord embeds through the main config.
• Added support for custom webhook titles, descriptions, colors, footers, and images.
• Added placeholder support inside Discord messages.
• Added support for drop name, world, coordinates, and remaining time placeholders.

Event Reminder Notifications​

• Added a new reminder system to notify Discord before a drop event starts.
• Added configurable reminder time using notify_before_seconds.
• Server owners can now choose how many seconds before the event the Discord alert should be sent.
• The reminder is only sent when the event is close to starting and the required conditions are met.
• Added protection to avoid sending the same reminder multiple times for the same event cycle.

New Discord Config Options​

• Added discord.enabled to enable or disable Discord notifications.
• Added discord.webhook_url to set the Discord webhook.
• Added discord.send_reminder to enable pre-event reminders.
• Added discord.notify_before_seconds to control how early the reminder is sent.
• Added discord.send_on_start for optional start notifications.
• Added discord.send_on_complete for optional completion notifications.
• Added discord.reminder_embed for custom pre-event embed messages.

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

Recommended Config​

Use this example to send a Discord alert 1 minute before the event starts:

Code:

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: ""
```

Recommended after updating​

After installing this version, regenerate your Discord webhook if you previously shared it publicly, then update the config and reload the plugin:

Code:

/ssugardrop reload

This patch makes it easier to announce upcoming SugarDrop events directly in Discord before the event starts.

sSugarDrop Update 2.2.2 - Visual Editor & Hologram Hotfix​

This update focuses on improving the visual editor, making configuration easier, and fixing hologram-related issues from previous versions.

New Visual Editor Improvements​

• Added a cleaner visual editor through /ssugardrop edit <name>.
• Added submenus for general settings, piñata options, animation, launch settings, holograms, effects, and location.
• Reduced the need to type values in chat.
• Added numeric adjustment buttons such as -10, -5, -1, +1, +5, and +10.
• Added preset menus for display names, broadcast messages, worlds, and hologram layouts.
• Improved reward editing with paginated menus.
• Improved reward probability editing.

Piñata Material Editor​

• Added a Change Material button inside the piñata editor.
• Added a material selector menu with available blocks.
• Added drag & drop support: hold a block from your inventory and click the Change Material button to apply it instantly.
• Added material preview so you can see the current piñata material directly in the menu.

Reset Buttons​

• Added Reset All Config inside the Complete Editor.
• Added reset buttons inside each submenu.
• Added Reset General, Reset Piñata, Reset Animation, Reset Launch, Reset Hologram, and Reset Location.
• Added confirmation menus before applying reset actions.
• Improved numeric reset behavior so values return to their default instead of simply being set to 0.

Hologram Fixes​

• Fixed an issue where holograms could remain stuck in the world after removing or disabling the plugin.
• Fixed old holograms causing unnecessary server lag.
• Fixed hologram text/hit display overlapping when multiple hits were registered.
• Fixed hologram updates creating or leaving behind duplicated entities.
• Improved hologram handling so existing displays are updated instead of constantly recreated.
• Added safer cleanup on plugin startup, reload, and shutdown.

Added Cleanup Commands​

• Added /ssugardrop hardcleanup to remove old stuck plugin entities such as TextDisplay, BlockDisplay, and Interaction.
• Improved /ssugardrop cleanup all to properly clean old holograms and regenerate active displays.

Recommended after updating​

Run the following commands once after installing this version:

Code:

/ssugardrop hardcleanup
/ssugardrop reload

This will remove old stuck holograms from previous versions and reload the plugin cleanly.

sSugarDrop 2.1
The Ultimate Party Plugin for Your Minecraft Server​

The party just got bigger!

sSugarDrop 2.1 is here with a cleaner event system, new visual effects, daily limits, improved placeholders, language files, reward chances, protection improvements, and a fully configurable GUI editor.

Setting up your next server event is now faster, cleaner, and way more customizable.



What’s New in 2.1

New Effects System

Each drop can now use its own visual effect. Effects are configured from effects.yml and can be selected directly from the in-game editor.

Included effects:

Classic Explosion
Epic Party
Gold Rain
Heart Burst
Dark Magic
Celestial Aura
Power Impact
Dragon Fury
Toxic Cloud
Crystal Blast
Emerald Burst
Infernal Flames
Ice Nova
Thunder Strike
Cherry Blossom
Soul Spiral
Rainbow Pop



Improved Visual Editor

The visual editor now supports multiple pages, custom GUI buttons, event reset tools, drop information, and an effects menu.

Use the editor to:

Add reward items
Save rewards automatically
Manage multiple reward pages
Open the effects menu
Reset daily event limits
Force start a drop from the GUI
View live drop information with placeholders



Reward Chances

Rewards are now saved with individual chances inside each drop file.

Example:

Code:

rewards.reward_0.item
rewards.reward_0.chance

This allows you to create common, rare, epic, or special rewards for every piñata.



Hit System

Piñatas now use a hit system.

Players must hit the piñata until it reaches the required amount of hits.

Code:

required_hits:

Controls how many hits are needed before the piñata breaks and drops rewards.



Daily Event Limits

You can now limit how many times each drop can run per day.

Code:

max_daily_events:

Controls the maximum number of events allowed per day.

You can reset limits using commands or directly from the editor.



Drop Protection

Drop locations are now protected from unwanted interactions.

Protected blocks include:

Dispensers
Droppers
Hoppers
Drop blocks
Explosions near drop locations

Only users with permission can interact with protected drop blocks.



Language System

sSugarDrop now includes language files:

Code:

languages/en.yml
languages/es.yml

You can customize:

Command messages
Error messages
GUI text
Status messages
Effect names
Protection messages
Event messages
Redeem messages

Change the default language from config.yml:

Code:

settings.language: "en"

or

Code:

settings.language: "es"

New PlaceholderAPI Placeholders

sSugarDrop 2.1 includes new placeholders for holograms, GUIs, and server displays.

Code:

%ssugardrop_players_total%
%ssugardrop_time_%
%ssugardrop_name_%
%ssugardrop_id_%
%ssugardrop_status_%
%ssugardrop_players_needed_%
%ssugardrop_current_hits_%
%ssugardrop_required_hits_%
%ssugardrop_remaining_hits_%
%ssugardrop_events_today_%
%ssugardrop_daily_events_%
%ssugardrop_max_daily_events_%
%ssugardrop_remaining_daily_events_%
%ssugardrop_interval_minutes_%
%ssugardrop_rewards_amount_%
%ssugardrop_spread_radius_%
%ssugardrop_float_height_%
%ssugardrop_final_rise_height_%
%ssugardrop_enabled_%

Main Commands

Requires administrator/OP permissions.

Code:

/ssugardrop help
/ssugardrop create
/ssugardrop delete
/ssugardrop setlocation
/ssugardrop edit
/ssugardrop force
/ssugardrop force all
/ssugardrop reset
/ssugardrop reset all
/ssugardrop eventreset <id/all>
/ssugardrop restart <id/all>
/ssugardrop fire
/ssugardrop list
/ssugardrop cleanup
/ssugardrop reload

Command Aliases

Code:

/ssd
/pinata
/sdrop

Examples:

Code:

/ssd edit spawn
/pinata force all
/sdrop reload

Drop Files

When you create a drop, sSugarDrop generates a .yml file inside:

Code:

plugins/sSugarDrop/locations/

Each drop has its own file, where you can customize how that event works.

Drop YML Settings

Code:

config.enabled
config.display_name
config.interval_minutes
config.max_daily_events
config.needed_players
config.required_hits
config.type_effect
config.broadcast_message

Piñata Settings

Code:

config.pinata.material
config.pinata.scale
config.pinata.hitbox_width
config.pinata.hitbox_height

Animation Settings

Code:

config.animation.spin_speed
config.animation.bob_speed
config.animation.bob_height
config.animation.swing_radius
config.animation.wobble
config.animation.scale_pulse

Launch Settings

Code:

config.launch_settings.float_height
config.launch_settings.final_rise_height
config.launch_settings.final_rise_ticks
config.launch_settings.spread_radius
config.launch_settings.amount_to_drop

Hologram Settings

Code:

hologram.enabled
hologram.hide_during_event
hologram.y_offset
hologram.lines

Hologram lines are fully customizable and support sSugarDrop placeholders and PlaceholderAPI.



Main Config

The main config.yml controls global plugin options.

You can configure:

Default language
Discord webhook section
GUI editor title
GUI buttons
Custom GUI materials
Custom player heads
Button names
Button lores
Placeholder-supported GUI text

The GUI editor supports custom items such as:

Code:

background
prev_page
next_page
reset_events
info_drop
effects_item

You can also use custom heads with:

Code:

material: "PLAYER_HEAD"
texture: "<hash/url/base64>"

Effects Config

The effects.yml file controls the full effects menu.

Each effect supports:

Code:

slot
display-name
selected-display-name
material
selected-material
particle
preview-count
count
sound
volume
pitch
selected-lore
click-lore
lore

Visual Editor

Don’t waste time editing reward files manually.

Use:

Code:

/ssugardrop edit

From there, you can:

Place reward items directly into the menu
Save rewards automatically when closing the inventory
Use multiple reward pages
Open the effects menu
Reset event limits
View live drop information
Force start the event with right click



How to Update

1. Download sSugarDrop 2.1.
2. Replace the old .jar in your /plugins folder.
3. Start or restart your server.
4. Check your files inside:

Code:

plugins/sSugarDrop/

Your drops will be loaded from:

Code:

plugins/sSugarDrop/locations/

Then run:

Code:

/ssugardrop reload

Open your drop editor with:

Code:

/ssugardrop edit

Configure rewards, chances, effects, holograms, animations, and event limits.

You’re ready to start the party!



Important Notes

Permission:

All admin commands require:

Code:

ssugardrop.admin

Minecraft Version:

sSugarDrop 2.1 is built for API version 1.20.

PlaceholderAPI:

PlaceholderAPI is recommended for the best hologram and GUI experience.

Backup:

Always make a backup of your old configuration before updating.

Support:

If you have questions, bugs, or suggestions, join our Discord!

Spect Studios
Crafting the best experiences for your Minecraft server.​