ZL2启动器使用教程

ZL2 简介

产品定位与运行条件

ZL2启动器（Zalith Launcher 2）是一款面向安卓手机和平板的我的世界Java版启动器。它使用 PojavLauncher 作为启动核心，以 Jetpack Compose 和 Material Design 3 构建界面，提供游戏版本安装、模组加载、账号管理、渲染器和触控布局配置。

与旧版项目的关系

ZL2 与旧版 Zalith Launcher 是两个独立项目。ZL2 项目代码使用 GPL-3.0 开源协议。

下载与安装

先安装启动器，再在启动器内安装我的世界Java版游戏。

获取安装文件并完成安装

1. 进入本站下载中心，查看软件信息与安装说明。
2. 点击“立即下载 ZL2”，通过下载入口获取对应安卓安装文件。
3. 下载完成后，在系统下载列表或文件管理器中找到安装文件。
4. 打开安装文件，按照安卓系统实际提示完成安装。根据系统提示确认安装操作。
5. 安装完成后打开 ZL2，按应用显示的提示完成初始设置。

初次启动与账号设置

账号管理用于保存与切换游戏身份。使用微软账号登录需持有我的世界Java版游戏资格，并建立对应游戏档案。

开始授权前请阅读账号信息处理说明和账号使用条款。

完成微软账号授权

1. 打开 ZL2，在主界面顶部点击账号图标，进入账号管理。
2. 选择微软账号或外置认证账号，按对应授权流程登录。离线模式需满足下方使用条件。
3. 使用微软账号时，发起微软登录，等待启动器获取设备码。
4. 在启动器打开的微软授权网页中输入设备码，完成登录与授权。
5. 返回启动器，等待我的世界登录验证完成，确认账号与游戏档案状态。

安装我的世界Java版

启动器用于安装和管理游戏运行环境。开始前先确认账号与目标游戏版本。

选择游戏版本与附加内容

1. 在主界面点击顶部下载图标，进入下载页面。也可以通过版本管理中的下载入口进入。
2. 在游戏版本列表中选择需要游玩的我的世界版本。
3. 查看版本信息，并检查对应运行环境要求。
4. 进入附加内容页，为游戏环境设置一个容易识别且与已有版本不同的名称。按需选择兼容的模组加载器。
5. 确认内容后点击顶部下载按钮。若出现通知或安装提示，按当前应用与系统说明操作。
6. 等待下载与安装任务完成，期间留意任务面板中的状态。
7. 进入版本管理，选择安装完成的版本，返回主界面启动游戏。

游戏版本管理

不同游戏版本可以分别命名和管理。安装后，在版本管理页面确认版本名称、我的世界版本与加载器信息。

管理不同游戏环境

1. 从主界面进入版本管理。
2. 在列表中选择已安装的目标版本，检查游戏版本和附加内容。
3. 为不同玩法使用清晰的版本名称，例如区分原版、Forge 与 Fabric 环境。
4. 进入目标版本的管理页面，按需管理模组、资源包、存档等内容。
5. 启动前确认当前选择的游戏版本与账号，重要存档在迁移或删除前先备份。

版本隔离

版本隔离将不同版本的存档、模组、资源包与配置保存在各自的游戏环境中。隔离后的版本文件夹作为游戏的数据目录传递给我的世界。

确认独立游戏目录

1. 在目标版本的设置中查看游戏目录与版本隔离状态。
2. 在该版本的资源管理页面检查模组、资源包和存档所在位置。
3. 添加资源前确认当前操作的是目标版本的独立环境。
4. 迁移已有数据时先备份，再复制到正确的版本目录，并启动游戏检查。

隔离后的目录结构

.minecraft/
└── versions/
    ├── 原版环境/
    │   ├── saves/
    │   └── resourcepacks/
    └── 模组环境/
        ├── mods/
        ├── config/
        ├── saves/
        └── resourcepacks/

Forge 安装

Forge 是 Java 版传统模组生态中常见的加载器。先根据目标模组的要求确定我的世界版本，再选择加载器。

安装匹配的Forge环境

1. 进入游戏版本下载页面，选择模组要求的我的世界版本。
2. 在附加内容列表中展开 Forge，选择与该游戏版本兼容的 Forge 版本。
3. 为新环境设置独立名称，确认附加内容后点击安装。
4. 等待加载器安装完成，在版本管理中确认 Forge 信息。
5. 将适配该我的世界与 Forge 版本的模组放入对应环境，补齐依赖后启动检查。

Fabric 安装

