cml-launcher 1.0.0__tar.gz

cml_launcher-1.0.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: cml-launcher
+Version: 1.0.0
+Summary: CML - cm Minecraft Launcher - 纯代码 Minecraft 启动器
+Author: cm
+License: MIT
+Project-URL: Homepage, https://github.com/your-repo/cml-launcher
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: minecraft-launcher-lib>=1.4.0
+Provides-Extra: gui
+Requires-Dist: customtkinter>=5.2.0; extra == "gui"
+Requires-Dist: Pillow>=10.0.0; extra == "gui"
+
+# CML - cm Minecraft Launcher
+
+简洁高效的 Minecraft 启动器，基于 CustomTkinter 构建。
+
+## 功能特性
+
+- 账户管理（离线登录）
+- 版本管理（安装/删除/选择）
+- 模组管理（扫描/启用/禁用/删除）
+- Modrinth 模组/光影搜索下载
+- 自动 Java 检测
+- 深色主题 UI
+
+## 安装
+
+### 方式一：pip 安装
+
+```bash
+pip install cml-launcher
+```
+
+安装后，在命令行运行：
+
+```bash
+cml
+```
+
+或使用模块方式：
+
+```bash
+python -m cml
+```
+
+### 方式二：开发模式
+
+```bash
+git clone <repo-url>
+cd cml-launcher
+pip install -e .
+```
+
+## 使用
+
+安装后，运行以下命令启动：
+
+```bash
+cml
+```
+
+## 系统要求
+
+- Python 3.8+
+- Windows/Linux/macOS
+- Minecraft 游戏文件（首次启动会自动下载）
+
+## 依赖
+
+- customtkinter >= 5.2.0
+- minecraft-launcher-lib >= 1.4.0
+- Pillow >= 10.0.0
+
+## License
+
+MIT

cml_launcher-1.0.0/README.md

@@ -0,0 +1,64 @@
+# CML - cm Minecraft Launcher
+
+简洁高效的 Minecraft 启动器，基于 CustomTkinter 构建。
+
+## 功能特性
+
+- 账户管理（离线登录）
+- 版本管理（安装/删除/选择）
+- 模组管理（扫描/启用/禁用/删除）
+- Modrinth 模组/光影搜索下载
+- 自动 Java 检测
+- 深色主题 UI
+
+## 安装
+
+### 方式一：pip 安装
+
+```bash
+pip install cml-launcher
+```
+
+安装后，在命令行运行：
+
+```bash
+cml
+```
+
+或使用模块方式：
+
+```bash
+python -m cml
+```
+
+### 方式二：开发模式
+
+```bash
+git clone <repo-url>
+cd cml-launcher
+pip install -e .
+```
+
+## 使用
+
+安装后，运行以下命令启动：
+
+```bash
+cml
+```
+
+## 系统要求
+
+- Python 3.8+
+- Windows/Linux/macOS
+- Minecraft 游戏文件（首次启动会自动下载）
+
+## 依赖
+
+- customtkinter >= 5.2.0
+- minecraft-launcher-lib >= 1.4.0
+- Pillow >= 10.0.0
+
+## License
+
+MIT

cml_launcher-1.0.0/cml/__init__.py

@@ -0,0 +1,39 @@
+"""
+CML - cm Minecraft Launcher
+
+无 GUI 版本：通过代码启动/下载游戏
+
+用法：
+    import cml
+
+    # 启动游戏
+    cml.launch_game("1.20.1")  # 通过版本名启动
+    cml.launch_game(jar_path="C:/MC/versions/1.20.1/1.20.1.jar")  # 通过 jar 绝对路径启动
+
+    # 下载游戏
+    cml.download_version("1.20.1")      # 下载到默认目录
+    cml.download_version("1.20.1", "D:/MC")  # 下载到指定目录
+
+    # 其他
+    cml.list_versions()       # 获取可下载版本
+    cml.get_versions()        # 获取已安装版本
+    cml.set_version("1.20.1")  # 设置当前版本
+    cml.get_java_path()       # 获取 Java 路径
+"""
+
+__version__ = "1.0.0"
+__author__ = "cm"
+
+from .core import CMLCore, launch_game, get_versions, set_version, get_java_path, download_version, list_versions, search_versions
+
+__all__ = [
+    "CMLCore",
+    "launch_game",
+    "get_versions",
+    "set_version",
+    "get_java_path",
+    "download_version",
+    "list_versions",
+    "search_versions",
+    "__version__",
+]

