Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changes/alpha7-docs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@dropout/docs": "patch:fix"
---

Publish bilingual Alpha 7 release notes and align installation, navigation, feature, and migration guidance with shipped behavior.
7 changes: 7 additions & 0 deletions .changes/alpha7-fixtures.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
"dropout": "patch:feat"
"@dropout/ui": "patch:feat"
"@dropout/docs": "patch:feat"
---

Add deterministic browser fixtures, route code splitting, accessibility checks, and reviewed cross-platform visual regression baselines.
7 changes: 7 additions & 0 deletions .changes/alpha7-instance-library.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
"dropout": "patch:feat"
"@dropout/ui": "patch:feat"
"@dropout/docs": "patch:feat"
---

Add a searchable and sortable instance library with scalable views, progressive readiness, detail workflows, and guarded management actions.
7 changes: 7 additions & 0 deletions .changes/alpha7-launch-readiness.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
"dropout": "patch:feat"
"@dropout/ui": "patch:feat"
"@dropout/docs": "patch:feat"
---

Redesign Home as a state-driven launch readiness, progress, logging, and recovery command center.
7 changes: 7 additions & 0 deletions .changes/alpha7-monaco.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
"dropout": "patch:feat"
"@dropout/ui": "patch:feat"
"@dropout/docs": "patch:feat"
---

Replace the raw configuration textarea with a locally bundled, schema-aware Monaco JSON editor and safe editing workflows.
9 changes: 6 additions & 3 deletions README.CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,12 +58,14 @@ Rust 核心负责副作用。React UI 调用 Tauri 命令并渲染状态。文

- **Microsoft 认证** - 设备代码 OAuth、Minecraft Services 登录、令牌刷新和账户持久化。
- **离线账户** - 支持本地账户,便于测试或离线使用。
- **实例系统** - 隔离游戏目录,并支持实例备注、内存覆盖、Java 参数、版本和加载器状态。
- **启动指挥中心** - 依据真实就绪检查,用同一个主操作完成登录、修复、下载、启动、停止和失败恢复。
- **实例库** - 支持搜索、排序、网格/列表视图、渐进就绪检查、当前实例详情和带保护的管理操作。
- **实例系统** - 隔离游戏目录,并支持实例备注、内存与 Java 覆盖、版本、加载器、模组、存档和迁移入口。
- **Minecraft 版本管理** - 安装、校验、列出、删除并启动本地版本。
- **Fabric 和 Forge 支持** - 发现加载器版本,并为模组实例提供安装流程。
- **Java 管理** - 本地 Java 检测、兼容性检查、Adoptium 目录查询、下载、恢复和取消。
- **并发下载** - 资源和依赖库队列、进度事件和恢复路径。
- **配置编辑器** - 查看和编辑原始 JSON/TOML 启动器配置。
- **配置编辑器** - 使用本地打包的 Monaco 编辑 JSON,并提供 Schema 诊断、格式化、键盘保存和放弃更改保护。
- **发布动态** - 在主页展示 GitHub Release 更新。
- **游戏助手** - 可选的本地或 OpenAI 兼容助手,用于日志、崩溃和配置问题。

