更新时间为2024.7.17，适用启动器版本A27
- 获取启动器
- 启动启动器
- 启动器相关概念
- 主页面
- 账户页面
- 添加游戏实例页面
- 在线整合包页面
- 修改游戏实例页面
- 配置文件页面
- 游戏实例日志页面
- 游戏实例导出页面
- 服务器实例生成页面
- 启动器设置页面
- 添加资源页面
- 游戏统计页面
- 角色皮肤页面
- 映射大厅页面
- 实例云同步页面
- 游戏内覆盖页面
获取启动器二进制文件有3种方式
- Releases 里面的一般是正式发布版
- Actons 里面的一般是测试版
- 群文件/网盘
- 从源码构建
然后根据你的电脑系统选择下载
- windows系统下载win64 msi是安装包
- linux系统.deb .pkg.tar.zst .AppImage
- macOs系统下载osx64
有aot标记的都是本机二进制编译的(linux arm64的构建不出来)
- 从其他地方下载
加入群571239090
从群文件下载
从网盘下载
- 从源码里面构建
参见构建指南
- windows和macOs系统，解压即可双击启动
- 若你是从msi安装包安装的，查找桌面的启动器图标，双击即可启动
- Linux系统安装包后可以在桌面或菜单中直接启动
- AppImage可以在Linux上直接启动
第一次启动启动器，若出现欢迎界面，则正常启动
若你将启动器安装在没有权限的目录下面，启动后出现
请尝试将启动器安装在其他地方，或者根据上面的提示进行操作
在正式使用启动器之前，你需要了解一些概念性的东西
能够更好的帮助你使用启动器
- Windows系统下，游戏默认存会在启动器根目录下
账户储存会放在C:\Users\{User}\AppData\Roaming\ColorMC - Linux系统下，游戏默认存会放在
~/ColorMC
账户储会放在~/.config/ColorMC - macOs系统下，游戏默认放在
/Users/shared/ColorMC
账户储存会会放在/Users/{User}/ColorMC
游戏存储路径可以后期修改，但是账户储存路径固定不可修改
启动器启动后会创建如下的文件夹结构
- dll 启动器更新
- download 下载缓存
- frp 端口映射二进制文件储存
- image 图片缓存
- inputs 手柄配置方案储存
- java 下载的Java储存
- minecraft 游戏文件储存
- assets 游戏资源文件
- instances 游戏实例
- libraries 游戏运行库
- versions 游戏版本信息储存
- tools 工具文件夹
- cloud.json 云同步储存
- config.json 核心配置文件
- count.dat 游戏统计储存
- frp.json 映射信息存储
- gui.json GUI配置文件
- lock 启动器锁定
- logs.log 启动器日志
- maven.json 本地运行库信息
- temp 文件权限测试文件
在账户文件夹
- auth.json 账户储存
- run 启动器运行目录储存
ColorMC是多实例游戏启动器，启动器是以游戏实例为单位启动游戏
游戏实例相当于一个独立的游戏配置
启动器将 Mod 配置 世界 等 储存在一个游戏文件夹，及放在一个游戏实例内
使用多实例管理游戏可以将多个整合包放在一个启动器内统一管理，互不影响，但共享游戏资源文件和运行库，以此来减少重复文件
一个游戏实例只能启动一次，禁止重复启动，因为同时启动可能会有干扰，损坏游戏文件等风险
若需要运行多个相同的游戏实例，只能进行游戏实例复制多几份，单独运行
游戏实例还有下面几个变种，本质上也是游戏实例
- 服务器实例
用于游戏客户端同步的特殊
游戏实例，需要用一台服务器分发文件 - 云同步实例
将
游戏实例放在云服务器上的特殊游戏实例，云同步仅支持ColorMC的服务器与合作服务器商(目前没有了)
ColorMC的启动游戏实例需要一个账户，账户可以是以下几种类型
- 离线账户
- 微软账户(OAuth登录验证)
- 统一通行证账户(Nide8)
- 外置登录(Authlib方式)
- LittleSkin皮肤站账户
- 自建皮肤站账户
账户至少会有以下数据
- 用户名(Username)
- 用户UUID(UUID)
- 账户类型(UserType)
- 客户端UUID(ClientUUID)
启动器不会储存账户密码与游戏Token，但会储存更新Token
使用离线账户来启动游戏时，至少登录一个微软账户
启动器主页面中间会显示所有目前存在的游戏实例
顶部是菜单，点击按钮可以打开对应的窗口
从左到右分别是启动器用户手册 游戏统计 启动器设置
右侧是当前使用的账户，点击头像可以打开账户设置窗口，点击右边的按钮可以打开皮肤显示窗口
右侧是信息栏，目前有Minecraft New入口
若启动器有新版本，则会显示一个启动器升级栏
若目前正在使用微软账户，则会显示映射大厅入口
若目前正在播放自定义音乐，则会显示音乐控制栏
中间是游戏实例和游戏实例分组，所有游戏实例都在这里
游戏实例分组内的每一个图标代表一个游戏实例，图标下面是游戏实例的名字
点击分组右上角箭头可以让游戏分组最大化/最小化
点击分组内加号可以打开新建游戏实例页面，同时会设置游戏实例添加在该分组
按下Ctrl+F可以打开实例搜索
若开启了服务器显示，则会在最上方显示服务器信息
若开启Live2D展示，会在背景Live2D模型
启动器更新检测是联网进行获取的，可以在更新日志内查看近期与未来的计划
启动器用户手册点开后会打开网页（即本网页）
可以选择是在github（国外）上查看还是gitee（国内）网站上查看
若你还没有创建任何实例，则会显示快速配置界面
你可以快速的进行账户添加、游戏运行时（JAVA）设置、添加游戏实例
Minecraft New栏是可以可以进入查看
若进入则会显示更多内容
点击游戏实例可以选择游戏实例
鼠标放在游戏实例上可以显示相关操作，启动和修改实例，点击右键可以呼出实例菜单
若有多个游戏分组，拖拽游戏实例到其他分组下可以直接修改分组
选择好需要启动的游戏实例
可以点击火箭按钮启动，又或者双击需要启动的游戏实例
此时左上角会显示启动进度，右上角会有提示信息
则表示游戏实例正在启动中
点击旁边的修改按钮可以打开游戏实例设置页面
在主页面点击右上角的头像后，可以打开账户页面
在该页面内，可以完成，账户的添加、删除、修改、切换操作
使用的账户即启动游戏的账户需要在这里切换
上方为账户的筛选，可以选择筛选的账户类型
点击右上角的按钮，可以开始新建账户
双击账户列表中的账户可以切换账户
右键账户可以呼出菜单
- 切换账户 切换使用的账户为此账户
- 刷新密钥 重新获取token
- 重新登录 重新输入密码登录
- 删除账户 删除储存的账户
- 修改账户 修改账户的名字或者UUID
点击主页面的添加实例，可以打开新建实例窗口
添加游戏实例有4种方式
- 从头新建 手动填写所有版本信息
- 下载实例 从网络上下载游戏实例
- 从压缩包导入 选择压缩包并导入游戏实例
- 从文件夹导入 选择游戏文件夹并导入
从头新建
只需要填写实例名字，选择版本等信息，最后点击右下角的完成按键即可添加
下载��例
此时会打开第二层菜单
点击下载整合包可以打开 在线整合包页面 及在线下载整合包来添加实例
点击下载云同步实例选择下载云同步的实例，详情查看
点击下载服务器实例填入网址开始下载服务器实例，详情查看
从压缩包导入从压缩包导入实例需要先选择压缩包，然后填写实例名字与选择压缩包类型，最后点击右下角的导入压缩包即可
从文件夹导入从现有的文件夹导入实例需要先选择文件夹路径，然后填写实例名字，点击扫描文件选择需要导入的文件内容，最后点击导入即可
扫描阶段会自动扫描存在的游戏版本，然后自动导入它们
目前支持Minecraft Launcher MMC HMCL PCL BAKAXL 等启动器的游戏版本结构
导入后可能会缺失版本信息，需要手动选择游戏版本，加载器
若你不想使用该方式添加游戏实例，可以点击右上角的 返回 回到上一个界面
可以从主流网站上下载并安装游戏整合包
可以在上方的选择中筛选整合包等，按下鼠标侧键可以前后翻页，按下F5可以刷新列表
双击一个整合包可以打开版本选择
再次双击可以开始下载整合包
若需要下载其他整合包，可以点击右上角返回关闭版本选择
在下载前若保持添加实例窗口开启
整合包下载完成后会自动填入实例名字与游戏分组信息
用于修改游戏实例相关内容
左侧的侧边栏有主要设置功能，以及该界面的更多功能入口
版本设置设置游戏的版本，模组加载器，整合包信息
可以检测整合包更新
更多功能
- 导出游戏实例 打开游戏实例导出页面
- 查看运行日志 打开游戏实例运行日志页面
- 修改配置文件 打开游戏实例配置文件页面
- 打开文件夹 在资源管理器查看游戏实例文件
- 生成服务器实例 打开游戏实例分发页面
- 生成实例信息 将游戏实例信息进行打印
- 删除实例 删除这个游戏实例
启动参数设置游戏启动时使用的参数
可以设置的参数有
- 游戏窗口设置 设置窗口初始启动大小，自定义标题
- Java基础设置 设置启动使用的Java与内存大小
- 自定义执行 设置启动前与启动后执行
- Jvm参数设置 设置Jvm与游戏具体的启动参数
- 自动加入服务器 设置游戏启动后自动加入的服务器
- 端口代理设置 设置游戏内联网的端口代理
更多功能
- 删除所有配置 删除该游戏实例的单独设置
模组可以查看游戏实例的模组���表
不是所有模组都能正确识别，有些coremod是无法识别出来的
可以拖拽 jar文件 到列表中来直接导入模组
按住Shift键可以多选模组
选择模组右键可以打开菜单
双击模组可以选择启用或者禁用
上方为模组筛选，筛选有4种过滤方式
- 名字 根据模组的名字过滤
- 文件名 根据现有的文件名过滤
- 作者 根据模组的作者名过滤
- modid 根据模组的唯一标识过滤
更多功能
- 导入模组 从现有文件添加到游戏实例中
- 在线下载 打开资源下载页面，并选择模组下载
- 检测更新 检测有标记的模组是否有新版本
- 自动标记 自动标记模组对应的项目(只支持Modrinth自动标记)
- 手动标记 手动标记模组对应的项目
- 依赖检测 检测模组的前置是否齐全
- 打开文件夹 打开模组所在的文件夹
地图查看游戏实例的地图
选择地图后可以查看地图的数据包，对数据包可以可以进行修改操作
右键可以打开菜单
点击修改配置可以打开 该地图的配置文件页面
更多功能
- 导入地图压缩包 从压缩包导入地图
- 在线下载 从网上下载地图
- 地图编辑器 开启地图编辑器
- 还原地图备份 从压缩包还原地图
- 备份文件夹 打开地图备份的文件夹
- 打开文件夹 打开游戏实例地图文件夹
资源包查看游戏实例的资源包
上方可以按照名字进行筛选
右键可以打开菜单
更多功能
- 导入资源包包 选择资源包并导入
- 在线下载 从在线下载资源包
- 打开文件夹 打开游戏实例的资源包文件夹
游戏截图查看游戏实例内的截图
右键可以打开菜单
服务器查看游戏实例的服务器列表
选择一个服务器后会自动获取服务器显示信息
右键可以打开菜单，右下角为添加新的服务器
更多功能
- 刷新列表 重新读取服务器列表
- 添加地址 为列表添加服务器地址
光影包查看游戏实例的光影包(shaderpack)信息
右键可以打开菜单
更多功能
- 刷新列表 重新读取光影包列表
- 导入光影包 选择文件并导入
- 在线下载 从网上下载光影包
- 打开文件夹 打开游戏实例的光影包文件夹
结构文件查看游戏实例的结构文件(schematics)，包括投影模组的结构文件
右击可以打开菜单
更多功能
- 刷新列表 重新读取光影包列表
- 导入结构文件 选择文件并导入
- 打开文件夹 打开游戏实例的结构文件文件夹
打开游戏实例设置窗口后，在版本设置修改配置文件
或在地图列表内右键世界点击修改配置按钮可以打开窗口
打开窗口后可以查看\修改配置文件
在左上角的选择框可以选择配置文件
过滤器会选出名字包含的文件
按下右上角的保存文件或者Ctrl+S会保存修改到文件中
NBT修改内置有NBT修改器，若打开的是NBT格式文件，或地图文件，可以进行NBT修改
NBT编辑器下，可以通过右键来打开菜单进行编辑
地图查找模式下，可以进行方块或者实体的查找
点击保存修改或按下快捷键Ctrl+S会保存修改到文件中
打开游戏实例设置窗口后，在版本设置点击 查看运行日志
或在主界面右键实例点击运行日志按钮可以打开窗口
日志文本无法编辑，但是可以复制
该页面会加载所有logs/下的日志文件
默认会显示启动器内最后运行产生的日志
在上方选择后可以打开文件
功能按钮
- 测试启动 启动游戏实例，并显示日志信息
- 强制停止 强制停止(Kill)游戏
- 刷新列表 重新加载日志列表
- 搜索 打开日志内容搜索
- 上传日志 上传当前日志信息到服务器，生成一个网页链接
打开游戏实例设置窗口后，在版本设置点击导出游戏实例
或者在主页面内右击游戏实例，选择导出游戏实例可以打开该页面
打开后可以选择导出类型
首先选择导出类型
- ColorMC整合包 只能在ColorMC启动器内使用
- CurseForge整合包 用于主流启动器整合包
- Modrinth整合包 用于主流启动器整合包
然后选择模组在线下载
设置了模组在线下载后，导出的整合包内可以不附带该mod，在导入时进行下载
双击勾选可以选择/不选择该模组
只有标记的模组支持该操作
然后再选择所需文件放进压缩包内
如果是Modrinth整合包，还可以设置文件在线下载
导出的CurseForge或Modrinth整合包，可以发布在其网站上
打开游戏实例设置窗口后，在版本设置点击生成服务器实例
可以打开游戏服务器实例生成页面
根据需要选择模组
如模组有标记，则会自动填充下载地址
根据需要选择资源包
最后生成服务器实例，会导出到一个文件夹
你需要把这个文件夹内的东西放在服务器上，让客户端可以访问即可
在启动器主页面点击设置按钮可以打开窗口
启动器设置页面只用于调整启动器内容设置
界面设置调节启动器界面显示等
例如启动器的主题色，背景颜色
启动器的字体，窗口透明方式等
还可以调节主界面的人物头像显示方式
往下拖动有Live2D人物设置选项
在使用Live2D人物模型显示之前，需要先安装Core
选择导入下载的压缩包，此时会自动导入所需文件
或者下载好的压缩包解压后，复制dll或so文件到启动器运行目录下
然后重启启动器
再次打开设置页面找到Live2D人物设置，若能正确识别Core版本则安装成功
然后就可以选择模型并加载
模型只支持model3和moc3，不支持其他版本
不同系统需要放的文件不一样
在主界面显示人物后，可以点击人物进行互动，操作等
右键可以呼出菜单
网络设置调节启动器联网功能
- 下载设置 调节游戏文件下载源，下载线程数等
- 代理设置 调节下载使用使用的端口代理
- 启动器更新 是否自动检测启动器更新
- 云同步密钥 用于启动器游戏实例云同步
在文件下载过程中，不可修改下载与代理设置 云同步密钥不要随便泄露，有可能会导致存档丢失，损害等
启动设置调节游戏启动参数等
主要调节
- 游戏文件检查 是否在启动前检测完整性
- 游戏窗口设置 设置游戏窗口大小
- Jvm参数设置 调整Jvm和游戏启动参数
- 启动前，启动后运行 设置启动器在游戏开启和顺利开启后运行程序
Java路径调节游戏使用的的Java路径
上方可以手动选择Java来添加，选择Java后会自动生成一个名字
更多功能
- 刷新列表 刷新Javal列表
- 下载Java 从网上下载Java
- 扫描并添加 尝试扫描电脑上存在的Java（非扫盘）
- 删除所有 删除所有Java路径
- 压缩包导入 导入一个压缩包到启动器内
选择一个Java路径，右击可以打开菜单
客户端定制给服主使用的定制功能
主要调节
- 服务器信息 可以设置在主界面显示服务器及自动进服
- 锁定设置 锁定玩家能启动的游戏实例和登录的账户类型
- 自定义主界面 启用自定义界面代码，教程
- 背景音乐 在启动器启动时循环播放音乐，支持网易云的音乐链接
配置文件启动器配置文件，及工作目录设置
更多功能
- 重置所有配置 将配置文件删除，恢复到默认
- 清空所有账户 删除所有登录的账户
- 运行文件夹 打开启动器运行的文件夹
- Java下载目录 打开启动器下载的Java目录
- 下载缓存文件夹 打开启动器下载缓存文件夹
- 图片缓存文件夹 打开启动器图片缓存文件夹
调整启动器工作目录只在特殊情况下使用，调整后文件不会自动复制，需要手动复制
手柄设置启动器支持手柄输入到游戏内，无需安装手柄模组也能体验游戏内手柄支持
勾选游戏内手柄支持后，只要启动游戏都会采用 游戏内覆盖页面 来显示游戏
只要是有驱动的手柄都能支持上
手柄配置是按文件区分开来的，默认会使用启用配置里的手柄配置
手柄配置分为3个部分绑定
- 按键绑定 在手柄上按下该按键后就会执行对应绑定的按钮
- 扳机与摇杆绑定 可以在线性区内划分区域，绑定不同的按钮
- 摇杆绑定 指定视角与指针移动所用的摇杆
摇杆与扳机都可以设置死区，视角与光标可以设置其灵敏度
上滚轮与下滚轮需要单独绑定在按键内
目前仅支持Windows平台
关于启动器说明
打开游戏实例设置窗口后，在Mod列表，地图列表等点击左侧的在线下载按钮
或在主界面右键实例点击添加资源按钮可以打开窗口
添加资源主要用于下载游戏资源，例如Mod，地图，材质包等
搜索模组可以选择搜索源
不同的资源有不同的搜索源
在上方可以选择来筛选内容
双击后打开版本列表，双击版本可以开始下载资源
如果你发现没有文件可以选，请确定你的游戏实例模组加载器类型正确
在设置界面点击下载Java后会打开Java下载窗口
双击文件即可下载并自动安装
在主界面点击游戏统计，打开游戏统计窗口
游戏统计会统计游戏的启动记录与运行时间
在主界面点击角色皮肤，打开角色皮肤查看窗口
左侧为皮肤显示，右侧为功能选择
在左侧的皮肤显示，可以修改模型显示角度 位置 大小
- 鼠标左键并移动鼠标 或者点击 右边的上下左右 为旋转角色模型
- 鼠标右键并移动鼠标 或者点击 左边的上下左右 为平移角色模型
- 鼠标滚轮 或者点击 右侧的上下 为缩放角色模型
在右侧，可以修改皮肤模型，启用/关闭动画
或者修改骨骼关节角度
点击映射工具可以打开窗口
打开映射工具需要选择正版账户，打开后会登录并验证正版账户
映射大厅会显示目前存在的映射
可以查看MOTD信息和选择实例加入
映射大厅集成端口映射，目前支持NatFrp与OpenFrp两个映射平台集成
如果你需要集成其他平台请联系我
选择一个映射平台
填写好密钥后，刷新可以看到隧道列表
然后启动游戏，开启局域网
之后切换到局域网游戏
选择你需要映射的局域网
点击开始映射后选择隧道
等待程序运行，完成后映射成功
如果你需要共享映射，点击右上方的共享映射即可
此时就能在映射大厅看到你的映射了
启动云同步之前，需要在启动器设置的网络设置内配置正确的云同步密钥
在主界面选择一个游戏实例，右击选择云同步
即可打开云同步页面
在主界面，可以选择游戏实例是否启用云同步
��为启用，则后面的同步操作将不可用
云同步主要同步，配置文件与地图
配置文件的上传，请确保整个游戏实例关键的文件都上传了
若有文件没上传，重新上传会覆盖之前的文件
若为整合包，且有标记的模组，则模组可以不需要上传，可以在启动前自动补全
地图同步主要是根据存档来上传，首次上传会上传所有文件
后续上传只会更新修改的文件
右键存档可以打开菜单
开启了云同步后，在添加游戏实例中，选择下载云同步实例
此时可以选择下载云同步实例
只能选择上传了配置的游戏实例，若为 已经在本地的游戏实例不会在此列表中展示
云同步密钥请不要泄漏，否则造成的文件丢失概不负责
云同步会消耗云存储空间，超出后将无法写入文件，请适当使用
若启用了游戏内手柄支持，则会直接向系统发送手柄转换操作
在主界面右击游戏实例，选择调整手柄可以调整设置
开启了此功能后，会使用ColorMCASM，仅支持JAVA8及以上的游戏版本