URLDrop

插件

· 作者 RayAstra

适用于 Paper 服务器的游戏内异步下载管理器。通过 URL 将大型文件直接下载到你的服务器——配备图形界面、进度跟踪和 Discord Webhook。

0 本站下载 0 关注 更新于 6 个月前

最新 1.0.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

? 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 文件中。


你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源