logo
0
0
WeChat Login
The repository has been archived and is now in read-only mode.
build: 添加模块配置并完善构建配置

DownloadsMinecraftServer GUI

一个用于快速下载与管理 Minecraft 服务端核心的图形化工具,支持 Vanilla、Paper,以及通过 BuildTools 构建 Spigot。应用同时提供下载历史记录、SHA256 校验、Java 版本检测与可视化构建日志。

功能特性

  • 下载 Vanilla 与 Paper 服务端核心
  • Paper 构建号选择与 SHA256 校验
  • 下载历史记录持久化存储(SQLite)
  • 一键构建 Spigot(集成 BuildTools)
  • 自动检测本机已安装的 Java 版本并提示兼容性
  • 图形化日志输出、进度显示与状态提示
  • 关于界面展示项目信息与官方仓库链接

系统要求

  • 操作系统:Windows 10/11(64位)
  • 运行环境:
    • 使用安装包运行:无需预装 JRE(已打包运行时)
    • 使用源码开发:JDK 17(本项目 Gradle 配置基于 JDK 17)

快速开始(安装包)

  • 下载并运行安装包:build/jpackage/DownloadsMinecraftServer-0.0.1.exe
  • 安装完成后,在开始菜单或桌面快捷方式打开应用
  • 也可直接运行便携版:build/jpackage/DownloadsMinecraftServer/DownloadsMinecraftServer.exe

从源码构建

  • 安装依赖:
    • JDK 17
    • Gradle(已内置 Wrapper 可直接使用本机 Gradle)
  • 常用命令:
    • 运行开发版:gradle run
    • 生成安装包:gradle jpackage
  • 生成目录:
    • 安装包:build/jpackage/DownloadsMinecraftServer-<version>.exe
    • 便携运行镜像:build/jpackage/DownloadsMinecraftServer/

主要界面与操作

  • 下载页:选择服务器类型与版本,指定下载路径,点击“下载服务器”
  • Paper:点击“获取构建号”,选择构建后进行下载与 SHA256 校验
  • 下载管理:查看历史记录(类型、版本、路径、时间)
  • 构建 Spigot:
    • BuildTools.jar 放置到项目根目录下的 Tools 文件夹
    • 选择 Spigot 版本与 Java 版本,点击“构建Spigot服务端”
  • 设置:配置默认下载路径并保存
  • 关于:查看项目信息与官方仓库链接

配置与数据存储

  • 下载历史数据库:~/.dms/history.db(SQLite)
  • 默认下载路径与设置由应用在本地进行持久化(首次运行后可在“设置”页修改并保存)

官方仓库链接

  • BuildData: https://hub.spigotmc.org/stash/scm/spigot/builddata.git
  • Bukkit: https://hub.spigotmc.org/stash/scm/spigot/bukkit.git
  • CraftBukkit: https://hub.spigotmc.org/stash/scm/spigot/craftbukkit.git
  • Spigot: https://hub.spigotmc.org/stash/scm/spigot/spigot.git
  • BuildTools: https://hub.spigotmc.org/stash/scm/spigot/buildtools.git

常见问题

  • jar 无法打开:请使用安装包或便携版运行,源码打出的裸 jar 不包含 JavaFX 运行时
  • 编码问题(中文乱码或无法映射字符):本项目已统一为 UTF-8,如仍有问题请确保系统区域与字体正常
  • JavaFX 类缺失:请使用打包版或通过 gradle run 启动,Gradle 会自动提供 JavaFX 依赖
  • 构建 Spigot 失败:
    • 确认 Tools/BuildTools.jar 存在
    • 检查网络环境
    • 查看“构建日志”获取具体错误

开发提示

  • 入口类:net.mingpixel.dms.gui.DownloadMinecraftServerGUI
  • 主控制器:src/main/java/net/mingpixel/dms/gui/MainController.java
  • 主界面 FXML:src/main/resources/net/mingpixel/dms/gui/main-view.fxml
  • 版本与下载逻辑:src/main/java/net/mingpixel/dms/version/VersionManager.java
  • 历史数据库:src/main/java/net/mingpixel/dms/db/DatabaseManager.java

致谢

  • Mojang 官方版本与下载清单
  • PaperMC API
  • SpigotMC 官方仓库与 BuildTools

许可证

  • 本项目采用 MIT License,详见 LICENSE
  • 项目使用的依赖与引用的上游仓库(PaperMC、SpigotMC 等)分别遵循其各自的许可证与使用条款