oaoi

oaoi 是一个 Minecraft 启动器，支持正版登录、离线启动、版本安装、整合包导入、Mod 管理和个性化界面设置。

它的目标是让启动、安装、管理实例这些常用操作尽量简单直接，适合日常游玩和整合包使用。

功能介绍

游戏启动

oaoi 支持启动原版 Minecraft，也支持常见 Mod Loader：

• Vanilla
• Fabric
• Forge
• NeoForge
• Quilt

启动器会读取实例配置，自动组装游戏所需的 libraries、assets、natives、JVM 参数和游戏参数。启动后会记录启动日志，方便排查游戏崩溃或 Mod 冲突问题。

账号登录

oaoi 支持两种登录方式：

• 微软正版登录
• 离线玩家名启动

正版登录会保存账号信息，方便下次直接使用。离线模式适合本地测试、单机游玩或不需要正版验证的环境。

版本安装

下载中心可以查看 Minecraft 官方版本，并安装不同类型的游戏实例。

支持内容包括：

• 正式版
• 快照版
• 原版实例
• Fabric 实例
• Forge 实例
• NeoForge 实例
• Quilt 实例

安装时会自动下载游戏本体、依赖库、资源文件和对应 Loader 文件。版本文件会按官方 Minecraft 目录结构保存，方便实例、库文件和资源文件复用。

下载器

oaoi 使用统一下载器处理游戏文件、依赖库、资源文件、Loader 安装器、整合包内部文件和在线 Mod 下载。

下载器支持：

• 多文件异步下载
• 单文件切片下载
• 总连接数上限控制
• 断点续传
• 下载取消
• 慢速或失败时自动换源
• 当前源冷却，避免一直请求已经限流的源

下载源会按当前任务的来源策略排序。官方下载优先使用官方源，镜像下载优先使用镜像源，失败后再回退到可用候选源。

Java 管理

不同 Minecraft 版本需要不同 Java 版本。oaoi 可以根据实例版本选择合适的 Java。

支持：

• 自动查找本机 Java
• 自动下载常用 Java 运行环境
• 手动选择 Java 路径
• 按实例单独设置 Java
• 启动时检查 Java 是否匹配当前游戏版本

Java 8、Java 17、Java 21 等常用运行环境可以按需准备。Java 7 不会自动下载，低版本实例需要玩家手动安装 Java 7，并在版本设置里选择对应的 java.exe。

这样可以减少因为 Java 版本不对导致的游戏无法启动问题。

整合包导入

oaoi 支持导入常见整合包文件：

• Modrinth .mrpack
• CurseForge .zip

可以把整合包直接拖进启动器，启动器会自动识别整合包类型，解析 Minecraft 版本、Loader 类型、Mod 文件、配置文件和资源目录。

导入后会生成独立实例，并把 Mod、配置、材质包、光影包、存档等文件放到对应目录。安装过程中如果取消或失败，会清理未完成的实例目录，避免留下半成品。

整合包内部下载会保留整合包原有的兼容逻辑，只替换实际下载方法。解析出的 Mod、材质包、光影包等文件会交给统一下载器处理。

Mod 管理

每个实例都有独立的管理页面，可以查看和管理当前实例里的 Mod。

支持：

• 查看已安装 Mod
• 启用或禁用 Mod
• 删除 Mod
• 打开实例目录
• 打开 mods、saves、resourcepacks、shaderpacks、config 等常用文件夹
• 在线搜索并安装 Mod
• 在线下载材质包和光影包

禁用 Mod 时会保留文件，只改变启用状态，方便排查冲突。

实例管理

每个游戏版本或整合包都会作为一个独立实例保存。

实例可以单独管理：

• Mod
• 存档
• 材质包
• 光影包
• 配置文件
• Java 设置
• 内存设置
• JVM 参数

这样不同整合包、不同版本之间不会互相影响。

内存设置

oaoi 支持全局内存设置，也支持每个实例单独设置内存。

内存模式包括：

• 自己设置
• 自动分配

自动分配会结合整合包信息和 Mod 数量给出较合适的内存。实例有单独内存设置时，会优先使用实例自己的设置。

崩溃分析

游戏崩溃后，oaoi 可以读取启动日志并进行分析。

支持：

• 本地规则分析
• 可选 AI 分析

本地分析不需要额外配置。AI 分析需要用户自己填写兼容 OpenAI 格式的 API 地址、API Key 和模型名称。

下载与安装进度

下载中心会显示正在进行的任务和安装进度。

支持：

• 游戏版本下载进度
• 整合包下载进度
• Mod 文件下载进度
• 材质包和光影包下载进度
• 安装失败提示
• 任务取消

大整合包安装时可以看到当前正在处理的文件类型和数量。取消任务后会中断下载器里的相关任务，并停止后续安装流程。

个性化设置

DIY 页面可以调整启动器外观。

支持：

• 内置背景图片
• 自定义背景图片
• 主题色
• 花瓣动画开关
• 花瓣数量
• 花瓣颜色
• 花瓣样式
• 背景模糊
• 窗口透明度
• 内容框透明度
• 弹窗透明度
• 窗口圆角
• 窗口大小恢复

这些设置会保存在本地，下次打开启动器时自动恢复。

界面与体验

oaoi 使用自定义窗口界面，整体偏轻量化。

主要页面包括：

• 主页
• 服务器列表
• 下载中心
• 设置中心
• 关于页面
• DIY 页面
• 实例详情页

常用操作都可以从侧边栏进入。

适合场景

oaoi 适合这些使用场景：

• 日常启动 Minecraft
• 管理多个版本和整合包
• 给不同实例设置不同 Java 或内存
• 拖入整合包快速安装
• 管理 Mod、材质包、光影包和存档
• 排查启动失败和崩溃日志
• 使用简洁一点的自定义启动器界面

开发与编译

安装依赖：

npm install

开发运行：

npx tauri dev

编译正式版：

cd src-tauri
cargo build --release

正式版输出位置：

src-tauri/target/release/oaoi.exe