diff options
Diffstat (limited to 'packages/docs/content/zh/features')
| -rw-r--r-- | packages/docs/content/zh/features/authentication.mdx | 266 | ||||
| -rw-r--r-- | packages/docs/content/zh/features/index.mdx | 176 | ||||
| -rw-r--r-- | packages/docs/content/zh/features/java.mdx | 394 | ||||
| -rw-r--r-- | packages/docs/content/zh/features/meta.json | 9 | ||||
| -rw-r--r-- | packages/docs/content/zh/features/mod-loaders.mdx | 409 |
5 files changed, 0 insertions, 1254 deletions
diff --git a/packages/docs/content/zh/features/authentication.mdx b/packages/docs/content/zh/features/authentication.mdx deleted file mode 100644 index e83cc35..0000000 --- a/packages/docs/content/zh/features/authentication.mdx +++ /dev/null @@ -1,266 +0,0 @@ ---- -title: 身份验证 -description: DropOut 中的 Microsoft OAuth 和离线身份验证 ---- - -# 身份验证 - -DropOut 支持两种身份验证方法：Microsoft 账户（用于官方 Minecraft）和离线模式（用于测试和离线游玩）。 - -## Microsoft 身份验证 - -### 概述 - -DropOut 使用 **Device Code Flow** 进行 Microsoft 身份验证，具有以下特点： -- 无需重定向 URL（无需浏览器集成） -- 适用于任何拥有浏览器的设备 -- 提供简单的基于代码的身份验证 -- 完全符合 Microsoft OAuth 2.0 标准 - -### 身份验证流程 - -身份验证链包含多个步骤： - -1. **Device Code** → 用户授权 -2. **MS Token** → 访问令牌 + 刷新令牌 -3. **Xbox Live** → Xbox 令牌 + UHS -4. **XSTS** → 安全令牌 -5. **Minecraft** → 游戏访问令牌 -6. **Profile** → 用户名 + UUID - -#### 第 1 步：设备代码请求 -1. 单击"使用 Microsoft 登录" -2. DropOut 从 Microsoft 请求设备代码 -3. 您会收到： - - 用户代码（例如 `A1B2-C3D4`） - - 验证 URL（通常为 `https://microsoft.com/link`） - - 设备代码（内部使用） - -#### 第 2 步：用户授权 -1. 在任何浏览器中访问验证 URL -2. 输入用户代码 -3. 使用 Microsoft 账户登录 -4. 授权 DropOut 访问您的 Minecraft 个人资料 - -#### 第 3 步：令牌交换 -- DropOut 轮询 Microsoft 检查授权完成 -- 授权后接收访问令牌和刷新令牌 -- 刷新令牌被存储以备将来登录使用 - -#### 第 4 步：Xbox Live 身份验证 -- Microsoft 令牌被交换为 Xbox Live 令牌 -- 检索用户哈希 (UHS) 用于下一步 - -#### 第 5 步：XSTS 授权 -- Xbox Live 令牌被用来获取 XSTS 令牌 -- 此令牌特定于 Minecraft 服务 - -#### 第 6 步：Minecraft 登录 -- XSTS 令牌被交换为 Minecraft 访问令牌 -- 使用端点：`/launcher/login` - -#### 第 7 步：个人资料获取 -- 检索您的 Minecraft 用户名 -- 获取您的 UUID -- 检查您是否拥有 Minecraft - -### 令牌管理 - -**访问令牌：** -- 短期有效（通常为 1 小时） -- 用于游戏身份验证 -- 过期时自动刷新 - -**刷新令牌：** -- 长期有效（通常为 90 天） -- 安全存储在 `accounts.json` 中 -- 用于获取新的访问令牌 - -**自动刷新：** -```rust -// Automatic refresh when token expires -if account.expires_at < current_time { - refresh_full_auth(&account).await?; -} -``` - -### 安全考虑 - -- 令牌存储在平台特定的应用数据目录中 -- 所有 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 生成：** -```rust -// Deterministic UUID v3 from username -let uuid = generate_offline_uuid(&username); -``` - -- 使用 UUID v3（基于命名空间） -- 确定性：相同的用户名 = 相同的 UUID -- 无需网络请求 - -**身份验证：** -- 返回 `"null"` 作为访问令牌 -- Minecraft 在离线模式下接受空令牌 -- 用户名和 UUID 本地存储 - -### 限制 - -- 无法加入在线服务器 -- 不支持皮肤 -- 不支持披风 -- 无法使用 Microsoft 账户功能 - -### 用例 - -**开发：** -```bash -# Testing mod development -cargo tauri dev -# Use offline mode to test quickly -``` - -**LAN 游玩：** -- 无需身份验证即可加入 LAN 世界 -- 托管 LAN 世界 - -**离线游玩：** -- 单人游戏无需网络 -- 无需身份验证 - -## 账户管理 - -### 切换账户 - -目前 DropOut 一次只支持一个活跃账户。多账户支持正在规划中。 - -**切换账户的步骤：** -1. 登出当前账户 -2. 使用新账户登录 - -### 账户存储 - -账户存储在 `accounts.json` 中： - -```json -{ - "current_account_id": "uuid-here", - "accounts": [ - { - "id": "uuid", - "type": "Microsoft", - "username": "PlayerName", - "access_token": "...", - "refresh_token": "...", - "expires_at": 1234567890 - } - ] -} -``` - -### 删除账户 - -删除账户的步骤： -1. 打开设置 -2. 导航到账户 -3. 单击"登出" -4. 或手动删除 `accounts.json` - -## API 参考 - -### Tauri 命令 - -**启动 Microsoft 登录：** -```typescript -const { user_code, verification_uri } = await invoke('start_microsoft_login'); -``` - -**完成 Microsoft 登录：** -```typescript -const account = await invoke('complete_microsoft_login', { deviceCode }); -``` - -**离线登录：** -```typescript -const account = await invoke('offline_login', { username: 'Player' }); -``` - -**登出：** -```typescript -await invoke('logout'); -``` - -**获取当前账户：** -```typescript -const account = await invoke('get_current_account'); -``` - -### 事件 - -**身份验证状态：** -```typescript -listen('auth-status', (event) => { - console.log(event.payload); // "logged_in" | "logged_out" -}); -``` - -## 最佳实践 - -### 对于玩家 - -1. **对官方服务器使用 Microsoft 账户** -2. **保护令牌安全** - 不要分享 accounts.json -3. **定期刷新令牌** - 通过登录来刷新 -4. **仅在测试时使用离线模式** - -### 对于开发者 - -1. **优雅地处理令牌过期** -2. **为网络故障实现重试逻辑** -3. **缓存账户数据** 以减少 API 调用 -4. **在游戏启动前验证令牌** - -## 未来增强 - -- **多账户支持**：轻松在账户之间切换 -- **账户配置文件**：保存每个账户的设置 -- **自动登录**：记住最后一个账户 -- **令牌加密**：为存储的令牌增强安全性 diff --git a/packages/docs/content/zh/features/index.mdx b/packages/docs/content/zh/features/index.mdx deleted file mode 100644 index bb53ce2..0000000 --- a/packages/docs/content/zh/features/index.mdx +++ /dev/null @@ -1,176 +0,0 @@ ---- -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/features/java.mdx b/packages/docs/content/zh/features/java.mdx deleted file mode 100644 index bdc3c15..0000000 --- a/packages/docs/content/zh/features/java.mdx +++ /dev/null @@ -1,394 +0,0 @@ ---- -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 计算 -- 解压进度 -- 安装确认 - -### 目录管理 - -Java 目录缓存 24 小时以提高性能： - -```rust -// 目录结构 -{ - "versions": [ - { - "version": "17.0.9+9", - "major": 17, - "url": "https://api.adoptium.net/...", - "sha256": "...", - "size": 123456789 - } - ], - "last_updated": 1234567890 -} -``` - -**刷新：** -- 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 参数： - -**常用参数：** -```bash -# 垃圾回收 --XX:+UseG1GC --XX:+UnlockExperimentalVMOptions - -# 性能 --XX:G1NewSizePercent=20 --XX:G1ReservePercent=20 --XX:MaxGCPauseMillis=50 - -# 内存 --XX:G1HeapRegionSize=32M -``` - -### 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 - -## API 参考 - -### Tauri 命令 - -**检测 Java 安装：** -```typescript -const javas = await invoke('detect_java_installations'); -// 返回: Array<{ path: string, version: string, major: number }> -``` - -**获取 Java 目录：** -```typescript -const catalog = await invoke('get_java_catalog'); -// 返回: { versions: Array<JavaVersion>, last_updated: number } -``` - -**下载 Java：** -```typescript -await invoke('download_java', { - version: '17.0.9+9', - variant: 'jdk' // 或 'jre' -}); -``` - -**取消 Java 下载：** -```typescript -await invoke('cancel_java_download'); -``` - -**设置 Java 路径：** -```typescript -await invoke('set_java_path', { path: '/path/to/java' }); -``` - -### 事件 - -**下载进度：** -```typescript -listen('java-download-progress', (event) => { - const { percent, speed, eta } = event.payload; -}); -``` - -**下载完成：** -```typescript -listen('java-download-complete', (event) => { - const { path, version } = event.payload; -}); -``` - -## 最佳实践 - -### 对于玩家 - -1. **使用 Adoptium 构建版本** - 免费、高质量、维护良好 -2. **Java 与 Minecraft 版本匹配** - 检查版本要求 -3. **不要过度分配内存** - 为操作系统留出 RAM -4. **保持 Java 更新** - 安全性和性能 -5. **使用 64 位 Java** - 大内存所需 - -### 对于开发者 - -1. **测试多个 Java 版本** - 确保兼容性 -2. **记录 Java 要求** - 帮助用户 -3. **处理缺少的 Java** - 优雅的后备方案 -4. **启动前验证 Java 路径** -5. **提供清晰的错误** - 当 Java 错误时 - -## 高级主题 - -### 自定义 Java 安装 - -使用自定义 Java 安装： - -1. 手动安装 Java -2. 记录安装路径 -3. 在 DropOut 设置 → Java 中 -4. 点击"自定义路径" -5. 浏览到 Java 可执行文件 -6. 验证版本正确 - -### 服务器用 Java - -运行 Minecraft 服务器时： - -```bash -# 推荐的服务器 JVM 参数 --Xms4G -Xmx4G \ --XX:+UseG1GC \ --XX:+ParallelRefProcEnabled \ --XX:MaxGCPauseMillis=200 \ --XX:+UnlockExperimentalVMOptions \ --XX:+DisableExplicitGC \ --XX:G1NewSizePercent=30 \ --XX:G1MaxNewSizePercent=40 \ --XX:G1HeapRegionSize=8M \ --XX:G1ReservePercent=20 \ --XX:G1HeapWastePercent=5 \ --XX:G1MixedGCCountTarget=4 \ --XX:InitiatingHeapOccupancyPercent=15 \ --XX:G1MixedGCLiveThresholdPercent=90 \ --XX:G1RSetUpdatingPauseTimePercent=5 \ --XX:SurvivorRatio=32 \ --XX:+PerfDisableSharedMem \ --XX:MaxTenuringThreshold=1 -``` - -### GraalVM - -GraalVM 支持高级用户： - -1. 从 graalvm.org 下载 GraalVM -2. 手动安装 -3. 作为自定义 Java 添加到 DropOut -4. 可能提高性能 -5. 使用前彻底测试 diff --git a/packages/docs/content/zh/features/meta.json b/packages/docs/content/zh/features/meta.json deleted file mode 100644 index 2fb2ded..0000000 --- a/packages/docs/content/zh/features/meta.json +++ /dev/null @@ -1,9 +0,0 @@ -{ - "title": "功能特性", - "pages": [ - "index", - "authentication", - "java", - "mod-loaders" - ] -} diff --git a/packages/docs/content/zh/features/mod-loaders.mdx b/packages/docs/content/zh/features/mod-loaders.mdx deleted file mode 100644 index 3687230..0000000 --- a/packages/docs/content/zh/features/mod-loaders.mdx +++ /dev/null @@ -1,409 +0,0 @@ ---- -title: 模组加载器 -description: Fabric 和 Forge 安装和管理 ---- - -# 模组加载器 - -DropOut 支持两个最流行的 Minecraft 模组加载器：Fabric 和 Forge。两者都可以直接从启动器中轻松安装和管理。 - -## Fabric 支持 - -### 概述 - -Fabric 是一个轻量级、模块化的模组工具链，专注于： -- 快速更新至新的 Minecraft 版本 -- 干净、极简的 API -- 强大的开发者社区 -- 优异的性能 - -### 安装 - -1. 导航至 **Versions** 选项卡 -2. 点击 **"Install Fabric"** -3. 选择 Minecraft 版本 -4. 选择 Fabric 加载器版本 -5. 点击 **"Install"** -6. 等待安装完成 - -### 工作原理 - -**Meta API 集成：** -```rust -// Fetch available Fabric versions -let url = format!( - "https://meta.fabricmc.net/v2/versions/loader/{}", - minecraft_version -); -``` - -**配置文件生成：** -1. 获取 Fabric 加载器元数据 -2. 下载 Fabric 库 -3. 使用 `inheritsFrom` 生成版本 JSON -4. 与父级 Minecraft 版本合并 -5. 添加至版本列表 - -**版本格式：** -```json -{ - "id": "fabric-loader-0.15.0-1.20.4", - "inheritsFrom": "1.20.4", - "mainClass": "net.fabricmc.loader.impl.launch.knot.KnotClient", - "libraries": [...] -} -``` - -### Fabric 版本 - -**加载器版本：** -- 最新稳定版（推荐） -- 用于兼容性的特定版本 -- Beta/快照版本 - -**游戏版本：** -- 所有 1.14+ 的 Minecraft 版本 -- 支持快照版本 -- 支持战斗测试版本 - -### 库管理 - -Fabric 库从 Maven 解析： - -**主库：** -``` -net.fabricmc:fabric-loader:0.15.0 -``` - -**依赖项：** -- `net.fabricmc:tiny-mappings-parser` -- `net.fabricmc:sponge-mixin` -- `net.fabricmc:access-widener` - -**下载：** -```rust -// Maven resolution -let url = format!( - "https://maven.fabricmc.net/{}/{}", - artifact_path, filename -); -``` - -### 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. 安装完成 - -### 工作原理 - -**Forge 安装程序：** -```rust -// Download Forge installer -let installer_url = format!( - "https://maven.minecraftforge.net/net/minecraftforge/forge/{}/forge-{}-installer.jar", - full_version, full_version -); - -// Run installer -java -jar forge-installer.jar --installClient -``` - -**配置文件解析：** -1. Forge 安装程序创建版本 JSON -2. DropOut 解析安装配置文件 -3. 提取库依赖项 -4. 处理处理器（如果有） -5. 生成启动器配置文件 - -**版本格式：** -```json -{ - "id": "1.20.4-forge-49.0.26", - "inheritsFrom": "1.20.4", - "mainClass": "cpw.mods.bootstraplauncher.BootstrapLauncher", - "libraries": [...] -} -``` - -### Forge 版本 - -**发布类型：** -- **Latest**: 最新的稳定版本 -- **Recommended**: 生产环境中最稳定的版本 -- **Specific**: 版本锁定以确保兼容性 - -**Minecraft 版本支持：** -- 旧版本 (1.6.4+) -- 现代版本 (1.13+) -- 最新版本 (1.20+) - -### 库管理 - -Forge 有许多库： - -**核心库：** -- `net.minecraftforge:forge:<version>` -- `net.minecraftforge:fmlloader:<version>` -- `org.ow2.asm:asm:<version>` - -**解析：** -```rust -// Forge Maven -"https://maven.minecraftforge.net/" - -// Dependencies may use: -// - Maven Central -// - Minecraft Libraries -``` - -### Forge 处理器 - -某些 Forge 版本在安装期间运行"处理器"： -- 字节码操纵 -- 库修补 -- 映射生成 - -DropOut 自动处理这些操作。 - -## 版本继承 - -Fabric 和 Forge 都使用 Minecraft 的继承系统： - -### 父版本 - -```json -{ - "id": "fabric-loader-0.15.0-1.20.4", - "inheritsFrom": "1.20.4" // Parent vanilla version -} -``` - -### 合并过程 - -**库：** -```rust -// Merged from both -parent_libraries + modded_libraries -// Duplicates removed -``` - -**参数：** -```rust -// Combined -parent_jvm_args + modded_jvm_args -parent_game_args + modded_game_args -``` - -**资源：** -```rust -// Inherited from parent -assets = parent.assets -``` - -**主类：** -```rust -// Overridden by modded -main_class = modded.mainClass -``` - -## 对比 - -| 功能 | 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 参考 - -### Tauri 命令 - -**安装 Fabric：** -```typescript -await invoke('install_fabric', { - minecraftVersion: '1.20.4', - loaderVersion: '0.15.0' -}); -``` - -**安装 Forge：** -```typescript -await invoke('install_forge', { - minecraftVersion: '1.20.4', - forgeVersion: '49.0.26' -}); -``` - -**列出 Fabric 版本：** -```typescript -const versions = await invoke('get_fabric_versions', { - minecraftVersion: '1.20.4' -}); -``` - -**列出 Forge 版本：** -```typescript -const versions = await invoke('get_forge_versions', { - minecraftVersion: '1.20.4' -}); -``` - -### 事件 - -**安装进度：** -```typescript -listen('mod-loader-progress', (event) => { - const { stage, percent } = event.payload; - // Stages: "downloading", "installing", "processing", "complete" -}); -``` - -## 最佳实践 - -### 对于玩家 - -1. **每个实例选择一个模组加载器** -2. **精确匹配版本** - Minecraft 和加载器 -3. **安装前阅读模组要求** -4. **循序渐进** - 逐步添加模组 -5. **备份世界** - 添加模组前备份 -6. **检查兼容性** 列表 -7. **谨慎更新** - 在单独的实例中测试 - -### 对于模组包创建者 - -1. **记录版本** - MC、加载器、所有模组 -2. **彻底测试** - 所有功能 -3. **列出依赖项** - 包括 API -4. **提供更新日志** - 用于更新 -5. **版本锁定** - 为了稳定性 -6. **包含配置** - 预配置 -7. **测试更新** - 发布前测试 - -## 未来功能 - -- **模组浏览器** - 从启动器安装模组 -- **自动更新** - 保持模组最新 -- **依赖项解析** - 自动安装需求 -- **冲突检测** - 警告不兼容性 -- **配置文件导出** - 共享模组包配置 -- **CurseForge 集成** - 直接模组包导入 -- **Modrinth 集成** - 模组搜索和安装 |