cml_launcher-1.0.0/cml/__main__.py

@@ -0,0 +1,8 @@
+"""
+支持 python -m cml 运行
+"""
+
+from .app import main
+
+if __name__ == "__main__":
+    main()

cml_launcher-1.0.0/cml/app.py

@@ -0,0 +1,174 @@
+"""
+CML - cm Minecraft Launcher
+主入口模块
+"""
+
+import customtkinter as ctk
+import os
+import subprocess
+import threading
+import minecraft_launcher_lib as mll
+
+from .modules.sidebar import Sidebar
+from .modules.pages.home_page import HomePage
+from .modules.pages.versions_page import VersionsPage
+from .modules.pages.download_page import DownloadPage
+from .modules.pages.mods_page import ModsPage
+from .modules.pages.settings_page import SettingsPage
+from .modules.config_manager import ConfigManager
+
+
+class CMLauncher(ctk.CTk):
+    def __init__(self):
+        super().__init__()
+
+        self.title("CML - cm Minecraft Launcher")
+        self.geometry("1000x650")
+        self.minsize(900, 600)
+
+        ctk.set_appearance_mode("dark")
+        ctk.set_default_color_theme("blue")
+        self.configure(bg_color="#1a1a2e")
+
+        self.config = ConfigManager()
+        self.pages = {}
+        self.current_page = None
+
+        self._setup_ui()
+
+        # 启动后台线程自动检测 Java
+        threading.Thread(target=self._auto_detect_java, daemon=True).start()
+
+    def _setup_ui(self):
+        self.sidebar = Sidebar(self, self._switch_page)
+        self.sidebar.pack(side="left", fill="y")
+
+        self.content = ctk.CTkFrame(self, fg_color="#16213e", corner_radius=0)
+        self.content.pack(side="right", fill="both", expand=True)
+
+        self.pages["home"] = HomePage(self.content, self.config)
+        self.pages["versions"] = VersionsPage(self.content, self.config)
+        self.pages["download"] = DownloadPage(self.content)
+        self.pages["mods"] = ModsPage(self.content, self.config)
+        self.pages["settings"] = SettingsPage(self.content, self.config)
+
+        self._switch_page("home")
+
+    def _switch_page(self, page_name):
+        if self.current_page:
+            self.current_page.pack_forget()
+        page = self.pages.get(page_name)
+        if page:
+            page.pack(fill="both", expand=True, padx=20, pady=20)
+            self.current_page = page
+            self.sidebar.set_active(page_name)
+
+    def _auto_detect_java(self):
+        """启动时后台检测 Java 路径（已有有效路径则跳过）"""
+        saved = self.config.get("java_path", "")
+        if saved and os.path.exists(saved):
+            return  # 已有有效路径，不重复扫描
+
+        found = self._scan_java()
+        if found:
+            self.config.set("java_path", found)
+            # 通知首页刷新 Java 显示
+            self.after(0, self._notify_java_found, found)
+
+    def _scan_java(self):
+        """多策略扫描 Java，返回第一个找到的 javaw.exe 路径"""
+
+        # 策略1：mll 内置检测
+        try:
+            path = mll.utils.get_java_executable()
+            if path and path != "java" and os.path.exists(path):
+                return path
+        except Exception:
+            pass
+
+        # 策略2：Minecraft 自带 runtime（jre-legacy / java-runtime-gamma 等）
+        mc_dir = mll.utils.get_minecraft_directory()
+        runtime_base = os.path.join(mc_dir, "runtime")
+        if os.path.exists(runtime_base):
+            for runtime_name in os.listdir(runtime_base):
+                for sub in ["bin", os.path.join("bin", "java")]:
+                    candidate = os.path.join(runtime_base, runtime_name, "windows", runtime_name, sub, "javaw.exe")
+                    if os.path.exists(candidate):
+                        return candidate
+                    # 另一种路径结构
+                    candidate2 = os.path.join(runtime_base, runtime_name, sub, "javaw.exe")
+                    if os.path.exists(candidate2):
+                        return candidate2
+
+        # 策略3：注册表
+        reg_keys = [
+            r"HKLM\SOFTWARE\JavaSoft\Java Runtime Environment",
+            r"HKLM\SOFTWARE\JavaSoft\JDK",
+            r"HKLM\SOFTWARE\JavaSoft\Java Development Kit",
+            r"HKLM\SOFTWARE\WOW6432Node\JavaSoft\Java Runtime Environment",
+        ]
+        for key in reg_keys:
+            try:
+                result = subprocess.run(
+                    ["reg", "query", key, "/v", "JavaHome"],
+                    capture_output=True, text=True, timeout=5,
+                )
+                if result.returncode == 0:
+                    for line in result.stdout.splitlines():
+                        if "REG_SZ" in line:
+                            java_home = line.split("REG_SZ")[-1].strip()
+                            exe = os.path.join(java_home, "bin", "javaw.exe")
+                            if os.path.exists(exe):
+                                return exe
+            except Exception:
+                continue
+
+        # 策略4：常见安装目录扫描
+        common_bases = [
+            r"C:\Program Files\Java",
+            r"C:\Program Files\Eclipse Adoptium",
+            r"C:\Program Files\Microsoft",
+            r"C:\Program Files (x86)\Java",
+            r"D:\Java",
+            r"D:\Program Files\Java",
+        ]
+        for base in common_bases:
+            if not os.path.exists(base):
+                continue
+            try:
+                for entry in os.listdir(base):
+                    exe = os.path.join(base, entry, "bin", "javaw.exe")
+                    if os.path.exists(exe):
+                        return exe
+            except Exception:
+                continue
+
+        # 策略5：where java（PATH 里找）
+        try:
+            result = subprocess.run(
+                ["where", "javaw"], capture_output=True, text=True, timeout=5
+            )
+            if result.returncode == 0:
+                path = result.stdout.strip().splitlines()[0]
+                if os.path.exists(path):
+                    return path
+        except Exception:
+            pass
+
+        return None
+
+    def _notify_java_found(self, path):
+        """检测到 Java 后刷新首页显示"""
+        home = self.pages.get("home")
+        if home and hasattr(home, "_refresh_java_info"):
+            home._refresh_java_info()
+
+
+def main():
+    """命令行入口（用于 python -m cml 或安装后 cml 命令）"""
+    app = CMLauncher()
+    app.mainloop()
+
+
+if __name__ == "__main__":
+    main()

