Qomicex Launcher

常见问题

以下整理 Qomicex Launcher(QML 启动器)使用过程中最常见的问题,涵盖版本与加载器支持、Java 环境、启动失败排查、实例迁移、模组与整合包安装、多人联机以及数据与隐私。若此处未能解决你的问题,请前往GitHub Issues提交,或在文档站查阅详细的图文教程。

支持哪些 Minecraft 版本?
支持从 1.6 到最新正式版的所有 Minecraft Java 版版本,包括快照版。启动器会从官方版本清单拉取可用版本列表,新版本发布后无需更新启动器即可安装;安装时可按需选择原版或配合 Forge、Fabric、Quilt、NeoForge 等加载器。
支持哪些模组加载器?
支持 Forge、Fabric、Quilt、NeoForge 与 OptiFine,并兼容整合包常用的 LiteLoader、Cleanroom 等加载器。安装实例时可指定加载器与对应游戏版本,启动器会自动补全该加载器所需的依赖库文件。
启动器支持哪些操作系统?
支持 Windows(x64 / ARM64)、macOS(Intel x64 / Apple Silicon)与 Linux(x64 / ARM64,AppImage、DEB、RPM 三种包格式)。Linux 另提供 LoongArch64 与 RISC-V 64 的实验性构建,稳定性尚未保证。各平台最低系统版本见下载页的系统要求表。
为什么启动器需要 Java?要装哪个版本?
Minecraft Java 版本身依赖 Java 运行环境。启动器可自动扫描并下载适配目标游戏版本的 Java(如 1.17 以上通常需要 Java 17+,更早版本需要 Java 8)。若自动安装失败,也可在设置中手动指定本地 Java 路径。
启动器无法启动游戏怎么办?
建议按顺序排查:①确认实例的游戏版本与已安装的 Java 版本匹配;②检查是否缺少加载器依赖库,可在实例详情中尝试修复;③查看启动器日志(设置页可直接打开日志目录)定位具体报错;④更新显卡驱动,部分光影或高版本资源对驱动版本敏感。若问题仍在,请附带日志文件提交 GitHub Issue。
如何迁移其他启动器的实例?
暂不支持一键导入其他启动器的实例。可行的做法是手动复制:把原启动器 .minecraft 目录下的 versions、mods、saves、resourcepacks 等文件夹,分别复制到 QML 对应实例的目录中。由于不同启动器的版本隔离结构可能不同,建议先复制 versions 与 saves,确认可正常启动后再迁移模组。
什么是「版本隔离」?
版本隔离指每个实例拥有独立的游戏目录。开启后,实例的模组、存档、配置文件互不影响,因此可以在不同实例中安装彼此冲突的模组,或同时保留多个整合包而不必反复增删文件。关闭隔离则会让实例共用同一个 .minecraft 目录。
如何管理多个游戏实例?
在「实例」页面可以创建、重命名、复制与删除实例,并为每个实例单独配置 Java 版本、内存上限、窗口尺寸、启动参数以及启动前后的自定义命令。每个实例也可单独备份与恢复,备份目录支持自定义位置。
模组和整合包从哪里来?
资源中心集成了 Modrinth 与 CurseForge 两个平台,可按游戏版本、加载器、来源与分类筛选,查看项目详情与依赖关系后直接安装到指定实例。安装模组时启动器会自动检查缺失的前置依赖并提供补全入口。
多人联机怎么用?
联机模块基于 EasyTier 组网实现。可由一名玩家创建房间并生成房间码,其他玩家凭房间码加入,无需公网 IP 或手动配置端口映射。启动器也可自动发现本机已开放到局域网的 Minecraft 世界,便于快速联机。
启动器是免费的吗?如何获取源代码?
完全免费且开源,基于 GPL-3.0 协议发布。源代码托管于 GitHub(Qomicex-Public/Qomicex.Tauri),你可以自由使用、阅读、修改与分发,但分发衍生作品时需遵守 GPL-3.0 的条款,例如同样以 GPL-3.0 开源。
启动器会收集我的数据吗?
不会。启动器不包含遥测或行为分析,也不自动上传任何数据。账户凭据、应用设置、下载任务等全部保存在本机,凭据文件经过加密且与机器码绑定。唯一主动外传数据的场景是你在崩溃分析中手动触发日志上传,且上传前会展示将要发送的内容。
为什么换电脑后账户需要重新登录?
账户凭据在本地加密存储,且加密密钥与当前机器的硬件标识绑定。更换设备或重装系统后,原凭据文件无法在新环境解密,因此需要重新登录。这是为防止凭据文件被直接复制到其他机器使用而采取的保护措施。
下载速度慢怎么办?
下载页提供代理下载、镜像源与 GitHub 直连三种来源,可在下载弹窗中切换。启动器支持多线程分片下载与断点续传,也可在设置中调整并发线程数与限速。若某个镜像不稳定,切换到其他来源通常即可恢复速度。
更新检查会发送什么信息?
更新检查仅向 GitHub Releases 与项目更新接口请求版本清单,用于判断是否有新版本;请求不包含个人身份信息。你可以在设置中关闭自动检查更新,改用手动检查。
如何反馈 Bug 或提出功能建议?
请前往 GitHub 仓库的 Issues 页面提交(Qomicex-Public/Qomicex.Tauri/issues)。提交前建议先搜索是否已有同类问题;报告 Bug 时请附上启动器版本、操作系统、复现步骤,以及设置页中导出的日志文件,这些信息能显著加快定位速度。

仍未解决?

  • 查看在线文档中的安装与排障章节,含截图步骤说明。
  • 在GitHub Issues搜索是否已有同类问题,或新建 Issue 并附上日志文件。
  • 加入 QQ 群 623362446 与其他用户交流(群号同样可在 GitHub 仓库页面获取)。