Expand Down Expand Up @@ -190,7 +192,8 @@ UI 的长期状态位于 `packages/ui/src/models/`,页面位于 `packages/ui/s
- [ ] 内置模组管理器
- [ ] 自定义游戏目录选择
- [ ] 启动器自动更新
- [x] 从 PCL、HMCL、MultiMC、Prism Launcher 和其他配置导入
- [x] 从 PCL、HMCL、MultiMC 和 Prism Launcher 进行基础发现与复制式导入
- [ ] 迁移冲突预览、取消、回滚和结构化兼容性报告

公开路线图见 <https://roadmap.sh/r/minecraft-launcher-dev>。

Expand Down
9 changes: 6 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,12 +58,14 @@ The Rust core owns side effects. The React UI invokes Tauri commands and renders

- **Microsoft authentication** - device-code OAuth flow, Minecraft Services login, token refresh, and persisted account state.
- **Offline accounts** - local accounts for testing or non-network play.
- **Instance system** - isolated game directories with per-instance notes, memory overrides, Java arguments, version, and loader state.
- **Launch command center** - one state-driven action for sign-in, repair, download, launch, stop, and failure recovery, backed by real readiness checks.
- **Instance library** - searchable and sortable grid/list views, progressive readiness, active-instance details, and guarded management actions.
- **Instance system** - isolated game directories with per-instance notes, memory and Java overrides, version, loader, mods, saves, and migration entry points.
- **Minecraft version management** - install, verify, list, delete, and launch local versions.
- **Fabric and Forge support** - loader version discovery plus installer flows for modded instances.
- **Java management** - local Java detection, compatibility checks, Adoptium catalog lookup, downloads, resume, and cancellation.
- **Concurrent downloads** - asset/library queues with progress events and recovery paths.
- **Configuration editor** - inspect and edit raw JSON/TOML launcher configuration.
- **Configuration editor** - edit launcher JSON with locally bundled Monaco, schema diagnostics, formatting, keyboard save, and discard protection.
- **Release feed** - GitHub release notes surfaced on the home screen.
- **Game assistant** - optional local or OpenAI-compatible helper for logs, crashes, and configuration questions.

Expand Down Expand Up @@ -190,7 +192,8 @@ The UI keeps long-lived state in `packages/ui/src/models/`, renders routes from
- [ ] Built-in mods manager
- [ ] Custom game directory selection
- [ ] Launcher auto-updater
- [x] Import from PCL, HMCL, MultiMC, Prism Launcher, and other profiles
- [x] Basic discovery and copy-based import from PCL, HMCL, MultiMC, and Prism Launcher
- [ ] Migration conflict previews, cancellation, rollback, and structured compatibility reports

The public roadmap is tracked at <https://roadmap.sh/r/minecraft-launcher-dev>.

Expand Down
27 changes: 11 additions & 16 deletions packages/docs/content/en/manual/features/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,15 +30,10 @@ DropOut is packed with features designed for both casual players and power users
href="instances"
description="Isolated game environments with independent configs"
/>
<Card
title="Downloads"
href="downloads"
description="Fast concurrent downloads with resume support"
/>
<Card
title="AI Assistant"
href="assistant"
description="Built-in AI helper for troubleshooting and guidance"
<Card
title="Configuration Editor"
href="config-editor"
description="Schema-aware Monaco JSON editing"
/>
</Cards>

Expand All @@ -65,7 +60,7 @@ DropOut is packed with features designed for both casual players and power users
| Mods Manager | Planned | Enable/disable mods in launcher |
| Launcher Auto-update | Planned | Self-updating mechanism |
| Custom Game Directory | Planned | Choose game files location |
| Import Profiles | Planned | Import from MultiMC/Prism |
| Launcher Migration | Preview | Basic PCL/HMCL/MultiMC/Prism discovery and copy import |

## Performance Features

Expand All @@ -90,7 +85,7 @@ DropOut is packed with features designed for both casual players and power users
## User Interface Features

### Modern Design
- Dark mode enforced for eye comfort
- Light and dark themes with readable launch-state contrast
- Particle background effects
- Clean, distraction-free layout
- Responsive design
Expand Down Expand Up @@ -163,11 +158,11 @@ Built-in [Monaco configuration editor](/docs/manual/features/config-editor) with
- Mod compatibility checking
- Version management

### Profile Import
- Import from MultiMC
- Import from Prism Launcher
- Import from other launchers
- Preserve settings and saves
### Migration Compatibility
- Preview imported, skipped, unsupported, and conflicting content
- Preserve launcher-specific metadata and overrides
- Add cancellation, rollback, and compatibility reports
- Keep source launcher data unchanged

### Launcher Auto-update
- Background update checks
Expand Down
47 changes: 23 additions & 24 deletions packages/docs/content/en/manual/getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,31 +11,32 @@ DropOut is a modern, reproducible, and developer-grade Minecraft launcher built

### Download Pre-built Binaries

Download the latest release for your platform from the [Releases](https://github.com/HsiangNianian/DropOut/releases) page.
Download the latest prerelease for your platform from the [HydroRoll Team releases](https://github.com/HydroRoll-Team/DropOut/releases) page. Alpha builds are intended for testing, so export important instances before upgrading.

| Platform | Files |
| -------------- | ------------------- |
| Linux x86_64 | `.deb`, `.AppImage` |
| Linux ARM64 | `.deb`, `.AppImage` |
| macOS ARM64 | `.dmg` |
| Windows x86_64 | `.msi`, `.exe` |
| Windows ARM64 | `.msi`, `.exe` |
| Platform | Release asset |
| -------------- | -------------------- |
| Linux x86_64 | `.deb`, `.AppImage` |
| Linux ARM64 | `.deb`, `.AppImage` |
| macOS x86_64 | `.dmg` |
| macOS ARM64 | `.dmg` |
| Windows x86_64 | NSIS `.exe` installer |
| Windows ARM64 | NSIS `.exe` installer |

### Linux Installation

#### Using .deb Package

```bash
sudo dpkg -i dropout_*.deb
sudo dpkg -i Dropout_*.deb
# Fix dependencies if needed
sudo apt-get install -f
```

#### Using AppImage

```bash
chmod +x dropout_*.AppImage
./dropout_*.AppImage
chmod +x Dropout_*.AppImage
./Dropout_*.AppImage
```

### macOS Installation
Expand All @@ -46,16 +47,9 @@ chmod +x dropout_*.AppImage

### Windows Installation

#### Using .msi Installer

1. Double-click the `.msi` file
2. Follow the installation wizard
3. Launch DropOut from the Start Menu

#### Using .exe Portable

1. Double-click the `.exe` file
2. DropOut will run directly without installation
1. Double-click the architecture-appropriate `-setup.exe` installer.
2. Follow the installation wizard.
3. Launch DropOut from the Start Menu.

## First Launch

Expand Down Expand Up @@ -136,9 +130,14 @@ DropOut calculates the Java and file checks with the same backend rules used by
href="/docs/manual/features/mod-loaders"
description="Install and manage Fabric and Forge"
/>
<Card
title="Alpha 7 release notes"
href="/docs/manual/releases/alpha-7"
description="Review the UX changes, upgrade notes, and known limitations"
/>
<Card
title="Troubleshooting"
href="/docs/troubleshooting"
href="/docs/manual/troubleshooting"
description="Common issues and solutions"
/>
</Cards>
Expand All @@ -163,6 +162,6 @@ DropOut calculates the Java and file checks with the same backend rules used by

If you encounter issues:

- Check the [Troubleshooting Guide](/docs/troubleshooting)
- Report bugs on [GitHub Issues](https://github.com/HsiangNianian/DropOut/issues)
- Check the [Troubleshooting Guide](/docs/manual/troubleshooting)
- Report bugs on [GitHub Issues](https://github.com/HydroRoll-Team/DropOut/issues)
- Join our community discussions
9 changes: 6 additions & 3 deletions packages/docs/content/en/manual/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,12 +36,12 @@ This launcher is built for players who value control, transparency, and long-ter
/>
<Card
title="Architecture"
href="architecture"
href="/docs/development/architecture"
description="Learn about the technical design"
/>
<Card
title="Development"
href="development"
href="/docs/development"
description="Build and contribute to DropOut"
/>
</Cards>
Expand All @@ -52,7 +52,10 @@ This launcher is built for players who value control, transparency, and long-ter
Built with Rust and Tauri for minimal resource usage and fast startup times.

### Modern UI
Clean, distraction-free interface with React 19, shadcn/ui, Tailwind CSS 4, and particle effects.
State-driven launch command center, scalable instance library, light/dark themes, and responsive layouts at the supported desktop window sizes.

### Safe Configuration
Locally bundled Monaco JSON editor with schema diagnostics, formatting, keyboard save, and unsaved-change protection.

### Secure Authentication
Microsoft OAuth 2.0 with device code flow and offline authentication support.
Expand Down
2 changes: 1 addition & 1 deletion packages/docs/content/en/manual/meta.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"title": "User Manual",
"pages": ["index", "getting-started", "features", "troubleshooting"]
"pages": ["index", "getting-started", "releases", "features", "troubleshooting"]
}
49 changes: 49 additions & 0 deletions packages/docs/content/en/manual/releases/alpha-7.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
---
title: 0.2.0-alpha.7 — UX Foundation
description: Launch readiness, a scalable instance library, Monaco configuration editing, and reproducible UI validation.
---

# 0.2.0-alpha.7 — UX Foundation

Alpha 7 turns DropOut's core launcher surfaces into an inspectable daily workflow. It is a prerelease: back up or export important instances before upgrading, and report regressions on [GitHub Issues](https://github.com/HydroRoll-Team/DropOut/issues).

## Highlights

### Launch from real readiness

Home is now a launch command center. One primary action follows the current account, instance, game files, loader, Java, memory, download, and process state. The same screen exposes recovery actions, aggregate download progress, live output, recent failures, and Minecraft logs.

### Navigate large instance libraries

The instance library adds name/content search, sorting, persistent grid/list views, progressive readiness checks, and an active detail workspace. Management actions include edit, duplicate, export, migrate, open directory, mod shortcuts, and guarded deletion with recovery guidance.

### Edit JSON safely with Monaco

The advanced configuration editor now bundles Monaco and its JSON worker locally. Schema diagnostics, formatting, <kbd>Ctrl</kbd>/<kbd>Command</kbd>+<kbd>S</kbd>, reset, cursor/validation status, immediate theme/language application, and unsaved-change protection work without a CDN.

### Reproduce UI states before shipping

Development fixtures cover empty, ready, downloading, running, failed, migration, and scaled instance-library states without requiring Tauri services. The Alpha 7 gate exercises 108 UI checks with keyboard/accessibility coverage and reviewed dark/light screenshots at both the 1024×768 default and 905×575 minimum window sizes on macOS and Linux.

## Upgrade and migration notes

- Existing DropOut configuration and instances are reused; Alpha 7 does not intentionally change their storage format.
- Basic PCL, HMCL, MultiMC, and Prism discovery/import remains available from **Library actions** and copies selected game content into a DropOut-managed instance.
- Full conflict preview, cancellation, rollback, launcher-specific compatibility reporting, and broader cross-platform migration fixtures are scheduled for Alpha 8.
- Export an instance before destructive changes when its saves, mods, packs, or configuration cannot be recreated.

## Release assets

| Platform | Assets |
| --- | --- |
| Linux x86_64 / ARM64 | `.deb`, `.AppImage` |
| macOS x86_64 / ARM64 | `.dmg` |
| Windows x86_64 / ARM64 | NSIS `-setup.exe` |

## Known limitations

- Alpha builds may change behavior and data contracts before the stable release.
- Launcher auto-update and the complete in-launcher mods manager are not finished.
- Migration is a preview workflow until the Alpha 8 compatibility milestone is complete.

Continue with the [launch workflow](/docs/manual/getting-started), [instance library](/docs/manual/features/instances), or [Monaco configuration editor](/docs/manual/features/config-editor).
4 changes: 4 additions & 0 deletions packages/docs/content/en/manual/releases/meta.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"title": "Release Notes",
"pages": ["alpha-7"]
}
27 changes: 11 additions & 16 deletions packages/docs/content/zh/manual/features/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,15 +30,10 @@ DropOut 功能丰富,既适合休闲玩家也适合高级用户。本指南涵
href="instances"
description="具有独立配置的隔离游戏环境"
/>
<Card
title="下载"
href="downloads"
description="快速并发下载,支持断点续传"
/>
<Card
title="AI 助手"
href="assistant"
description="内置 AI 助手用于故障排除和指导"
<Card
title="配置编辑器"
href="config-editor"
description="具备 Schema 感知能力的 Monaco JSON 编辑器"
/>
</Cards>

Expand All @@ -65,7 +60,7 @@ DropOut 功能丰富,既适合休闲玩家也适合高级用户。本指南涵
| 模组管理器 | 计划中 | 在启动器中启用/禁用模组 |
| 启动器自动更新 | 计划中 | 自我更新机制 |
| 自定义游戏目录 | 计划中 | 选择游戏文件位置 |
| 导入配置文件 | 计划中 | 从 MultiMC/Prism 导入 |
| 启动器迁移 | 预览 | 基础发现并复制导入 PCL/HMCL/MultiMC/Prism 实例 |

## 性能功能

Expand All @@ -90,7 +85,7 @@ DropOut 功能丰富,既适合休闲玩家也适合高级用户。本指南涵
## 用户界面功能

### 现代设计
- 强制暗色模式保护眼睛
- 提供亮色与暗色主题,并保证启动状态对比度
- 粒子背景效果
- 简洁、无干扰的布局
- 响应式设计
Expand Down Expand Up @@ -163,11 +158,11 @@ DropOut 功能丰富,既适合休闲玩家也适合高级用户。本指南涵
- 模组兼容性检查
- 版本管理

### 配置文件导入
- 从 MultiMC 导入
- 从 Prism Launcher 导入
- 从其他启动器导入
- 保留设置和存档
### 迁移兼容性
- 导入前预览已包含、跳过、不支持和冲突的内容
- 保留启动器专属元数据与覆盖设置
- 增加取消、回滚和兼容性报告
- 保证源启动器数据不被修改

### 启动器自动更新
- 后台更新检查
Expand Down
Loading
Loading