Windows 上的 Minecraft 伺服器 GUI 管理工具。從建立伺服器、啟動監控到模組安裝更新，主要流程都可在圖形介面內完成；線上模組安裝與本地更新提供可審查的 Review 步驟。
僅支援 Windows 10 / 11（64-bit） 介面使用 PySide6 / Qt Widgets，顯示縮放跟隨 Windows 與 Qt 高 DPI 行為。
- 建立伺服器 — Vanilla／Fabric／Forge／Quilt／NeoForge 精靈式設定流程
- Java 管理 — 自動偵測已安裝 Java，缺少時可引導 winget 或手動安裝
- 即時監控 — 控制台輸出、記憶體、運行狀態與玩家資訊集中顯示
- 模組管理 — 本地掃描 + Modrinth 線上搜尋，線上安裝前 Review 確認
- 模組更新 — Hash-first 批次比對，相依套件自動規劃
- 匯入伺服器 — 掃描既有資料夾或壓縮檔快速匯入
- 兩種安裝模式 — 同一個 installer 支援一般安裝與可攜式安裝
- 前往 Releases 下載最新的
*-Setup-*.exe - 執行安裝程式
- 選擇一般安裝，或選擇可攜式安裝並指定目標資料夾
一般安裝會使用 %LOCALAPPDATA%\Programs\MinecraftServerManager。可攜式安裝會在指定資料夾內建立 .portable 標記，並把資料寫入該資料夾下的 .config 與 .log。
可攜式安裝不會建立 Windows 解除安裝項目；如要移除，請關閉程式後直接刪除整個指定資料夾。
本程式不內含 Java。建立或啟動伺服器時，程式會自動偵測對應版本的 Java。
- 自動安裝：在背景使用
winget安裝對應版本的 Oracle JRE 8 或 Microsoft OpenJDK，並自動同意來源與套件授權 - 手動安裝：自行下載 JDK / JRE，之後回到程式中指定 Java 路徑
多數 Windows 10 / 11 環境可直接完成 winget 安裝，但部分系統仍可能出現額外的系統提示。
詳細流程與注意事項請見 使用者手冊。
需求： Python 3.14、uv
git clone https://github.com/Colin955023/MinecraftServerManager.git
cd MinecraftServerManager
py -m pip install --user -U uv
uv sync
uv run python -m src.main品質檢查：
# 快速 test
uv run quick_test.py
# 格式、型別、測試檢查
scripts/format_lint_check.bat
# 產生綜合報告
uv run report\comprehensive_report.pysrc/
core/ 核心邏輯（版本管理、伺服器控制、模組服務）
ui/ 主視窗、功能頁、對話框
utils/ 共用基礎設施（設定、HTTP、日誌、視窗管理）
models/ 資料模型
docs/ 文件
tests/ 自動化測試
scripts/ 建置與品質腳本
report/ 產生綜合報告的腳本與輸出
歡迎提交 Issue 或 Pull Request。
- 每個 PR 聚焦於單一主題
- 提交前執行
scripts/format_lint_check.bat - UI 行為變更請附上重現步驟與預期結果