? sSugarDrop | 终极派对插件
通过 sSugarDrop 将你的 Minecraft 服务器变成一个不间断的庆典——这是一个适用于 Paper 服务器的可定制皮纳塔(Piñata)活动插件。
创建交互式派对活动,让玩家可以击打皮纳塔、将其打破,并获得自定义奖励,支持全息图、动画、音效、粒子效果、Discord 提醒以及完整的可视化编辑器。
✨ 功能特性
- ? 完全可定制的皮纳塔活动
- ? 带有物品概率设置的奖励编辑器 GUI
- ? 支持多页奖励
- ? 支持多个皮纳塔/掉落点
- ? 带有子菜单的完整可视化编辑器
- ? 支持拖拽操作的皮纳塔材质编辑器
- ? 编辑器各部分的重置按钮
- ? 支持 PlaceholderAPI 的自定义全息图
- ? 使用粒子和声音的自定义特效
- ? 活动前的 Discord Webhook 提醒
- ⏰ 可配置的提醒时间
- ⚡ 轻量级且经过优化
- ? 用于清理旧全息图或卡住的全息图的工具
- ?️ 基于 YAML 的配置系统
- ? 支持热重载
? 主要命令
需要管理员或 OP 权限。
皮纳塔管理
-
/ssugardrop create <name>
创建一个新的皮纳塔/掉落点。
-
/ssugardrop delete <name>
删除现有的皮纳塔/掉落点。
-
/ssugardrop setlocation <name>
将你正在查看的方块位置设置为皮纳塔的位置。
-
/ssugardrop edit <name>
打开可视化编辑器和奖励菜单。
-
/ssugardrop list
显示所有已创建的掉落点。
-
/ssugardrop force <name/all>
强制启动一个或多个所有掉落点。
-
/ssugardrop reset <name/all>
重置每日活动限制。
-
/ssugardrop fire <name> <amount>
手动从某个掉落点发放奖励。
-
/ssugardrop reload
重新加载插件文件、掉落点、特效、语言文件、全息图和 Discord 设置。
-
/ssugardrop cleanup all
清理旧全息图并重新生成活跃显示。
-
/ssugardrop hardcleanup
移除卡住或遗留的插件实体。
? 可视化奖励编辑器
管理奖励从未如此简单。
使用:
/ssugardrop edit <name>
在编辑器中你可以:
- ➕ 通过将物品直接放入 GUI 来添加奖励
- ? 使用多页管理奖励
- ? 配置自定义掉落概率
- ⚙️ 通过可视化子菜单编辑活动设置
- ? 使用选择器或拖拽操作更改皮纳塔材质
- ? 使用 GUI 按钮调整数值
- ? 将各个部分重置为默认值
- ? 为你的玩家创建独特的活动体验
⚙️ 配置
创建皮纳塔时,插件会自动为其生成一个配置文件。
每个皮纳塔/掉落点都可以通过可视化编辑器或 YAML 文件进行自定义。
活动设置
config:
enabled: true
display_name: "My Drop"
interval_minutes: 60
max_daily_events: 3
needed_players: 10
required_hits: 25
broadcast_message: ""
你可以自定义:
- 活动名称
- 自动活动间隔
- 所需最低玩家数
- 打破皮纳塔所需的击打次数
- 每日活动限制
- 开始广播消息
皮纳塔设置
pinata:
material: DRAGON_EGG
scale: 1.0
hitbox_width: 1.25
hitbox_height: 1.25
你可以自定义:
- 皮纳塔材质
- 视觉大小
- 交互碰撞箱宽度
- 交互碰撞箱高度
动画设置
animation:
spin_speed: 0.095
bob_speed: 0.115
bob_height: 0.28
swing_radius: 0.13
wobble: 0.22
scale_pulse: 0.035
你可以自定义:
- 旋转速度
- 浮动速度
- 浮动高度
- 摆动幅度
- 晃动效果
- 缩放脉冲效果
发放设置
launch_settings:
float_height: 3.0
final_rise_height: 4.0
final_rise_ticks: 20
spread_radius: 3.0
amount_to_drop: 20
你可以自定义:
- 发放的奖励数量
- 奖励散射半径
- 皮纳塔浮动高度
- 最终上升动画高度
- 最终上升动画持续时间
? Discord Webhook 提醒
sSugarDrop 现在包含针对 v2.2.2 版本的修补版 Discord Webhook 提醒系统。
你可以在 SugarDrop 活动开始前发送自动 Discord 嵌入消息。
示例 Discord 配置
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 占位符
%drop_name% - 显示 SugarDrop 活动名称
%world% - 显示活动所在世界
%x% - 显示 X 坐标
%y% - 显示 Y 坐标
%z% - 显示 Z 坐标
%time% - 显示距离活动开始剩余的时间
? 全息图支持
sSugarDrop 支持带有内部占位符和 PlaceholderAPI 支持的自定义全息图。
可以显示如下信息:
- ⏳ 剩余时间
- ? 在线玩家数
- ? 活动状态
- ? 当前击打次数
- ? 所需击打次数
- ? 奖励信息
- ? 每日活动限制
? 特效系统
通过自定义最终特效创造更令人兴奋的活动。
特效可以包括:
- 粒子效果
- 音效
- 自定义显示物品
- 预览设置
- 自定义描述和名称
特效可以通过 effects.yml 进行配置,并直接从可视化编辑器中选择。
? 清理工具
sSugarDrop 包含清理命令,用于移除旧的或卡住的全息图/显示实体。
这些命令在从旧版本更新后,或者如果全息图被遗留下来时非常有用。
/ssugardrop cleanup all
/ssugardrop hardcleanup
? 快速入门
- 下载插件。
- 将其放入
/plugins 文件夹中。
- 启动服务器。
- 运行:
/ssugardrop create MyPinata
- 看向你想要放置皮纳塔的方块,然后运行:
/ssugardrop setlocation MyPinata
- 使用以下命令配置奖励和设置:
/ssugardrop edit MyPinata
- (可选)在配置文件中设置 Discord 提醒。
完成!你的服务器派对系统已准备就绪 ?
⚠️ 要求
- 推荐使用 Paper 1.20+
- Java 17+
- PlaceholderAPI(可选,但建议安装以支持高级全息显示)
- Discord webhook(可选,仅在使用 Discord 提醒时需要)
? 技术支持
需要帮助、发现 bug 或希望提出功能建议?
加入我们的 Discord 社区,直接从开发者处获取支持。
? Spect Studios
打造优质 Minecraft 体验。
? 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
- Download the plugin.
- Place it inside your
/plugins folder.
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