快速开始
从下载页拿到压缩包，解压到任意目录，双击 elytra-gui.exe 即可。
- 系统：Windows 10 / 11 x64。
- Java：不用自己装。Elytra 会按版本要求挑选本机 Java，缺哪个就下 Mojang 官方运行时。
- 首次启动：默认进「启动游戏」页，此时还没有实例，点「前往下载」选一个游戏版本。
配置存在 %APPDATA%\Elytra\config.json，游戏目录默认 %APPDATA%\.minecraft，可在设置页改。
Java 与内存
Elytra 内置 Java 探测顺序：Mojang 运行时 → 本机 JDK → 手动指定。版本窗口按游戏要求取 required..required+5，
宁可用官方运行时也不拿 Java 27 去跑 1.8。
- 1.16.5 及更早：Java 8
- 1.17 – 1.20.4：Java 17
- 1.20.5+ / NeoForge 1.21：Java 21
内存默认 4096 MB，设置页可调（512 – 16384）。-Xms 会自动取 min(内存, 1024)。
安装游戏版本
「下载 › 游戏版本」里可以按「全部 / 正式版 / 快照 / 已安装」筛选，也可以直接搜索。选中后右侧会显示版本详情， 主操作是安装与启动游戏；已安装的版本再点一次就是「重新安装」（用于修复缺失文件）。
安装过程会补齐：客户端 jar、依赖库、资源索引与对象、日志配置。1.16.5 大约 318 MB 资源，网络好时几分钟。
模组加载器
| 加载器 | 来源 | 说明 |
|---|---|---|
| Fabric | meta.fabricmc.net | 列表新的在前，自动选稳定版 |
| Quilt | meta.quiltmc.org | 列表顺序不保证，按版本号数字比较取最高稳定版 |
| Forge | 官方 installer | 调用 --installClient，装完自动补齐资源 |
| NeoForge | 官方 installer | 版本号由 MC 版本反推前缀（1.21.1 → 21.1.） |
入口：「下载 › 游戏版本」右上角的安装模组加载器。选目标版本、选加载器、选具体 loader 版本，点开始安装。
安装完成后会生成一个独立实例，例如 fabric-loader-0.20.1-1.16.5。
模组
「下载 › 模组」分两页：
- 搜索安装：先选目标版本（决定游戏版本与加载器），再搜关键词。行内直接安装，必需依赖会自动带出（最多 4 层）。
- 已安装：列出记录在
elytra-mods.json的模组；工具条有「检查更新」「全部更新（N）」， 可更新的行会显示新版本号和「更新」按钮。手动拖进mods/的 jar 不会出现在记录里。
卸载模组时可选「同时清理孤儿依赖」——只会删非整合包来源、且只被该模组需要的依赖。
整合包
导入：支持 Modrinth 的 .mrpack 与 CurseForge 的整合包 zip。导入会先装原版和对应加载器，
再按清单下载文件（已存在且校验一致就跳过），最后解压包内自带的配置覆盖默认值。重复导入不会产生重复记录。
导出：在「下载 › 整合包」点「导出整合包」，可选：
- Modrinth .mrpack：写
modrinth.index.json，能解析出官方地址的模组只留下载链接。 - CurseForge .zip：写
manifest.json，靠文件指纹反查projectID/fileID。 - 只导出配置：跳过所有模组、不联网，产物约 13 KB，适合做「配置文件预设包」。
解析不到下载地址的文件会被一起打包进整合包，保证导入方一定装得上。
命令行（进阶）
默认下载包只含图形界面。命令行版本面向脚本化使用（批量安装、导出整合包、排查启动参数）， 不随包提供，需要的话可以单独获取；它和图形界面共用同一份配置与游戏目录。常用命令：
elytra list --limit 10 # 版本清单
elytra install 1.16.5 # 装原版
elytra fabric 1.16.5 # 装 Fabric（quilt / forge / neoforge 同理）
elytra launch fabric-loader-0.20.1-1.16.5 --dry-run # 只看启动参数，不真启动
elytra mod search sodium --source modrinth --game 1.16.5 --loader fabric
elytra mod outdated --version fabric-loader-0.20.1-1.16.5
elytra mod update --version fabric-loader-0.20.1-1.16.5
elytra pack import my-pack.mrpack
elytra pack export --format curseforge --version fabric-loader-0.20.1-1.16.5
elytra pack export --config-only --version fabric-loader-0.20.1-1.16.5全局参数：--game-dir、--proxy off|auto|http://host:port、--source auto|official|mirror。
排障时设 ELYTRA_DEBUG_URLS=1 可以打印每个实际请求的 URL。
镜像与代理
- 代理：默认读 Windows「Internet 选项」；开关是关的但本机有 Clash 之类在跑时，会再探测常见端口 （7890 / 7897 / 10809 / 10808 / 1080 / 2080 / 8889 / 20171）。也可在设置里写死或选直连。
- 下载源：
auto（官方优先，失败回退镜像）/official/mirror（BMCLAPI 优先）。 - Quilt 的 Meta 与 Maven 不走镜像：BMCLAPI 上的 Quilt 副本是过期且下钻端点 404 的，加进去只会白等。
- 模组平台（Modrinth / CurseForge）也不走 BMCLAPI 改写，它们是第三方服务。
常见问题
启动就闪退 / 没有任何窗口
先看「日志」页最后 50 行。最常见的是 Java 版本不对（1.20.5+ 必须 Java 21）或内存设置过大。 设置页把内存调回 2048–4096 MB 再试。
下载很慢或者一直 0%
在设置页把下载源切到 mirror，或填写代理。镜像遇到限速时会自动等待重试，必要时回退到官方源。
装完模组进游戏没变化
模组要装到对应实例上：Modrinth 的模组有加载器区分，Forge 模组在 Fabric 实例里不会生效。 另外确认启动的是那个已经装了模组的实例（启动页的实例列表里会标出「上次启动」）。
整合包导入后少模组
如果包里有 CurseForge 文件拿不到下载地址（作者关闭第三方分发），Elytra 会依次尝试镜像的 向平台重新索取下载地址，再到 Modrinth 找同一个文件；都失败时会明确报「N 个文件拿不到下载地址」而不是静默跳过。
需要登录正版账号吗
离线账号开箱即用。微软登录的代码路径是完整的，但需要你自建 Azure 应用 ID 填进设置（涉及凭据合规，默认不带）。