CML - cm Minecraft Launcher

简洁高效的 Minecraft 启动器，支持 GUI 和纯代码 API 调用。

功能特性

• 账户管理（离线登录）
• 版本管理（安装/删除/选择）
• 模组管理（扫描/启用/禁用/删除）
• Modrinth 模组/光影搜索下载
• 自动 Java 检测
• 纯代码 API：可通过 import cml 在 Python 中调用
• 深色主题 UI（GUI 版本）

安装

方式一：pip 安装

pip install cml-launcher

方式二：开发模式

git clone <repo-url>
cd cml-launcher
pip install -e .

使用

GUI 启动器

cml

或

python -m cml

纯代码 API

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 路径

系统要求

• Python 3.8+
• Windows/Linux/macOS
• Minecraft 游戏文件（首次启动会自动下载）

依赖

• minecraft-launcher-lib >= 1.4.0

GUI 版本额外依赖：

• customtkinter >= 5.2.0
• Pillow >= 10.0.0

License

MIT