Console Minecraft Launcher

一个在控制台上运行的 Minecraft Java 版启动器

English README | 查看更新日志

视频教程

支持的界面语言

英语
简体中文
粤语（简体）

特别鸣谢

@Graetpro-X：开发部分功能
@FZZkill：帮助美化README

帮助文档

获得全部帮助文档，直接加 -h 或 --help，如cmcl -h
获得单个功能的帮助文档，在功能选项后面加 -h 或 --help，如cmcl account --help
注：中括号内的内容是可选的。选项中的逗号意为两边的选项都能实现相同的功能。
对于给选项指定内容，仅能在缩略选项（一条横杠）后面直接加上内容（无需空格），如cmcl -lD:\.minecraft，
仅能在完整选项（两条横杠）后面加上等号再输入内容，如cmcl --list=D:\.minecraft，
或在此两者后加上空格再输入内容，如cmcl -l D:\.minecraft；cmcl --list D:\.minecraft，详细请参考选项说明后面的例子。

配置

配置存储在程序运行目录（在 Linux 下则为用户目录/.config/cmcl）的一个名为cmcl.json的JSON文件，你可以使用文本编辑器（需了解JSON教程，修改前备份）或config <配置名称> <配置值>的程序参数（详见帮助文档配置相关）以修改配置。
使用文本编辑器编辑的话，配置名称以及文本配置值需要在英语的双引号（""）内。
使用命令来修改时，如果配置值包含空格，则需要使用英语的双引号（""）括起来
该内容可通过参数config --view查看。

配置名	类型	含义
accounts	JSON数组	账号（非直接修改，请通过“account -h”获得相关使用教程以进行修改）
downloadSource	整数	下载源，0为默认，1为BMCLAPI，2为MCBBS
language	字符串	语言，zh为简体中文，en为英文，cantonese是粤语（简体）
selectedVersion	字符串	已选择的版本
maxMemory	整数	[游戏相关]最大内存（单位：MB）
gameDir	字符串	[游戏相关]自定义游戏目录路径（或设置版本隔离），默认为.minecraft
assetsDir	字符串	[游戏相关]自定义assets资源目录路径，若为空则为游戏目录内的assets目录
resourcesDir	字符串	[游戏相关]自定义资源包目录路径，若为空则为游戏目录内的resourcepacks目录
javaPath	字符串	[游戏相关]Java 路径（如果为空会自动获得）
windowSizeWidth	整数	[游戏相关]游戏窗口的宽
windowSizeHeight	整数	[游戏相关]游戏窗口的高
isFullscreen	布尔值	[游戏相关]是否为全屏，是则为true，否则为false
exitWithMinecraft	布尔值	[游戏相关]运行游戏时，若需要退出启动器时顺便退出游戏，则为true，否则为false
printStartupInfo	布尔值	[游戏相关]开始游戏的时候，是否输出启动信息（Java 路径、最大内存等）
checkAccountBeforeStart	布尔值	[游戏相关]开始游戏之前，是否检查账号是否可用
jvmArgs	JSON数组	[游戏相关]自定义JVM参数（查看下方的示例或通过“jvmArgs -h”获得相关使用教程以进行修改）
gameArgs	JSON对象	[游戏相关]自定义游戏参数（查看下方的示例或通过“gameArgs -h”获得相关使用教程以进行修改）
proxyHost	字符串	代理主机地址
proxyPort	整数	代理端口
proxyUsername	字符串	代理验证的账户（代理可选）
proxyPassword	字符串	代理验证的密码（代理可选）

jvmArgs 示例

["-Dfile.encoding=UTF-8", "-Djava.library.path=natives", "-XX:+PrintGC"]

以上内容意为设置-Dfile.encoding=UTF-8、-Djava.library.path=natives以及-XX:+PrintGC的参数。

gameArgs 示例

{
  "fullscreen": "",
  "arg1": "value1",
  "arg2": "value2",
  "arg3": "space value3"
}

以上内容将会加入游戏参数--fullscreen --arg1 value1 --arg2 value2 --arg3 "space value3"

版权

MrShiehX 拥有该程序的版权。
任何人都可以对此程序提出意见和建议。

软件协议

该软件在 GPL v3 下分发，附带附加条款。

Console Minecraft Launcher
Copyright (C) 2021-2023  MrShiehX <3553413882@qq.com>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your function) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

附加条款（依据 GPLv3 协议第七条）

免责声明

Minecraft 版权归 Mojang Studios 与 Microsoft 所有，使用CMCL产生的所有版权问题，软件制作方概不负责，请支持正版。
用户因使用CMCL而产生的一切后果由用户自己承担，任何涉及CMCL的法律纠纷与冲突与开发者无关，CMCL与开发者将不承担任何责任。

关于作者

MrShiehX

职业：
学生
哔哩哔哩：
@MrShiehX
Youtube：
@MrShiehX

gggxbbb / console-minecraft-launcher