Fabric 是轻量化的模组加载方案。许多 Fabric 模组还需要 Fabric API，安装前请查看目标模组说明。

选择Fabric与所需依赖

1. 在下载页面选择需要的我的世界版本，进入附加内容列表。
2. 选择兼容的 Fabric Loader 版本。
3. 若目标模组依赖 Fabric API，在可用附加内容中一并选择匹配的 Fabric API。
4. 完成安装后，在版本管理中选择该 Fabric 环境。
5. 添加对应的 Fabric 模组与依赖，检查游戏版本要求后启动。

NeoForge / Quilt

加载器类型与依赖

选择并安装目标加载器

1. 先确认目标模组要求的我的世界版本与加载器类型。
2. 选择游戏版本，在附加内容列表中选择 NeoForge 或 Quilt 的可用版本。
3. 检查目标模组对加载器与附加依赖的要求，再开始安装。
4. 将匹配的模组放入对应环境，启动并检查日志与游戏状态。

模组管理

安装加载器后，在模组下载页面查找资源，根据模组的游戏版本、加载器和依赖要求选择文件。

添加模组与前置依赖

1. 在版本管理中确认目标环境使用的我的世界版本与加载器。
2. 查看模组介绍，核对支持版本、加载器类型以及前置依赖。
3. 通过模组下载页面或文件管理，将模组加入目标版本的 mods 目录。
4. 安装前置依赖后，先少量添加并启动测试，方便定位问题。
5. 出现加载失败时，结合启动日志核对缺失依赖、重复文件与版本冲突。

渲染器配置

渲染器负责将游戏图形调用转换为设备可执行的绘制过程。不同 GPU、驱动与我的世界版本的适配情况存在差异。

按设备与游戏版本选择方案

1. 进入启动器设置中的“渲染设置”，查看渲染器选项。
2. 读取各选项旁标注的我的世界版本或设备条件。
3. 优先测试默认配置，再根据实际图形问题选择适用方案。
4. 每次调整一个选项，使用相同游戏环境测试，记录是否出现黑屏、花屏或闪退。
5. 如果调整后无法正常显示，恢复可用配置，再结合日志排查。

触控布局管理

控制布局是一层与游戏交互的虚拟按键。可以使用已有布局，也可以创建适合自己握持方式的布局。

选择、创建与编辑布局

1. 打开启动器设置，在左侧选择“控制管理”。
2. 在左侧列表中选择已有布局，查看右侧的布局详情。
3. 创建新布局时点击“创建”，填写布局名称，其余可选信息按需填写。
4. 选择目标布局，点击“编辑控制布局”进入编辑器。
5. 通过悬浮球打开编辑器菜单，管理控件层与预览设置。
6. 编辑完成后保存配置，选择该布局并进入游戏检查操作效果。

按键自定义

控件层用于组织虚拟按键，按钮可响应触摸操作。文字显示控件可用于提示信息。

调整虚拟按键和点击事件

1. 进入目标控制布局的编辑器，先选择或创建一个控件层。
2. 通过菜单向当前层添加按钮等控件。
3. 拖动控件调整位置，点击控件打开编辑菜单。
4. 调整尺寸、文本、样式与点击事件，使按键位置符合手指操作习惯。
5. 使用预览功能查看布局效果，保存后进入游戏测试移动、视角和常用操作。
6. 若按键无法响应，检查控件类型、点击事件、控件层可见状态与当前使用的布局。

游戏无法启动

先记录发生问题的游戏环境与现象，再逐项检查，便于找出具体原因。

根据故障现象排查

• 游戏启动失败核对游戏版本、运行环境与渲染器设置。先测试一个独立的原版环境，比较故障是否与模组环境有关。
• 画面卡顿或显示异常根据设备情况降低游戏画面设置和视距。检查当前渲染器的适配要求，每次调整一项后测试。
• 游戏闪退查看最近的启动日志，关注报错信息。备份后暂时移出近期添加的模组与资源，逐项恢复检查。
• 触控按键无法使用确认正在使用的布局已选中并保存，检查按钮事件与控件层可见设置。

模组加载失败

按日志逐项检查

1. 查看日志中最先出现的相关报错，记录模组名称或缺失依赖。
2. 逐项检查模组对应的我的世界版本与加载器类型。
3. 确认所有必需前置模组已经安装，移除同一模组的重复或冲突版本。
4. 确认模组文件位于当前启动版本实际使用的 mods 目录，留意版本隔离设置。
5. 备份游戏数据后，使用少量模组测试，逐批恢复并定位冲突。

常见问题

设备与安装

账号与游戏环境

触控与问题排查