Skip to content

USER_GUIDE.md

Latest commit

 

History

History
104 lines (76 loc) · 3.47 KB

USER_GUIDE.md

File metadata and controls

104 lines (76 loc) · 3.47 KB
Raw

🎮 Minecraft 伺服器管理器 - 使用指南

📋 專案簡介

現代化 Minecraft 伺服器與模組管理工具，支援多伺服器、多載入器、即時模組掃描、線上查詢與自動更新，介面簡潔、全繁體中文。

🏆 核心特色

  • 🎨 現代化UI: 基於 CustomTkinter 的美觀介面
  • 🧩 智慧模組管理: 參考 PrismLauncher 的模組管理體驗
  • ☕ 智慧Java管理: 自動偵測與下載最適合的Java版本
  • 📊 即時監控: 伺服器狀態與資源使用監控

📊 專案架構概覽

🏗️ 三層架構設計
├── 🧠 核心層 (src/core/)     - 業務邏輯處理
├── 🎨 介面層 (src/ui/)       - 使用者介面
└── 🔧 工具層 (src/utils/)    - 共用工具函式

🔍 進階功能

請參閱：

🚀 快速開始

📦 安裝與啟動

# 安裝依賴
pip install -r requirements.txt

# 啟動程式
python minecraft_server_manager.py

# 快速測試（可選）
quick_test.bat

🎯 快速建立伺服器

  1. 執行程式 → 2. 點擊「建立伺服器」→ 3. 輸入伺服器名稱 → 4. 選擇 Minecraft 版本和載入器版本(點開選擇或是滾輪選擇) → 5. 設定記憶體 → 6. 點擊建立

💡 記憶體建議

  • 小型（1-5人）：1-2GB
  • 中型（5-15人）：2-8GB
  • 大型（15+人）：8GB+

📖 操作教學

1️⃣ 管理模組

  1. 切換到「模組管理」分頁
  2. 選擇要管理的伺服器
  3. 本地模組：
    • 雙擊模組切換啟用/停用狀態
    • 使用 Ctrl+點擊 進行多選
    • 點擊「批量切換」進行批量啟用/停用操作

2️⃣ 伺服器監控

  1. 在「管理伺服器」分頁選擇伺服器
  2. 點擊「啟動/停止」控制伺服器
  3. 點擊「監控」開啟監控視窗
  4. 在監控視窗中：
    • 查看即時記憶體使用率
    • 監控控制台輸出
    • 發送命令到伺服器

🔧 進階功能

📊 伺服器監控

  • 資源監控：即時顯示記憶體使用情況
  • 控制台輸出：即時顯示伺服器日誌
  • 命令發送：直接向伺服器發送管理命令
  • 多視窗支援：可同時開啟多個伺服器的監控視窗

⚙️ 伺服器設定

  • 屬性編輯：圖形化編輯 server.properties
  • 資料夾管理：直接開啟伺服器資料夾

❓ 常見問題

Q: 為什麼模組沒有顯示？

A: 確保模組檔案是 .jar 格式，且放在正確的 mods 資料夾中。

Q: 如何同時運行多個伺服器？

A: 每個伺服器都是獨立的程序，可以同時啟動多個，但注意記憶體使用量以及各別伺服器port。

Q: 停用的模組檔案在哪裡？

A: 停用的模組會被重命名為 .jar.disabled，仍在同一個資料夾中。

Q: 我需要自己安裝 Java 嗎？

A: 不需要！本程式會根據你選擇的 Minecraft/載入器版本，自動偵測本機所有 Java 安裝，並自動選擇最適合的版本。若本機無合適版本，會自動下載 Microsoft JDK（或支援 Adoptium、Azul、Oracle JDK），無需手動安裝 Java。

🆘 支援與回饋

如果您遇到問題或有改進建議，請：

  1. 檢查 logs 資料夾中的錯誤日誌
  2. 確保 Python 版本為 3.7 或以上
  3. 確認所有依賴套件已正確安裝

開始享受簡單高效的 Minecraft 伺服器管理體驗！ 🎉