? URLDrop
面向服务器的游戏内异步下载管理器
通过 URL 直接将大文件下载到服务器——无需触碰控制台。
✨ 什么是 URLDrop?
URLDrop 是一款面向管理员的插件,可将你的 Minecraft 服务器变成一个下载站。
你不再需要 SSH 登录到机器上使用 wget 来下载备份或世界存档,只需在游戏内的箱子 GUI 中粘贴 URL,选择目标路径,剩下的交给服务器处理即可。
适用于:
- ? 从远程存储下载服务器备份
- ? 拉取世界存档或数据包
- ? 在不退出游戏的情况下预置插件更新
- ? 通过 URL 在服务器之间迁移大文件
?️ GUI 概览
使用 /urldrop 或 /ud 打开:
| 界面 |
描述 |
| 主菜单 |
所有操作的中心枢纽 |
| 新建下载 |
5 步向导:URL → 路径 → 文件名 → 校验和 → 确认 |
| 活动下载 |
实时进度条、速度、预计剩余时间、取消按钮 |
| 队列 |
重新排序、立即开始或移除待处理任务 |
| 历史记录 |
重新下载或删除已完成条目 |
| 设置 |
切换运行时选项,无需重载配置 |
⚡ 功能特性
下载
- ✅ 基于 Java 21 虚拟线程 的异步下载 —— 零主线程阻塞
- ✅ HTTP 流式直写磁盘 —— 大文件不会导致内存激增
- ✅ HTTP Range 断点续传 —— 中断后可从中断处继续
- ✅ 可配置的 指数退避重试机制
- ✅ 自动 进度跟踪(速度、ETA、完成百分比)
- ✅ 下载完成后自动 解压
.zip 归档文件
- ✅ 覆盖前备份现有文件(支持保留限制)
安全性
- ? 防止路径遍历(规范化前后均拦截
..)
- ? URL 验证 —— 仅允许
http/https,可选域名白名单/黑名单
- ? 屏蔽特定文件扩展名 / 内容类型过滤
- ? 可选 SHA-256 校验和验证,文件放置前进行检查
- ? 下载先暂存为临时文件,然后 原子移动 至目标位置
- ? 文件大小硬性上限(默认 2 GB)
目标路径
- ? 服务器进程可访问的 任意路径(相对或绝对)
- ? 兼容 Pterodactyl(
/home/container/...)
- ? 可配置路径 别名(例如输入
backup → 解析为 backups/)
通知
- ? 带有
[Retry] / [History] 按钮的可点击游戏内冒险模式消息
- ? 当你在离线时下载完成,操作员上线时会收到提醒
- ? 支持 Discord Webhook,附带富嵌入信息
命令
/ud 打开 GUI
/ud download <url> <path> 立即开始下载
/ud queue <url> <path> 加入队列
/ud status [id] 显示进度
/ud cancel <id> 取消
/ud retry <id> 重试失败的下载
/ud history 在聊天栏显示最近的历史记录
/ud debug <id> 完整诊断信息
/ud reload 重载配置
⚙️ 配置
首次运行时将生成四个配置文件:
| 文件 |
用途 |
config.yml |
限制、超时、重试、安全、通知 |
messages.yml |
所有消息(MiniMessage 格式 —— 完全可自定义) |
paths.yml |
别名、敏感路径、屏蔽片段 |
webhook.yml |
Discord Webhook URL 及事件开关 |
快速示例 — config.yml
max-simultaneous-downloads: 3
max-file-size-mb: 2048
allow-resume: true
auto-unzip: false
require-checksum-for-sensitive-paths: false
operator-notify-on-complete: true
快速示例 — paths.yml 别名
aliases:
backup: "backups"
update: "plugins/update"
home: "/home/container"
? 权限
| 权限 |
描述 |
urldrop.admin |
所有权限 |
urldrop.open |
打开 GUI |
urldrop.download |
开始下载 |
urldrop.queue |
队列下载 |
urldrop.cancel |
取消下载 |
urldrop.history |
查看历史记录 |
urldrop.settings |
切换设置 |
urldrop.reload |
重载配置 |
urldrop.debug |
查看诊断信息 |
所有权限默认仅限 操作员 使用。
? 要求
| 要求 |
版本 |
| 服务端 |
Paper 1.21.x |
| Java |
21+ |
无需其他插件。Gson 已内置于 JAR 文件中。
? URLDrop
In-game async download manager for Servers
Download large files directly to your server via URL — without touching the console.
✨ What is URLDrop?
URLDrop is an admin-focused plugin that turns your Minecraft server into a download station.
Instead of SSH-ing into your machine to wget a backup or a world archive, you open a
chest GUI in-game, paste a URL, choose a destination, and let the server do the rest.
Perfect for:
- ? Downloading server backups from remote storage
- ? Pulling world archives or data packs
- ? Staging plugin updates without leaving the game
- ? Migrating large files between servers via URL
?️ GUI Overview
Open with /urldrop or /ud:
| Screen |
Description |
| Main Menu |
Hub for all actions |
| New Download |
5-step wizard: URL → path → filename → checksum → confirm |
| Active Downloads |
Live progress bars, speed, ETA, cancel button |
| Queue |
Reorder, start-now, or remove pending jobs |
| History |
Re-download or purge completed entries |
| Settings |
Toggle runtime options without reloading |
⚡ Features
Downloads
- ✅ Async downloads on Java 21 virtual threads — zero main-thread blocking
- ✅ HTTP streaming directly to disk — no RAM spike for large files
- ✅ HTTP Range resume — picks up where it left off if interrupted
- ✅ Configurable retry with exponential back-off
- ✅ Automatic progress tracking (speed, ETA, % complete)
- ✅ Auto-unzip
.zip archives after download
- ✅ Backup existing files before overwrite (with retention limit)
Security
- ? Path traversal prevention (
.. blocked before and after normalization)
- ? URL validation —
http/https only, optional domain whitelist/blacklist
- ? Blocked file extensions / content-type filtering
- ? Optional SHA-256 checksum verification before file is placed
- ? Downloads stage to a temp file first, then atomically move to destination
- ? File size hard cap (default 2 GB)
Destinations
- ? Any path the server process can reach (relative or absolute)
- ? Works with Pterodactyl (
/home/container/...)
- ? Configurable path aliases (e.g. type
backup → resolves to backups/)
Notifications
- ? Clickable in-game Adventure messages with
[Retry] / [History] buttons
- ? Operator join reminders for downloads that finished while you were offline
- ? Discord webhook support with rich embeds
Commands
/ud Open GUI
/ud download <url> <path> Start immediately
/ud queue <url> <path> Add to queue
/ud status [id] Show progress
/ud cancel <id> Cancel
/ud retry <id> Retry failed download
/ud history Recent history in chat
/ud debug <id> Full diagnostics
/ud reload Reload config
⚙️ Configuration
Four config files are generated on first run:
| File |
Purpose |
config.yml |
Limits, timeouts, retry, security, notifications |
messages.yml |
All messages (MiniMessage format — fully customisable) |
paths.yml |
Aliases, sensitive paths, blocked fragments |
webhook.yml |
Discord webhook URL and event toggles |
Quick example — config.yml
max-simultaneous-downloads: 3
max-file-size-mb: 2048
allow-resume: true
auto-unzip: false
require-checksum-for-sensitive-paths: false
operator-notify-on-complete: true
Quick example — paths.yml aliases
aliases:
backup: "backups"
update: "plugins/update"
home: "/home/container"
? Permissions
| Permission |
Description |
urldrop.admin |
All permissions |
urldrop.open |
Open the GUI |
urldrop.download |
Start downloads |
urldrop.queue |
Queue downloads |
urldrop.cancel |
Cancel downloads |
urldrop.history |
View history |
urldrop.settings |
Toggle settings |
urldrop.reload |
Reload config |
urldrop.debug |
View diagnostics |
All permissions default to operator only.
? Requirements
| Requirement |
Version |
| Server |
Paper 1.21.x |
| Java |
21+ |
No other plugins required. Gson is bundled inside the JAR.
评论 0
登录后参与评分
还没有评论,来抢沙发吧