diff options
Diffstat (limited to 'packages/docs/content/zh/manual')
| -rw-r--r-- | packages/docs/content/zh/manual/features/authentication.mdx | 131 | ||||
| -rw-r--r-- | packages/docs/content/zh/manual/features/index.mdx | 176 | ||||
| -rw-r--r-- | packages/docs/content/zh/manual/features/java.mdx | 286 | ||||
| -rw-r--r-- | packages/docs/content/zh/manual/features/meta.json | 9 | ||||
| -rw-r--r-- | packages/docs/content/zh/manual/features/mod-loaders.mdx | 242 | ||||
| -rw-r--r-- | packages/docs/content/zh/manual/getting-started.mdx | 152 | ||||
| -rw-r--r-- | packages/docs/content/zh/manual/index.mdx | 95 | ||||
| -rw-r--r-- | packages/docs/content/zh/manual/meta.json | 10 | ||||
| -rw-r--r-- | packages/docs/content/zh/manual/troubleshooting.mdx | 523 |
9 files changed, 1624 insertions, 0 deletions
diff --git a/packages/docs/content/zh/manual/features/authentication.mdx b/packages/docs/content/zh/manual/features/authentication.mdx new file mode 100644 index 0000000..cd5b622 --- /dev/null +++ b/packages/docs/content/zh/manual/features/authentication.mdx @@ -0,0 +1,131 @@ +--- +title: 身份验证 +description: DropOut 中的 Microsoft OAuth 和离线身份验证 +--- + +# 身份验证 + +DropOut 支持两种身份验证方法：Microsoft 账户（用于官方 Minecraft）和离线模式（用于测试和离线游玩）。 + +## Microsoft 身份验证 + +### 概述 + +DropOut 使用 **Device Code Flow** 进行 Microsoft 身份验证，具有以下特点： +- 无需重定向 URL（无需浏览器集成） +- 适用于任何拥有浏览器的设备 +- 提供简单的基于代码的身份验证 +- 完全符合 Microsoft OAuth 2.0 标准 + +### 身份验证流程 + +身份验证链包含多个步骤。DropOut 自动处理这些复杂的交换过程，包括与 Microsoft、Xbox Live 和 Minecraft 服务的交互。如果您对详细的 API 实现感兴趣，请参阅[内部实现](/docs/development/implementation#1-身份验证系统-authentication)。 + +### 令牌管理 + +**访问令牌：** +- 短期有效（通常为 1 小时） +- 用于游戏身份验证 +- 过期时自动刷新 + +**刷新令牌：** +- 长期有效（通常为 90 天） +- 安全存储在 `accounts.json` 中 +- 用于获取新的访问令牌 + +**自动刷新：** +令牌过期时，DropOut 会在您启动游戏时尝试使用刷新令牌自动更新您的登录状态，确保您可以无缝开始游玩。 + +### 安全考虑 + +- 令牌存储在平台特定的应用数据目录中 +- 所有 API 调用仅使用 HTTPS +- 不存储凭据（仅存储令牌） +- 需要 User-Agent 标头（绕过 MS WAF） + +### Microsoft 登录故障排除 + +**"Device code expired"（设备代码已过期）** +- 代码在 15 分钟后过期 +- 重新开始登录流程 + +**"Authorization pending"（授权待处理）** +- 在等待阶段很正常 +- 在浏览器中完成授权 + +**"Invalid token"（无效令牌）** +- 令牌可能已过期 +- 登出后重新登录 + +**"You don't own Minecraft"（您不拥有 Minecraft）** +- 验证您的 Microsoft 账户拥有 Minecraft Java Edition +- 在 https://www.minecraft.net/profile 检查 + +## 离线身份验证 + +### 概述 + +离线模式创建一个不需要互联网连接或 Microsoft 账户的本地账户。这对以下情况很有用： +- 测试和开发 +- 无网络游玩 +- LAN 多人游戏 +- Mod 开发 + +### 创建离线账户 + +1. 在登录屏幕单击"离线模式" +2. 输入用户名（3-16 个字符） +3. 单击"创建账户" + +### 工作原理 + +**UUID 生成：** +离线模式使用基于用户名的确定性 UUID 生成算法（UUID v3）。这意味着在同一个启动器实例中，相同的用户名始终会获得相同的 UUID，从而保持单人游戏存档的一致性。 + +- 确定性：相同的用户名 = 相同的 UUID +- 无需网络请求 + +**身份验证：** +- 返回 `"null"` 作为访问令牌 +- Minecraft 在离线模式下接受空令牌 +- 用户名和 UUID 本地存储 + +### 限制 + +- 无法加入在线服务器 +- 不支持皮肤 +- 不支持披风 +- 无法使用 Microsoft 账户功能 + +## 账户管理 + +### 切换账户 + +目前 DropOut 一次只支持一个活跃账户。多账户支持正在规划中。 + +**切换账户的步骤：** +1. 登出当前账户 +2. 使用新账户登录 + +### 账户存储 + +账户数据存储在应用文件夹的 `accounts.json` 中。该文件包含已登录账户的加密令牌、过期时间和基本的个人资料信息。 + +### 删除账户 + +删除账户的步骤： +1. 打开设置 +2. 导航到账户 +3. 单击"登出" +4. 或手动删除 `accounts.json` + +## API 参考 + +关于身份验证的底层实现、OAuth 2.0 流程细节以及相关的 Tauri 命令接口，请参考开发文档：[实现细节：身份验证](../development/implementation.mdx#1-身份验证系统-authentication)。 + +## 最佳实践 + +1. **对官方服务器使用 Microsoft 账户**：为了能够加入官方服务器并使用正版皮肤，请务必使用 Microsoft 账户。 +2. **保护令牌安全**：不要向他人分享 `accounts.json` 文件或其内容，因为其中包含您的登录凭据。 +3. **定期刷新令牌**：长时间未使用的离线账户或过期的 Microsoft 令牌可以通过重新登录或启动游戏来刷新。 +4. **仅在测试时使用离线模式**：离线模式不支持皮肤和部分多人游戏功能。 diff --git a/packages/docs/content/zh/manual/features/index.mdx b/packages/docs/content/zh/manual/features/index.mdx new file mode 100644 index 0000000..bb53ce2 --- /dev/null +++ b/packages/docs/content/zh/manual/features/index.mdx @@ -0,0 +1,176 @@ +--- +title: 功能概览 +description: DropOut 所有功能的综合指南 +--- + +# 功能概览 + +DropOut 功能丰富，既适合休闲玩家也适合高级用户。本指南涵盖所有主要功能。 + +## 核心功能 + +<Cards> + <Card + title="身份验证" + href="authentication" + description="Microsoft OAuth 和离线身份验证" + /> + <Card + title="Java 管理" + href="java" + description="Java 运行时的自动检测和安装" + /> + <Card + title="模组加载器" + href="mod-loaders" + description="Fabric 和 Forge 支持，轻松安装" + /> + <Card + title="实例" + href="instances" + description="具有独立配置的隔离游戏环境" + /> + <Card + title="下载" + href="downloads" + description="快速并发下载，支持断点续传" + /> + <Card + title="AI 助手" + href="assistant" + description="内置 AI 助手用于故障排除和指导" + /> +</Cards> + +## 快速功能矩阵 + +| 功能 | 状态 | 描述 | +|---------|--------|-------------| +| Microsoft 身份验证 | 完成 | 使用设备代码流的 OAuth 2.0 | +| 离线身份验证 | 完成 | 用于离线游玩的本地账户 | +| 令牌自动刷新 | 完成 | 自动刷新过期的令牌 | +| Java 自动检测 | 完成 | 扫描系统中的 Java 安装 | +| Java 下载 | 完成 | 下载 Adoptium JDK/JRE 版本 | +| Fabric 支持 | 完成 | 安装和启动 Fabric 加载器 | +| Forge 支持 | 完成 | 安装和启动 Forge 加载器 | +| 实例系统 | 完成 | 隔离的游戏环境 | +| GitHub 集成 | 完成 | 查看发布和更新日志 | +| 并发下载 | 完成 | 多线程资源下载 | +| 断点续传 | 完成 | 恢复中断的下载 | +| AI 助手 | 完成 | 内置故障排除助手 | +| 配置编辑器 | 完成 | JSON/TOML 配置编辑器 | +| 自定义分辨率 | 完成 | 设置游戏窗口尺寸 | +| 内存分配 | 完成 | 自定义 JVM 内存设置 | +| 多账户 | 进行中 | 在多个账户之间切换 | +| 模组管理器 | 计划中 | 在启动器中启用/禁用模组 | +| 启动器自动更新 | 计划中 | 自我更新机制 | +| 自定义游戏目录 | 计划中 | 选择游戏文件位置 | +| 导入配置文件 | 计划中 | 从 MultiMC/Prism 导入 | + +## 性能功能 + +### 并发下载 +- 可配置的线程数（默认：10） +- 并行资源和库下载 +- 每个文件的进度跟踪 +- ETA 计算 + +### 断点续传支持 +- 中断的下载自动恢复 +- `.part` 文件跟踪进度 +- 大文件的多段下载 +- 用于状态跟踪的元数据文件 + +### 缓存 +- Java 目录缓存 24 小时 +- 本地缓存版本清单 +- 资源索引缓存 +- 库去重 + +## 用户界面功能 + +### 现代设计 +- 强制暗色模式保护眼睛 +- 粒子背景效果 +- 简洁、无干扰的布局 +- 响应式设计 + +### 实时反馈 +- 实时下载进度 +- 游戏控制台输出 +- 日志流 +- Toast 通知 + +### 设置管理 +- 内存分配滑块 +- 分辨率自定义 +- Java 路径选择 +- 线程数配置 +- 自定义 JVM 参数 + +## 高级功能 + +### 版本继承 +模组版本（Fabric/Forge）自动从父原版版本继承： +- 从父版本 + 模组加载器合并库 +- 组合并去重参数 +- 从原版版本继承资源 + +### 原生库提取 +- 特定平台的原生提取 +- 自动清理 +- 正确的库路径配置 + +### 规则引擎 +- 特定操作系统的库过滤 +- 功能标志支持 +- 架构检测 + +### 下载队列持久化 +- 保存未完成的下载 +- 启动器重启后恢复 +- 队列优先级管理 + +## 开发者功能 + +### 配置编辑器 +内置 JSON/TOML 编辑器，具有： +- 语法高亮 +- 验证 +- 快速访问所有配置 + +### 日志访问 +- 实时游戏日志 +- 启动器调试日志 +- 复制/导出功能 + +### AI 助手 +- 故障排除指导 +- 错误分析 +- 配置帮助 +- 文档搜索 + +## 即将推出 + +### 多账户管理 +- 轻松切换账户 +- 账户配置文件 +- 快速切换 + +### 模组管理器 +- 浏览和安装模组 +- 启用/禁用模组 +- 模组兼容性检查 +- 版本管理 + +### 配置文件导入 +- 从 MultiMC 导入 +- 从 Prism Launcher 导入 +- 从其他启动器导入 +- 保留设置和存档 + +### 启动器自动更新 +- 后台更新检查 +- 一键更新 +- 版本历史 +- 回滚支持 diff --git a/packages/docs/content/zh/manual/features/java.mdx b/packages/docs/content/zh/manual/features/java.mdx new file mode 100644 index 0000000..6894ec1 --- /dev/null +++ b/packages/docs/content/zh/manual/features/java.mdx @@ -0,0 +1,286 @@ +--- +title: Java 管理 +description: 自动 Java 检测、下载和安装 +--- + +# Java 管理 + +DropOut 提供全面的 Java 管理，自动检测已安装的版本并根据需要下载新版本。 + +## 自动检测 + +### 系统扫描 + +DropOut 扫描多个位置查找 Java 安装： + +**Linux:** +- `/usr/lib/jvm/` +- `/usr/java/` +- `$JAVA_HOME` +- `PATH` 环境变量 + +**macOS:** +- `/Library/Java/JavaVirtualMachines/` +- `/System/Library/Java/JavaVirtualMachines/` +- `$JAVA_HOME` +- `PATH` 环境变量 + +**Windows:** +- `C:\Program Files\Java\` +- `C:\Program Files (x86)\Java\` +- `%JAVA_HOME%` +- `PATH` 环境变量 +- Windows 注册表 + +### 版本检测 + +对于找到的每个 Java 安装，DropOut 会： +1. 运行 `java -version` 获取版本信息 +2. 解析主要版本（8、11、17、21 等） +3. 检测架构（x64、ARM64） +4. 识别供应商（Oracle、Adoptium 等） + +### 结果 + +所有检测到的 Java 安装都显示在设置 → Java 中： +- 版本号 +- 安装路径 +- 架构 +- 当前选择状态 + +## Java 下载 + +### Adoptium 集成 + +DropOut 集成了 Eclipse Adoptium API 以下载高质量的免费 JDK/JRE 构建版本。 + +**支持的版本：** +- Java 8（LTS） +- Java 11（LTS） +- Java 17（LTS） +- Java 21（LTS） +- Java 23+（最新版） + +**功能：** +- 自动平台检测 +- 特定架构的构建版本 +- JDK 或 JRE 选择 +- 校验和验证 + +### 下载过程 + +1. 导航到设置 → Java +2. 点击"下载 Java" +3. 选择版本（例如 Java 17） +4. 选择 JDK 或 JRE +5. 点击下载 +6. 等待下载和解压 + +**进度跟踪：** +- 实时下载速度 +- ETA 计算 +- 解压进度 +- 安装确认 + +### 目录管理 + +DropOut 会缓存可用的 Java 版本列表，以加快加载速度，并自动处理不同步时的刷新工作。 + +**刷新：** +- 24 小时后自动刷新 +- 设置中手动刷新 +- 下载失败时强制刷新 + +## 安装 + +### 下载目录 + +下载的 Java 运行时安装到： + +``` +~/.local/share/com.dropout.launcher/java/ (Linux) +~/Library/Application Support/com.dropout.launcher/java/ (macOS) +%APPDATA%/com.dropout.launcher/java/ (Windows) +``` + +### 目录结构 + +``` +java/ +├── jdk-17.0.9+9/ +│ ├── bin/ +│ │ └── java (或 java.exe) +│ └── lib/ +├── jdk-21.0.1+12/ +│ ├── bin/ +│ └── lib/ +└── download_queue.json +``` + +### 解压 + +1. 下载到 `.part` 文件 +2. 验证校验和 +3. 解压存档： + - Linux/macOS 上的 `.tar.gz` + - Windows 上的 `.zip` +4. 移动到 `java/<version>/` 目录 +5. 设置可执行权限（Unix） + +## 配置 + +### 内存分配 + +在设置中配置 JVM 内存： + +**最小内存：** +- 默认：1024 MB +- 推荐：原版 2048 MB +- 推荐：模组 4096+ MB + +**最大内存：** +- 默认：4096 MB +- 根据系统 RAM 调整 +- 为操作系统和其他应用留出 4GB + +**格式：** +```bash +-Xms1024M -Xmx4096M +``` + +### 自定义 JVM 参数 + +为高级配置添加自定义 JVM 参数。DropOut 为您提供了经过优化的默认配置，通常无需手动更改。 + +**参数说明：** +- **垃圾回收 (GC)**: 默认使用 G1GC，能够大幅减少大规模模组环境下的游戏卡顿。 +- **实验性选项**: 部分性能优化参数需要开启此开关才能生效。 +- **内存分块**: 优化大内存环境下的数据读写效率。 + +关于每个参数的具体作用、推荐数值以及技术实现，请参考 [实现细节：JVM 参数优化](../development/implementation.mdx#参数优化与-jvm-配置)。 + +### Java 路径选择 + +**自动选择：** +- DropOut 为每个 Minecraft 版本推荐最佳 Java 版本 +- Java 8 用于 Minecraft 1.12.2 及更早版本 +- Java 17 用于 Minecraft 1.18-1.20.4 +- Java 21 用于 Minecraft 1.20.5+ + +**手动选择：** +1. 前往设置 → Java +2. 从检测到的安装中选择 +3. 或指定自定义路径 + +## 版本推荐 + +### Minecraft 版本 → Java 版本 + +| Minecraft 版本 | 推荐 Java | 最低 Java | +|-------------------|------------------|--------------| +| 1.7.10 及更早 | Java 8 | Java 8 | +| 1.8 - 1.12.2 | Java 8 | Java 8 | +| 1.13 - 1.16.5 | Java 8 或 11 | Java 8 | +| 1.17 - 1.17.1 | Java 16 | Java 16 | +| 1.18 - 1.20.4 | Java 17 | Java 17 | +| 1.20.5+ | Java 21 | Java 21 | + +### 模组 Minecraft + +**Fabric:** +- 通常与原版要求匹配 +- 一些模组可能需要更新的 Java + +**Forge:** +- 可能需要特定的 Java 版本 +- 检查模组加载器文档 +- 通常需要完全匹配版本 + +## 故障排除 + +### 未检测到 Java + +**问题：** 已安装的 Java 未显示 + +**解决方案：** +1. 验证 Java 在标准位置 +2. 检查 `JAVA_HOME` 环境变量 +3. 将 Java `bin` 目录添加到 `PATH` +4. 重启 DropOut +5. 手动选择路径 + +### 下载失败 + +**问题：** Java 下载未完成 + +**解决方案：** +1. 检查互联网连接 +2. 验证磁盘空间 +3. 尝试不同版本 +4. 清除下载队列 +5. 从 Adoptium 手动下载 + +### Java 版本错误 + +**问题：** 由于 Java 版本导致游戏崩溃 + +**解决方案：** +1. 检查 Minecraft 版本要求 +2. 下载正确的 Java 版本 +3. 在设置中选择适当的 Java +4. 验证 Java 路径正确 + +### 内存不足错误 + +**问题：** 游戏因内存错误崩溃 + +**解决方案：** +1. 增加最大内存分配 +2. 关闭其他应用程序 +3. 升级系统 RAM +4. 使用 64 位 Java +5. 优化 JVM 参数 + +### 性能问题 + +**问题：** 低 FPS 或卡顿 + +**解决方案：** +1. 调整内存分配（不要太高！） +2. 启用 G1GC 垃圾收集器 +3. 添加性能 JVM 参数 +4. 如兼容使用更新的 Java 版本 +5. 为整合包分配 4-8GB + +## 最佳实践 + +### 对于玩家 + +1. **使用 Adoptium 构建版本** - 免费、高质量、维护良好 +2. **Java 与 Minecraft 版本匹配** - 检查版本要求 +3. **不要过度分配内存** - 为操作系统留出 RAM +4. **保持 Java 更新** - 安全性和性能 +5. **使用 64 位 Java** - 大内存所需 + +## 高级主题 + +### 自定义 Java 安装 + +使用自定义 Java 安装： + +1. 手动安装 Java +2. 记录安装路径 +3. 在 DropOut 设置 → Java 中 +4. 点击"自定义路径" +5. 浏览到 Java 可执行文件 +6. 验证版本正确 + +### GraalVM + +GraalVM 支持高级用户： + +1. 从 graalvm.org 下载 GraalVM +2. 手动安装 +3. 作为自定义 Java 添加到 DropOut +4. 可能提高性能 +5. 使用前彻底测试 diff --git a/packages/docs/content/zh/manual/features/meta.json b/packages/docs/content/zh/manual/features/meta.json new file mode 100644 index 0000000..2fb2ded --- /dev/null +++ b/packages/docs/content/zh/manual/features/meta.json @@ -0,0 +1,9 @@ +{ + "title": "功能特性", + "pages": [ + "index", + "authentication", + "java", + "mod-loaders" + ] +} diff --git a/packages/docs/content/zh/manual/features/mod-loaders.mdx b/packages/docs/content/zh/manual/features/mod-loaders.mdx new file mode 100644 index 0000000..cbd8148 --- /dev/null +++ b/packages/docs/content/zh/manual/features/mod-loaders.mdx @@ -0,0 +1,242 @@ +--- +title: 模组加载器 +description: Fabric 和 Forge 安装和管理 +--- + +# 模组加载器 + +DropOut 支持两个最流行的 Minecraft 模组加载器：Fabric 和 Forge。两者都可以直接从启动器中轻松安装和管理。 + +## Fabric 支持 + +### 概述 + +Fabric 是一个轻量级、模块化的模组工具链，专注于： +- 快速更新至新的 Minecraft 版本 +- 干净、极简的 API +- 强大的开发者社区 +- 优异的性能 + +### 安装 + +1. 导航至 **Versions** 选项卡 +2. 点击 **"Install Fabric"** +3. 选择 Minecraft 版本 +4. 选择 Fabric 加载器版本 +5. 点击 **"Install"** +6. 等待安装完成 + +### 工作原理 + +DropOut 集成了 Fabric 的 Meta API，能够自动获取兼容的加载器版本。在后台，它会生成版本 JSON，处理库依赖，并利用继承系统确保与原版 Minecraft 的完美兼容。详细的 JSON 结构可参阅[技术细节](/docs/development/implementation#fabric-集成)。 + +### Fabric 版本 + +**加载器版本：** +- 最新稳定版（推荐） +- 用于兼容性的特定版本 +- Beta/快照版本 + +**游戏版本：** +- 所有 1.14+ 的 Minecraft 版本 +- 支持快照版本 +- 支持战斗测试版本 + +### 库管理 + +Fabric 的依赖项通常托管在其官方 Maven 仓库中。DropOut 自动解析并下载所有必需的库文件。 + +### Fabric API + +Fabric Loader ≠ Fabric API： +- **Fabric Loader**: 模组加载器（由 DropOut 安装） +- **Fabric API**: 库模组（单独下载） + +许多模组需要 Fabric API： +1. 从 [Modrinth](https://modrinth.com/mod/fabric-api) 或 [CurseForge](https://www.curseforge.com/minecraft/mc-mods/fabric-api) 下载 +2. 放置在实例的 `mods/` 文件夹中 + +## Forge 支持 + +### 概述 + +Forge 是原始的、最流行的 Minecraft 模组加载器： +- 广泛的模组生态系统 +- 成熟的 API +- 广泛的版本支持 +- 庞大的社区 + +### 安装 + +1. 导航至 **Versions** 选项卡 +2. 点击 **"Install Forge"** +3. 选择 Minecraft 版本 +4. 选择 Forge 版本 +5. 点击 **"Install"** +6. 等待安装程序运行 +7. 安装完成 + +### 工作原理 + +DropOut 会为您下载 Forge 安装程序。通过在后台以无头模式运行安装程序，我们能够生成所需的版本配置文件并处理复杂的补丁程序。详细实现请参考[技术实现](/docs/development/implementation#forge-支持)。 + +### Forge 版本 + +**发布类型：** +- **Latest**: 最新的稳定版本 +- **Recommended**: 生产环境中最稳定的版本 +- **Specific**: 版本锁定以确保兼容性 + +**Minecraft 版本支持：** +- 旧版本 (1.6.4+) +- 现代版本 (1.13+) +- 最新版本 (1.20+) + +### 库管理 + +Forge 的运行依赖于大量的库文件，包括底层的 `fmlloader` 和字节码操作库。DropOut 能够自动解析复杂的依赖树，并从 Forge 官方 Maven 仓库以及 Minecraft 官方库中获取这些文件。 + +关于 Forge 库的详细解析逻辑，请参考[实现细节：Forge 核心库解析](../development/implementation.mdx#核心库解析)。 + +### Forge 处理器 + +某些 Forge 版本在安装期间运行"处理器"： +- 字节码操纵 +- 库修补 +- 映射生成 + +DropOut 自动处理这些操作。 + +## 版本继承 + +Fabric 和 Forge 都利用了 Minecraft 的版本继承机制。在这种模式下，模组加载器的版本 JSON 仅包含相对于原版版本的增量变化，通过 `inheritsFrom` 字段递归向上寻址。 + +DropOut 的启动引擎能够自动处理这种复杂的合并： +- **库 (Libraries)**：自动排重并确保加载顺序。 +- **参数 (Arguments)**：合并游戏参数与 JVM 参数。 +- **主类 (Main Class)**：自动切换至模组加载器的入口点。 + +具体的合并逻辑和代码实现请查看[实现细节：版本合并](../development/implementation.mdx#版本合并机制)。 + +## 对比 + +| 功能 | Fabric | Forge | +|---------|--------|-------| +| **性能** | 优异 | 良好 | +| **更新速度** | 非常快 | 中等 | +| **模组选择** | 增长中 | 广泛 | +| **API 简洁性** | 简洁 | 复杂 | +| **版本支持** | 1.14+ | 1.6.4+ | +| **开发者友好** | 非常友好 | 中等 | +| **稳定性** | 优异 | 优异 | + +## 安装模组 + +### Fabric 模组 + +1. 创建/选择实例 +2. 确保 Fabric 已安装 +3. 从以下位置下载模组： + - [Modrinth](https://modrinth.com/) + - [CurseForge](https://www.curseforge.com/) + - [GitHub Releases](https://github.com/) +4. 将 `.jar` 文件放置在 `instances/<name>/mods/` +5. 启动游戏 + +**兼容性：** +- 检查 Minecraft 版本 +- 检查 Fabric Loader 版本 +- 检查 Fabric API 需求 +- 阅读模组依赖项 + +### Forge 模组 + +1. 创建/选择实例 +2. 确保 Forge 已安装 +3. 从以下位置下载模组： + - [CurseForge](https://www.curseforge.com/) + - [Modrinth](https://modrinth.com/) +4. 将 `.jar` 文件放置在 `instances/<name>/mods/` +5. 启动游戏 + +**兼容性：** +- 精确检查 Minecraft 版本 +- 检查 Forge 版本范围 +- 阅读模组依赖项 +- 检查冲突 + +## 故障排除 + +### Fabric 问题 + +**"Fabric Loader not found"** +- 重新安装 Fabric +- 检查版本 JSON 是否存在 +- 验证库是否已下载 + +**"Mixin apply failed"** +- 模组不兼容 +- 删除冲突的模组 +- 更新 Fabric Loader + +**"Fabric API required"** +- 下载 Fabric API +- 匹配 Minecraft 版本 +- 放置在 mods 文件夹中 + +### Forge 问题 + +**"Forge installer failed"** +- 验证 Java 安装 +- 检查磁盘空间 +- 尝试旧版本的 Forge +- 检查日志获取详细信息 + +**"Missing dependencies"** +- 安装所需的模组 +- 检查模组版本兼容性 +- 仔细阅读错误消息 + +**"Class not found"** +- Forge 版本不匹配 +- 重新安装 Forge +- 验证库是否已下载 + +### 常见模组问题 + +**启动时崩溃：** +1. 检查崩溃报告 +2. 识别有问题的模组 +3. 删除或更新模组 +4. 使用最少的模组测试 +5. 逐步添加模组回来 + +**性能问题：** +1. 安装了太多模组 +2. 增加内存分配 +3. 安装性能模组： + - Fabric: Sodium, Lithium + - Forge: OptiFine, Magnesium +4. 删除资源密集型模组 + +## API 参考 + +如果您正在为 DropOut 开发自定义主题或进行二次开发，可以使用我们提供的 Tauri 命令和事件接口。 + +具体的命令接口、参数说明及进度推送事件详见开发文档：[实现细节：模组加载器 API](../development/implementation.mdx#api-参考)。 + +## 最佳实践 + +1. **每个实例选择一个模组加载器**：不要在同一个实例中混用 Fabric 和 Forge。 +2. **精确匹配版本**：确保 Minecraft 版本与模组加载器版本高度兼容。 +3. **安装前阅读要求**：许多模组需要额外的依赖库（如 Fabric API 或 Architectury）。 +4. **循序渐进**：首次构建模组包时，应分批添加模组以便于排查问题。 +5. **养成备份习惯**：在安装大型模组包或进行版本大更新前，请备份您的存档。 + +更多面向开发者和模组包创作者的进阶指南，请参阅[开发文档：分发最佳实践](../development/implementation.mdx#对于模组包modpack创建者)。 + +## 规划与展望 + +我们致力于为 DropOut 打造最便捷的模组体验。未来，我们计划引入模组浏览器、自动更新监控以及智能冲突检测等功能。 + +详见[开发路线图](../development/implementation.mdx#模组管理系统)。 diff --git a/packages/docs/content/zh/manual/getting-started.mdx b/packages/docs/content/zh/manual/getting-started.mdx new file mode 100644 index 0000000..5d8c8c5 --- /dev/null +++ b/packages/docs/content/zh/manual/getting-started.mdx @@ -0,0 +1,152 @@ +--- +title: 快速开始 +description: 使用 DropOut Minecraft 启动器的快速入门指南 +--- + +# 快速开始 + +DropOut 是一个使用 Tauri v2 构建的现代化、可复现、开发者级别的 Minecraft 启动器。本指南将帮助你开始安装和使用 DropOut。 + +## 安装 + +### 下载预编译二进制文件 + +从[发布页面](https://github.com/HsiangNianian/DropOut/releases)下载适合你平台的最新版本。 + +| 平台 | 文件 | +| -------------- | ------------------- | +| Linux x86_64 | `.deb`, `.AppImage` | +| Linux ARM64 | `.deb`, `.AppImage` | +| macOS ARM64 | `.dmg` | +| Windows x86_64 | `.msi`, `.exe` | +| Windows ARM64 | `.msi`, `.exe` | + +### Linux 安装 + +#### 使用 .deb 包 + +```bash +sudo dpkg -i dropout_*.deb +# 如果需要，修复依赖 +sudo apt-get install -f +``` + +#### 使用 AppImage + +```bash +chmod +x dropout_*.AppImage +./dropout_*.AppImage +``` + +### macOS 安装 + +1. 打开下载的 `.dmg` 文件 +2. 将 DropOut 拖到应用程序文件夹 +3. 如果看到安全警告，转到系统偏好设置 → 安全性与隐私并允许该应用 + +### Windows 安装 + +#### 使用 .msi 安装程序 + +1. 双击 `.msi` 文件 +2. 按照安装向导操作 +3. 从开始菜单启动 DropOut + +#### 使用 .exe 便携版 + +1. 双击 `.exe` 文件 +2. DropOut 将直接运行，无需安装 + +## 首次启动 + +首次启动 DropOut 时，你需要： + +1. **选择认证方式** + - **微软账户**: 推荐用于官方 Minecraft + - **离线模式**: 用于测试或离线游戏 + +2. **配置 Java 运行时** + - DropOut 将自动检测已安装的 Java 版本 + - 如果需要，你可以直接从启动器下载 Java + +3. **选择 Minecraft 版本** + - 浏览可用的 Minecraft 版本 + - 选择原版或模组版本（Fabric/Forge） + +## 快速入门教程 + +### 1. 登录 + +<Cards> + <Card title="微软账户" description="使用你的官方 Minecraft 账户登录" /> + <Card title="离线模式" description="创建本地配置文件进行离线游戏" /> +</Cards> + +**微软登录：** + +1. 点击"使用微软登录" +2. 将显示设备代码 +3. 访问显示的 URL 并输入代码 +4. 授权应用程序 +5. 返回 DropOut - 你将自动登录 + +**离线登录：** + +1. 点击"离线模式" +2. 输入用户名 +3. 点击"创建账户" + +### 2. 安装 Minecraft + +1. 导航到**版本**标签 +2. 浏览可用的 Minecraft 版本 +3. 点击一个版本进行安装 +4. 等待下载完成 + +### 3. 启动游戏 + +1. 转到**主页**标签 +2. 从下拉菜单中选择你想要的版本 +3. 如果需要，调整设置： + - 内存分配（RAM） + - 窗口分辨率 + - Java 路径 +4. 点击**启动游戏** +5. 在控制台中监视启动过程 + +## 下一步 + +<Cards> + <Card title="功能特性" href="/docs/manual/features" description="了解 DropOut 提供的所有功能" /> + <Card title="实例管理" href="/docs/manual/features/instances" description="创建隔离的游戏环境" /> + <Card + title="模组加载器" + href="/docs/manual/features/mod-loaders" + description="安装和管理 Fabric 和 Forge" + /> + <Card title="故障排除" href="/docs/troubleshooting" description="常见问题和解决方案" /> +</Cards> + +## 系统要求 + +### 最低要求 + +- **操作系统**: Windows 10+、macOS 11+ 或 Linux（基于 Debian） +- **内存**: 4GB（推荐 8GB 用于模组 Minecraft） +- **存储**: 启动器 + 游戏文件需要 2GB +- **Java**: 如果找不到，DropOut 会自动安装 + +### 推荐配置 + +- **操作系统**: 你操作系统的最新稳定版本 +- **内存**: 16GB 以获得带模组的最佳性能 +- **存储**: 10GB+ 用于多个版本和模组 +- **Java**: Java 17 或 21（由 DropOut 管理） + +## 获取帮助 + +如果遇到问题： + +- 查看[故障排除指南](/docs/troubleshooting) +- 在 [GitHub Issues](https://github.com/HsiangNianian/DropOut/issues) 上报告 bug +- 加入我们的社区讨论 diff --git a/packages/docs/content/zh/manual/index.mdx b/packages/docs/content/zh/manual/index.mdx new file mode 100644 index 0000000..1b74743 --- /dev/null +++ b/packages/docs/content/zh/manual/index.mdx @@ -0,0 +1,95 @@ +--- +title: 欢迎使用 DropOut +description: 现代化、可复现、开发者级别的 Minecraft 启动器 +--- + +# 欢迎使用 DropOut + +DropOut 是一个使用 Tauri v2 构建的现代 Minecraft 启动器，专为重视控制、透明度和长期稳定性的玩家设计。 + +<div style={{ textAlign: 'center', margin: '2rem 0' }}> + <img src="/image.png" alt="DropOut 启动器" style={{ maxWidth: '700px', borderRadius: '8px' }} /> +</div> + +## 为什么选择 DropOut？ + +大多数 Minecraft 启动器专注于让你进入游戏。DropOut 专注于保持你的游戏**稳定**、**可调试**和**可复现**。 + +- 你的实例昨天还能用，今天就坏了？→ **DropOut 让它可追溯。** +- 分享模组包意味着打包数GB的文件？→ **DropOut 分享精确的依赖清单。** +- Java、加载器、模组、配置不同步？→ **DropOut 将它们锁定在一起。** + +这个启动器是为重视控制、透明度和长期稳定性的玩家构建的。 + +## 快速链接 + +<Cards> + <Card + title="快速开始" + href="getting-started" + description="在几分钟内安装和设置 DropOut" + /> + <Card + title="功能特性" + href="features" + description="探索 DropOut 的所有功能" + /> + <Card + title="架构设计" + href="architecture" + description="了解技术设计" + /> + <Card + title="开发指南" + href="development" + description="构建和贡献代码" + /> +</Cards> + +## 核心特性 + +### 高性能 +使用 Rust 和 Tauri 构建，资源占用最小，启动速度极快。 + +### 现代化界面 +简洁、无干扰的界面，使用 Svelte 5、Tailwind CSS 4 和粒子效果。 + +### 安全认证 +微软 OAuth 2.0 设备代码流和离线认证支持。 + +### 模组加载器支持 +内置 Fabric 和 Forge 安装，自动版本管理。 + +### Java 管理 +自动检测已安装的 Java 版本，集成 Adoptium JDK/JRE 下载器。 + +### 实例系统 +独立的游戏环境，具有独立的配置、模组和存档。 + +### AI 助手 +内置 AI 帮助，用于故障排除、配置和指导。 + +### 快速下载 +并发资源和库下载，支持断点续传和进度跟踪。 + +## 技术栈 + +- **后端**: Rust + Tauri v2 +- **前端**: Svelte 5 with runes +- **样式**: Tailwind CSS 4 +- **构建工具**: Vite with Rolldown +- **文档**: Fumadocs with React Router + +## 社区 + +- **GitHub**: [HydroRoll-Team/DropOut](https://github.com/HydroRoll-Team/DropOut) +- **问题反馈**: [报告 bug](https://github.com/HydroRoll-Team/DropOut/issues) +- **开发路线图**: [查看开发路线图](https://roadmap.sh/r/minecraft-launcher-dev) + +## 许可证 + +DropOut 是在 MIT 许可证下的开源软件。 + +--- + +准备好开始了吗？查看[快速开始指南](getting-started)！ diff --git a/packages/docs/content/zh/manual/meta.json b/packages/docs/content/zh/manual/meta.json new file mode 100644 index 0000000..cc3767a --- /dev/null +++ b/packages/docs/content/zh/manual/meta.json @@ -0,0 +1,10 @@ +{ + "title": "使用文档", + "pages": [ + "index", + "getting-started", + "architecture", + "features", + "troubleshooting" + ] +} diff --git a/packages/docs/content/zh/manual/troubleshooting.mdx b/packages/docs/content/zh/manual/troubleshooting.mdx new file mode 100644 index 0000000..ba0ec66 --- /dev/null +++ b/packages/docs/content/zh/manual/troubleshooting.mdx @@ -0,0 +1,523 @@ +--- +title: 故障排除 +description: DropOut 启动器常见问题和解决方案 +--- + +# 故障排除 + +本指南涵盖常见问题及其解决方案。如果在这里找不到你的问题，请在 GitHub 上[提交 issue](https://github.com/HydroRoll-Team/DropOut/issues)。 + +## 安装问题 + +### Linux：缺少依赖 + +**问题：** 安装时提示缺少库 + +**解决方案：** +```bash +# Ubuntu/Debian +sudo apt update +sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0 + +# Fedora +sudo dnf install webkit2gtk4.1 gtk3 + +# Arch +sudo pacman -S webkit2gtk gtk3 +``` + +### macOS："应用程序已损坏" + +**问题：** macOS 提示 DropOut 已损坏无法打开 + +**解决方案：** +1. 打开终端 +2. 运行：`xattr -cr /Applications/DropOut.app` +3. 再次尝试打开 +4. 或者：系统偏好设置 → 安全性 → 仍要打开 + +### Windows：SmartScreen 警告 + +**问题：** Windows SmartScreen 阻止安装程序 + +**解决方案：** +1. 点击"更多信息" +2. 点击"仍要运行" +3. 这对于没有扩展验证证书的新应用是正常的 + +## 身份验证问题 + +### Microsoft 登录失败 + +**问题：** 无法完成 Microsoft 登录 + +**可能原因和解决方案：** + +**1. 设备代码过期：** +- 代码在 15 分钟后过期 +- 重新开始登录过程 +- 更快地完成授权 + +**2. 网络问题：** +- 检查互联网连接 +- 暂时禁用 VPN +- 检查防火墙设置 +- 尝试不同的网络 + +**3. Microsoft 账户问题：** +- 验证账户拥有 Minecraft Java 版 +- 在 https://www.minecraft.net/profile 检查 +- 确保账户未被封禁 + +**4. 浏览器问题：** +- 尝试不同的浏览器 +- 清除浏览器缓存 +- 禁用广告拦截器 +- 使用无痕/隐私模式 + +### 令牌刷新失败 + +**问题：** 令牌刷新失败，必须频繁重新登录 + +**解决方案：** +1. 完全退出登录 +2. 从应用数据目录删除 `accounts.json` +3. 重新登录 +4. 如果持续存在，检查 Microsoft 账户状态 + +### 离线登录不工作 + +**问题：** 无法创建离线账户 + +**解决方案：** +- 用户名必须是 3-16 个字符 +- 仅使用字母、数字、下划线 +- 不使用特殊字符 +- 不使用空格 + +## 游戏启动问题 + +### 找不到 Java + +**问题：** "未找到 Java 安装" + +**解决方案：** + +**1. 自动检测现有 Java：** +- 设置 → Java → 检测安装 +- 如果找到，选择它 +- 如果未找到，进行步骤 2 + +**2. 通过 DropOut 下载 Java：** +- 设置 → Java → 下载 Java +- 选择适当的版本： + - Java 8 用于 Minecraft 1.12.2 及更早版本 + - Java 17 用于 Minecraft 1.18-1.20.4 + - Java 21 用于 Minecraft 1.20.5+ + +**3. 手动安装 Java：** +- 从 [Adoptium](https://adoptium.net/) 下载 +- 安装到系统 +- 重启 DropOut +- 再次检测 + +### Java 版本错误 + +**问题：** 游戏崩溃并提示"不支持的类文件版本" + +**解决方案：** +将 Java 版本与 Minecraft 版本匹配： + +| Minecraft 版本 | Java 版本 | +|-------------------|--------------| +| 1.7.10 及更早 | Java 8 | +| 1.8 - 1.12.2 | Java 8 | +| 1.13 - 1.16.5 | Java 8 或 11 | +| 1.17 - 1.17.1 | Java 16 | +| 1.18 - 1.20.4 | Java 17 | +| 1.20.5+ | Java 21 | + +### 内存不足错误 + +**问题：** 游戏崩溃并显示 `java.lang.OutOfMemoryError` + +**解决方案：** + +**1. 增加内存分配：** +- 设置 → 内存 +- 增加最大内存： + - 原版：最少 4GB + - 轻度模组：6GB + - 重度整合包：8-12GB +- 不要超过系统 RAM 的 80% + +**2. 使用 64 位 Java：** +- 检查当前 Java 架构 +- 如需要下载 64 位 Java +- 32 位 Java 限制在约 2GB + +**3. 降低渲染距离：** +- 游戏内视频设置 +- 将渲染距离降低到 8-12 区块 + +**4. 优化 JVM 参数：** +```bash +-Xms4G -Xmx8G -XX:+UseG1GC -XX:+UnlockExperimentalVMOptions +``` + +### 游戏无法启动 + +**问题：** 游戏不启动，没有错误消息 + +**检查：** + +**1. 日志输出：** +- 检查 DropOut 中的游戏控制台 +- 查找错误消息 +- 常见问题： + - 文件缺失 + - 下载损坏 + - 模组冲突 + +**2. 验证文件：** +- 删除版本文件夹 +- 重新下载版本 +- 在模组版本之前先尝试原版 + +**3. 检查权限：** +- 确保 DropOut 可以写入游戏目录 +- 检查文件夹权限 +- 在 Linux 上：`chmod -R 700 ~/.local/share/com.dropout.launcher`（仅当前用户可访问） + +## 下载问题 + +### 下载失败 + +**问题：** 资源或库下载失败 + +**解决方案：** + +**1. 网络问题：** +- 检查互联网连接 +- 禁用 VPN +- 尝试不同的网络 +- 检查防火墙/杀毒软件 + +**2. 恢复下载：** +- DropOut 自动恢复中断的下载 +- 关闭并重新打开 DropOut +- 下载应该继续 + +**3. 清除下载缓存：** +- 删除 libraries/assets 中的 `.part` 文件 +- 重新开始下载 + +**4. 手动下载：** +- 检查日志中失败的 URL +- 手动下载文件 +- 放置在正确位置 + +### 下载缓慢 + +**问题：** 下载非常慢 + +**解决方案：** + +**1. 调整线程数：** +- 设置 → 下载 +- 尝试不同的线程数： + - 太低：整体较慢 + - 太高：连接限流 + - 推荐：5-10 个线程 + +**2. 网络优化：** +- 关闭占用大量带宽的应用 +- 如可能使用有线连接 +- 检查 ISP 限速 + +**3. 备用 CDN：** +- Mojang 镜像可能很慢 +- 尝试在一天中的不同时间 + +## 模组加载器问题 + +### Fabric 安装失败 + +**问题：** 无法安装 Fabric 加载器 + +**解决方案：** + +**1. 检查 Minecraft 版本：** +- Fabric 支持 1.14+ +- 不支持更早版本 +- 尝试更新的 Minecraft 版本 + +**2. 网络问题：** +- 检查互联网连接 +- Fabric Meta API 可能宕机 +- 稍后再试 + +**3. 手动安装：** +- 从 [fabricmc.net](https://fabricmc.net/) 下载 Fabric +- 使用官方安装器 +- 将配置文件导入 DropOut + +### Forge 安装失败 + +**问题：** Forge 安装器失败或挂起 + +**解决方案：** + +**1. Java 版本：** +- 确保 Java 版本正确 +- Forge 1.17+ 需要 Java 16+ +- 更早的 Forge 可能需要 Java 8 + +**2. 安装器超时：** +- Forge 安装器可能很慢 +- 等待最多 10 分钟 +- 检查日志查看进度 + +**3. 磁盘空间：** +- 确保有足够的可用空间 +- Forge 临时需要约 1GB +- 检查 Linux 上的 `/tmp` + +**4. 手动安装：** +- 从 [minecraftforge.net](https://files.minecraftforge.net/) 下载 Forge 安装器 +- 手动运行安装器 +- 选择安装客户端 +- 导入配置文件 + +### 模组崩溃 + +**问题：** 安装模组后游戏崩溃 + +**解决方案：** + +**1. 检查兼容性：** +- 验证模组适用于正确的 Minecraft 版本 +- 检查模组加载器版本要求 +- 阅读模组说明了解依赖项 + +**2. 安装依赖项：** +- Fabric 模组通常需要 Fabric API +- 一些模组需要库 +- 检查崩溃日志中的"缺失"错误 + +**3. 移除冲突的模组：** +- 逐一禁用模组 +- 识别有问题的模组 +- 检查已知冲突 +- 更新或替换模组 + +**4. 更新模组：** +- 使用最新的模组版本 +- 检查模组更新说明 +- 一些更新修复崩溃 + +## 性能问题 + +### 低 FPS + +**问题：** 游戏运行缓慢或卡顿 + +**解决方案：** + +**1. 分配更多内存：** +- 将最大内存增加到 6-8GB +- 不要过度分配（导致 GC 暂停） + +**2. 安装性能模组：** +- **Fabric**: Sodium、Lithium、Phosphor +- **Forge**: OptiFine、Magnesium、Rubidium + +**3. 优化设置：** +- 降低渲染距离 +- 禁用精美图形 +- 关闭粒子 +- 如果 fps < 60 禁用垂直同步 + +**4. 更新显卡驱动：** +- 从制造商下载最新版本 +- NVIDIA: GeForce Experience +- AMD: Adrenalin +- Intel: Graphics Command Center + +**5. 关闭后台应用：** +- 释放系统资源 +- 禁用覆盖层（Discord 等） +- 检查任务管理器中的 CPU/RAM 占用 + +### 启动器启动缓慢 + +**问题：** DropOut 启动时间很长 + +**解决方案：** + +**1. 检查系统资源：** +- 关闭不必要的程序 +- 确保有足够的 RAM 可用 +- 检查 CPU 使用率 + +**2. 杀毒软件干扰：** +- 将 DropOut 添加到例外 +- 暂时禁用以测试 +- 一些杀毒软件会显著减慢速度 + +**3. 损坏的数据：** +- 删除应用数据中的 `cache` 文件夹 +- 重启 DropOut +- 将重建缓存 + +## UI 问题 + +### 窗口不打开 + +**问题：** DropOut 窗口不出现 + +**解决方案：** + +**1. 检查是否在运行：** +```bash +# Linux/macOS +ps aux | grep dropout + +# Windows +tasklist | findstr dropout +``` + +**2. 终止并重启：** +```bash +# Linux/macOS +pkill dropout + +# Windows +taskkill /F /IM dropout.exe +``` + +**3. 重置窗口位置：** +- 删除窗口状态配置 +- 重启 DropOut + +### 图形故障 + +**问题：** UI 看起来不对或有视觉伪影 + +**解决方案：** + +**1. 更新显卡驱动：** +- 安装最新驱动 +- 重启系统 + +**2. 禁用硬件加速：** +- 检查设置中是否存在选项 +- 可能会降低性能但修复故障 + +**3. 尝试不同的显示器：** +- 多显示器设置可能导致问题 +- 在不同显示器上尝试 + +## 文件系统问题 + +### 无法访问游戏目录 + +**问题：** 访问游戏文件时出错 + +**解决方案：** + +**1. 检查权限：** +```bash +# Linux +chmod -R 700 ~/.local/share/com.dropout.launcher + +# macOS +chmod -R 700 ~/Library/Application\ Support/com.dropout.launcher +``` + +**2. 检查磁盘空间：** +- 确保有足够的可用空间 +- Minecraft 需要 2-10GB，取决于模组 +- 清理旧版本 + +**3. 杀毒软件阻止：** +- 将游戏目录添加到例外 +- 一些杀毒软件会阻止文件访问 + +### 文件损坏 + +**问题：** 文件似乎损坏或无效 + +**解决方案：** + +**1. 验证校验和：** +- DropOut 验证 SHA1/SHA256 +- 验证失败会触发重新下载 + +**2. 重新下载：** +- 删除损坏的文件 +- 再次启动版本 +- DropOut 将重新下载 + +**3. 清除缓存：** +- 完全删除版本文件夹 +- 从头重新安装 + +## 获取更多帮助 + +### 收集调试信息 + +报告问题时，包括： + +**1. 系统信息：** +- 操作系统和版本 +- DropOut 版本 +- Java 版本 + +**2. 日志：** +- 控制台的启动器日志 +- 如适用的游戏日志 +- 错误消息（完整文本） + +**3. 重现步骤：** +- 你做了什么 +- 你期望什么 +- 实际发生了什么 + +**4. 截图：** +- 错误消息 +- UI 问题 +- 设置屏幕 + +### 报告问题 + +1. 搜索[现有 issues](https://github.com/HydroRoll-Team/DropOut/issues) +2. 如果未找到，[创建新 issue](https://github.com/HydroRoll-Team/DropOut/issues/new) +3. 使用 issue 模板 +4. 提供所有要求的信息 +5. 保持耐心和响应 + +### 社区支持 + +- **GitHub 讨论**：提问 +- **Discord**：实时帮助（如果可用） +- **文档**：查看所有指南 + +## 已知问题 + +### 目前正在处理 + +- 多账户切换（进行中） +- 选择自定义游戏目录（计划中） +- 启动器自动更新（计划中） + +### 解决方案 + +**问题**：无法轻松切换账户 +**解决方案**：退出登录并使用不同账户登录 + +**问题**：没有内置模组管理器 +**解决方案**：在实例文件夹中手动管理模组 + +**问题**：无法从其他启动器导入 +**解决方案**：手动复制实例文件 |