cml_launcher-1.0.0/cml/core.py

@@ -0,0 +1,297 @@
+"""
+CML - cm Minecraft Launcher
+核心启动模块（无 GUI）
+"""
+
+import os
+import subprocess
+import minecraft_launcher_lib as mll
+from .modules.config_manager import ConfigManager
+
+
+class CMLCore:
+    """CML 核心类（无 GUI）"""
+
+    def __init__(self):
+        self.config = ConfigManager()
+        self.minecraft_dir = mll.utils.get_minecraft_directory()
+
+    def get_java_path(self):
+        """获取 Java 路径（自动检测）"""
+        saved = self.config.get("java_path", "")
+        if saved and os.path.exists(saved):
+            return saved
+
+        # 自动检测
+        java_path = self._detect_java()
+        if java_path:
+            self.config.set("java_path", java_path)
+        return java_path
+
+    def _detect_java(self):
+        """多策略扫描 Java"""
+        # 策略1：mll 内置检测
+        try:
+            path = mll.utils.get_java_executable()
+            if path and path != "java" and os.path.exists(path):
+                return path
+        except Exception:
+            pass
+
+        # 策略2：Minecraft 自带 runtime
+        runtime_base = os.path.join(self.minecraft_dir, "runtime")
+        if os.path.exists(runtime_base):
+            for runtime_name in os.listdir(runtime_base):
+                for sub in ["bin", os.path.join("bin", "java")]:
+                    candidate = os.path.join(runtime_base, runtime_name, "windows", runtime_name, sub, "javaw.exe")
+                    if os.path.exists(candidate):
+                        return candidate
+                    candidate2 = os.path.join(runtime_base, runtime_name, sub, "javaw.exe")
+                    if os.path.exists(candidate2):
+                        return candidate2
+
+        # 策略3：注册表
+        reg_keys = [
+            r"HKLM\SOFTWARE\JavaSoft\Java Runtime Environment",
+            r"HKLM\SOFTWARE\JavaSoft\JDK",
+            r"HKLM\SOFTWARE\WOW6432Node\JavaSoft\Java Runtime Environment",
+        ]
+        for key in reg_keys:
+            try:
+                result = subprocess.run(
+                    ["reg", "query", key, "/v", "JavaHome"],
+                    capture_output=True, text=True, timeout=5,
+                )
+                if result.returncode == 0:
+                    for line in result.stdout.splitlines():
+                        if "REG_SZ" in line:
+                            java_home = line.split("REG_SZ")[-1].strip()
+                            exe = os.path.join(java_home, "bin", "javaw.exe")
+                            if os.path.exists(exe):
+                                return exe
+            except Exception:
+                continue
+
+        # 策略4：常见安装目录
+        common_bases = [
+            r"C:\Program Files\Java",
+            r"C:\Program Files\Eclipse Adoptium",
+            r"C:\Program Files\Microsoft",
+            r"D:\Java",
+        ]
+        for base in common_bases:
+            if not os.path.exists(base):
+                continue
+            try:
+                for entry in os.listdir(base):
+                    exe = os.path.join(base, entry, "bin", "javaw.exe")
+                    if os.path.exists(exe):
+                        return exe
+            except Exception:
+                continue
+
+        # 策略5：PATH
+        try:
+            result = subprocess.run(
+                ["where", "javaw"], capture_output=True, text=True, timeout=5
+            )
+            if result.returncode == 0:
+                path = result.stdout.strip().splitlines()[0]
+                if os.path.exists(path):
+                    return path
+        except Exception:
+            pass
+
+        return None
+
+    def get_installed_versions(self):
+        """获取已安装的版本列表"""
+        try:
+            return mll.utils.get_installed_versions(self.minecraft_dir)
+        except Exception:
+            return []
+
+    def get_current_version(self):
+        """获取当前选中的版本"""
+        return self.config.get("current_version")
+
+    def set_current_version(self, version_name):
+        """设置当前版本"""
+        self.config.set("current_version", version_name)
+
+    def launch_game(self, version=None, username=None, jar_path=None):
+        """
+        启动 Minecraft 游戏
+
+        参数：
+            version: 版本名（如 "1.20.1"），为 None 则使用当前选中版本
+            username: 用户名，为 None 则使用配置中的用户名
+            jar_path: .jar 文件绝对路径，指定后忽略 version 参数
+
+        返回：
+            成功返回 True，失败返回 False
+        """
+        if username is None:
+            username = self.config.get("username", "Player")
+
+        java_path = self.get_java_path()
+        if not java_path:
+            print("错误：未找到 Java，请手动设置 Java 路径")
+            return False
+
+        try:
+            if jar_path:
+                # 指定 jar 路径启动
+                if not os.path.exists(jar_path):
+                    print(f"错误：jar 文件不存在 {jar_path}")
+                    return False
+
+                # 获取版本目录作为游戏目录
+                game_dir = os.path.dirname(os.path.dirname(jar_path))
+                assets_dir = os.path.join(game_dir, "assets")
+                libs_dir = os.path.join(game_dir, "libraries")
+
+                command = [
+                    java_path,
+                    f"-Djava.library.path={libs_dir}",
+                    "-cp", jar_path,
+                    "net.minecraft.client.Main",
+                    "--username", username,
+                    "--version", os.path.basename(os.path.dirname(jar_path)),
+                    "--gameDir", game_dir,
+                    "--assetsDir", assets_dir,
+                ]
+
+                print(f"启动 jar：{jar_path}")
+            else:
+                # 使用版本名启动
+                if version is None:
+                    version = self.get_current_version()
+
+                if not version:
+                    print("错误：未指定版本，且未设置当前版本")
+                    return False
+
+                options = {
+                    "username": username,
+                    "uuid": self.config.get("uuid", ""),
+                    "token": self.config.get("token", ""),
+                }
+
+                command = mll.command.get_minecraft_command(
+                    version, self.minecraft_dir, options
+                )
+
+                # 替换 java 路径
+                if command and command[0] == "java":
+                    command[0] = java_path
+
+                print(f"启动版本：{version}")
+
+            print(f"Java 路径：{java_path}")
+            print(f"用户名：{username}")
+
+            # 启动游戏
+            subprocess.Popen(command, cwd=self.minecraft_dir)
+            return True
+
+        except Exception as e:
+            print(f"启动失败：{e}")
+            return False
+
+    def install_version(self, version, minecraft_version=None, path=None):
+        """
+        安装新版本
+
+        参数：
+            version: 版本名（如 "1.20.1"）
+            minecraft_version: 对应的 MC 版本（通常和 version 相同）
+            path: 安装目录路径，为 None 则使用默认 .minecraft 目录
+        """
+        if minecraft_version is None:
+            minecraft_version = version
+
+        target_dir = path if path else self.minecraft_dir
+
+        try:
+            print(f"正在安装版本 {version} 到 {target_dir}...")
+            mll.install.install_minecraft_version(
+                minecraft_version, target_dir
+            )
+            print(f"版本 {version} 安装成功")
+            return True
+        except Exception as e:
+            print(f"安装失败：{e}")
+            return False
+
+    def get_available_versions(self):
+        """获取可下载的版本列表"""
+        try:
+            return mll.utils.get_available_versions(self.minecraft_dir)
+        except Exception:
+            return []
+
+    def search_versions(self, keyword):
+        """搜索版本"""
+        all_versions = self.get_available_versions()
+        keyword = keyword.lower()
+        return [v for v in all_versions if keyword in v.get("id", "").lower()]
+
+
+def launch_game(version=None, username=None, jar_path=None):
+    """
+    快捷函数：启动 Minecraft 游戏
+
+    用法：
+        import cml
+        cml.launch_game("1.20.1")                                    # 通过版本名启动
+        cml.launch_game(jar_path="C:/MC/versions/1.20.1/1.20.1.jar")  # 通过 jar 路径启动
+    """
+    core = CMLCore()
+    return core.launch_game(version, username, jar_path)
+
+
+def get_versions():
+    """获取已安装版本列表"""
+    core = CMLCore()
+    return core.get_installed_versions()
+
+
+def set_version(version_name):
+    """设置当前版本"""
+    core = CMLCore()
+    core.set_current_version(version_name)
+
+
+def get_java_path():
+    """获取 Java 路径"""
+    core = CMLCore()
+    return core.get_java_path()
+
+
+def download_version(version, path=None):
+    """
+    快捷函数：下载安装 Minecraft 版本
+
+    用法：
+        import cml
+        cml.download_version("1.20.1")                      # 下载到默认目录
+        cml.download_version("1.20.1", "D:/MC")             # 下载到指定目录
+    """
+    core = CMLCore()
+    return core.install_version(version, path=path)
+
+
+def list_versions():
+    """快捷函数：获取可下载版本列表"""
+    core = CMLCore()
+    return core.get_available_versions()
+
+
+def search_versions(keyword):
+    """快捷函数：搜索可下载版本"""
+    core = CMLCore()
+    return core.search_versions(keyword)
+
+
+__all__ = ["CMLCore", "launch_game", "get_versions", "set_version", "get_java_path", "download_version", "list_versions", "search_versions"]