oaoi 使用什么技术开发？

oaoi 启动器采用 Tauri + Rust 架构开发。

• 前端：HTML、CSS、JavaScript
• 后端：Rust
• 桌面框架：Tauri
• 构建打包：Tauri CLI + Cargo

它不是传统的 Electron 启动器。

这种架构有什么优势？

oaoi 的界面部分使用前端技术实现，所以 UI 可以做得很灵活，比如粉色玻璃拟态风格、弹窗、动画和各种交互效果。

真正负责核心逻辑的部分则由 Rust 后端完成，包括：

• 启动游戏
• 下载版本文件
• 校验资源完整性
• 安装 Forge、NeoForge、Fabric、Quilt
• 安装整合包
• 下载 Mod、材质包、光影包
• 自动补齐依赖
• 自动修复缺失资源
• 管理 Java 环境

这样的好处是：

• 启动器本体更轻量
• 启动速度更快
• 内存占用更低
• 文件处理更稳定
• 并发下载能力更强
• 更适合处理 Minecraft 启动器这种大量本地文件和网络下载的场景

简单来说，oaoi 既保留了网页技术做 UI 的灵活性，又利用 Rust 提供了更高的性能和稳定性，同时避免了 Electron 启动器体积大、占用高的问题。

游戏启动

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

• Vanilla
• Fabric
• Forge
• NeoForge
• Quilt

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

账号登录

oaoi 支持两种登录方式：

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

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

版本安装

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

支持内容包括：

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

安装时会自动下载游戏本体、依赖库、资源文件和对应 Loader 文件。

Java 管理

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

支持：

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

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

整合包导入

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

• Modrinth .mrpack
• CurseForge .zip

可以把整合包直接拖进启动器，启动器会自动识别整合包类型，解析 Minecraft 版本、Loader 类型、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、材质包、光影包和存档
• 排查启动失败和崩溃日志
• 使用简洁一点的自定义启动器界面