一个现代化、可视化的 Minecraft Java 版服务端管理工具。选择版本与服务端类型，自动下载 Java、服务端 jar、Mod 与插件，一键启动并实时查看控制台日志。
- 支持 9 种主流服务端类型：
- 原版：Vanilla (Mojang 官方)
- 插件服：Paper、Purpur、Spigot
- 模组服：Forge、Fabric、Quilt
- 混合服：Mohist、Magma (Forge + 插件)
- 自动获取各服务端可用版本列表
- 自动从官方源下载服务端 jar
- 通过 Adoptium / Temurin API 自动下载 Java 运行时
- 支持 Java 8 / 17 / 21 三个版本
- 自动解压并按版本归档管理
- 智能版本推荐：
- Java 8 — 1.8 ~ 1.16.5
- Java 17 — 1.17 ~ 1.20.4
- Java 21 — 1.20.5 及以上（推荐）
- 接入 Modrinth API
- 同时支持 Mods 与 Plugins 搜索
- 按游戏版本与加载器（Forge / Fabric / Quilt）筛选
- 显示下载量、作者、图标
- 一键下载到对应服务端的
mods/或plugins/目录
- 基于 Socket.IO 的实时日志推送
- 自动识别日志类型（INFO / WARN / ERROR）着色显示
- 直接在浏览器中发送服务端指令
- 配置启动参数（最小/最大内存）
- 自动同意 EULA
- 深色主题 + 玻璃拟态（Glassmorphism）设计
- 流畅的动画与过渡效果
- 实时下载进度条（含百分比与字节数）
- Toast 通知系统
- 响应式布局，适配各种屏幕
选择服务端类型（Vanilla / Paper / Forge / Fabric 等）→ 选择 Minecraft 版本 → 一键下载
选择 Java 版本 → 自动下载并解压 → 自动识别已安装的 Java
列出所有已创建的服务端，显示 jar 数量、EULA 状态、是否包含 Mods / 插件
启动 / 停止服务端，实时查看日志输出，发送指令
从 Modrinth 搜索并安装，按版本与加载器智能筛选
- Python 3.10+（推荐 3.12 / 3.13）
- 网络连接（用于下载 Java、服务端 jar、Mods）
cd mc-server-tool
chmod +x start.sh
./start.shcd mc-server-tool
pip install -r requirements.txt
python app.pycd mc-server-tool
pip install -r requirements.txt
python app.py启动后浏览器访问 http://localhost:8765 即可使用。
mc-server-tool/
├── app.py # Flask 后端 + Socket.IO 实时通信
├── requirements.txt # Python 依赖
├── start.sh # 一键启动脚本
├── LICENSE
├── README.md
├── templates/
│ └── index.html # 前端主页面
├── static/
│ ├── css/
│ │ └── style.css # 深色主题样式
│ └── js/
│ └── app.js # 前端逻辑
├── servers/ # 服务端文件 (运行时生成, 已 gitignore)
└── java/ # Java 运行时 (运行时生成, 已 gitignore)
- Flask 3.0 — Web 框架
- Flask-SocketIO — 实时通信
- requests — HTTP 客户端
- 原生 HTML / CSS / JavaScript（无构建步骤）
- Socket.IO — 实时日志推送
- Inter 字体 + JetBrains Mono 等宽字体
- Mojang Launcher Meta — Vanilla 版本与服务端 jar
- PaperMC Fill API v3 — Paper 服务端
- Purpur API — Purpur 服务端
- Fabric Meta — Fabric 安装器
- Quilt Meta — Quilt 安装器
- Forge Maven — Forge 安装器
- Modrinth API v2 — Mods / 插件搜索
- Adoptium API — Java 运行时
- 下载 Java — 进入"Java 运行时"页面，选择版本（推荐 Java 21），点击下载
- 新建服务端 — 进入"新建服务端"页面：
- 选择服务端类型（如 Paper）
- 选择 Minecraft 版本
- 输入服务端名称
- 点击"下载服务端"
- 启动服务端 — 进入"已有服务端"页面，点击服务端卡片：
- 选择 Java 版本
- 设置内存（如 2G / 4G）
- 点击"启动"
- 查看日志 — 在"控制台"页面实时查看启动日志
- 安装插件 / Mod — 进入"插件 / Mod"页面搜索并安装
list # 查看在线玩家
say Hello! # 发送广播
op <玩家名> # 给予管理员权限
stop # 停止服务端
编辑 app.py 最后一段：
socketio.run(app, host="0.0.0.0", port=8765, ...)编辑 app.py 中的路径常量：
SERVERS_DIR = BASE_DIR / "servers"
JAVA_DIR = BASE_DIR / "java"A: 未安装依赖。运行 pip install -r requirements.txt。
A: 检查网络连接，或手动从 Adoptium 下载并解压到 java/jdk-<版本>/ 目录下。
A: 检查 Java 版本是否匹配：
- 1.17+ 需要 Java 17+
- 1.20.5+ 需要 Java 21+
A: PaperMC 现在要求 User-Agent 头。本工具已自动处理，如仍失败请检查防火墙设置。
A: 请先在"新建服务端"页面选择服务端类型与版本，加载器筛选会基于此自动应用。
欢迎提交 Issue 与 Pull Request！
- Fork 本仓库
- 创建特性分支：
git checkout -b feature/amazing-feature - 提交更改：
git commit -m 'Add amazing feature' - 推送到分支：
git push origin feature/amazing-feature - 提交 Pull Request
本项目基于 MIT License 开源。
Minecraft 是 Mojang AB 的商标。本项目与 Mojang / Microsoft 无任何关联。