chore: 发布 1.0.0 正式版公告

- catalog.ts 增量新增 1.0.0 公告（启用内置自动更新、修复启动崩溃）；
- 网站 catalog.json 重新生成。

.github/workflows/build-on-tag.yml

@@ -1,4 +1,4 @@
-name: Axolotl release
+name: Starlight release
 
 on:
   push:
@@ -53,6 +53,15 @@ jobs:
           node scripts/axolotl/i18n-check.mjs
           cargo fmt --all --check
 
+      - name: Check updater signing configuration
+        env:
+          TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
+        run: |
+          if [[ -z "${TAURI_SIGNING_PRIVATE_KEY:-}" ]]; then
+            echo '::error::Configure TAURI_SIGNING_PRIVATE_KEY with the private key matching apps/app/tauri-release.conf.json before publishing updates.'
+            exit 1
+          fi
+
       - name: Prepare draft release
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -72,7 +81,7 @@ jobs:
           release_args=(
             --draft
             --notes-file "$release_notes"
-            --title "Axolotl Launcher ${GITHUB_REF_NAME}"
+            --title "Starlight Launcher ${GITHUB_REF_NAME}"
           )
           if [[ "${GITHUB_REF_NAME}" == *-* ]]; then
             release_args+=(--prerelease)
@@ -175,7 +184,7 @@ jobs:
           tauriScript: pnpm tauri
           args: ${{ matrix.args }}
           tagName: ${{ github.ref_name }}
-          releaseName: Axolotl Launcher ${{ github.ref_name }}
+          releaseName: Starlight Launcher ${{ github.ref_name }}
           releaseDraft: true
           prerelease: ${{ contains(github.ref_name, '-') }}
           generateReleaseNotes: false
@@ -198,7 +207,7 @@ jobs:
         shell: pwsh
         run: |
           $version = "${{ github.ref_name }}" -replace '^v', ''
-          $appName = "Axolotl Launcher"
+          $appName = (Get-Content apps/app/tauri.conf.json -Raw | ConvertFrom-Json).mainBinaryName
           $outDir = "target/release/bundle/nsis"
           $buildDir = "target/portable-build"
           $publishDir = Join-Path $env:RUNNER_TEMP "windows-assets"
@@ -249,6 +258,15 @@ jobs:
             New-Item -ItemType Directory -Force -Path "$buildDir\Axolotl" | Out-Null
             Copy-Item -Force $appExe "$buildDir\Axolotl\"
 
+            $editorResources = "target/release/resources/blockbench-skin"
+            foreach ($requiredFile in @('index.html', 'css/setup.css', 'dist/skin.bundle.js.gz')) {
+              if (!(Test-Path -LiteralPath (Join-Path $editorResources $requiredFile) -PathType Leaf)) {
+                throw "Missing skin editor resource: $requiredFile"
+              }
+            }
+            New-Item -ItemType Directory -Force -Path "$buildDir\Axolotl\resources" | Out-Null
+            Copy-Item -LiteralPath $editorResources -Destination "$buildDir\Axolotl\resources" -Recurse -Force
+
             # Create empty .Axolotl folder to trigger portable mode
             New-Item -ItemType Directory -Force -Path "$buildDir\Axolotl\.Axolotl" | Out-Null
 
@@ -268,18 +286,37 @@ jobs:
     name: Verify and publish
     needs: build
     runs-on: ubuntu-24.04
+    env:
+      UPDATE_SERVER_URL: ${{ secrets.UPDATE_SERVER_URL }}
+      UPDATE_SERVER_WEBHOOK_SECRET: ${{ secrets.UPDATE_SERVER_WEBHOOK_SECRET }}
+      CNB_TOKEN: ${{ secrets.CNB_TOKEN }}
+      CNB_REPO_URL_HTTPS: ${{ secrets.CNB_REPO_URL_HTTPS }}
     steps:
       - name: Check out source
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 0
-          ref: main
+          ref: ${{ github.ref }}
 
       - name: Download updater signatures
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: gh release download "${GITHUB_REF_NAME}" --pattern '*.sig' --dir release-check/signatures
 
+      # Publish the draft release before generating the updater manifest. While
+      # the release is a draft GitHub reports asset URLs as
+      # `.../releases/download/untagged-<hash>/...`; only after publishing does
+      # the manifest point at the stable `.../releases/download/<tag>/...` path.
+      - name: Publish release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          if [[ "${GITHUB_REF_NAME}" == *-* ]]; then
+            gh release edit "${GITHUB_REF_NAME}" --draft=false --prerelease
+          else
+            gh release edit "${GITHUB_REF_NAME}" --draft=false --latest
+          fi
+
       - name: Download release metadata
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -306,31 +343,6 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: gh release upload "${GITHUB_REF_NAME}" release-check/latest.json --clobber
 
-      - name: Publish release
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          if [[ "${GITHUB_REF_NAME}" == *-* ]]; then
-            gh release edit "${GITHUB_REF_NAME}" --draft=false --prerelease
-          else
-            gh release edit "${GITHUB_REF_NAME}" --draft=false --latest
-          fi
-
-      - name: Refresh published GitHub release metadata
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          release_id="$(
-            gh api "repos/${GITHUB_REPOSITORY}/releases" \
-              --paginate \
-              --jq ".[] | select(.tag_name == \"${GITHUB_REF_NAME}\") | .id"
-          )"
-          if [[ -z "$release_id" ]]; then
-            echo "Published release ${GITHUB_REF_NAME} was not found"
-            exit 1
-          fi
-          gh api "repos/${GITHUB_REPOSITORY}/releases/${release_id}" > release-check/release.json
-
       - name: Build Update Server artifact catalog
         run: |
           node scripts/axolotl/create-update-server-catalog.mjs \
@@ -340,6 +352,7 @@ jobs:
           node scripts/axolotl/create-update-server-catalog.test.mjs
 
       - name: Notify Update Server to publish release assets
+        if: ${{ env.UPDATE_SERVER_URL != '' && env.UPDATE_SERVER_WEBHOOK_SECRET != '' }}
         env:
           UPDATE_SERVER_URL: ${{ secrets.UPDATE_SERVER_URL }}
           UPDATE_SERVER_WEBHOOK_SECRET: ${{ secrets.UPDATE_SERVER_WEBHOOK_SECRET }}
@@ -350,6 +363,13 @@ jobs:
             release-check/release.json \
             "${GITHUB_REF_NAME}"
 
+      - name: Check out website branch
+        if: ${{ !contains(github.ref_name, '-') }}
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          ref: main
+          clean: false
+
       - name: Publish website download metadata
         if: ${{ !contains(github.ref_name, '-') }}
         env:
@@ -372,11 +392,14 @@ jobs:
           fi
 
       - name: Mirror published release to CNB
+        if: ${{ env.CNB_TOKEN != '' && env.CNB_REPO_URL_HTTPS != '' }}
         env:
           CNB_REPO_URL_HTTPS: ${{ secrets.CNB_REPO_URL_HTTPS }}
           CNB_TOKEN: ${{ secrets.CNB_TOKEN }}
           CNB_TOKEN_USER_NAME: ${{ secrets.CNB_TOKEN_USER_NAME }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_API_BASE_URL: https://api.github.com/repos/${{ github.repository }}
+          GITHUB_RELEASE_BASE_URL: https://github.com/${{ github.repository }}/releases/download
         run: |
           set -euo pipefail
           if [[ -z "${CNB_TOKEN:-}" ]]; then

.github/workflows/sync-cnb-source.yml

@@ -19,6 +19,7 @@ concurrency:
 jobs:
   sync:
     name: Sync Git ref
+    if: ${{ vars.ENABLE_CNB_SYNC == 'true' }}
     runs-on: ubuntu-24.04
     timeout-minutes: 5
     steps:
@@ -38,8 +39,8 @@ jobs:
           DELETED_REF_TYPE: ${{ github.event.ref_type }}
         run: |
           set -euo pipefail
-          if [[ -z "${CNB_TOKEN:-}" ]]; then
-            echo "CNB_TOKEN is not configured"
+          if [[ -z "${CNB_TOKEN:-}" || -z "${CNB_REPO_URL_HTTPS:-}" ]]; then
+            echo "CNB_TOKEN and CNB_REPO_URL_HTTPS must be configured"
             exit 1
           fi
 

.gitignore

@@ -79,6 +79,7 @@ access-jwt*.txt
 
 # Codex local verification artifacts
 /.codex-*
+/.tmp/
 
 # Oh My Code
 .omc/

Cargo.lock

@@ -6795,7 +6795,7 @@ dependencies = [
 
 [[package]]
 name = "theseus"
-version = "1.9.6-beta.3"
+version = "1.0.0-beta12"
 dependencies = [
  "ariadne",
  "async-minecraft-ping",
@@ -6899,7 +6899,7 @@ dependencies = [
 
 [[package]]
 name = "theseus_gui"
-version = "1.9.6-beta.3"
+version = "1.0.0-beta12"
 dependencies = [
  "ashpd",
  "async_zip",

README.md

@@ -5,13 +5,13 @@
   <p><strong>次世代 Minecraft 桌面客户端，全能、美观、全平台覆盖。</strong></p>
 
   <p>
-    <a href="https://git.starlight.cool/AxTps/Starlight_Lancher/actions">
-      <img src="https://img.shields.io/badge/Repo-git.starlight.cool-blue?style=for-the-badge&logo=git" alt="Repository" />
+    <a href="https://github.com/ApTx2012/Starlight_Lancher/actions">
+      <img src="https://img.shields.io/badge/Repo-GitHub-black?style=for-the-badge&logo=github" alt="Repository" />
     </a>
-    <a href="https://git.starlight.cool/AxTps/Starlight_Lancher/releases">
+    <a href="https://github.com/ApTx2012/Starlight_Lancher/releases">
       <img src="https://img.shields.io/badge/Releases-Download-green?style=for-the-badge&logo=github" alt="Releases" />
     </a>
-    <a href="https://git.starlight.cool/AxTps/Starlight_Lancher/stargazers">
+    <a href="https://github.com/ApTx2012/Starlight_Lancher/stargazers">
       <img src="https://img.shields.io/badge/Stars-★-ffb800?style=for-the-badge&logo=github" alt="Stars" />
     </a>
     <a href="COPYING.md">
@@ -21,7 +21,7 @@
 
   <p>
     <a href="https://skin.starlight.cool/">官方网站</a> ｜
-    <a href="https://git.starlight.cool/AxTps/Starlight_Lancher/releases/latest">下载最新版</a> ｜
+    <a href="https://github.com/ApTx2012/Starlight_Lancher/releases/latest">下载最新版</a> ｜
     <a href="CONTRIBUTING.md">参与贡献</a>
     ｜ <a href="CODE_OF_CONDUCT.md">行为准则</a>
   </p>
@@ -57,7 +57,7 @@ _(注：本项目是调用 Modrinth 公开 API 的独立客户端，与 Rinth, I
 
 ## 下载与安装
 
-请前往 [Releases](https://git.starlight.cool/AxTps/Starlight_Lancher/releases/latest) 下载适合你操作系统的最新安装包。
+请前往 [Releases](https://github.com/ApTx2012/Starlight_Lancher/releases/latest) 下载适合你操作系统的最新安装包。
 已安装的用户每次均可通过内置的 Tauri 签名校验机制，自动在后台完成更新，无需手动下载安装更新。
 
 | 系统平台                | 推荐下载文件                              |

apps/app-frontend/COPYING.md

@@ -22,6 +22,10 @@ Item identifiers, readable names, and textures are sourced from the `minecraft-t
 
 The recipe data and item artwork ultimately derive from Minecraft data generator output and Minecraft game resources. Minecraft and its original resources are Copyright Mojang Studios / Microsoft and are used only to identify compatible game content. Axolotl Launcher is not affiliated with or endorsed by Mojang Studios or Microsoft.
 
+## About-page scene attribution
+
+The about-page victory illustration is the user-approved generated artwork. Its bundled scene layers preserve the approved preview without regenerating the illustration at runtime. The supplied netherite sword artwork and the unmodified `clouds.png` and `moon_phases.png` textures from Minecraft: Java Edition 1.20.6 are Minecraft resources, Copyright Mojang Studios / Microsoft. These assets are stored in `src/assets/about-scene` and do not require a network connection.
+
 ## AI integration attribution
 
 The AI provider settings information architecture, provider catalog, and provider descriptions are adapted from [LobeChat](https://github.com/lobehub/lobe-chat) at commit `a27dfaeda1ab499ac024a6eb0448917b216ba8a1`. The localized provider descriptions under `src/data/lobehub-provider-descriptions` are reproduced from that release. Bundled text-model metadata is synchronized separately from [LobeHub's model bank](https://github.com/lobehub/lobehub/tree/main/packages/model-bank/src/aiModels), with its exact source revision recorded in the backend catalog. LobeChat is distributed under the LobeHub Community License; a verbatim copy of that license is provided in [third-party/licenses/LobeHub-Community-License.txt](../../third-party/licenses/LobeHub-Community-License.txt).

apps/app-frontend/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@modrinth/app-frontend",
 	"private": true,
-	"version": "1.0.0-beta1",
+	"version": "1.0.0-beta12",
 	"type": "module",
 	"scripts": {
 		"dev": "vite",

apps/app-frontend/src/App.vue

@@ -3,7 +3,6 @@ import { AuthFeature, TauriModrinthClient, VerboseLoggingFeature } from '@modrin
 import {
 	ChangeSkinIcon,
 	CompassIcon,
-	GlobeIcon,
 	DownloadIcon,
 	ExternalIcon,
 	FlaskConicalIcon,
@@ -57,16 +56,18 @@ import SymlinkMethodCards from '@modrinth/ui/src/components/flows/drop/SymlinkMe
 import { useQuery } from '@tanstack/vue-query'
 import { getVersion } from '@tauri-apps/api/app'
 import { convertFileSrc, invoke } from '@tauri-apps/api/core'
-import { hideAllPoppers } from 'floating-vue'
 import { listen } from '@tauri-apps/api/event'
 import { Effect, getCurrentWindow } from '@tauri-apps/api/window'
 import { fetch as tauriFetch } from '@tauri-apps/plugin-http'
 import { openUrl } from '@tauri-apps/plugin-opener'
 import { type as getOsType } from '@tauri-apps/plugin-os'
 import { saveWindowState, StateFlags } from '@tauri-apps/plugin-window-state'
-import { computed, nextTick, onMounted, onUnmounted, provide, ref, watch } from 'vue'
+import { hideAllPoppers } from 'floating-vue'
+import { computed, onMounted, onUnmounted, provide, ref, watch } from 'vue'
 import { type RouteLocationNormalizedLoaded, RouterView, useRoute, useRouter } from 'vue-router'
 
+import InstancePlayerModal from '@/components/instance/InstancePlayerModal.vue'
+import TaggedModDownloadsModal from '@/components/instance/TaggedModDownloadsModal.vue'
 import InstanceExportModal from '@/components/lab/recipe-generator/InstanceExportModal.vue'
 import AccountsCard from '@/components/ui/AccountsCard.vue'
 import AppActionBar from '@/components/ui/AppActionBar.vue'
@@ -90,6 +91,7 @@ import NavButton from '@/components/ui/NavButton.vue'
 import NavRail from '@/components/ui/NavRail.vue'
 import OnboardingOverlay from '@/components/ui/onboarding/OnboardingOverlay.vue'
 import QuickInstanceSwitcher from '@/components/ui/QuickInstanceSwitcher.vue'
+import SkinSiteSessionFrame from '@/components/ui/SkinSiteSessionFrame.vue'
 import SplashScreen from '@/components/ui/SplashScreen.vue'
 import WindowControls from '@/components/ui/WindowControls.vue'
 import { useCheckDisableMouseover } from '@/composables/macCssFix.js'
@@ -111,6 +113,7 @@ import {
 } from '@/helpers/events.js'
 import { install_create_modpack_instance, install_get_modpack_preview } from '@/helpers/install'
 import { type DirectLinkSyncReport, get as getInstance, run } from '@/helpers/instance'
+import { PlayerSelectionNavigatedAwayError } from '@/helpers/instance-player'
 import { reconcileMojangAuthSourceAtStartup } from '@/helpers/mojang-auth'
 import { cancelLogin, get as getCreds, login, logout } from '@/helpers/mr_auth.ts'
 import { mergeUrlQuery, parseModrinthLink } from '@/helpers/project-links.ts'
@@ -135,7 +138,6 @@ import {
 	isDev,
 	isElevated,
 	isNetworkMetered,
-	restartApp,
 	setRestartAfterPendingUpdate,
 } from '@/helpers/utils.js'
 import { start_join_server, start_join_singleplayer_world } from '@/helpers/worlds.ts'
@@ -487,6 +489,12 @@ onMounted(async () => {
 	document.querySelector('body').addEventListener('auxclick', handleAuxClick)
 	window.addEventListener(DIRECT_LINKS_SYNCED_EVENT, handleDirectLinkSyncReport)
 
+	try {
+		await stateInitialization
+	} catch {
+		return
+	}
+
 	checkUpdates()
 	void warnIfRunningElevated()
 	startDirectLinkSync()
@@ -730,10 +738,6 @@ const messages = defineMessages({
 		id: 'app.navigation.skin-selector',
 		defaultMessage: 'Skin selector',
 	},
-	starlightSkin: {
-		id: 'app.navigation.starlight-skin',
-		defaultMessage: '斯达莱特',
-	},
 	library: {
 		id: 'app.navigation.library',
 		defaultMessage: 'Library',
@@ -758,9 +762,9 @@ const messages = defineMessages({
 		id: 'app.account.signed-in-as',
 		defaultMessage: 'Signed in as',
 	},
-	playingAs: {
-		id: 'app.minecraft.playing-as',
-		defaultMessage: 'Playing as',
+	userInformation: {
+		id: 'app.minecraft.user-information',
+		defaultMessage: 'User information',
 	},
 	collapseSidebar: {
 		id: 'app.sidebar.collapse',
@@ -1702,6 +1706,7 @@ onMounted(() => {
 	setServerUpdateToPlayModal(updateToPlayModal.value)
 	void (async () => {
 		try {
+			await stateInitialization
 			const ready = await invoke<{
 				pending_crashes: { instance_id: string; uuid: string }[]
 				pending_commands: Parameters<typeof handleCommand>[0][]
@@ -1759,6 +1764,10 @@ async function handleCommand(e) {
 	} else if (e.event === 'LaunchInstance') {
 		const instance = await getInstance(e.id).catch(() => null)
 		const handleLaunchCommandError = async (launchError) => {
+			// Navigating to the skin-site login to pick a player is a deliberate
+			// user action, not a launch failure: stay silent and let the user
+			// re-trigger the launch after signing in.
+			if (launchError instanceof PlayerSelectionNavigatedAwayError) return
 			const handled =
 				(await minecraftCrashModal.value?.handleLaunchError(launchError, {
 					instance_id: e.id,
@@ -2156,6 +2165,8 @@ provideAppUpdateDownloadProgress(appUpdateDownload)
 
 <template>
 	<SplashScreen v-if="!stateFailed" ref="splashScreen" data-tauri-drag-region />
+	<SkinSiteSessionFrame v-if="stateInitialized" />
+	<InstancePlayerModal v-if="stateInitialized" />
 	<div id="teleports"></div>
 	<div
 		v-if="stateInitialized && themeStore.customBackgroundPath && !themeStore.transparentBackground"
@@ -2237,13 +2248,6 @@ provideAppUpdateDownloadProgress(appUpdateDownload)
 				>
 					<ChangeSkinIcon />
 				</NavButton>
-				<NavButton
-					v-tooltip.right="formatMessage(messages.starlightSkin)"
-					data-onboarding-id="nav-starlight-skin"
-					to="/starlight-skin"
-				>
-					<GlobeIcon />
-				</NavButton>
 				<NavButton
 					v-tooltip.right="formatMessage(messages.library)"
 					data-onboarding-id="nav-library"
@@ -2425,9 +2429,13 @@ provideAppUpdateDownloadProgress(appUpdateDownload)
 				{{ formatMessage(messages.authUnreachableBody) }}
 			</Admonition>
 			<div class="page-transition-grid grid min-h-full">
-				<RouterView v-slot="{ Component, route }">
+				<RouterView v-slot="{ Component, route: currentRoute }">
 					<Transition name="page-slide" :css="themeStore.getFeatureFlag('page_transitions')">
-						<div v-if="Component" :key="getPageTransitionKey(route)" class="page-transition-layer">
+						<div
+							v-if="Component"
+							:key="getPageTransitionKey(currentRoute)"
+							class="page-transition-layer"
+						>
 							<Suspense @pending="onSuspensePending" @resolve="onSuspenseResolve">
 								<component :is="Component"></component>
 							</Suspense>
@@ -2469,7 +2477,7 @@ provideAppUpdateDownloadProgress(appUpdateDownload)
 				<div class="sidebar-default-content hidden" :class="{ 'sidebar-enabled': sidebarVisible }">
 					<div class="p-4 border-0 border-b-[1px] border-[--brand-gradient-border] border-solid">
 						<h3 class="text-base text-primary font-medium m-0">
-							{{ formatMessage(messages.playingAs) }}
+							{{ formatMessage(messages.userInformation) }}
 						</h3>
 						<suspense>
 							<AccountsCard ref="accounts" />
@@ -2491,7 +2499,7 @@ provideAppUpdateDownloadProgress(appUpdateDownload)
 		:on-error-action="exportNotificationErrorLogs"
 		:error-action-label="formatMessage(messages.exportErrorLogs)"
 	/>
-	<MinecraftCrashModal ref="minecraftCrashModal" @error="handleError" />
+	<MinecraftCrashModal v-if="stateInitialized" ref="minecraftCrashModal" @error="handleError" />
 	<JavaDownloadConfirmationModal ref="javaDownloadConfirmationModal" />
 	<NewModal
 		ref="closeChoiceModal"
@@ -2579,6 +2587,7 @@ provideAppUpdateDownloadProgress(appUpdateDownload)
 		@install="handleContentInstallModpackInstall"
 		@cancel="handleContentInstallModpackInstallCancel"
 	/>
+	<TaggedModDownloadsModal v-if="stateInitialized" />
 	<CurseForgeManualDownloadsModal
 		ref="contentInstallCurseForgeManualDownloadsModal"
 		@view-instance="handleContentInstallModpackDuplicateGoToInstance"

apps/app-frontend/src/assets/about-scene/wither-cleanup-generation.md

@@ -0,0 +1,31 @@
+# 凋灵局部清理素材
+
+## 横梁删除修正（2026-09-15）
+
+- 素材：[wither-beams-removed.png](./wither-beams-removed.png)，2172 × 724。
+- 方式：内置 imagegen，局部对象删除；输入为上一版清理图与用户标注的两处横梁。
+- 仅使用左右横梁及其侧面的轮廓区域，补回露出的背景；其他位置仍使用之前的清晰素材。对应的横梁护盾面同时删除。
+- 不重编码既有母图，不使用整张新生成图替换画面，不增加模糊或羽化。
+
+最终提示词：
+
+Use case: precise-object-edit.
+Image 1 is the edit target: the full 3:1 Minecraft night scene. Image 2 is a location guide only, with red rectangles identifying two unwanted horizontal shoulder beams. Do NOT copy the UI, red marks, sword, star, clouds or alternate appearance from image 2.
+Remove the TWO long thin horizontal brown/black bars running out sideways from the fallen Wither's upper chest to its left and right side skulls. In image 1 at normalized 2048x683 coordinates these are approximately left x978–1140 y467–527 and right x1280–1405 y487–535. ERASE these bars completely, including their top face and side face; show the existing dark blue-gray ground/background visible through the new open gaps. The left and right skulls must stay in their exact positions on the ground, separated visually from the chest in these gaps. Do not invent substitute bars, short stumps, connecting rods, upright shoulder bones, debris, ribs or decorations in these two gaps.
+Preserve all other pixels/geometry/composition: the three blocky skulls, central neck, broken rib cage, spine, player's exact pose and clothes, moon, landscape, frame edges, lighting and colors. In particular do not remove or redraw the existing curved/segmented chest ribs below the two bars. Precisely restore the small exposed background behind removed bars, with crisp square voxel texture. No blur, smoothing, feathering, depth of field, re-rendering of the whole image, glow or haze. Keep the original full 3:1 frame and exact object registration, at 2172x724 if possible. This is a tiny local object removal, not a restyle.
+
+## 上一版肩部凸出结构清理
+
+- 素材：[wither-shoulder-cleanup.png](./wither-shoulder-cleanup.png)，2172 × 724。
+- 生成方式：内置 imagegen 图像编辑工具。
+- 编辑目标：`victory-clean.jpg`；辅助参考为用户标红的两处肩部异常结构及 Minecraft 凋灵截图。
+- 实际使用：仅将两处肩部异常结构的清理结果合成到清晰母图。整张生成图不作为背景使用，三个头、肋骨、角色和环境保留原有素材。
+- 动画在独立图层中绘制；护盾几何记录在 `wither-shield.ts`，坐标以 2048 × 682⅔ 的场景空间表示。
+
+## 生成时使用的提示词
+
+Use case: precise-object-edit. Asset type: a sharp replacement Wither plate for an existing Minecraft cinematic animated banner. Image 1 is the EDIT TARGET: retain its exact 3:1 panoramic framing and camera, keep every other object and the character unchanged. Image 2 is ONLY an annotation reference: its red rectangles identify two erroneous upright slabs/extra structures on the Wither's shoulders which must be removed; do not draw any red marks. Image 3 is ONLY a vanilla Minecraft Wither anatomy reference; use its simple three-headed skeletal structure, not its standing pose or blue shield.
+
+Regenerate ONLY the fallen Wither in Image 1 cleanly, with crisp straight voxel edges, dark charcoal/black nether bone material and clean low-resolution Minecraft pixel textures. Exactly three cuboid skulls: near-left skull under the player's raised boot, central skull farther back facing upward, right skull at the right, preserving their existing centers, scale, screen orientation and silhouette as closely as possible. Retain the existing supine defeated pose, clean horizontal shoulder crossbar linking the three heads, a compact rib cage with separated squared ribs, and the central spine receding into the foreground. Remove the two upright paddle-like shoulder projections indicated by the red boxes, all extra heads, all spikes/horns, all gold mechanisms, odd rubble embedded in the body, noisy invented decorations and duplicate bones. The chest has one coherent small broken sternum opening centered exactly where the animated sword will enter (about 56% across and 72% down the full panorama). Preserve visible negative space between ribs, without random detached bits. This is a defeated non-human Minecraft boss, no blood or gore.
+
+Keep the player's existing foot resting on the near-left skull at precisely the same height and location. Keep the character, face, volumetric brown hair, yellow clothing, armor, hands and boots absolutely unchanged. Keep the sky, moon, trees, terrain and all other regions unchanged and sharp. Do NOT add a sword or nether star: these already exist as separate animated layers. Do NOT paint any blue shielding, electricity, glow halos or particles onto the Wither; those will be separate precisely aligned animated layers. Match existing cool night illumination and subtle warm gold light on the top-facing bone planes. Reconstruct only the small pieces of ground/sky revealed by removing the two wrong shoulder slabs. No blur, no painterly smoothing, no depth-of-field blur, no sharpening halos. Output a single full panoramic 3:1 edited plate, same framing as Image 1, at the highest available resolution.

apps/app-frontend/src/assets/icons/lucky-clover.svg

@@ -0,0 +1,41 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+	<title>幸运四叶草</title>
+	<path
+		d="M33 34C39.5 38.5 44.5 46 47 56"
+		stroke="var(--clover-edge, #16883F)"
+		stroke-width="5.5"
+		stroke-linecap="round"
+	/>
+	<path
+		d="M32 32C24 29 17 24 17 17.5C17 12.2 21 8 26 8C28.8 8 31 9.7 32 12.2C33 9.7 35.2 8 38 8C43 8 47 12.2 47 17.5C47 24 40 29 32 32Z"
+		fill="var(--clover-leaf, #42C95A)"
+		stroke="var(--clover-edge, #16883F)"
+		stroke-width="2.2"
+		stroke-linejoin="round"
+	/>
+	<path
+		d="M32 32C24 29 17 24 17 17.5C17 12.2 21 8 26 8C28.8 8 31 9.7 32 12.2C33 9.7 35.2 8 38 8C43 8 47 12.2 47 17.5C47 24 40 29 32 32Z"
+		transform="rotate(90 32 32)"
+		fill="var(--clover-leaf, #42C95A)"
+		stroke="var(--clover-edge, #16883F)"
+		stroke-width="2.2"
+		stroke-linejoin="round"
+	/>
+	<path
+		d="M32 32C24 29 17 24 17 17.5C17 12.2 21 8 26 8C28.8 8 31 9.7 32 12.2C33 9.7 35.2 8 38 8C43 8 47 12.2 47 17.5C47 24 40 29 32 32Z"
+		transform="rotate(180 32 32)"
+		fill="var(--clover-leaf, #42C95A)"
+		stroke="var(--clover-edge, #16883F)"
+		stroke-width="2.2"
+		stroke-linejoin="round"
+	/>
+	<path
+		d="M32 32C24 29 17 24 17 17.5C17 12.2 21 8 26 8C28.8 8 31 9.7 32 12.2C33 9.7 35.2 8 38 8C43 8 47 12.2 47 17.5C47 24 40 29 32 32Z"
+		transform="rotate(270 32 32)"
+		fill="var(--clover-leaf, #42C95A)"
+		stroke="var(--clover-edge, #16883F)"
+		stroke-width="2.2"
+		stroke-linejoin="round"
+	/>
+	<circle cx="32" cy="32" r="3.7" fill="var(--clover-edge, #16883F)" />
+</svg>

apps/app-frontend/src/components/RowDisplay.vue

@@ -42,6 +42,7 @@ const { offline } = useNetworkStatus()
 const handleMinecraftLaunchError = useMinecraftLaunchError()
 
 const messages = defineMessages({
+	stopAll: { id: 'app.instance.stop-all', defaultMessage: 'Stop all windows of this instance' },
 	addContent: { id: 'app.instances.add-content', defaultMessage: 'Add content' },
 	viewInstance: { id: 'app.instances.view-instance', defaultMessage: 'View instance' },
 	duplicateInstance: {
@@ -265,7 +266,12 @@ onUnmounted(() => {
 		@delete="deleteInstance"
 	/>
 	<div ref="rowContainer" class="flex flex-col gap-4">
-		<div v-for="row in actualInstances" ref="rows" :key="row.label" class="row flex flex-col items-start overflow-hidden w-full min-w-full">
+		<div
+			v-for="row in actualInstances"
+			ref="rows"
+			:key="row.label"
+			class="row flex flex-col items-start overflow-hidden w-full min-w-full"
+		>
 			<HeadingLink class="mt-1" :to="row.route">
 				{{ row.label }}
 			</HeadingLink>
@@ -307,7 +313,7 @@ onUnmounted(() => {
 	</div>
 	<ContextMenu ref="instanceOptions" @option-clicked="handleOptionsClick">
 		<template #play> <PlayIcon /> {{ formatMessage(commonMessages.playButton) }} </template>
-		<template #stop> <StopCircleIcon /> {{ formatMessage(commonMessages.stopButton) }} </template>
+		<template #stop> <StopCircleIcon /> {{ formatMessage(messages.stopAll) }} </template>
 		<template #add_content> <PlusIcon /> {{ formatMessage(messages.addContent) }} </template>
 		<template #edit> <EyeIcon /> {{ formatMessage(messages.viewInstance) }} </template>
 		<template #delete> <TrashIcon /> {{ formatMessage(commonMessages.deleteLabel) }} </template>

apps/app-frontend/src/components/home/HomeLaunchProgress.vue

@@ -1,11 +1,11 @@
-
 <script setup lang="ts">
 import { DownloadIcon } from '@modrinth/assets'
-import { defineMessages, useVIntl } from '@modrinth/ui'
+import { defineMessages, ProgressBar, useVIntl } from '@modrinth/ui'
 import { computed, onUnmounted, ref } from 'vue'
 
 import { loading_listener } from '@/helpers/events'
 import type { LoadingBar } from '@/helpers/state'
+import { progress_bars_list } from '@/helpers/state'
 
 const { formatMessage } = useVIntl()
 
@@ -15,6 +15,7 @@ const messages = defineMessages({
 })
 
 interface LoadingEventPayload {
+	total?: number | null
 	event: LoadingBar['bar_type']
 	loader_uuid: string
 	fraction: number | null
@@ -22,6 +23,7 @@ interface LoadingEventPayload {
 }
 
 interface LaunchProgressItem {
+	waiting: boolean
 	key: string
 	message: string
 	fraction: number | null
@@ -29,6 +31,7 @@ interface LaunchProgressItem {
 
 // 启动相关（以及准备）阶段会发的 loading 类型；安装/下载也一并显示，便于用户看到进度
 const LAUNCH_BAR_TYPES = new Set([
+	'hosted_pack_sync',
 	'minecraft_download',
 	'instance_update',
 	'zip_extract',
@@ -54,6 +57,7 @@ function applyEvent(payload: LoadingEventPayload) {
 	if (!isVisible(payload.event)) return
 
 	activeMap.set(payload.loader_uuid, {
+		waiting: payload.total === 0,
 		key: payload.loader_uuid,
 		message: payload.message,
 		fraction: payload.fraction,
@@ -64,13 +68,28 @@ function applyEvent(payload: LoadingEventPayload) {
 const hasProgress = computed(() => progressItems.value.length > 0)
 
 function percent(item: LaunchProgressItem): string {
-	if (item.fraction == null || !Number.isFinite(item.fraction)) return ''
+	if (item.waiting || item.fraction == null || !Number.isFinite(item.fraction)) return ''
 	return `${Math.round(Math.max(0, Math.min(1, item.fraction)) * 100)}%`
 }
 
+let initializing = true
+const buffered: LoadingEventPayload[] = []
 const unlistenLoading = await loading_listener((payload: LoadingEventPayload) => {
-	applyEvent(payload)
+	if (initializing) buffered.push(payload)
+	else applyEvent(payload)
 })
+const bars = await progress_bars_list().catch(() => ({}))
+for (const bar of Object.values(bars)) {
+	applyEvent({
+		event: bar.bar_type,
+		loader_uuid: String(bar.loading_bar_uuid),
+		fraction: bar.total ? (bar.current ?? 0) / bar.total : 0,
+		total: bar.total,
+		message: bar.message ?? '',
+	})
+}
+initializing = false
+for (const payload of buffered) applyEvent(payload)
 
 onUnmounted(() => {
 	unlistenLoading?.()
@@ -96,12 +115,7 @@ onUnmounted(() => {
 						{{ percent(item) }}
 					</span>
 				</div>
-				<div class="h-1 w-full overflow-hidden rounded-full bg-surface-4">
-					<div
-						class="h-full rounded-full bg-brand transition-[width] duration-200"
-						:style="{ width: percent(item) || '100%' }"
-					/>
-				</div>
+				<ProgressBar :progress="item.fraction ?? 0" :waiting="item.waiting" full-width />
 			</li>
 		</ul>
 	</section>

apps/app-frontend/src/components/home/HomeMinecraftNews.vue

@@ -1,35 +1,70 @@
 <script setup lang="ts">
-import { ExternalIcon } from '@modrinth/assets'
-import { defineMessages, injectNotificationManager, useVIntl } from '@modrinth/ui'
-import { openUrl } from '@tauri-apps/plugin-opener'
+import { ButtonStyled, defineMessages, useVIntl } from '@modrinth/ui'
+import { computed, ref, watch } from 'vue'
+
+import LuckyCloverIcon from '@/assets/icons/lucky-clover.svg'
+import {
+	openSkinSiteLogin,
+	requestSkinSiteLuck,
+	skinSiteUser,
+} from '@/composables/skin-site-session'
 
 const { formatMessage } = useVIntl()
-const { handleError } = injectNotificationManager()
 
 const messages = defineMessages({
-	widgetTitle: { id: 'app.home.skin-site.title', defaultMessage: 'StarLight skin site' },
-	luckyIndex: { id: 'app.home.skin-site.lucky-index', defaultMessage: 'Lucky index' },
-	jump: { id: 'app.home.skin-site.jump', defaultMessage: 'Jump to StarLight skin site' },
+	widgetTitle: { id: 'app.home.luck.title', defaultMessage: 'Daily luck index' },
+	getLuck: { id: 'app.home.luck.get', defaultMessage: 'Get with one click' },
+	loginToGet: { id: 'app.home.luck.login-to-get', defaultMessage: 'Sign in to get it' },
+	loading: { id: 'app.home.luck.loading', defaultMessage: 'Asking the little sprite...' },
+	error: {
+		id: 'app.home.luck.error',
+		defaultMessage: 'The little sprite did not answer. Please try again later.',
+	},
+	outOf: { id: 'app.home.luck.out-of', defaultMessage: 'out of 100' },
 })
 
-const SKIN_PROFILE_URL = 'https://skin.starlight.cool/profile'
-const SKIN_HOME_URL = 'https://skin.starlight.cool/'
+const luck = ref<number | null>(null)
+const loading = ref(false)
+const failed = ref(false)
+const waitingForLogin = ref(false)
+const signedIn = computed(() => Boolean(skinSiteUser.value))
 
-async function openProfile() {
+async function fetchLuck() {
+	if (loading.value) return
+	loading.value = true
+	failed.value = false
 	try {
-		await openUrl(SKIN_PROFILE_URL)
-	} catch (error) {
-		handleError(error)
+		luck.value = await requestSkinSiteLuck()
+	} catch {
+		failed.value = true
+	} finally {
+		loading.value = false
 	}
 }
 
-async function openSkinSite() {
-	try {
-		await openUrl(SKIN_HOME_URL)
-	} catch (error) {
-		handleError(error)
+function handlePrimaryAction() {
+	if (signedIn.value) {
+		void fetchLuck()
+		return
 	}
+	waitingForLogin.value = true
+	openSkinSiteLogin()
 }
+
+watch(
+	() => skinSiteUser.value?.uuid,
+	(uuid, previousUuid) => {
+		if (uuid === previousUuid) return
+		luck.value = null
+		failed.value = false
+		if (uuid && waitingForLogin.value) {
+			waitingForLogin.value = false
+			void fetchLuck()
+		} else if (!uuid) {
+			waitingForLogin.value = false
+		}
+	},
+)
 </script>
 
 <template>
@@ -37,32 +72,72 @@ async function openSkinSite() {
 		class="flex min-w-0 flex-col gap-3 border-0 border-b-[1px] border-solid border-[--brand-gradient-border] p-4"
 	>
 		<div class="flex items-center gap-2">
-			<ExternalIcon class="size-4 shrink-0 text-secondary" aria-hidden="true" />
+			<LuckyCloverIcon class="lucky-clover size-5 shrink-0" aria-hidden="true" />
 			<h2 class="m-0 truncate text-lg">
 				{{ formatMessage(messages.widgetTitle) }}
 			</h2>
 		</div>
 
-		<div class="flex flex-col gap-2">
-			<button
-				type="button"
-				class="flex w-full cursor-pointer items-center justify-between rounded-lg border border-[--brand-gradient-border] bg-transparent px-3 py-2 text-left transition-colors hover:bg-button-bg"
-				@click="openProfile"
-			>
-				<span class="text-sm font-semibold text-contrast">
-					{{ formatMessage(messages.luckyIndex) }}
-				</span>
-				<ExternalIcon class="size-4 shrink-0 text-secondary" aria-hidden="true" />
-			</button>
+		<div class="flex flex-col gap-3">
+			<div v-if="loading" class="luck-feedback" role="status" aria-live="polite">
+				<LuckyCloverIcon
+					class="lucky-clover lucky-clover-loading size-7 shrink-0"
+					aria-hidden="true"
+				/>
+				<span>{{ formatMessage(messages.loading) }}</span>
+			</div>
+			<div v-else-if="luck !== null" class="luck-feedback" aria-live="polite">
+				<strong class="text-3xl leading-none text-contrast">{{ luck }}</strong>
+				<span class="text-xs text-secondary">{{ formatMessage(messages.outOf) }}</span>
+			</div>
+			<p v-else-if="failed" class="m-0 text-sm leading-5 text-secondary" role="alert">
+				{{ formatMessage(messages.error) }}
+			</p>
 
-			<button
-				type="button"
-				class="flex w-full cursor-pointer items-center justify-center gap-2 rounded-lg bg-[--brand-gradient] px-3 py-2 font-semibold text-[var(--color-contrast)] transition-opacity hover:opacity-90"
-				@click="openSkinSite"
-			>
-				<ExternalIcon class="size-4 shrink-0" aria-hidden="true" />
-				<span>{{ formatMessage(messages.jump) }}</span>
-			</button>
+			<ButtonStyled color="brand" class="w-full">
+				<button type="button" class="w-full" :disabled="loading" @click="handlePrimaryAction">
+					{{ formatMessage(signedIn ? messages.getLuck : messages.loginToGet) }}
+				</button>
+			</ButtonStyled>
 		</div>
 	</section>
 </template>
+
+<style scoped>
+.lucky-clover {
+	--clover-leaf: color-mix(in srgb, #42c95a 88%, var(--color-brand));
+	--clover-edge: color-mix(in srgb, #16883f 88%, var(--color-brand));
+}
+
+.luck-feedback {
+	display: flex;
+	min-height: 2.75rem;
+	align-items: center;
+	justify-content: center;
+	gap: 0.5rem;
+	font-weight: 600;
+	color: var(--color-secondary);
+	text-align: center;
+}
+
+.lucky-clover-loading {
+	transform-origin: center;
+	animation: clover-wait 850ms ease-in-out infinite;
+}
+
+@keyframes clover-wait {
+	0%,
+	100% {
+		transform: translateY(1px) rotate(-5deg) scale(0.96);
+	}
+	50% {
+		transform: translateY(-2px) rotate(6deg) scale(1.04);
+	}
+}
+
+@media (prefers-reduced-motion: reduce) {
+	.lucky-clover-loading {
+		animation: none;
+	}
+}
+</style>

apps/app-frontend/src/components/home/HomeMinimal.vue

@@ -28,6 +28,7 @@ import { useNetworkStatus } from '@/composables/useNetworkStatus'
 import { process_listener } from '@/helpers/events'
 import { install_existing_instance, install_pack_to_existing_instance } from '@/helpers/install'
 import { kill, run } from '@/helpers/instance'
+import { isInstanceLaunching } from '@/helpers/instance-launch-state'
 import { get_by_instance_id } from '@/helpers/process'
 import type { GameInstance } from '@/helpers/types'
 import { handleSevereError } from '@/store/error'
@@ -50,6 +51,8 @@ const handleMinecraftLaunchError = useMinecraftLaunchError()
 const { offline } = useNetworkStatus()
 
 const messages = defineMessages({
+	launchAnother: { id: 'app.instance.launch-another', defaultMessage: 'Launch another window' },
+	stopAll: { id: 'app.instance.stop-all', defaultMessage: 'Stop all windows of this instance' },
 	chooseInstance: {
 		id: 'app.home.minimal.choose-instance',
 		defaultMessage: 'Choose instance',
@@ -88,14 +91,17 @@ const selectedInstance = computed(() =>
 	props.instances.find((instance) => instance.id === props.selectedInstanceId),
 )
 const running = ref(false)
-const loading = ref(false)
-const currentEvent = ref<string | null>(null)
+const installingId = ref<string>()
 const installed = computed(() => selectedInstance.value?.install_stage === 'installed')
 const installing = computed(
 	() => selectedInstance.value?.install_stage.includes('installing') ?? false,
 )
 const busy = computed(
-	() => loading.value || installing.value || (currentEvent.value === 'launched' && !running.value),
+	() =>
+		!!selectedInstance.value &&
+		(isInstanceLaunching(selectedInstance.value.id) ||
+			installingId.value === selectedInstance.value.id ||
+			installing.value),
 )
 
 const lastPlayed = computed(() => {
@@ -111,18 +117,17 @@ async function refreshProcessState() {
 		return
 	}
 
-	const processes = await get_by_instance_id(selectedInstance.value.id).catch((error) => {
+	const id = selectedInstance.value.id
+	const processes = await get_by_instance_id(id).catch((error) => {
 		handleError(error)
 		return []
 	})
-	running.value = processes.length > 0
+	if (selectedInstance.value?.id === id) running.value = processes.length > 0
 }
 
 async function playInstance() {
 	const instance = selectedInstance.value
-	if (!instance) return
-
-	loading.value = true
+	if (!instance || busy.value) return
 	try {
 		await run(instance.id)
 	} catch (error) {
@@ -132,7 +137,6 @@ async function playInstance() {
 		})
 		if (!handled) handleSevereError(error, { instanceId: instance.id })
 	} finally {
-		loading.value = false
 		await refreshProcessState()
 	}
 }
@@ -142,14 +146,14 @@ async function stopInstance() {
 	if (!instance) return
 
 	await kill(instance.id).catch(handleError)
-	running.value = false
+	await refreshProcessState()
 }
 
 async function installInstance() {
 	const instance = selectedInstance.value
 	if (!instance) return
 
-	loading.value = true
+	installingId.value = instance.id
 	try {
 		if (
 			instance.install_stage !== 'pack_installed' &&
@@ -168,14 +172,14 @@ async function installInstance() {
 	} catch (error) {
 		handleError(error)
 	} finally {
-		loading.value = false
+		if (installingId.value === instance.id) installingId.value = undefined
 	}
 }
 
 watch(
 	() => props.selectedInstanceId,
 	() => {
-		currentEvent.value = null
+		running.value = false
 		void refreshProcessState()
 	},
 )
@@ -184,9 +188,7 @@ await refreshProcessState()
 
 const unlistenProcess = await process_listener((event: { instance_id: string; event: string }) => {
 	if (event.instance_id !== selectedInstance.value?.id) return
-	currentEvent.value = event.event
-	if (event.event === 'finished') running.value = false
-	else void refreshProcessState()
+	void refreshProcessState()
 })
 
 onUnmounted(() => {
@@ -237,13 +239,17 @@ onUnmounted(() => {
 						</router-link>
 
 						<div class="flex min-h-11 shrink-0 items-center justify-end gap-2">
-							<ButtonStyled v-if="running" color="red" size="large">
-								<button class="w-36 justify-center" @click="stopInstance">
+							<ButtonStyled v-if="running" color="red" size="large" circular>
+								<button
+									v-tooltip="formatMessage(messages.stopAll)"
+									:aria-label="formatMessage(messages.stopAll)"
+									:disabled="busy"
+									@click="stopInstance"
+								>
 									<StopCircleIcon aria-hidden="true" />
-									<span class="truncate">{{ formatMessage(commonMessages.stopButton) }}</span>
 								</button>
 							</ButtonStyled>
-							<ButtonStyled v-else-if="busy" size="large">
+							<ButtonStyled v-if="busy" size="large">
 								<button class="w-36 justify-center" disabled>
 									<SpinnerIcon class="animate-spin" aria-hidden="true" />
 									<span class="truncate">
@@ -256,7 +262,9 @@ onUnmounted(() => {
 							<ButtonStyled v-else-if="installed" color="brand" size="large">
 								<button class="w-36 justify-center" @click="playInstance">
 									<PlayIcon class="translate-x-px" aria-hidden="true" />
-									<span class="truncate">{{ formatMessage(commonMessages.playButton) }}</span>
+									<span class="truncate">{{
+										formatMessage(running ? messages.launchAnother : commonMessages.playButton)
+									}}</span>
 								</button>
 							</ButtonStyled>
 							<ButtonStyled v-else color="brand" size="large">

apps/app-frontend/src/components/home/HomeRecentWorlds.vue

@@ -36,6 +36,7 @@ const props = withDefaults(
 		limit?: HomeRecentLimit
 	}>(),
 	{
+		dashboardSize: null,
 		limit: HOME_RECENT_DEFAULT_LIMIT,
 	},
 )
@@ -146,11 +147,17 @@ async function stopInstance(instance: GameInstance) {
 </script>
 
 <template>
-	<section class="home-recent-worlds flex min-w-0 min-h-0 h-full flex-col gap-3" :data-size="dashboardSize">
+	<section
+		class="home-recent-worlds flex min-w-0 min-h-0 h-full flex-col gap-3"
+		:data-size="dashboardSize"
+	>
 		<div class="home-widget-heading flex min-w-0 h-8 flex-none items-center gap-2">
 			<h2>{{ formatMessage(messages.recentTitle) }}</h2>
 		</div>
-		<div v-if="recentItems.length > 0" class="home-recent-list flex min-w-0 min-h-0 flex-1 flex-col gap-1 overflow-x-hidden overflow-y-auto pr-1">
+		<div
+			v-if="recentItems.length > 0"
+			class="home-recent-list flex min-w-0 min-h-0 flex-1 flex-col gap-1 overflow-x-hidden overflow-y-auto pr-1"
+		>
 			<template
 				v-for="item in recentItems"
 				:key="item.type === 'world' ? worldKey(item.world) : `${item.instance.id}:instance`"

apps/app-frontend/src/components/instance/HostedGameDirModal.vue

@@ -0,0 +1,161 @@
+<template>
+	<NewModal
+		ref="modal"
+		:header="formatMessage(messages.header)"
+		max-width="560px"
+		:on-hide="handleHide"
+	>
+		<div class="flex flex-col gap-4">
+			<p class="m-0 text-secondary">
+				{{ formatMessage(messages.description) }}
+			</p>
+
+			<div class="flex flex-col gap-2">
+				<span class="font-semibold text-contrast">
+					{{ formatMessage(messages.gameDirLabel) }}
+				</span>
+				<div class="flex gap-2">
+					<StyledInput
+						class="flex-1"
+						:model-value="selectedPath"
+						readonly
+						:placeholder="defaultPath || formatMessage(messages.noSelection)"
+					/>
+					<ButtonStyled>
+						<button type="button" @click="browse">
+							<FolderOpenIcon />
+							{{ formatMessage(messages.browse) }}
+						</button>
+					</ButtonStyled>
+				</div>
+				<button
+					v-if="defaultPath && selectedPath !== defaultPath"
+					type="button"
+					class="self-start text-sm text-brand underline decoration-transparent underline-offset-2 transition-colors hover:decoration-current"
+					@click="selectedPath = defaultPath"
+				>
+					{{ formatMessage(messages.resetDefault) }}
+				</button>
+			</div>
+
+			<p v-if="previewPath" class="m-0 text-sm text-secondary break-all">
+				{{ formatMessage(messages.preview, { path: previewPath }) }}
+			</p>
+		</div>
+
+		<template #actions>
+			<div class="flex justify-end gap-2">
+				<ButtonStyled type="outlined">
+					<button type="button" @click="handleCancel">
+						<XIcon />
+						{{ formatMessage(commonMessages.cancelButton) }}
+					</button>
+				</ButtonStyled>
+				<ButtonStyled color="brand">
+					<button type="button" :disabled="!selectedPath" @click="handleConfirm">
+						<CheckIcon />
+						{{ formatMessage(messages.confirm) }}
+					</button>
+				</ButtonStyled>
+			</div>
+		</template>
+	</NewModal>
+</template>
+
+<script setup lang="ts">
+import { CheckIcon, FolderOpenIcon, XIcon } from '@modrinth/assets'
+import {
+	ButtonStyled,
+	commonMessages,
+	defineMessages,
+	injectFilePicker,
+	NewModal,
+	StyledInput,
+	useVIntl,
+} from '@modrinth/ui'
+import { invoke } from '@tauri-apps/api/core'
+import { computed, ref } from 'vue'
+
+const emit = defineEmits<{
+	(e: 'confirm', gameDirRoot: string): void
+	(e: 'cancel'): void
+}>()
+
+const { formatMessage } = useVIntl()
+const filePicker = injectFilePicker()
+const modal = ref<InstanceType<typeof NewModal>>()
+const defaultPath = ref('')
+const selectedPath = ref('')
+const accepted = ref(false)
+
+const messages = defineMessages({
+	header: {
+		id: 'app.hosted-install.game-dir.header',
+		defaultMessage: 'Choose game directory',
+	},
+	description: {
+		id: 'app.hosted-install.game-dir.description',
+		defaultMessage:
+			'StarLight instance data (mods, saves, configs, resource packs) is stored in an external game directory. Pick a root folder — the modpack gets its own subfolder inside it.',
+	},
+	gameDirLabel: {
+		id: 'app.hosted-install.game-dir.label',
+		defaultMessage: 'Game directory root',
+	},
+	browse: {
+		id: 'app.hosted-install.game-dir.browse',
+		defaultMessage: 'Browse',
+	},
+	noSelection: {
+		id: 'app.hosted-install.game-dir.no-selection',
+		defaultMessage: 'No folder selected',
+	},
+	resetDefault: {
+		id: 'app.hosted-install.game-dir.reset-default',
+		defaultMessage: 'Use default location',
+	},
+	preview: {
+		id: 'app.hosted-install.game-dir.preview',
+		defaultMessage: 'Game files will be installed to: {path}',
+	},
+	confirm: {
+		id: 'app.hosted-install.game-dir.confirm',
+		defaultMessage: 'Install',
+	},
+})
+
+const previewPath = computed(() => {
+	const base = (selectedPath.value ?? '').replace(/[\\/]+$/, '')
+	return base ? `${base}/<pack name>` : ''
+})
+
+async function show() {
+	if (!defaultPath.value) {
+		defaultPath.value = await invoke<string>('get_launcher_root_dir').catch(() => '')
+	}
+	if (!selectedPath.value) selectedPath.value = defaultPath.value
+	accepted.value = false
+	modal.value?.show()
+}
+
+async function browse() {
+	const picked = await filePicker.pickFolder?.()
+	if (picked?.path) selectedPath.value = picked.path
+}
+
+function handleCancel() {
+	modal.value?.hide()
+}
+
+function handleConfirm() {
+	accepted.value = true
+	modal.value?.hide()
+	emit('confirm', selectedPath.value)
+}
+
+function handleHide() {
+	if (!accepted.value) emit('cancel')
+}
+
+defineExpose({ show })
+</script>

apps/app-frontend/src/components/instance/HostedModpacks.vue

@@ -0,0 +1,208 @@
+<template>
+	<InstanceModeSettings :instance-id="instanceId" :disabled="syncing" class="mb-5" />
+	<div v-if="modeQuery.data.value === 'local'" class="flex flex-col gap-3">
+		<h2 class="m-0">{{ formatMessage(messages.localTitle) }}</h2>
+		<p class="m-0 text-secondary">{{ formatMessage(messages.localPacks) }}</p>
+		<div class="flex flex-wrap gap-3">
+			<ButtonStyled
+				><button type="button" @click="router.push('/browse/modpack')">
+					{{ formatMessage(messages.browse) }}
+				</button></ButtonStyled
+			>
+			<ButtonStyled
+				><button type="button" @click="importLocal">
+					{{ formatMessage(messages.importLocal) }}
+				</button></ButtonStyled
+			>
+		</div>
+	</div>
+	<template v-if="modeQuery.data.value === 'starlight'">
+		<section class="flex flex-col gap-4" :aria-busy="loading || syncing">
+			<div class="flex items-center justify-between gap-4">
+				<div>
+					<h2 class="m-0">{{ formatMessage(messages.title) }}</h2>
+					<p>{{ formatMessage(messages.description) }}</p>
+				</div>
+				<ButtonStyled
+					><button type="button" :disabled="loading || syncing" @click="load">
+						{{ formatMessage(messages.refresh) }}
+					</button></ButtonStyled
+				>
+			</div>
+			<p v-if="loading" role="status">{{ formatMessage(messages.loading) }}</p>
+			<p v-if="error" role="alert" class="text-red">{{ error }}</p>
+			<p v-if="binding">
+				{{
+					formatMessage(messages.bound, {
+						name: binding.publication.manifest.name,
+						version: binding.publication.manifest.version,
+					})
+				}}
+			</p>
+			<HostedPackProgress :instance-id="instanceId" :active="syncing" />
+			<div v-if="result" role="status" class="rounded-xl bg-bg-raised p-4">
+				<p>
+					{{
+						formatMessage(messages.complete, {
+							version: result.version,
+							count: result.changedFiles,
+							size: (result.downloadedBytes / 1048576).toFixed(2),
+						})
+					}}
+				</p>
+				<details v-if="result.preservedFiles.length">
+					<summary>
+						{{ formatMessage(messages.preserved, { count: result.preservedFiles.length }) }}
+					</summary>
+					<ul>
+						<li v-for="path in result.preservedFiles" :key="path">{{ path }}</li>
+					</ul>
+				</details>
+			</div>
+
+			<article
+				v-if="pack"
+				class="flex flex-wrap items-center justify-between gap-4 rounded-xl bg-bg-raised p-4"
+			>
+				<div>
+					<h3 class="m-0">{{ pack.manifest.name }}</h3>
+					<p class="mb-0">
+						{{ pack.manifest.version }} · Minecraft {{ pack.manifest.runtime.gameVersion }} ·
+						{{ pack.manifest.runtime.loader }}
+					</p>
+				</div>
+				<ButtonStyled color="brand"
+					><button type="button" :disabled="!ready || syncing || loading" @click="sync">
+						{{ formatMessage(binding ? messages.update : messages.install) }}
+					</button></ButtonStyled
+				>
+			</article>
+		</section>
+	</template>
+</template>
+<script setup lang="ts">
+import { ButtonStyled, defineMessages, useVIntl } from '@modrinth/ui'
+import { computed, inject, ref, watch } from 'vue'
+import { useRouter } from 'vue-router'
+
+import HostedPackProgress from '@/components/instance/HostedPackProgress.vue'
+import InstanceModeSettings from '@/components/instance/InstanceModeSettings.vue'
+import { markHostedCreationCompleted } from '@/composables/useHostedCreation'
+import { useHostedSync } from '@/composables/useHostedSync'
+import { useInstanceMode } from '@/composables/useInstanceMode'
+import {
+	type HostedBinding,
+	hostedBinding,
+	hostedDefault,
+	type HostedPublication,
+} from '@/helpers/hosted-packs'
+import { injectDownloadManager } from '@/providers/download-manager'
+const props = defineProps<{ instanceId: string }>()
+const modeQuery = useInstanceMode(() => props.instanceId)
+const router = useRouter()
+const showCreation = inject<(options: { skipSetupType: boolean; initialMode: 'import' }) => void>(
+	'showCreationModalWithOptions',
+)
+function importLocal() {
+	showCreation?.({ skipSetupType: true, initialMode: 'import' })
+}
+const { formatMessage } = useVIntl()
+const messages = defineMessages({
+	localTitle: { id: 'app.instance-mode.local-packs-title', defaultMessage: 'Local modpacks' },
+	localPacks: {
+		id: 'app.instance-mode.local-packs',
+		defaultMessage:
+			'Choose any modpack to install as a local instance. Existing files and worlds are kept when you switch to Local; StarLight changes will no longer be synchronized.',
+	},
+	browse: { id: 'app.instance-mode.browse', defaultMessage: 'Browse modpacks' },
+	importLocal: { id: 'app.instance-mode.import', defaultMessage: 'Import as a local instance' },
+	title: { id: 'app.hosted-packs.title', defaultMessage: 'Server-managed modpack' },
+	description: {
+		id: 'app.hosted-packs.description',
+		defaultMessage:
+			'The administrator selects this modpack and its versions. Every launch checks for updates and downloads changes before starting. A valid StarLight login and network connection are required.',
+	},
+	refresh: { id: 'app.hosted-packs.refresh', defaultMessage: 'Refresh' },
+	loading: { id: 'app.hosted-packs.loading', defaultMessage: 'Loading published modpacks…' },
+	bound: { id: 'app.hosted-packs.bound', defaultMessage: 'Installed: {name} · {version}' },
+	syncing: {
+		id: 'app.hosted-packs.syncing',
+		defaultMessage: 'Comparing files and synchronizing changes…',
+	},
+	complete: {
+		id: 'app.hosted-packs.complete',
+		defaultMessage: 'Synced to {version}. Changed {count} files; downloaded {size} MiB.',
+	},
+	preserved: {
+		id: 'app.hosted-packs.preserved',
+		defaultMessage: 'Preserved {count} locally modified or personal files',
+	},
+	empty: {
+		id: 'app.hosted-packs.empty',
+		defaultMessage: 'No modpacks have been approved for publication yet.',
+	},
+	update: { id: 'app.hosted-packs.update', defaultMessage: 'Synchronize now' },
+	install: { id: 'app.hosted-packs.install', defaultMessage: 'Retry automatic installation' },
+})
+const pack = ref<HostedPublication | null>(null)
+const binding = ref<HostedBinding | null>(null)
+const task = useHostedSync(() => props.instanceId)
+const result = task.result
+const manager = injectDownloadManager()
+const loading = ref(false)
+const syncing = computed(
+	() =>
+		task.busy.value ||
+		manager.legacyDownloads.value.some(
+			(bar) =>
+				bar.bar_type?.type === 'hosted_pack_sync' &&
+				bar.bar_type.instance_id === props.instanceId &&
+				!bar.bar_type.error,
+		),
+)
+const ready = ref(false)
+const loadError = ref('')
+const error = computed(() => loadError.value || task.error.value)
+let generation = 0
+async function load() {
+	if (modeQuery.data.value !== 'starlight') return
+	const current = ++generation
+	const instanceId = props.instanceId
+	loading.value = true
+	ready.value = false
+	loadError.value = ''
+	try {
+		const [official, installed] = await Promise.all([hostedDefault(), hostedBinding(instanceId)])
+		if (current !== generation) return
+		pack.value = official
+		binding.value = installed
+		ready.value = true
+	} catch (cause) {
+		if (current === generation) loadError.value = String(cause)
+	} finally {
+		if (current === generation) loading.value = false
+	}
+}
+async function sync() {
+	if (syncing.value || !ready.value || modeQuery.data.value !== 'starlight') return
+	loadError.value = ''
+	const result = await task.sync()
+	if (result) markHostedCreationCompleted(props.instanceId)
+}
+watch(syncing, (busy, wasBusy) => {
+	if (!busy && wasBusy) void load()
+})
+watch(
+	() => [props.instanceId, modeQuery.data.value] as const,
+	() => {
+		generation++
+		loading.value = false
+		ready.value = false
+		loadError.value = ''
+		pack.value = null
+		binding.value = null
+		void load()
+	},
+	{ immediate: true },
+)
+</script>

apps/app-frontend/src/components/instance/HostedPackProgress.vue

@@ -0,0 +1,50 @@
+<script setup lang="ts">
+import { defineMessages, ProgressBar, useVIntl } from '@modrinth/ui'
+import { computed } from 'vue'
+
+import { injectDownloadManager } from '@/providers/download-manager'
+
+const props = defineProps<{ instanceId?: string; active?: boolean }>()
+const manager = injectDownloadManager()
+const { formatMessage } = useVIntl()
+const messages = defineMessages({
+	preparing: {
+		id: 'app.hosted-packs.progress.preparing',
+		defaultMessage: 'Preparing modpack installation…',
+	},
+	downloads: { id: 'app.hosted-packs.progress.downloads', defaultMessage: 'View downloads' },
+})
+const bar = computed(() =>
+	manager.legacyDownloads.value.find(
+		(item) =>
+			props.instanceId &&
+			item.bar_type?.type === 'hosted_pack_sync' &&
+			!item.bar_type.error &&
+			item.bar_type.instance_id === props.instanceId,
+	),
+)
+const waiting = computed(() => !bar.value?.total)
+const current = computed(() =>
+	Math.max(0, Math.min(bar.value?.current ?? 0, bar.value?.total ?? 0)),
+)
+const message = computed(() => bar.value?.message || formatMessage(messages.preparing))
+</script>
+
+<template>
+	<div v-if="active || bar" class="flex min-w-0 flex-col gap-2" role="status">
+		<ProgressBar
+			:progress="current"
+			:max="bar?.total || 1"
+			:waiting="waiting"
+			:label="message"
+			label-class="min-w-0 break-all text-sm text-secondary"
+			:show-progress="!waiting"
+			full-width
+		>
+			<template #progress-icon />
+		</ProgressBar>
+		<RouterLink to="/downloads" class="self-start text-sm text-brand hover:underline">
+			{{ formatMessage(messages.downloads) }}
+		</RouterLink>
+	</div>
+</template>

apps/app-frontend/src/components/instance/InstanceModeOptions.vue

@@ -0,0 +1,59 @@
+<script setup lang="ts">
+import { defineMessages, useVIntl } from '@modrinth/ui'
+import { useId } from 'vue'
+
+import type { InstanceMode } from '@/helpers/hosted-packs'
+
+defineProps<{ modelValue?: InstanceMode; disabled?: boolean }>()
+const emit = defineEmits<{ 'update:modelValue': [value: InstanceMode] }>()
+const group = useId()
+const { formatMessage } = useVIntl()
+const messages = defineMessages({
+	title: { id: 'app.instance-mode.title', defaultMessage: 'Instance type' },
+	starlight: { id: 'app.instance-mode.starlight', defaultMessage: 'StarLight instance' },
+	local: { id: 'app.instance-mode.local', defaultMessage: 'Local instance' },
+	starlightDescription: {
+		id: 'app.instance-mode.starlight-description',
+		defaultMessage:
+			'Required for playing on StarLight. Automatically installs the server-selected modpack, Minecraft version, and loader. Every launch requires a StarLight login and checks for updates before starting.',
+	},
+	localDescription: {
+		id: 'app.instance-mode.local-description',
+		defaultMessage:
+			'Does not sync StarLight server changes. Skips sync checks for faster startup and lets you choose your own modpacks. Best for third-party servers and personal single-player worlds.',
+	},
+})
+</script>
+<template>
+	<fieldset class="m-0 flex flex-col gap-3 border-0 p-0" :disabled="disabled">
+		<legend class="mb-3 text-lg font-semibold text-contrast">
+			{{ formatMessage(messages.title) }}
+		</legend>
+		<label
+			v-for="mode in ['starlight', 'local'] as const"
+			:key="mode"
+			class="flex items-start gap-3 rounded-xl border border-solid border-divider p-4"
+			:class="[
+				modelValue === mode ? 'bg-surface-3' : 'bg-surface-1',
+				disabled ? 'opacity-60' : 'cursor-pointer',
+			]"
+		>
+			<input
+				type="radio"
+				class="mt-1"
+				:name="group"
+				:value="mode"
+				:checked="modelValue === mode"
+				@change="emit('update:modelValue', mode)"
+			/>
+			<span class="flex flex-col gap-1"
+				><span class="font-semibold text-contrast">{{ formatMessage(messages[mode]) }}</span
+				><span class="text-sm text-secondary">{{
+					formatMessage(
+						mode === 'starlight' ? messages.starlightDescription : messages.localDescription,
+					)
+				}}</span></span
+			>
+		</label>
+	</fieldset>
+</template>

apps/app-frontend/src/components/instance/InstanceModeSettings.vue

@@ -0,0 +1,67 @@
+<script setup lang="ts">
+import { ButtonStyled, defineMessages, useVIntl } from '@modrinth/ui'
+import { computed, watch } from 'vue'
+
+import InstanceModeOptions from '@/components/instance/InstanceModeOptions.vue'
+import { useInstanceMode, useSetInstanceMode } from '@/composables/useInstanceMode'
+import type { InstanceMode } from '@/helpers/hosted-packs'
+
+const props = defineProps<{ instanceId: string; disabled?: boolean }>()
+const query = useInstanceMode(() => props.instanceId)
+const save = useSetInstanceMode()
+const { formatMessage } = useVIntl()
+const messages = defineMessages({
+	saving: {
+		id: 'app.instance-mode.saving',
+		defaultMessage: 'Applying instance type and installing the server modpack when needed…',
+	},
+	loading: { id: 'app.instance-mode.loading', defaultMessage: 'Loading instance type…' },
+	retry: { id: 'app.instance-mode.retry', defaultMessage: 'Retry' },
+})
+const saving = computed(
+	() => save.isPending.value && save.variables.value?.instanceId === props.instanceId,
+)
+const selection = computed(() => (saving.value ? save.variables.value?.mode : query.data.value))
+const failure = computed(
+	() =>
+		query.error.value ??
+		(save.variables.value?.instanceId === props.instanceId ? save.error.value : null),
+)
+function select(mode: InstanceMode) {
+	if (props.disabled || saving.value || !query.data.value || query.data.value === mode) return
+	save.mutate({ instanceId: props.instanceId, mode })
+}
+function retry() {
+	if (props.disabled || saving.value) return
+	if (query.error.value) void query.refetch()
+	else if (save.variables.value?.instanceId === props.instanceId) save.mutate(save.variables.value)
+}
+watch(
+	() => props.instanceId,
+	() => save.reset(),
+)
+</script>
+<template>
+	<div class="flex flex-col gap-3">
+		<InstanceModeOptions
+			:model-value="selection"
+			:disabled="disabled || !query.data.value || query.isPending.value || saving"
+			@update:model-value="select"
+		/>
+		<p v-if="query.isPending.value || saving" class="m-0 text-secondary" role="status">
+			{{ formatMessage(saving ? messages.saving : messages.loading) }}
+		</p>
+		<div v-if="failure" role="alert" class="flex items-center gap-3">
+			<span>{{ String(failure) }}</span
+			><ButtonStyled
+				><button
+					type="button"
+					:disabled="disabled || query.isFetching.value || saving"
+					@click="retry"
+				>
+					{{ formatMessage(messages.retry) }}
+				</button></ButtonStyled
+			>
+		</div>
+	</div>
+</template>

apps/app-frontend/src/components/instance/InstancePlayerModal.vue

@@ -0,0 +1,250 @@
+<script setup lang="ts">
+import { ButtonStyled, NewModal, useVIntl } from '@modrinth/ui'
+import { computed, onUnmounted, ref, watch } from 'vue'
+import { useRouter } from 'vue-router'
+
+import MinecraftLoginModal from '@/components/ui/MinecraftLoginModal.vue'
+import {
+	openSkinSiteLogin,
+	requestSkinSitePlayers,
+	skinSitePlayers,
+	skinSiteStatus,
+	skinSiteUser,
+} from '@/composables/skin-site-session'
+import { users } from '@/helpers/auth'
+import { getInstanceMode } from '@/helpers/hosted-packs'
+import {
+	type InstancePlayer,
+	type PlayerChoice,
+	PlayerSelectionNavigatedAwayError,
+	registerInstancePlayerPicker,
+	saveInstancePlayer,
+	waitForSkinSiteSession,
+} from '@/helpers/instance-player'
+
+import { playerMessages as messages } from './instance-player-messages'
+
+const { formatMessage } = useVIntl()
+
+const modal = ref<InstanceType<typeof NewModal>>()
+const microsoftLogin = ref<InstanceType<typeof MinecraftLoginModal>>()
+const router = useRouter()
+const accounts = ref<PlayerChoice[]>([])
+const active = ref(false)
+const loading = ref(false)
+const saving = ref(false)
+const error = ref('')
+const instanceId = ref('')
+const locked = ref<InstancePlayer | null>(null)
+const awaitingSkinLogin = ref(false)
+let hideForLogin = false
+let generation = 0
+let resolveSelection: ((player: InstancePlayer) => void) | undefined
+let rejectSelection: ((reason: Error) => void) | undefined
+const choices = computed(() => {
+	const skin: PlayerChoice[] =
+		skinSiteStatus.value === 'signed-in'
+			? skinSitePlayers.value
+					.filter((player) => !player.isMojang)
+					.map((player) => ({
+						id: player.uuid,
+						name: player.name,
+						account_type: 'yggdrasil',
+						skin_site_user: skinSiteUser.value?.uuid,
+						head: player.headDataUrl,
+					}))
+			: []
+	return [...skin, ...accounts.value].filter(
+		(player) =>
+			!locked.value ||
+			(player.id.replaceAll('-', '') === locked.value.id.replaceAll('-', '') &&
+				player.account_type === locked.value.account_type &&
+				(player.skin_site_user ?? null) === (locked.value.skin_site_user ?? null)),
+	)
+})
+
+async function refresh() {
+	const revision = ++generation
+	loading.value = true
+	error.value = ''
+	try {
+		const [available, mode] = await Promise.all([users(), getInstanceMode(instanceId.value)])
+		if (revision !== generation) return
+		accounts.value = available
+			.filter(
+				(account) =>
+					account.account_type === 'microsoft' ||
+					(mode === 'local' && account.account_type === 'offline'),
+			)
+			.map((account) => ({
+				id: account.profile.id,
+				name: account.profile.name,
+				account_type: account.account_type,
+			}))
+		await waitForSkinSiteSession()
+		if (revision !== generation) return
+		if (skinSiteStatus.value === 'signed-in') await requestSkinSitePlayers()
+		if (skinSiteStatus.value === 'error') throw new Error('无法确认皮肤站登录状态，请重试。')
+	} catch (cause) {
+		if (revision === generation)
+			error.value = cause instanceof Error ? cause.message : String(cause)
+	} finally {
+		if (revision === generation) loading.value = false
+	}
+}
+
+function cancelled() {
+	if (hideForLogin) {
+		hideForLogin = false
+		return
+	}
+	if (!active.value) return
+	active.value = false
+	awaitingSkinLogin.value = false
+	generation++
+	rejectSelection?.(new Error('已取消选择实例玩家'))
+	resolveSelection = undefined
+	rejectSelection = undefined
+}
+
+async function select(player: PlayerChoice) {
+	if (loading.value || saving.value || !active.value) return
+	saving.value = true
+	error.value = ''
+	try {
+		const { head: _, ...binding } = player
+		await saveInstancePlayer(instanceId.value, binding)
+		active.value = false
+		resolveSelection?.(binding)
+		resolveSelection = undefined
+		rejectSelection = undefined
+		modal.value?.hide()
+	} catch (cause) {
+		error.value = cause instanceof Error ? cause.message : String(cause)
+	} finally {
+		saving.value = false
+	}
+}
+
+function signInSkinSite() {
+	awaitingSkinLogin.value = true
+	hideForLogin = true
+	active.value = false
+	generation++
+	// Settle the pending selection so `prepareInstancePlayer` releases its
+	// in-flight entry; otherwise a later launch would await this forever and
+	// never re-prompt. The caller treats this sentinel as a silent abort.
+	rejectSelection?.(new PlayerSelectionNavigatedAwayError())
+	resolveSelection = undefined
+	rejectSelection = undefined
+	openSkinSiteLogin()
+	modal.value?.hide()
+	void router.push('/starlight-skin')
+}
+
+const unregister = registerInstancePlayerPicker((id, saved) => {
+	if (active.value) return Promise.reject(new Error('请先完成当前实例的玩家选择。'))
+	instanceId.value = id
+	locked.value = saved
+	accounts.value = []
+	awaitingSkinLogin.value = false
+	active.value = true
+	modal.value?.show()
+	void refresh()
+	return new Promise((resolve, reject) => {
+		resolveSelection = resolve
+		rejectSelection = reject
+	})
+})
+watch([skinSiteStatus, () => skinSiteUser.value?.uuid], () => {
+	if (!active.value || saving.value) return
+	if (
+		awaitingSkinLogin.value &&
+		skinSiteStatus.value === 'signed-in' &&
+		(!locked.value?.skin_site_user || locked.value.skin_site_user === skinSiteUser.value?.uuid)
+	) {
+		awaitingSkinLogin.value = false
+		modal.value?.show()
+	}
+	void refresh()
+})
+onUnmounted(() => {
+	unregister()
+	cancelled()
+})
+</script>
+
+<template>
+	<NewModal
+		ref="modal"
+		:header="formatMessage(messages.title)"
+		:closable="!saving"
+		:on-hide="cancelled"
+	>
+		<div class="flex flex-col gap-3">
+			<p class="m-0 text-secondary">
+				{{
+					locked
+						? formatMessage(messages.restore, { name: locked.name })
+						: formatMessage(messages.remember)
+				}}
+			</p>
+			<p v-if="loading" class="m-0" role="status">{{ formatMessage(messages.loading) }}</p>
+			<template v-else>
+				<ButtonStyled v-for="player in choices" :key="`${player.account_type}:${player.id}`">
+					<button
+						type="button"
+						:disabled="saving"
+						class="flex items-center gap-3"
+						@click="select(player)"
+					>
+						<img
+							v-if="player.head"
+							:src="player.head"
+							alt=""
+							class="size-8 rounded-md [image-rendering:pixelated]"
+						/>
+						<span>{{ player.name }}</span
+						><span class="text-secondary">{{
+							formatMessage(
+								player.account_type === 'microsoft'
+									? messages.licensed
+									: player.account_type === 'offline'
+										? messages.offline
+										: messages.skin,
+							)
+						}}</span>
+					</button>
+				</ButtonStyled>
+				<p v-if="!choices.length && !error && !locked" class="m-0 text-secondary">
+					{{ formatMessage(skinSiteStatus === 'signed-in' ? messages.empty : messages.signIn) }}
+				</p>
+			</template>
+			<p v-if="error" class="m-0 text-red" role="alert">{{ error }}</p>
+			<ButtonStyled v-if="error"
+				><button :disabled="loading || saving" @click="refresh">
+					{{ formatMessage(messages.retry) }}
+				</button></ButtonStyled
+			>
+			<ButtonStyled
+				v-if="
+					skinSiteStatus === 'signed-out' ||
+					(locked?.skin_site_user && locked.skin_site_user !== skinSiteUser?.uuid)
+				"
+				><button :disabled="saving" @click="signInSkinSite">
+					{{ formatMessage(messages.skinLogin) }}
+				</button></ButtonStyled
+			>
+			<div class="flex flex-col items-center gap-2">
+				<span class="text-secondary">{{ formatMessage(messages.or) }}</span>
+				<ButtonStyled
+					><button :disabled="loading || saving" @click="microsoftLogin?.showDeviceLogin()">
+						{{ formatMessage(messages.useMicrosoft) }}
+					</button></ButtonStyled
+				>
+			</div>
+			<p v-if="saving" class="m-0" role="status">{{ formatMessage(messages.saving) }}</p>
+		</div>
+	</NewModal>
+	<MinecraftLoginModal ref="microsoftLogin" @complete="refresh" />
+</template>

apps/app-frontend/src/components/instance/InstancePlayerSettings.vue

@@ -0,0 +1,81 @@
+<script setup lang="ts">
+import { ButtonStyled, useVIntl } from '@modrinth/ui'
+import { onUnmounted, ref, watch } from 'vue'
+
+import {
+	chooseInstancePlayer,
+	getInstancePlayer,
+	type InstancePlayer,
+	onInstancePlayerChanged,
+} from '@/helpers/instance-player'
+
+import { playerMessages as messages } from './instance-player-messages'
+
+const { formatMessage } = useVIntl()
+
+const props = defineProps<{ instanceId: string }>()
+const player = ref<InstancePlayer | null>(null)
+const busy = ref(false)
+const error = ref('')
+let generation = 0
+const stop = onInstancePlayerChanged((id, saved) => {
+	if (id === props.instanceId) {
+		generation++
+		player.value = saved
+		busy.value = false
+		error.value = ''
+	}
+})
+onUnmounted(() => {
+	generation++
+	stop()
+})
+watch(
+	() => props.instanceId,
+	async (id) => {
+		const revision = ++generation
+		player.value = null
+		error.value = ''
+		busy.value = true
+		try {
+			const saved = await getInstancePlayer(id)
+			if (generation === revision) player.value = saved
+		} catch (cause) {
+			if (generation === revision) error.value = String(cause)
+		} finally {
+			if (generation === revision) busy.value = false
+		}
+	},
+	{ immediate: true },
+)
+async function change() {
+	if (busy.value) return
+	const revision = generation
+	const id = props.instanceId
+	busy.value = true
+	error.value = ''
+	try {
+		const saved = await chooseInstancePlayer(id)
+		if (generation === revision) player.value = saved
+	} catch (cause) {
+		if (generation === revision)
+			error.value = cause instanceof Error ? cause.message : String(cause)
+	} finally {
+		if (generation === revision) busy.value = false
+	}
+}
+</script>
+<template>
+	<div class="mb-6 flex flex-col gap-2" data-onboarding-id="instance-player-settings">
+		<h3 class="m-0 text-contrast">{{ formatMessage(messages.setting) }}</h3>
+		<p class="m-0 text-secondary">
+			{{ player ? player.name : formatMessage(messages.firstLaunch) }}
+		</p>
+		<ButtonStyled
+			><button :disabled="busy" @click="change">
+				{{ formatMessage(busy ? messages.loading : messages.change) }}
+			</button></ButtonStyled
+		>
+		<p v-if="error" class="m-0 text-red" role="alert">{{ error }}</p>
+	</div>
+</template>

apps/app-frontend/src/components/instance/ModManagementSwitch.vue

@@ -0,0 +1,73 @@
+<template>
+	<div
+		class="management-switch relative isolate mb-4 flex w-full max-w-[26rem] rounded-xl bg-surface-1 p-1"
+		:data-packs="selected === 'packs'"
+		role="group"
+		:aria-label="formatMessage(messages.label)"
+	>
+		<span
+			class="selection absolute inset-y-1 left-1 -z-10 w-[calc(50%_-_4px)] rounded-lg bg-surface-3 shadow-sm"
+			aria-hidden="true"
+		/>
+		<button
+			class="flex-1 cursor-pointer border-0 bg-transparent px-4 py-2.5 font-semibold text-base aria-pressed:text-contrast"
+			type="button"
+			:aria-pressed="selected === 'mods'"
+			@click="select('mods')"
+		>
+			{{ formatMessage(messages.mods) }}
+		</button>
+		<button
+			class="flex-1 cursor-pointer border-0 bg-transparent px-4 py-2.5 font-semibold text-base aria-pressed:text-contrast"
+			type="button"
+			:aria-pressed="selected === 'packs'"
+			@click="select('packs')"
+		>
+			{{ formatMessage(messages.packs) }}
+		</button>
+	</div>
+	<div v-show="selected === 'mods'"><slot /></div>
+	<div v-if="openedPacks" v-show="selected === 'packs'"><slot name="packs" /></div>
+</template>
+<script setup lang="ts">
+import { defineMessages, useVIntl } from '@modrinth/ui'
+import { ref } from 'vue'
+const { formatMessage } = useVIntl()
+const messages = defineMessages({
+	label: { id: 'app.hosted-packs.management', defaultMessage: 'Content management' },
+	mods: { id: 'app.hosted-packs.mods', defaultMessage: 'Manage mods' },
+	packs: { id: 'app.hosted-packs.packs', defaultMessage: 'Manage modpacks' },
+})
+const key = 'starlight:instance:mod-management-tab'
+function initial(): 'mods' | 'packs' {
+	try {
+		return localStorage.getItem(key) === 'packs' ? 'packs' : 'mods'
+	} catch {
+		return 'mods'
+	}
+}
+const selected = ref(initial())
+const openedPacks = ref(selected.value === 'packs')
+function select(value: 'mods' | 'packs') {
+	selected.value = value
+	if (value === 'packs') openedPacks.value = true
+	try {
+		localStorage.setItem(key, value)
+	} catch {
+		/* Selection remains usable without storage. */
+	}
+}
+</script>
+<style scoped>
+.selection {
+	transition: transform 420ms cubic-bezier(0.22, 1, 0.36, 1);
+}
+[data-packs='true'] .selection {
+	transform: translateX(100%);
+}
+@media (prefers-reduced-motion: reduce) {
+	.selection {
+		transition: none;
+	}
+}
+</style>

apps/app-frontend/src/components/instance/TaggedModDownloadsModal.vue

@@ -0,0 +1,151 @@
+<script setup lang="ts">
+import { ButtonStyled, defineMessages, NewModal, ProgressBar, useVIntl } from '@modrinth/ui'
+import { nextTick, onMounted, onUnmounted, ref, shallowRef } from 'vue'
+import { useRouter } from 'vue-router'
+
+import { loading_listener } from '@/helpers/events'
+import { onHostedPackAttemptStarted } from '@/helpers/hosted-packs'
+import { progress_bars_list } from '@/helpers/state'
+import {
+	createTaggedModProgress,
+	type TaggedProgressEvent,
+	type TaggedProgressGroup,
+} from '@/helpers/tagged-mod-progress'
+
+const modal = ref<InstanceType<typeof NewModal>>()
+const router = useRouter()
+const { formatMessage } = useVIntl()
+const state = createTaggedModProgress()
+const groups = shallowRef<TaggedProgressGroup[]>([])
+const messages = defineMessages({
+	title: { id: 'app.hosted-mods.title', defaultMessage: 'Updating server Mods' },
+	description: {
+		id: 'app.hosted-mods.description',
+		defaultMessage: 'The game starts after all required updates have been installed.',
+	},
+	complete: { id: 'app.hosted-mods.complete', defaultMessage: 'Downloaded' },
+	downloads: { id: 'app.hosted-mods.downloads', defaultMessage: 'View downloads' },
+	close: { id: 'app.hosted-mods.close', defaultMessage: 'Close' },
+})
+const size = (value: number) => `${(value / 1048576).toFixed(1)} MiB`
+let disposed = false
+let unlisten: (() => void) | undefined
+let stopAttempts: (() => void) | undefined
+function refresh() {
+	groups.value = [...state.groups.values()]
+}
+function consume(payload: TaggedProgressEvent) {
+	const opened = state.update(payload)
+	refresh()
+	if (opened)
+		void nextTick(() => {
+			const group = state.groups.get(payload.event?.batch_id ?? '')
+			if (!disposed && group && (!group.done || group.error)) modal.value?.show()
+		})
+	if (groups.value.length > 0 && groups.value.every((group) => group.done && !group.error))
+		modal.value?.hide()
+}
+onMounted(async () => {
+	stopAttempts = onHostedPackAttemptStarted((id) => {
+		state.reset(id)
+		refresh()
+		if (!groups.value.length) modal.value?.hide()
+	})
+	let initializing = true
+	const buffered: TaggedProgressEvent[] = []
+	const stop = await loading_listener((payload: TaggedProgressEvent) => {
+		if (initializing) buffered.push(payload)
+		else consume(payload)
+	})
+	if (disposed) {
+		stop()
+		return
+	}
+	unlisten = stop
+	const bars = await progress_bars_list().catch(() => ({}))
+	if (disposed) return
+	const ordered = Object.values(bars).sort(
+		(a, b) =>
+			Number(b.bar_type?.type === 'hosted_pack_sync') -
+			Number(a.bar_type?.type === 'hosted_pack_sync'),
+	)
+	for (const bar of ordered)
+		consume({
+			loader_uuid: String(bar.loading_bar_uuid),
+			event: bar.bar_type,
+			fraction: bar.total ? (bar.current ?? 0) / bar.total : 0,
+			total: bar.total,
+			message: bar.message ?? '',
+		})
+	initializing = false
+	for (const payload of buffered) consume(payload)
+})
+onUnmounted(() => {
+	disposed = true
+	unlisten?.()
+	stopAttempts?.()
+})
+function openDownloads() {
+	modal.value?.hide()
+	void router.push('/downloads')
+}
+</script>
+
+<template>
+	<NewModal
+		ref="modal"
+		:header="formatMessage(messages.title)"
+		width="min(38rem, calc(100vw - 2rem))"
+		scrollable
+		max-content-height="60vh"
+		:close-on-click-outside="false"
+	>
+		<div class="flex flex-col gap-4">
+			<p class="m-0 text-secondary">{{ formatMessage(messages.description) }}</p>
+			<section v-for="group in groups" :key="group.id" class="flex min-w-0 flex-col gap-3">
+				<h3 class="m-0 text-contrast">{{ group.name }}</h3>
+				<p v-if="group.error" role="alert" class="m-0 break-words text-red">{{ group.error }}</p>
+				<p v-else-if="group.message" class="m-0 break-words text-sm text-secondary">
+					{{ group.message }}
+				</p>
+				<div
+					v-for="file in group.files.values()"
+					:key="file.id"
+					class="flex min-w-0 flex-col gap-1"
+				>
+					<div class="flex flex-wrap justify-between gap-2 text-sm">
+						<span class="min-w-0 break-all text-contrast">{{ file.name }}</span>
+						<span class="text-secondary tabular-nums"
+							>{{ size(file.current) }} / {{ size(file.total) }}</span
+						>
+					</div>
+					<p v-if="file.error" class="m-0 break-words text-sm text-red">{{ file.error }}</p>
+					<ProgressBar
+						v-else
+						:progress="file.current"
+						:max="file.total || 1"
+						:waiting="!file.total"
+						:show-progress="!file.done"
+						:label="file.done ? formatMessage(messages.complete) : file.message"
+						full-width
+						><template #progress-icon
+					/></ProgressBar>
+				</div>
+			</section>
+		</div>
+		<template #actions>
+			<div class="flex w-full items-center justify-between gap-2">
+				<ButtonStyled>
+					<button @click="openDownloads">
+						{{ formatMessage(messages.downloads) }}
+					</button>
+				</ButtonStyled>
+				<ButtonStyled>
+					<button @click="modal?.hide()">
+						{{ formatMessage(messages.close) }}
+					</button>
+				</ButtonStyled>
+			</div>
+		</template>
+	</NewModal>
+</template>

apps/app-frontend/src/components/instance/instance-player-messages.ts

@@ -0,0 +1,37 @@
+import { defineMessages } from '@modrinth/ui'
+
+export const playerMessages = defineMessages({
+	title: { id: 'app.instance-player.title', defaultMessage: 'Choose an instance player' },
+	remember: {
+		id: 'app.instance-player.remember',
+		defaultMessage:
+			'This instance will keep using your choice. Switch players in instance settings.',
+	},
+	restore: {
+		id: 'app.instance-player.restore',
+		defaultMessage: 'Sign in again as {name}. To choose someone else, open instance settings.',
+	},
+	loading: { id: 'app.instance-player.loading', defaultMessage: 'Loading signed-in players…' },
+	licensed: { id: 'app.instance-player.licensed', defaultMessage: 'Minecraft account' },
+	skin: { id: 'app.instance-player.skin', defaultMessage: 'Skin site player' },
+	offline: { id: 'app.instance-player.offline', defaultMessage: 'Offline player' },
+	empty: {
+		id: 'app.instance-player.empty',
+		defaultMessage: 'No available skin site players. You can create a player on the skin site.',
+	},
+	signIn: { id: 'app.instance-player.sign-in', defaultMessage: 'Sign in to choose a player.' },
+	retry: { id: 'app.instance-player.retry', defaultMessage: 'Retry' },
+	skinLogin: { id: 'app.instance-player.skin-login', defaultMessage: 'Sign in to skin site' },
+	or: { id: 'app.instance-player.or', defaultMessage: 'Or' },
+	useMicrosoft: {
+		id: 'app.instance-player.use-microsoft',
+		defaultMessage: 'Use a Minecraft account',
+	},
+	saving: { id: 'app.instance-player.saving', defaultMessage: 'Saving instance player…' },
+	setting: { id: 'app.instance-player.setting', defaultMessage: 'Instance player' },
+	firstLaunch: {
+		id: 'app.instance-player.first-launch',
+		defaultMessage: 'Choose a player on first launch',
+	},
+	change: { id: 'app.instance-player.change', defaultMessage: 'Switch instance player' },
+})

apps/app-frontend/src/components/ui/AboutEasterEgg.vue

@@ -12,10 +12,14 @@
 				>
 					{{ formatMessage(messages.score, { score }) }}
 				</span>
-				<span class="shrink-0 whitespace-nowrap rounded-full bg-surface-3 px-2 py-0.5 tabular-nums text-secondary">
+				<span
+					class="shrink-0 whitespace-nowrap rounded-full bg-surface-3 px-2 py-0.5 tabular-nums text-secondary"
+				>
 					{{ formatMessage(messages.highestLevel, { level: highestLevel + 1 }) }}
 				</span>
-				<span class="shrink-0 whitespace-nowrap rounded-full bg-surface-3 px-2 py-0.5 tabular-nums text-secondary">
+				<span
+					class="shrink-0 whitespace-nowrap rounded-full bg-surface-3 px-2 py-0.5 tabular-nums text-secondary"
+				>
 					{{ formatMessage(messages.best, { score: bestScore }) }}
 				</span>
 				<NewButton type="base" size="sm" class="shrink-0" @click="settleGame">
@@ -80,7 +84,10 @@
 					</div>
 				</div>
 			</Transition>
-			<div v-if="gameOver && !endedManually" class="tide-drain pointer-events-none absolute inset-0 z-20" />
+			<div
+				v-if="gameOver && !endedManually"
+				class="tide-drain pointer-events-none absolute inset-0 z-20"
+			/>
 			<Transition name="panel">
 				<div
 					v-if="gameOver"
@@ -115,16 +122,26 @@
 						</div>
 						<div class="grid w-full min-w-0 grid-cols-3 gap-1.5">
 							<div class="flex min-w-0 flex-col items-center rounded-lg bg-surface-3 px-1 py-1">
-								<span class="text-[9px] text-secondary">{{ formatMessage(messages.levelLabel) }}</span>
-								<span class="text-sm font-bold tabular-nums text-contrast">{{ highestLevel + 1 }}</span>
+								<span class="text-[9px] text-secondary">{{
+									formatMessage(messages.levelLabel)
+								}}</span>
+								<span class="text-sm font-bold tabular-nums text-contrast">{{
+									highestLevel + 1
+								}}</span>
 							</div>
 							<div class="flex min-w-0 flex-col items-center rounded-lg bg-surface-3 px-1 py-1">
-								<span class="text-[9px] text-secondary">{{ formatMessage(messages.bestLabel) }}</span>
+								<span class="text-[9px] text-secondary">{{
+									formatMessage(messages.bestLabel)
+								}}</span>
 								<span class="text-sm font-bold tabular-nums text-contrast">{{ bestScore }}</span>
 							</div>
 							<div class="flex min-w-0 flex-col items-center rounded-lg bg-surface-3 px-1 py-1">
-								<span class="text-[9px] text-secondary">{{ formatMessage(messages.overtimesLabel) }}</span>
-								<span class="text-sm font-bold tabular-nums text-contrast">{{ overtimeCount }}</span>
+								<span class="text-[9px] text-secondary">{{
+									formatMessage(messages.overtimesLabel)
+								}}</span>
+								<span class="text-sm font-bold tabular-nums text-contrast">{{
+									overtimeCount
+								}}</span>
 							</div>
 						</div>
 						<div class="flex flex-wrap justify-center gap-2">
@@ -150,8 +167,8 @@ import blueStar from '@/assets/stars/blue.png'
 import greenStar from '@/assets/stars/green.png'
 import pinkStar from '@/assets/stars/pink.png'
 import redStar from '@/assets/stars/red.png'
-import yellowStar from '@/assets/stars/yellow.png'
 import superStar from '@/assets/stars/super.png'
+import yellowStar from '@/assets/stars/yellow.png'
 
 interface Piece {
 	id: number
@@ -396,7 +413,14 @@ function mergePieces(a: Piece, b: Piece) {
 	score.value += points[level]
 	highestLevel.value = Math.max(highestLevel.value, level)
 	const isRainbow = level === colors.length - 1
-	spawnBurst(x, y, isRainbow ? rainbowColors : [colors[level]], 10 + level * 3, 130 + level * 20, 3.4)
+	spawnBurst(
+		x,
+		y,
+		isRainbow ? rainbowColors : [colors[level]],
+		10 + level * 3,
+		130 + level * 20,
+		3.4,
+	)
 	spawnShockwave(x, y, 46 + level * 26, 'rgba(255, 255, 255, 0.9)', Math.min(3, 1.4 + level * 0.3))
 	shakePower = Math.max(shakePower, Math.min(2 + level * 1.2, 7))
 	spawnFloater(x, y, `+${points[level]}`, 15 + level * 3, colors[level])
@@ -423,7 +447,14 @@ function easeOutBack(t: number) {
 	return 1 + c3 * Math.pow(t - 1, 3) + c1 * Math.pow(t - 1, 2)
 }
 
-function spawnBurst(x: number, y: number, palette: string[], count: number, speed: number, size: number) {
+function spawnBurst(
+	x: number,
+	y: number,
+	palette: string[],
+	count: number,
+	speed: number,
+	size: number,
+) {
 	for (let i = 0; i < count; i++) {
 		if (particles.length >= 260) return
 		const angle = Math.random() * Math.PI * 2
@@ -508,7 +539,8 @@ function update(delta: number) {
 	if (overtimeStartAt >= 0) {
 		const overtimeElapsed = elapsed - overtimeStartAt
 		if (overtimeElapsed < 0.8) {
-			surfaceRatio = overtimeFromRatio + (0.05 - overtimeFromRatio) * easeInOutCubic(overtimeElapsed / 0.8)
+			surfaceRatio =
+				overtimeFromRatio + (0.05 - overtimeFromRatio) * easeInOutCubic(overtimeElapsed / 0.8)
 		} else {
 			overtimeStartAt = -1
 		}
@@ -670,17 +702,7 @@ function prepareBallSprite(src: string, level: number) {
 		sprite.height = Math.max(1, Math.round(bounds.h * scale))
 		const ctx = sprite.getContext('2d')
 		if (!ctx) return
-		ctx.drawImage(
-			image,
-			bounds.x,
-			bounds.y,
-			bounds.w,
-			bounds.h,
-			0,
-			0,
-			sprite.width,
-			sprite.height,
-		)
+		ctx.drawImage(image, bounds.x, bounds.y, bounds.w, bounds.h, 0, 0, sprite.width, sprite.height)
 		ballSprites[level] = sprite
 	}
 	image.src = src
@@ -692,9 +714,7 @@ function drawMergePiece(piece: Piece) {
 	const spawnProgress = Math.min(1, (elapsed - piece.spawnAt) / 0.22)
 	const spawnScale = spawnProgress >= 1 ? 1 : easeOutBack(spawnProgress)
 	const radius =
-		piece.radius *
-		spawnScale *
-		(isRainbow ? 1 + 0.05 * Math.sin(elapsed * 3.2 + piece.id) : 1)
+		piece.radius * spawnScale * (isRainbow ? 1 + 0.05 * Math.sin(elapsed * 3.2 + piece.id) : 1)
 	context.save()
 	context.translate(piece.x, piece.y)
 	const hue = (elapsed * 55) % 360
@@ -792,9 +812,7 @@ function draw() {
 	context.beginPath()
 	for (let x = 0; x <= width; x += 8) {
 		const waveY =
-			surfaceY +
-			Math.sin(x * 0.045 + elapsed * 1.8) * 2.5 +
-			Math.sin(x * 0.013 + elapsed * 0.9) * 2
+			surfaceY + Math.sin(x * 0.045 + elapsed * 1.8) * 2.5 + Math.sin(x * 0.013 + elapsed * 0.9) * 2
 		if (x === 0) context.moveTo(x, waveY)
 		else context.lineTo(x, waveY)
 	}
@@ -807,7 +825,12 @@ function draw() {
 		const progress = Math.min(1, (elapsed - waveStart) / 0.8)
 		const waveY = height * (1 - progress)
 		const bandHeight = Math.max(22, height * 0.1)
-		const gradient = context.createLinearGradient(0, waveY - bandHeight, 0, waveY + bandHeight * 0.5)
+		const gradient = context.createLinearGradient(
+			0,
+			waveY - bandHeight,
+			0,
+			waveY + bandHeight * 0.5,
+		)
 		gradient.addColorStop(0, 'rgba(255, 255, 255, 0)')
 		gradient.addColorStop(0.55, 'rgba(96, 178, 255, 0.5)')
 		gradient.addColorStop(1, 'rgba(255, 255, 255, 0)')

apps/app-frontend/src/components/ui/AboutScene.vue

@@ -1,318 +1,44 @@
 <template>
-	<canvas id="about_scene" class="size-full" />
+	<canvas ref="canvas" class="about-scene" aria-hidden="true" />
 </template>
 
 <script setup lang="ts">
-import * as THREE from 'three'
-import { onMounted, onScopeDispose, useTemplateRef } from 'vue'
+import { onActivated, onDeactivated, onMounted, onScopeDispose, useTemplateRef, watch } from 'vue'
 
-import { useTheming } from '@/store/theme'
+import { createWitherVictoryScene } from './about-scene/wither-victory'
 
-const themeStore = useTheming()
-function isDarkMode() {
-	if (themeStore.selectedTheme == 'system') {
-		return matchMedia('(prefers-color-scheme: dark)').matches
-	}
-	return ['dark', 'oled'].includes(themeStore.selectedTheme)
+const props = defineProps<{ paused?: boolean }>()
+const canvas = useTemplateRef<HTMLCanvasElement>('canvas')
+let scene: ReturnType<typeof createWitherVictoryScene> | undefined
+let active = true
+
+function updatePlayback() {
+	scene?.setPaused(!active || Boolean(props.paused))
 }
 
-function createTip(position: THREE.Vector3, color: THREE.ColorRepresentation = 0x00ff00) {
-	const tipGeometry = new THREE.SphereGeometry(2)
-	const tipMaterial = new THREE.MeshBasicMaterial({ color })
-	const tipMesh = new THREE.Mesh(tipGeometry, tipMaterial)
-	tipMesh.position.copy(position)
-	return tipMesh
-}
-
-function createWaterMaterial(): THREE.ShaderMaterial {
-	return new THREE.ShaderMaterial({
-		uniforms: {
-			time: { value: 0 },
-			seed: { value: Math.random() * 83 + 17 },
-			color: { value: new THREE.Color(0.3, 0.3, 1.0) },
-		},
-		transparent: true,
-		vertexShader: `#define WATER_VERT
-varying vec2 vUv;
-void main() {
-    vUv = uv;
-    gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
-}`,
-		fragmentShader: `#define WATER_FRAG
-uniform float time;
-uniform float seed;
-uniform vec3 color;
-varying vec2 vUv;
-
-vec2 randomGradient(vec2 p) {
-    float n = sin(dot(p, vec2(127.1, 311.7)));
-    float angle = fract(n * 43758.5453123) * 6.28318530718 * seed;
-    return vec2(cos(angle), sin(angle));
-}
-
-float perlinNoise(vec2 p) {
-    vec2 i = floor(p);
-    vec2 f = fract(p);
-
-    vec2 u = f * f * (3.0 - 2.0 * f);
-
-    vec2 g1 = randomGradient(i);
-    vec2 g2 = randomGradient(i + vec2(1.0, 0.0));
-    vec2 g3 = randomGradient(i + vec2(0.0, 1.0));
-    vec2 g4 = randomGradient(i + vec2(1.0, 1.0));
-
-    vec2 d1 = f;
-    vec2 d2 = f - vec2(1.0, 0.0);
-    vec2 d3 = f - vec2(0.0, 1.0);
-    vec2 d4 = f - vec2(1.0, 1.0);
-
-    float v1 = dot(g1, d1);
-    float v2 = dot(g2, d2);
-    float v3 = dot(g3, d3);
-    float v4 = dot(g4, d4);
-
-    return mix(mix(v1, v2, u.x), mix(v3, v4, u.x), u.y);
-}
-
-void main() {
-    float height = 0.0;
-    height += perlinNoise(vec2(vUv.x * 10.0, time * 0.8)) * 0.3;
-    height += perlinNoise(vec2(vUv.x * 5.0, time * 0.4)) * 0.35;
-    height += perlinNoise(vec2(vUv.x * 2.5, time * 0.2)) * 0.15;
-    height += perlinNoise(vec2(vUv.x * 2.0, time * 0.2)) * 0.2;
-    height = clamp(height, -1.0, 1.0);
-    height = height * 0.8 + 0.6;
-
-    float thickness = 0.008;
-    if(vUv.y < height - thickness) {
-        float scalar = 1.0 - height + vUv.y;
-        scalar = scalar * scalar * scalar * 0.6;
-        gl_FragColor = vec4(color, scalar);
-    } else if(vUv.y > height + thickness) {
-        gl_FragColor = vec4(0.0, 0.0, 0.0, 0.0);
-    } else {
-        gl_FragColor = vec4(color, 1.0);
-    }
-}`,
-	})
-}
-
-function createWater(material: THREE.ShaderMaterial, position: THREE.Vector3) {
-	const geometry = new THREE.PlaneGeometry(120, 16)
-	const waterMesh = new THREE.Mesh(geometry, material)
-	waterMesh.position.copy(position)
-	return waterMesh
-}
-
-function createCircleMaterial(): THREE.ShaderMaterial {
-	return new THREE.ShaderMaterial({
-		uniforms: {
-			color: { value: new THREE.Color(0.3, 0.3, 1.0) },
-		},
-		transparent: true,
-		vertexShader: `#define CIRCLE_VERT
-varying vec2 vUv;
-void main() {
-    vUv = uv;
-    gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
-}`,
-		fragmentShader: `#define CIRCLE_FRAG
-varying vec2 vUv;
-uniform vec3 color;
-float remap(float v, float inMin, float inMax, float outMin, float outMax) {
-  float t = (v - inMin) / (inMax - inMin);
-  return outMin + (outMax - outMin) * t;
-}
-void main() {
-    float dis = distance(vUv, vec2(0.5));
-    float thickness = 0.05;
-
-    gl_FragColor = vec4(0.0);
-    if(dis <= 0.35 && dis >= 0.35 - thickness) {
-        gl_FragColor = vec4(color, 0.8);
-    } else {
-        // emissive
-        float scalar = 0.0;
-        if(dis >= 0.35) {
-            scalar = clamp(0.5 - dis, 0.0, 0.15);
-            scalar = remap(scalar, 0.0, 0.15, 0.0, 1.0);
-        } else {
-            scalar = clamp(0.35 - dis, 0.0, 0.5);
-            scalar = remap(scalar, 0.0, 0.35, 1.0, 0.0);
-        }
-        scalar = clamp(scalar * scalar * scalar, 0.0, 1.0);
-        gl_FragColor = vec4(color, scalar);
-    }
-}`,
-	})
-}
-
-function createCircle(material: THREE.ShaderMaterial, position: THREE.Vector3) {
-	const geometry = new THREE.PlaneGeometry(0.6, 0.6)
-	const mesh = new THREE.Mesh(geometry, material)
-	mesh.position.copy(position)
-	return mesh
-}
-
-function main() {
-	const canvas = document.querySelector<HTMLCanvasElement>('#about_scene')
-	if (!canvas) return console.error('No canvas')
-
-	let isUpdating = true
-
-	const canvasSize = new THREE.Vector2(
-		canvas.getBoundingClientRect().width,
-		canvas.getBoundingClientRect().height,
-	)
-
-	const renderer = new THREE.WebGLRenderer({
-		antialias: true,
-		alpha: true,
-		canvas,
-	})
-	renderer.setPixelRatio(devicePixelRatio)
-	renderer.setSize(canvasSize.x, canvasSize.y)
-
-	const deltaClock = new THREE.Clock()
-	const elapseClock = new THREE.Clock()
-	deltaClock.start()
-	elapseClock.start()
-
-	const scene = new THREE.Scene()
-
-	const camera = new THREE.PerspectiveCamera(30, canvasSize.x / canvasSize.y, 1, 3000)
-	camera.fov *= 0.7
-	camera.position.set(-10, 5, 30)
-	camera.lookAt(0, 0, 0)
-
-	const ambientLight = new THREE.AmbientLight(0xffffff)
-	scene.add(ambientLight)
-
-	const dirLight = new THREE.DirectionalLight(0xffffff, 4.0)
-	dirLight.position.set(-30, 30, 28)
-	scene.add(dirLight)
-
-	scene.add(createTip(dirLight.position, 0xffff00))
-	scene.add(createTip(camera.position))
-
-	const accentColor =
-		getComputedStyle(document.documentElement).getPropertyValue('--color-brand').trim() || '#4444ff'
-
-	const waterMaterial = createWaterMaterial()
-	waterMaterial.uniforms.color.value = new THREE.Color(accentColor).multiplyScalar(
-		isDarkMode() ? 0.6 : 2.4,
-	)
-	// .multiplyScalar(0.6)
-	// .multiplyScalar(2.4)
-
-	scene.add(createWater(waterMaterial, new THREE.Vector3(0, -6.5, 4)))
-	scene.add(createWater(waterMaterial, new THREE.Vector3(2, -8, -10)))
-	scene.add(createWater(waterMaterial, new THREE.Vector3(16, -8, -26)))
-
-	// 静止的下界之星（替换原动态美西螈）
-	const starTexture = new THREE.TextureLoader().load('/models/netherstar.png')
-	starTexture.colorSpace = THREE.SRGBColorSpace
-	const starMaterial = new THREE.SpriteMaterial({ map: starTexture, transparent: true })
-	const starSprite = new THREE.Sprite(starMaterial)
-	starSprite.scale.set(8, 8, 1)
-	starSprite.position.set(0, -2.5, 0)
-	scene.add(starSprite)
-
-	let updateGLTF = (_deltaTime: number, _elapsedTime: number) => {}
-
-	const circleMaterial = createCircleMaterial()
-	circleMaterial.uniforms.color.value = new THREE.Color(accentColor).multiplyScalar(
-		isDarkMode() ? 1.2 : 3,
-	)
-	// .multiplyScalar(1.2)
-	// .multiplyScalar(3)
-
-	let circleMeshList: THREE.Mesh[] = []
-	let nextCircleCreateTime = 0.0
-	function updateCircle(deltaTime: number, elapsedTime: number) {
-		circleMeshList = circleMeshList.filter((m) => {
-			m.position.y += deltaTime * 2.0
-			if (m.position.y >= 32) {
-				scene.remove(m)
-				return false
-			}
-			return true
-		})
-
-		if (elapsedTime >= nextCircleCreateTime) {
-			nextCircleCreateTime = elapsedTime + Math.random() * 0.8
-			const circle = createCircle(
-				circleMaterial,
-				new THREE.Vector3(Math.random() * 64 - 32 - 12, -20, Math.random() * 6 + 1),
-			)
-			scene.add(circle)
-			circleMeshList.push(circle)
-		}
-	}
-
-	function animate(_time: number) {
-		if (isUpdating === false) return
-		requestAnimationFrame(animate)
-
-		const deltaTime = deltaClock.getDelta()
-		const elapsedTime = elapseClock.getElapsedTime()
-
-		updateGLTF(deltaTime, elapsedTime)
-		waterMaterial.uniforms.time.value = elapsedTime
-
-		updateCircle(deltaTime, elapsedTime)
-
-		renderer.render(scene, camera)
-	}
-	animate(Date.now())
-
-	const originCameraPosition = camera.position.clone()
-	function onMouseMove(event: MouseEvent) {
-		const mouseXOffsetRatio = ((event.clientX - innerWidth / 2) / innerWidth) * 2
-		const mouseYOffsetRatio = ((event.clientY - innerHeight / 2) / innerHeight) * 2
-		const newPosition = new THREE.Vector3(
-			originCameraPosition.x + mouseXOffsetRatio,
-			originCameraPosition.y + mouseYOffsetRatio * 0.5,
-			originCameraPosition.z,
-		)
-		camera.position.copy(newPosition)
-	}
-
-	function updateSize() {
-		if (!isUpdating) return
-		if (!canvas) return
-		const rect = canvas.getBoundingClientRect()
-		const w = rect.width
-		const h = rect.height
-		if (w > 0 && h > 0) {
-			renderer.setSize(w, h)
-			camera.aspect = w / h
-			camera.updateProjectionMatrix()
-		}
-	}
-
-	const resizeObserver = new ResizeObserver(updateSize)
-	resizeObserver.observe(canvas)
-
-	addEventListener('mousemove', onMouseMove)
-	onScopeDispose(() => {
-		isUpdating = false
-		removeEventListener('mousemove', onMouseMove)
-		resizeObserver.disconnect()
-		deltaClock.stop()
-		elapseClock.stop()
-		renderer.dispose()
-	})
-}
-
-onMounted(main)
+onMounted(() => {
+	if (!canvas.value) return
+	scene = createWitherVictoryScene(canvas.value)
+	updatePlayback()
+	scene.ready.catch((error: unknown) => console.warn('Unable to load about-page scene', error))
+})
+watch(() => props.paused, updatePlayback)
+onActivated(() => {
+	active = true
+	updatePlayback()
+})
+onDeactivated(() => {
+	active = false
+	updatePlayback()
+})
+onScopeDispose(() => scene?.dispose())
 </script>
-<style>
-#about_scene {
-	background: linear-gradient(
-		to bottom,
-		color-mix(in srgb, var(--color-brand) 36%, var(--surface-1) 100%),
-		#00000000 40%
-	);
+
+<style scoped>
+.about-scene {
+	display: block;
+	width: 100%;
+	height: 100%;
+	background: #0c1729;
 }
 </style>

apps/app-frontend/src/components/ui/AccountsCard.test.ts

@@ -0,0 +1,292 @@
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { createRequire, registerHooks, stripTypeScriptTypes } from 'node:module'
+import test from 'node:test'
+
+import { createRenderer, h, nextTick, Suspense } from 'vue'
+
+import {
+	receiveSkinSiteMessage,
+	resetSkinSiteSession,
+	setSkinSiteFrame,
+	SKIN_SITE_ORIGIN,
+} from '../../composables/skin-site-session.ts'
+import { useNetworkStatus } from '../../composables/useNetworkStatus.ts'
+
+// Exercise the real component's setup and reactive account list. Only platform,
+// navigation, and visual dependencies are replaced; auth/session logic stays real.
+const require = createRequire(import.meta.url)
+const { parse, compileScript } = require('vue/compiler-sfc')
+const componentUrl = new URL('./AccountsCard.vue', import.meta.url).href
+const stubs: Record<string, string> = {
+	'@modrinth/assets': `export const CopyIcon={}, LogInIcon={}, PlusIcon={}, RadioButtonCheckedIcon={}, RadioButtonIcon={}, RefreshCwIcon={}, SpinnerIcon={}, TrashIcon={}`,
+	'@modrinth/ui': `export const Accordion={}, Avatar={}, ButtonStyled={}; export const defineMessages=x=>x; export const injectNotificationManager=()=>({handleError:()=>{}}); export const useVIntl=()=>({formatMessage:x=>x.defaultMessage})`,
+	'@tanstack/vue-query': `export const useQueryClient=()=>({refetchQueries:async()=>{}})`,
+	'@tauri-apps/api/event': `export const listen=async()=>()=>{}`,
+	'vue-router': `export const useRoute=()=>({fullPath:'/'}); export const useRouter=()=>({push:async()=>{}})`,
+	'@/assets/netherstar.png': `export default 'logo'`,
+	'@/components/ui/MinecraftLoginModal.vue': `export default {}`,
+	'@/helpers/events': `export const process_listener=async()=>()=>{}`,
+	'@/helpers/rendering/batch-skin-renderer.ts': `export const getPlayerHeadUrl=async()=> 'head'`,
+	'@/helpers/skins': `export const get_available_skins=async()=>[]`,
+	'@/store/error.js': `export const handleSevereError=()=>{}`,
+	'@/store/state': `export const useTheming=()=>({homeLayout:'standard'})`,
+}
+const hooks = registerHooks({
+	resolve(specifier, context, nextResolve) {
+		if (specifier in stubs) {
+			return {
+				url: `data:text/javascript,${encodeURIComponent(stubs[specifier])}`,
+				shortCircuit: true,
+			}
+		}
+		if (specifier.startsWith('@/')) {
+			const file = new URL(`../../${specifier.slice(2)}`, import.meta.url)
+			if (!/\.(ts|js)$/.test(file.pathname))
+				file.pathname += specifier === '@/helpers/auth' ? '.js' : '.ts'
+			return nextResolve(file.href, context)
+		}
+		return nextResolve(specifier, context)
+	},
+	load(url, context, nextLoad) {
+		if (url !== componentUrl) return nextLoad(url, context)
+		const { descriptor } = parse(readFileSync(new URL(url), 'utf8'))
+		return {
+			format: 'module',
+			source: stripTypeScriptTypes(compileScript(descriptor, { id: 'accounts-card-test' }).content),
+			shortCircuit: true,
+		}
+	},
+})
+const { default: AccountsCard } = await import(componentUrl)
+hooks.deregister()
+
+type TestNode = Record<string, unknown>
+type TestAccount = {
+	account_type: 'microsoft' | 'yggdrasil'
+	profile: { id: string; name: string }
+	yggdrasil?: { api_root: string; server_name: string; login: string }
+}
+type CardState = {
+	accounts: TestAccount[]
+	defaultUser: string | undefined
+	selectedAccount: TestAccount | undefined
+	setAccount: (account: TestAccount) => Promise<void>
+	getAccountAvatarUrl: (account: TestAccount) => string | undefined
+}
+const renderer = createRenderer<TestNode, TestNode>({
+	createElement: () => ({}),
+	createText: () => ({}),
+	createComment: () => ({}),
+	insert() {},
+	remove() {},
+	setText() {},
+	setElementText() {},
+	patchProp() {},
+	parentNode: () => null,
+	nextSibling: () => null,
+})
+const flush = async () => {
+	await new Promise((resolve) => setImmediate(resolve))
+	await nextTick()
+}
+const firstId = '12345678-1234-1234-1234-123456789abc'
+const secondId = '22345678-1234-1234-1234-123456789abc'
+
+async function fixture(hasOfficial = true) {
+	const previousWindow = Object.getOwnPropertyDescriptor(globalThis, 'window')
+	const previousNavigator = Object.getOwnPropertyDescriptor(globalThis, 'navigator')
+	const stored: TestAccount[] = hasOfficial
+		? [{ account_type: 'microsoft', profile: { id: 'official', name: 'Official' } }]
+		: []
+	let selected: string | undefined = hasOfficial ? 'official' : undefined
+	let rejectLogin = false
+	let loginCalls = 0
+	const frame = {
+		postMessage(data: { type: string; requestId: string }) {
+			if (data.type === 'starlight-pack-token-request')
+				message({
+					type: 'starlight-pack-token-result',
+					requestId: data.requestId,
+					token: 'fixture.jwt',
+				})
+			if (data.type === 'starlight-skin-players-request')
+				message({
+					type: 'starlight-skin-players-result',
+					requestId: data.requestId,
+					ok: true,
+					players: [
+						{ uuid: firstId, name: 'First', isMojang: false, skinState: 'empty' },
+						{ uuid: secondId, name: 'Second', isMojang: false, skinState: 'empty' },
+					],
+				})
+		},
+	} as unknown as Window
+	function message(data: unknown) {
+		receiveSkinSiteMessage({ origin: SKIN_SITE_ORIGIN, source: frame, data } as MessageEvent, frame)
+	}
+	Object.defineProperty(globalThis, 'navigator', { configurable: true, value: { onLine: true } })
+	useNetworkStatus().refreshBrowserOffline()
+	Object.defineProperty(globalThis, 'window', {
+		configurable: true,
+		value: {
+			__TAURI_INTERNALS__: {
+				async invoke(command: string, args: Record<string, unknown>) {
+					if (command === 'plugin:auth|get_default_user') return selected
+					if (command === 'plugin:auth|get_users') return stored
+					if (command === 'plugin:auth|login_skin_site_player') {
+						loginCalls++
+						assert.equal(args.userId, 'owner')
+						assert.equal(args.token, 'fixture.jwt')
+						assert.ok(typeof args.playerId === 'string')
+						if (rejectLogin) throw new Error('Login failed')
+						stored.push({
+							profile: { id: args.playerId, name: args.playerId === firstId ? 'First' : 'Second' },
+							account_type: 'yggdrasil',
+							yggdrasil: {
+								api_root: `${SKIN_SITE_ORIGIN}/yggdrasil`,
+								server_name: 'StarLight',
+								login: 'owner',
+							},
+						})
+						return stored[stored.length - 1]
+					}
+					if (command === 'plugin:auth|set_default_user') {
+						assert.ok(typeof args.user === 'string')
+						assert.ok(stored.some((account) => account.profile.id === args.user))
+						selected = args.user
+						return
+					}
+					throw new Error(`Unexpected command: ${command}`)
+				},
+			},
+		},
+	})
+	resetSkinSiteSession()
+	setSkinSiteFrame(frame)
+	const node = h({ ...AccountsCard, render: () => null })
+	const app = renderer.createApp({ render: () => h(Suspense, null, { default: () => node }) })
+	app.mount({})
+	await flush()
+	return {
+		state: (node.component! as unknown as { setupState: CardState }).setupState,
+		login() {
+			message({
+				type: 'starlight-skin-session',
+				status: 'signed-in',
+				user: { uuid: 'owner', username: 'Owner' },
+			})
+		},
+		signOut() {
+			message({ type: 'starlight-skin-session', status: 'signed-out' })
+		},
+		failLogin(value: boolean) {
+			rejectLogin = value
+		},
+		get selected() {
+			return selected
+		},
+		get loginCalls() {
+			return loginCalls
+		},
+		close() {
+			app.unmount()
+			resetSkinSiteSession()
+			setSkinSiteFrame(null)
+			if (previousWindow) Object.defineProperty(globalThis, 'window', previousWindow)
+			else Reflect.deleteProperty(globalThis, 'window')
+			if (previousNavigator) Object.defineProperty(globalThis, 'navigator', previousNavigator)
+			else Reflect.deleteProperty(globalThis, 'navigator')
+		},
+	}
+}
+
+test('sidebar offers every skin-site player before any game authentication or launch', async () => {
+	const view = await fixture(false)
+	try {
+		view.failLogin(true)
+		view.login()
+		await flush()
+		assert.deepEqual(
+			view.state.accounts.map((account) => account.profile.id),
+			[firstId, secondId],
+		)
+		assert.equal(view.loginCalls, 0)
+		assert.equal(view.selected, undefined)
+	} finally {
+		view.close()
+	}
+})
+
+test('choosing an unused skin-site player authenticates and persists the default without a launch', async () => {
+	const view = await fixture()
+	try {
+		view.login()
+		await flush()
+		await view.state.setAccount(
+			view.state.accounts.find((account) => account.profile.id === secondId)!,
+		)
+		assert.equal(view.selected, secondId)
+		assert.equal(view.state.selectedAccount?.profile.id, secondId)
+		assert.equal(view.state.accounts.length, 3)
+		assert.equal(view.loginCalls, 1)
+	} finally {
+		view.close()
+	}
+})
+
+test('failed player authentication preserves the default and allows retry', async () => {
+	const view = await fixture()
+	try {
+		view.login()
+		await flush()
+		view.failLogin(true)
+		await view.state.setAccount(
+			view.state.accounts.find((account) => account.profile.id === secondId)!,
+		)
+		assert.equal(view.selected, 'official')
+		assert.equal(view.state.defaultUser, 'official')
+		view.failLogin(false)
+		await view.state.setAccount(
+			view.state.accounts.find((account) => account.profile.id === secondId)!,
+		)
+		assert.equal(view.selected, secondId)
+	} finally {
+		view.close()
+	}
+})
+
+test('signing out removes unregistered choices while keeping saved accounts', async () => {
+	const view = await fixture()
+	try {
+		view.login()
+		await flush()
+		await view.state.setAccount(
+			view.state.accounts.find((account) => account.profile.id === firstId)!,
+		)
+		view.signOut()
+		await flush()
+		assert.deepEqual(
+			view.state.accounts.map((account) => account.profile.id),
+			[firstId, 'official'],
+		)
+		assert.equal(view.selected, firstId)
+		view.login()
+		await flush()
+		assert.equal(view.state.accounts.length, 3)
+		assert.equal(view.loginCalls, 1)
+	} finally {
+		view.close()
+	}
+})
+
+test('a new player without a skin can render the shared empty avatar', async () => {
+	const view = await fixture(false)
+	try {
+		view.login()
+		await flush()
+		assert.equal(view.state.getAccountAvatarUrl(view.state.accounts[0]), undefined)
+	} finally {
+		view.close()
+	}
+})

apps/app-frontend/src/components/ui/AccountsCard.vue

@@ -1,10 +1,106 @@
 <template>
+	<div v-if="skinSiteUser" class="flex items-center gap-3 mt-2 p-3 rounded-xl bg-button-bg">
+		<Avatar :src="axolotlLogo" size="36px" />
+		<div class="flex min-w-0 flex-col">
+			<span class="truncate font-semibold text-contrast">{{ skinSiteUser.username }}</span>
+			<span class="text-secondary text-xs">{{ formatMessage(messages.skinSiteSignedIn) }}</span>
+		</div>
+	</div>
+	<p v-else-if="skinSiteStatus === 'checking'" class="text-sm text-secondary">
+		{{ formatMessage(messages.skinSiteChecking) }}
+	</p>
+	<p v-else-if="skinSiteStatus === 'error'" class="text-sm text-secondary">
+		{{ formatMessage(messages.skinSiteSyncError) }}
+	</p>
+	<div
+		v-if="skinSiteUser"
+		class="mt-2 overflow-hidden rounded-xl border border-solid border-surface-5 bg-button-bg"
+	>
+		<div class="flex items-center justify-between gap-3 px-3 py-2">
+			<span class="font-semibold text-contrast">
+				{{ formatMessage(messages.skinSitePlayers, { count: skinSitePlayers.length }) }}
+			</span>
+			<button
+				v-if="skinSitePlayersStatus === 'error'"
+				type="button"
+				class="button-base flex cursor-pointer items-center gap-1 border-0 bg-transparent p-1 text-xs text-secondary hover:text-brand"
+				@click="refreshSkinSitePlayers()"
+			>
+				<RefreshCwIcon class="h-4 w-4" />
+				{{ formatMessage(messages.retrySkinSitePlayers) }}
+			</button>
+			<SpinnerIcon
+				v-else-if="skinSitePlayersStatus === 'checking'"
+				class="h-4 w-4 animate-spin text-secondary"
+			/>
+		</div>
+		<div v-if="skinSitePlayers.length > 0" class="border-0 border-t border-solid border-surface-5">
+			<button
+				v-for="player in skinSitePlayers"
+				:key="player.uuid"
+				type="button"
+				class="flex w-full cursor-pointer items-center gap-2 border-0 border-b border-solid border-surface-5 px-3 py-2 text-left transition-colors last:border-b-0 hover:bg-button-hover"
+				:class="selectedSkinSitePlayerId === player.uuid ? 'bg-button-hover' : 'bg-transparent'"
+				:aria-pressed="selectedSkinSitePlayerId === player.uuid"
+				@click="setSkinSitePlayer(player.uuid)"
+			>
+				<Avatar
+					v-if="player.skinState === 'ready' && player.headDataUrl"
+					:src="player.headDataUrl"
+					size="32px"
+					pixelated
+					:unframed-natural-width="36"
+				/>
+				<div
+					v-else
+					class="h-8 w-8 shrink-0 rounded-sm border-2 border-dashed border-secondary/45 bg-surface-5/50 text-secondary"
+					style="
+						background-image:
+							linear-gradient(currentColor, currentColor),
+							linear-gradient(currentColor, currentColor),
+							linear-gradient(currentColor, currentColor);
+						background-position:
+							6px 8px,
+							22px 8px,
+							8px 20px;
+						background-repeat: no-repeat;
+						background-size:
+							4px 4px,
+							4px 4px,
+							16px 2px;
+					"
+					aria-hidden="true"
+				/>
+				<span class="min-w-0 flex-1 truncate text-sm text-primary">{{ player.name }}</span>
+			</button>
+		</div>
+		<p v-else-if="skinSitePlayersStatus === 'ready'" class="m-0 px-3 pb-3 text-sm text-secondary">
+			{{ formatMessage(messages.noSkinSitePlayers) }}
+		</p>
+		<p v-else-if="skinSitePlayersStatus === 'error'" class="m-0 px-3 pb-3 text-sm text-secondary">
+			{{ formatMessage(messages.skinSitePlayersError) }}
+		</p>
+	</div>
+	<ButtonStyled v-if="accounts.length > 0 && !offline && !skinSiteUser" color="brand">
+		<button class="mt-2 w-full" :disabled="loginDisabled" @click="goToSkinSiteLogin()">
+			<LogInIcon />
+			{{ formatMessage(messages.signInToStarlight) }}
+		</button>
+	</ButtonStyled>
 	<div
 		v-if="offline"
 		class="flex flex-col gap-1 bg-highlight-orange border border-solid border-orange rounded-xl p-3 mt-2"
 	>
 		<span class="font-semibold text-contrast">{{ formatMessage(messages.offlineMode) }}</span>
-		<span class="text-sm text-secondary">{{ formatMessage(messages.offlineModeDescription) }}</span>
+		<span class="text-sm text-secondary">
+			{{
+				formatMessage(
+					browserOffline
+						? messages.offlineModeNoInternetDescription
+						: messages.offlineModeServerUnavailableDescription,
+				)
+			}}
+		</span>
 		<ButtonStyled>
 			<button class="mt-1" :disabled="refreshingNetwork" @click="refreshNetworkStatus()">
 				<SpinnerIcon v-if="refreshingNetwork" class="animate-spin" />
@@ -17,18 +113,18 @@
 		v-if="accounts.length === 0"
 		class="flex flex-col gap-3 bg-button-bg border border-solid border-surface-5 rounded-xl p-3 mt-2"
 	>
-		<span>{{ formatMessage(messages.notSignedIn) }}</span>
-		<ButtonStyled v-if="!offline" color="brand">
-			<button color="primary" :disabled="loginDisabled" @click="login()">
+		<span v-if="skinSiteStatus === 'signed-out'">{{ formatMessage(messages.notSignedIn) }}</span>
+		<ButtonStyled v-if="!offline && !skinSiteUser" color="brand">
+			<button color="primary" :disabled="loginDisabled" @click="goToSkinSiteLogin()">
 				<LogInIcon v-if="!loginDisabled" />
 				<SpinnerIcon v-else class="animate-spin" />
-				{{ formatMessage(messages.signInToMinecraft) }}
+				{{ formatMessage(messages.signInToStarlight) }}
 			</button>
 		</ButtonStyled>
 		<ButtonStyled v-if="!offline">
-			<button :disabled="loginDisabled" @click="showYggdrasilAccountModal()">
+			<button :disabled="loginDisabled" @click="login()">
 				<PlusIcon />
-				{{ formatMessage(messages.addThirdPartyAccount) }}
+				{{ formatMessage(messages.addMicrosoftAccount) }}
 			</button>
 		</ButtonStyled>
 	</div>
@@ -68,6 +164,7 @@
 				<div v-for="account in accounts" :key="account.profile.id" class="flex gap-1 items-center">
 					<button
 						class="flex items-center flex-shrink flex-grow overflow-clip gap-2 p-2 border-0 bg-transparent cursor-pointer button-base min-w-0"
+						:disabled="accountSelectionPending"
 						@click="setAccount(account)"
 					>
 						<RadioButtonCheckedIcon
@@ -125,6 +222,7 @@
 							<CopyIcon />
 						</button>
 						<button
+							v-if="!account.skin_site_user"
 							v-tooltip="formatMessage(messages.removeAccount)"
 							type="button"
 							class="button-base border-0 bg-transparent p-1.5 cursor-pointer text-secondary hover:text-red"
@@ -142,109 +240,10 @@
 						{{ formatMessage(messages.addMicrosoftAccount) }}
 					</button>
 				</ButtonStyled>
-				<ButtonStyled v-if="accounts.length > 0 && !offline" class="w-full">
-					<button :disabled="loginDisabled" @click="showYggdrasilAccountModal()">
-						<PlusIcon />
-						{{ formatMessage(messages.addThirdPartyAccount) }}
-					</button>
-				</ButtonStyled>
 			</div>
 		</div>
 	</Accordion>
 	<MinecraftLoginModal ref="minecraftLoginModal" @complete="onMicrosoftLogin" />
-	<ModalWrapper ref="yggdrasilAccountModal" :header="formatMessage(messages.thirdPartyModalTitle)">
-		<div class="flex min-w-[24rem] flex-col gap-4">
-			<p class="m-0 text-secondary">{{ formatMessage(messages.thirdPartyModalDescription) }}</p>
-			<div v-if="savedYggdrasilLogins.length > 0" class="flex flex-col gap-2">
-				<span class="font-semibold">{{ formatMessage(messages.savedLogins) }}</span>
-				<div
-					v-for="savedLogin in savedYggdrasilLogins"
-					:key="`${savedLogin.api_root}:${savedLogin.login}`"
-					class="flex items-center gap-1 rounded-xl bg-surface-3 p-1"
-				>
-					<button
-						class="flex min-w-0 flex-grow flex-col items-start border-0 bg-transparent px-3 py-2 text-left cursor-pointer"
-						:disabled="loginDisabled"
-						@click="selectSavedYggdrasilLogin(savedLogin)"
-					>
-						<span class="w-full truncate font-semibold text-primary">{{ savedLogin.login }}</span>
-						<span class="w-full truncate text-xs text-secondary">{{ savedLogin.api_root }}</span>
-					</button>
-					<ButtonStyled circular color="red" color-fill="none" hover-color-fill="background">
-						<button
-							v-tooltip="formatMessage(messages.removeSavedLogin)"
-							:disabled="loginDisabled"
-							@click="removeSavedYggdrasilLogin(savedLogin)"
-						>
-							<TrashIcon />
-						</button>
-					</ButtonStyled>
-				</div>
-			</div>
-			<label class="flex flex-col gap-2 font-semibold">
-				{{ formatMessage(messages.apiRootLabel) }}
-				<StyledInput
-					v-model="yggdrasilApiRoot"
-					:disabled="true"
-					readonly
-					:placeholder="formatMessage(messages.apiRootPlaceholder)"
-					inputmode="url"
-					@blur="loadRememberedYggdrasilPassword()"
-				/>
-			</label>
-			<label class="flex flex-col gap-2 font-semibold">
-				{{ formatMessage(messages.accountLabel) }}
-				<StyledInput
-					v-model="yggdrasilLogin"
-					:disabled="loginDisabled"
-					:placeholder="formatMessage(messages.accountPlaceholder)"
-					autocomplete="username"
-					@blur="loadRememberedYggdrasilPassword()"
-				/>
-			</label>
-			<label class="flex flex-col gap-2 font-semibold">
-				{{ formatMessage(messages.passwordLabel) }}
-				<StyledInput
-					v-model="yggdrasilPassword"
-					type="password"
-					:disabled="loginDisabled"
-					autocomplete="current-password"
-					@keyup.enter="addYggdrasilAccount()"
-				/>
-			</label>
-			<Checkbox
-				v-model="rememberYggdrasilPassword"
-				:disabled="loginDisabled"
-				:label="formatMessage(messages.rememberPassword)"
-			/>
-			<div class="input-group push-right">
-				<ButtonStyled>
-					<button :disabled="loginDisabled" @click="yggdrasilAccountModal?.hide()">
-						{{ formatMessage(commonMessages.cancelButton) }}
-					</button>
-				</ButtonStyled>
-				<ButtonStyled color="brand">
-					<button :disabled="loginDisabled || !yggdrasilFormValid" @click="addYggdrasilAccount()">
-						<SpinnerIcon v-if="loginDisabled" class="animate-spin" />
-						<LogInIcon v-else />
-						{{ formatMessage(messages.signInButton) }}
-					</button>
-				</ButtonStyled>
-			</div>
-		</div>
-	</ModalWrapper>
-	<ModalWrapper ref="yggdrasilProfileModal" :header="formatMessage(messages.selectProfileTitle)">
-		<div class="flex min-w-[22rem] flex-col gap-2">
-			<p class="m-0 mb-2 text-secondary">{{ formatMessage(messages.selectProfileDescription) }}</p>
-			<ButtonStyled v-for="profile in pendingYggdrasilProfiles" :key="profile.id" class="w-full">
-				<button :disabled="loginDisabled" @click="selectYggdrasilProfile(profile.id)">
-					<SpinnerIcon v-if="loginDisabled" class="animate-spin" />
-					<RadioButtonIcon v-else />
-					{{ profile.name }}
-				</button>
-			</ButtonStyled>
-		</div>
-	</ModalWrapper>
 </template>
 
 <script setup lang="ts">
@@ -262,48 +261,59 @@ import {
 	Accordion,
 	Avatar,
 	ButtonStyled,
-	commonMessages,
 	defineMessages,
 	injectNotificationManager,
-	StyledInput,
 	useVIntl,
 } from '@modrinth/ui'
 import { useQueryClient } from '@tanstack/vue-query'
 import { listen } from '@tauri-apps/api/event'
 import type { Ref } from 'vue'
 import { computed, nextTick, onUnmounted, ref, watch } from 'vue'
-import { useRoute } from 'vue-router'
+import { useRoute, useRouter } from 'vue-router'
 
 import axolotlLogo from '@/assets/netherstar.png'
-import steveSkinTexture from '@/assets/skins/steve.png?inline'
 import MinecraftLoginModal from '@/components/ui/MinecraftLoginModal.vue'
-import ModalWrapper from '@/components/ui/modal/ModalWrapper.vue'
+import {
+	openSkinSiteLogin,
+	requestSkinSitePlayers,
+	selectedSkinSitePlayerId,
+	selectSkinSitePlayer,
+	skinSitePlayers,
+	skinSitePlayersStatus,
+	skinSiteStatus,
+	skinSiteUser,
+} from '@/composables/skin-site-session'
 import { useNetworkStatus } from '@/composables/useNetworkStatus'
 import { compareMinecraftAccounts } from '@/helpers/accounts'
 import {
-	begin_yggdrasil_login,
-	delete_yggdrasil_password,
-	finish_yggdrasil_login,
 	get_default_user,
-	get_yggdrasil_password,
-	list_yggdrasil_saved_logins,
 	login as loginToMinecraft,
 	remove_user,
 	set_default_user,
-	set_yggdrasil_password,
 	users,
 } from '@/helpers/auth'
 import { process_listener } from '@/helpers/events'
+import { authenticateInstancePlayer } from '@/helpers/instance-player'
 import { getPlayerHeadUrl } from '@/helpers/rendering/batch-skin-renderer.ts'
 import type { Skin } from '@/helpers/skins'
 import { get_available_skins } from '@/helpers/skins'
 import { handleSevereError } from '@/store/error.js'
+import { useTheming } from '@/store/state'
 
 const { formatMessage } = useVIntl()
 const { handleError } = injectNotificationManager()
-const { offline, refreshBrowserOffline } = useNetworkStatus()
+const { browserOffline, offline, refreshBrowserOffline } = useNetworkStatus()
 const queryClient = useQueryClient()
 const route = useRoute()
+const router = useRouter()
+const themeStore = useTheming()
+
+async function goToSkinSiteLogin() {
+	openSkinSiteLogin()
+	// The login action must reveal the iframe even if Minimal Home was selected.
+	themeStore.homeLayout = 'standard'
+	await router.push('/').catch(handleError)
+}
 const refreshingNetwork = ref(false)
 
 /**
@@ -345,25 +355,45 @@ type MinecraftCredential = {
 		server_name: string
 		login: string
 	}
+	skin_site_user?: string
+	head?: string
 }
 
-type YggdrasilProfile = {
-	id: string
-	name: string
-}
-
-type SavedYggdrasilLogin = {
-	api_root: string
-	login: string
-}
-
-type YggdrasilLoginResult =
-	| { status: 'complete'; credentials: MinecraftCredential }
-	| { status: 'select_profile'; flow_id: string; profiles: YggdrasilProfile[] }
-
 const STARLIGHT_YGGDRASIL_API_ROOT = 'https://skin.starlight.cool/yggdrasil'
 
-const accounts: Ref<MinecraftCredential[]> = ref([])
+const storedAccounts: Ref<MinecraftCredential[]> = ref([])
+const accounts = computed(() => {
+	// A site's player list is already authoritative for available choices.
+	// Game credentials are created only when the user selects a player.
+	const byId = new Map(
+		storedAccounts.value.map((account) => [
+			account.profile.id.replaceAll('-', '').toLowerCase(),
+			account,
+		]),
+	)
+	if (skinSiteStatus.value === 'signed-in' && skinSiteUser.value) {
+		for (const player of skinSitePlayers.value) {
+			if (player.isMojang) continue
+			const id = player.uuid.replaceAll('-', '').toLowerCase()
+			const stored = byId.get(id)
+			if (stored && stored.account_type !== 'yggdrasil') continue
+			byId.set(id, {
+				...stored,
+				account_type: 'yggdrasil',
+				profile: { ...stored?.profile, id: stored?.profile.id ?? player.uuid, name: player.name },
+				yggdrasil: {
+					api_root: STARLIGHT_YGGDRASIL_API_ROOT,
+					server_name: 'StarLight',
+					login: skinSiteUser.value.uuid,
+				},
+				skin_site_user: skinSiteUser.value.uuid,
+				head: player.headDataUrl,
+			})
+		}
+	}
+	return [...byId.values()].sort(compareMinecraftAccounts)
+})
+const accountSelectionPending = ref(false)
 const loginDisabled = ref(false)
 const defaultUser = ref<string | undefined>()
 const equippedSkin = ref<Skin | null>(null)
@@ -375,34 +405,13 @@ let refreshGeneration = 0
 let headRefreshTimer: ReturnType<typeof setTimeout> | undefined
 let defaultUserUpdateQueue = Promise.resolve()
 const minecraftLoginModal = ref<InstanceType<typeof MinecraftLoginModal> | null>(null)
-const yggdrasilAccountModal = ref<InstanceType<typeof ModalWrapper> | null>(null)
-const yggdrasilProfileModal = ref<InstanceType<typeof ModalWrapper> | null>(null)
-const yggdrasilApiRoot = ref(STARLIGHT_YGGDRASIL_API_ROOT)
-const yggdrasilLogin = ref('')
-const yggdrasilPassword = ref('')
-const rememberYggdrasilPassword = ref(true)
-const savedYggdrasilLogins = ref<SavedYggdrasilLogin[]>([])
-const pendingYggdrasilFlowId = ref<string | undefined>()
-const pendingYggdrasilProfiles = ref<YggdrasilProfile[]>([])
-const yggdrasilFormValid = computed(
-	() =>
-		yggdrasilApiRoot.value.trim().length > 0 &&
-		yggdrasilLogin.value.trim().length > 0 &&
-		yggdrasilPassword.value.length > 0,
-)
-
-function createSkinHeadDataUrl(textureUrl: string) {
-	const escapedTextureUrl = textureUrl
-		.replaceAll('&', '&amp;')
-		.replaceAll('"', '&quot;')
-		.replaceAll('<', '&lt;')
-		.replaceAll('>', '&gt;')
-	const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 8 8" shape-rendering="crispEdges"><image href="${escapedTextureUrl}" x="-8" y="-8" width="64" height="64" style="image-rendering:pixelated"/><image href="${escapedTextureUrl}" x="-40" y="-8" width="64" height="64" style="image-rendering:pixelated"/></svg>`
-
-	return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`
+async function refreshSkinSitePlayers() {
+	await requestSkinSitePlayers().catch(() => {})
 }
 
-const defaultSteveHeadUrl = createSkinHeadDataUrl(steveSkinTexture)
+function setSkinSitePlayer(playerId: string) {
+	selectSkinSitePlayer(playerId)
+}
 
 const HEAD_REFRESH_RETRY_DELAYS = [1500, 5000, 15000, 30000] as const
 const HEAD_REFRESH_CONTINUOUS_DELAY = 60_000
@@ -417,7 +426,7 @@ function hasResolvedAccountHead(account: MinecraftCredential) {
 }
 
 function hasMissingAccountHeads() {
-	return accounts.value.some(
+	return storedAccounts.value.some(
 		(account) => account.account_type !== 'offline' && !hasResolvedAccountHead(account),
 	)
 }
@@ -451,7 +460,7 @@ async function refreshValues(headRefreshAttempt = 0) {
 
 	defaultUser.value = selectedUser
 	if (offline.value && selectedUser) {
-		await persistDefaultUser(selectedUser)
+		await persistDefaultUser(selectedUser).catch(handleError)
 		if (generation !== refreshGeneration) return
 	}
 	const userList = await users(offline.value).catch(handleError)
@@ -460,7 +469,7 @@ async function refreshValues(headRefreshAttempt = 0) {
 	// MinecraftCredential but the TS types from the Tauri IPC bridge do not
 	// carry this refinement. The double cast is deliberate — the shape is
 	// correct and verified at runtime by the backend.
-	accounts.value = Array.isArray(userList)
+	storedAccounts.value = Array.isArray(userList)
 		? [...(userList as unknown as MinecraftCredential[])].filter(
 				(account) =>
 					account.account_type === 'microsoft' ||
@@ -468,8 +477,7 @@ async function refreshValues(headRefreshAttempt = 0) {
 						account.yggdrasil?.api_root.replace(/\/+$/, '') === STARLIGHT_YGGDRASIL_API_ROOT),
 			)
 		: []
-	accounts.value.sort(compareMinecraftAccounts)
-	await renderAccountHeads(accounts.value, generation)
+	await renderAccountHeads(storedAccounts.value, generation)
 	if (generation !== refreshGeneration) return
 	try {
 		const skins = await get_available_skins()
@@ -607,6 +615,7 @@ async function renderAccountHeads(accountList: MinecraftCredential[], generation
 
 const avatarUrl = computed(() => {
 	if (selectedAccount.value) {
+		if (selectedAccount.value.head) return selectedAccount.value.head
 		const cachedHeadUrl = accountHeadUrlCache.value.get(selectedAccount.value.profile.id)
 		if (cachedHeadUrl) return cachedHeadUrl
 	}
@@ -616,10 +625,11 @@ const avatarUrl = computed(() => {
 			return cachedUrl
 		}
 	}
-	return selectedAccount.value ? defaultSteveHeadUrl : axolotlLogo
+	return selectedAccount.value ? undefined : axolotlLogo
 })
 
 function getAccountAvatarUrl(account: MinecraftCredential) {
+	if (account.head) return account.head
 	const cachedHeadUrl = accountHeadUrlCache.value.get(account.profile.id)
 	if (cachedHeadUrl) {
 		return cachedHeadUrl
@@ -633,29 +643,54 @@ function getAccountAvatarUrl(account: MinecraftCredential) {
 			return cachedUrl
 		}
 	}
-	return defaultSteveHeadUrl
+	return undefined
 }
 
 function persistDefaultUser(userId: string) {
 	const update = defaultUserUpdateQueue.then(async () => {
-		await set_default_user(userId).catch(handleError)
+		await set_default_user(userId)
 	})
 	defaultUserUpdateQueue = update.catch(() => {})
 	return update
 }
 
 async function setAccount(account: MinecraftCredential) {
+	if (accountSelectionPending.value) return
+	accountSelectionPending.value = true
 	const userId = account.profile.id
 	refreshGeneration += 1
-	defaultUser.value = userId
-	equippedSkin.value = null
-
-	await persistDefaultUser(userId)
-	if (defaultUser.value !== userId) return
-	await refreshValues()
-	if (defaultUser.value === userId) notifyAccountChange()
+	try {
+		if (account.skin_site_user) {
+			await authenticateInstancePlayer({
+				id: userId,
+				name: account.profile.name,
+				account_type: account.account_type,
+				skin_site_user: account.skin_site_user,
+			})
+		}
+		await persistDefaultUser(userId)
+		selectSkinSitePlayer(null)
+		defaultUser.value = userId
+		equippedSkin.value = null
+		notifyAccountChange()
+		await refreshValues()
+	} catch (error) {
+		handleError(error as Error)
+	} finally {
+		accountSelectionPending.value = false
+	}
 }
 
+watch(
+	[skinSitePlayers, defaultUser, skinSiteUser],
+	([availablePlayers, selectedLocalUser]) => {
+		if (!selectedLocalUser && !selectedSkinSitePlayerId.value && availablePlayers.length > 0) {
+			selectSkinSitePlayer(availablePlayers[0].uuid)
+		}
+	},
+	{ immediate: true },
+)
+
 async function login() {
 	if (offline.value) return
 	loginDisabled.value = true
@@ -684,185 +719,6 @@ async function onMicrosoftLogin(account: MinecraftCredential) {
 	}
 }
 
-async function showYggdrasilAccountModal() {
-	yggdrasilApiRoot.value = STARLIGHT_YGGDRASIL_API_ROOT
-	yggdrasilLogin.value = ''
-	yggdrasilPassword.value = ''
-	rememberYggdrasilPassword.value = true
-	pendingYggdrasilFlowId.value = undefined
-	pendingYggdrasilProfiles.value = []
-	await loadSavedYggdrasilLogins()
-	yggdrasilAccountModal.value?.show()
-}
-
-async function loadSavedYggdrasilLogins() {
-	const storedLogins = await list_yggdrasil_saved_logins().catch(handleError)
-	const savedLogins: SavedYggdrasilLogin[] = Array.isArray(storedLogins)
-		? [...storedLogins].filter(
-				(savedLogin) => savedLogin.api_root.replace(/\/+$/, '') === STARLIGHT_YGGDRASIL_API_ROOT,
-			)
-		: []
-	const savedLoginKeys = new Set(
-		savedLogins.map((savedLogin) => `${savedLogin.api_root}\n${savedLogin.login}`),
-	)
-
-	for (const account of accounts.value) {
-		if (
-			!account.yggdrasil ||
-			account.yggdrasil.api_root.replace(/\/+$/, '') !== STARLIGHT_YGGDRASIL_API_ROOT
-		)
-			continue
-		const savedLogin = {
-			api_root: account.yggdrasil.api_root,
-			login: account.yggdrasil.login,
-		}
-		const key = `${savedLogin.api_root}\n${savedLogin.login}`
-		if (savedLoginKeys.has(key)) continue
-
-		try {
-			const password = await get_yggdrasil_password(savedLogin.api_root, savedLogin.login)
-			if (!password) continue
-			await set_yggdrasil_password(savedLogin.api_root, savedLogin.login, password)
-			savedLogins.push(savedLogin)
-			savedLoginKeys.add(key)
-		} catch {
-			continue
-		}
-	}
-
-	savedYggdrasilLogins.value = savedLogins.sort((left, right) =>
-		left.login.localeCompare(right.login),
-	)
-}
-
-async function selectSavedYggdrasilLogin(savedLogin: SavedYggdrasilLogin) {
-	if (loginDisabled.value) return
-
-	loginDisabled.value = true
-	try {
-		const password = await get_yggdrasil_password(savedLogin.api_root, savedLogin.login)
-		if (!password) {
-			await delete_yggdrasil_password(savedLogin.api_root, savedLogin.login)
-			await loadSavedYggdrasilLogins()
-			return
-		}
-		yggdrasilApiRoot.value = savedLogin.api_root
-		yggdrasilLogin.value = savedLogin.login
-		yggdrasilPassword.value = password
-		rememberYggdrasilPassword.value = true
-	} catch (error) {
-		handleError(error as Error)
-	} finally {
-		loginDisabled.value = false
-	}
-}
-
-async function removeSavedYggdrasilLogin(savedLogin: SavedYggdrasilLogin) {
-	if (loginDisabled.value) return
-
-	loginDisabled.value = true
-	try {
-		await delete_yggdrasil_password(savedLogin.api_root, savedLogin.login)
-		savedYggdrasilLogins.value = savedYggdrasilLogins.value.filter(
-			(entry) => entry.api_root !== savedLogin.api_root || entry.login !== savedLogin.login,
-		)
-		if (
-			yggdrasilApiRoot.value === savedLogin.api_root &&
-			yggdrasilLogin.value === savedLogin.login
-		) {
-			yggdrasilPassword.value = ''
-			rememberYggdrasilPassword.value = false
-		}
-	} catch (error) {
-		handleError(error as Error)
-	} finally {
-		loginDisabled.value = false
-	}
-}
-
-async function loadRememberedYggdrasilPassword() {
-	if (
-		!rememberYggdrasilPassword.value ||
-		!yggdrasilApiRoot.value.trim() ||
-		!yggdrasilLogin.value.trim() ||
-		yggdrasilPassword.value
-	)
-		return
-
-	try {
-		const password = await get_yggdrasil_password(
-			yggdrasilApiRoot.value.trim(),
-			yggdrasilLogin.value.trim(),
-		)
-		if (password) yggdrasilPassword.value = password
-	} catch {
-		return
-	}
-}
-
-async function persistYggdrasilPasswordPreference() {
-	try {
-		if (rememberYggdrasilPassword.value) {
-			await set_yggdrasil_password(
-				yggdrasilApiRoot.value.trim(),
-				yggdrasilLogin.value.trim(),
-				yggdrasilPassword.value,
-			)
-		} else {
-			await delete_yggdrasil_password(yggdrasilApiRoot.value.trim(), yggdrasilLogin.value.trim())
-		}
-	} catch (error) {
-		handleError(error as Error)
-	}
-}
-
-async function addYggdrasilAccount() {
-	if (!yggdrasilFormValid.value || loginDisabled.value) return
-	if (yggdrasilApiRoot.value.trim().replace(/\/+$/, '') !== STARLIGHT_YGGDRASIL_API_ROOT) return
-
-	loginDisabled.value = true
-	try {
-		const result = (await begin_yggdrasil_login(
-			yggdrasilApiRoot.value.trim(),
-			yggdrasilLogin.value.trim(),
-			yggdrasilPassword.value,
-		)) as YggdrasilLoginResult
-		if (result.status === 'complete') {
-			await persistYggdrasilPasswordPreference()
-			yggdrasilAccountModal.value?.hide()
-			await setAccount(result.credentials)
-		} else {
-			pendingYggdrasilFlowId.value = result.flow_id
-			pendingYggdrasilProfiles.value = result.profiles
-			yggdrasilAccountModal.value?.hide()
-			yggdrasilProfileModal.value?.show()
-		}
-	} catch (error) {
-		handleError(error as Error)
-	} finally {
-		loginDisabled.value = false
-	}
-}
-
-async function selectYggdrasilProfile(profileId: string) {
-	if (!pendingYggdrasilFlowId.value || loginDisabled.value) return
-
-	loginDisabled.value = true
-	try {
-		const account = (await finish_yggdrasil_login(
-			pendingYggdrasilFlowId.value,
-			profileId,
-		)) as MinecraftCredential
-		await persistYggdrasilPasswordPreference()
-		yggdrasilProfileModal.value?.hide()
-		await setAccount(account)
-	} catch (error) {
-		handleError(error as Error)
-	} finally {
-		loginDisabled.value = false
-	}
-}
-
 async function logout(account: MinecraftCredential) {
 	await remove_user(account.profile.id).catch(handleError)
 	await refreshValues()
@@ -881,7 +737,7 @@ async function copyAccountUuid(account: MinecraftCredential) {
 	}
 }
 
-const unlisten = await process_listener(async (e) => {
+const unlisten = await process_listener(async (e: { event: string }) => {
 	if (e.event === 'launched') {
 		await refreshValues()
 	}
@@ -897,14 +753,47 @@ onUnmounted(() => {
 })
 
 const messages = defineMessages({
+	skinSiteSignedIn: {
+		id: 'minecraft-account.skin-site.signed-in',
+		defaultMessage: 'Signed in to StarLight Skin Site',
+	},
+	skinSiteChecking: {
+		id: 'minecraft-account.skin-site.checking',
+		defaultMessage: 'Checking skin site session…',
+	},
+	skinSiteSyncError: {
+		id: 'minecraft-account.skin-site.sync-error',
+		defaultMessage: 'Could not verify the skin site session. Retrying automatically.',
+	},
+	skinSitePlayers: {
+		id: 'minecraft-account.skin-site.players',
+		defaultMessage: 'Skin site players ({count})',
+	},
+	retrySkinSitePlayers: {
+		id: 'minecraft-account.skin-site.players.retry',
+		defaultMessage: 'Retry',
+	},
+	noSkinSitePlayers: {
+		id: 'minecraft-account.skin-site.players.empty',
+		defaultMessage: 'No player profiles are attached to this skin site account.',
+	},
+	skinSitePlayersError: {
+		id: 'minecraft-account.skin-site.players.error',
+		defaultMessage: 'Could not refresh the player list. Previously loaded players are kept.',
+	},
 	offlineMode: {
 		id: 'minecraft-account.offline-mode',
 		defaultMessage: 'Offline mode',
 	},
-	offlineModeDescription: {
-		id: 'minecraft-account.offline-mode.description',
+	offlineModeNoInternetDescription: {
+		id: 'minecraft-account.offline-mode.description.no-internet',
 		defaultMessage:
-			'Only offline accounts are available. You can launch fully downloaded instances.',
+			'It looks like this device may not be connected to the internet. You can currently only launch fully downloaded instances and will most likely be unable to connect to StarLight servers. Check your network connection. If you are using a proxy, try disabling or enabling it, then refresh the connection status below.',
+	},
+	offlineModeServerUnavailableDescription: {
+		id: 'minecraft-account.offline-mode.description.server-unavailable',
+		defaultMessage:
+			"Your internet connection is working, but StarLight's authentication server cannot be reached. The StarLight server may be undergoing maintenance, or your proxy may be misconfigured. If you are using a proxy, try disabling or enabling it, then refresh the connection status below. If that does not help, contact a server administrator in the StarLight community group to confirm the maintenance status.",
 	},
 	refreshNetworkStatus: {
 		id: 'minecraft-account.offline-mode.refresh',
@@ -916,11 +805,11 @@ const messages = defineMessages({
 	},
 	addMicrosoftAccount: {
 		id: 'minecraft-account.add-microsoft-account',
-		defaultMessage: 'Add Microsoft account',
+		defaultMessage: 'Add your own Minecraft account',
 	},
-	addThirdPartyAccount: {
-		id: 'minecraft-account.add-third-party-account',
-		defaultMessage: 'Add third-party account',
+	signInToStarlight: {
+		id: 'minecraft-account.sign-in-starlight',
+		defaultMessage: 'Sign in to StarLight Skin Site',
 	},
 	thirdPartyAccount: {
 		id: 'minecraft-account.third-party-account',
@@ -930,58 +819,6 @@ const messages = defineMessages({
 		id: 'minecraft-account.third-party-badge',
 		defaultMessage: 'StarLight skin',
 	},
-	thirdPartyModalTitle: {
-		id: 'minecraft-account.third-party-modal.title',
-		defaultMessage: 'Sign in with StarLight skin',
-	},
-	thirdPartyModalDescription: {
-		id: 'minecraft-account.third-party-modal.description',
-		defaultMessage: 'Sign in with your StarLight skin account.',
-	},
-	apiRootLabel: {
-		id: 'minecraft-account.third-party-modal.api-root',
-		defaultMessage: 'StarLight skin API address',
-	},
-	apiRootPlaceholder: {
-		id: 'minecraft-account.third-party-modal.api-root-placeholder',
-		defaultMessage: 'https://skin.starlight.cool/yggdrasil',
-	},
-	accountLabel: {
-		id: 'minecraft-account.third-party-modal.account',
-		defaultMessage: 'Account or email',
-	},
-	accountPlaceholder: {
-		id: 'minecraft-account.third-party-modal.account-placeholder',
-		defaultMessage: 'Enter your account or email',
-	},
-	passwordLabel: {
-		id: 'minecraft-account.third-party-modal.password',
-		defaultMessage: 'Password',
-	},
-	rememberPassword: {
-		id: 'minecraft-account.third-party-modal.remember-password',
-		defaultMessage: 'Save this login on this device',
-	},
-	savedLogins: {
-		id: 'minecraft-account.third-party-modal.saved-logins',
-		defaultMessage: 'Saved logins',
-	},
-	removeSavedLogin: {
-		id: 'minecraft-account.third-party-modal.remove-saved-login',
-		defaultMessage: 'Remove saved login',
-	},
-	signInButton: {
-		id: 'minecraft-account.third-party-modal.sign-in',
-		defaultMessage: 'Sign in',
-	},
-	selectProfileTitle: {
-		id: 'minecraft-account.third-party-profile.title',
-		defaultMessage: 'Select a profile',
-	},
-	selectProfileDescription: {
-		id: 'minecraft-account.third-party-profile.description',
-		defaultMessage: 'Choose the Minecraft profile to use with this account.',
-	},
 	offlineAccount: {
 		id: 'minecraft-account.offline-account',
 		defaultMessage: 'Offline Minecraft account',
@@ -1064,10 +901,6 @@ const messages = defineMessages({
 		id: 'minecraft-account.label',
 		defaultMessage: 'Minecraft account',
 	},
-	signInToMinecraft: {
-		id: 'minecraft-account.sign-in',
-		defaultMessage: 'Sign in to Minecraft',
-	},
 	loginTrouble: {
 		id: 'minecraft-login.trouble',
 		defaultMessage: 'Having trouble?',

apps/app-frontend/src/components/ui/AppActionBar.vue

@@ -137,6 +137,11 @@
 										<OnlineIndicatorIcon />
 										<span class="mr-auto text-contrast flex items-center gap-2">
 											{{ process.instance.name }}
+											<span class="text-xs text-secondary">{{
+												formatMessage(messages.windowStarted, {
+													time: new Date(process.start_time),
+												})
+											}}</span>
 											<StarIcon v-if="process.uuid === selectedProcess.uuid" class="text-orange" />
 										</span>
 									</button>
@@ -307,11 +312,13 @@ const notificationCenterShown = ref(false)
 
 interface RunningProcess {
 	uuid: string
+	start_time: string
 	instance_id: string
 	instance: GameInstance
 }
 
 interface LoadingEventPayload {
+	total?: number | null
 	event: LoadingBar['bar_type']
 	loader_uuid: string
 	fraction: number | null
@@ -319,6 +326,10 @@ interface LoadingEventPayload {
 }
 
 const messages = defineMessages({
+	windowStarted: {
+		id: 'app.action-bar.window-started',
+		defaultMessage: 'Started {time, time, medium}',
+	},
 	offline: {
 		id: 'app.action-bar.offline',
 		defaultMessage: 'Offline',
@@ -345,7 +356,7 @@ const messages = defineMessages({
 	},
 	stopInstance: {
 		id: 'app.action-bar.stop-instance',
-		defaultMessage: 'Stop instance',
+		defaultMessage: 'Stop window',
 	},
 	viewLogs: {
 		id: 'app.action-bar.view-logs',
@@ -400,8 +411,9 @@ const refresh = async () => {
 	const processes = ((await getRunningProcesses().catch((error) => {
 		handleError(error)
 		return []
-	})) ?? []) as Array<{ uuid: string; instance_id: string }>
-	const instanceIds = processes.map((process) => process.instance_id)
+	})) ?? []) as Array<{ uuid: string; instance_id: string; start_time: string }>
+	processes.sort((a, b) => a.start_time.localeCompare(b.start_time))
+	const instanceIds = [...new Set(processes.map((process) => process.instance_id))]
 	const instances: GameInstance[] = await getInstances(instanceIds).catch((error) => {
 		handleError(error)
 		return []
@@ -419,9 +431,9 @@ const refresh = async () => {
 			}
 		})
 		.filter((process): process is RunningProcess => process !== null)
-	if (!selectedProcess.value || !currentProcesses.value.includes(selectedProcess.value)) {
-		selectedProcess.value = currentProcesses.value[0]
-	}
+	selectedProcess.value =
+		currentProcesses.value.find((process) => process.uuid === selectedProcess.value?.uuid) ??
+		currentProcesses.value[0]
 }
 
 await refresh()
@@ -435,7 +447,6 @@ const unlistenProcess = await process_listener(async () => {
 const stop = async (process: RunningProcess) => {
 	try {
 		await killProcess(process.uuid).catch(handleError)
-
 	} catch (e) {
 		console.error(e)
 	}
@@ -629,6 +640,7 @@ function isVisibleLoadingBar(loadingBar: LoadingBar): boolean {
 	return (
 		loadingBar.bar_type?.type !== 'launcher_update' &&
 		[
+			'hosted_pack_sync',
 			'java_download',
 			'pack_file_download',
 			'pack_download',
@@ -655,8 +667,8 @@ function applyLoadingEvent(payload: LoadingEventPayload): boolean {
 	const loadingBar = formatLoadingBars({
 		loading_bar_uuid: payload.loader_uuid,
 		message: payload.message,
-		current: payload.fraction,
-		total: 1,
+		current: payload.fraction * (payload.total ?? 1),
+		total: payload.total ?? 1,
 		bar_type: payload.event,
 	})
 	if (!isVisibleLoadingBar(loadingBar)) return false

apps/app-frontend/src/components/ui/ExportModal.vue

@@ -11,8 +11,8 @@ import {
 	StyledInput,
 	useVIntl,
 } from '@modrinth/ui'
-import { save } from '@tauri-apps/plugin-dialog'
 import { join } from '@tauri-apps/api/path'
+import { save } from '@tauri-apps/plugin-dialog'
 import { readDir, stat } from '@tauri-apps/plugin-fs'
 import { ref } from 'vue'
 

apps/app-frontend/src/components/ui/Instance.vue

@@ -1,12 +1,5 @@
 <script setup>
-import {
-	DownloadIcon,
-	GameIcon,
-	PlayIcon,
-	SpinnerIcon,
-	StopCircleIcon,
-	TimerIcon,
-} from '@modrinth/assets'
+import { DownloadIcon, GameIcon, PlayIcon, SpinnerIcon, TimerIcon } from '@modrinth/assets'
 import {
 	Avatar,
 	ButtonStyled,
@@ -27,6 +20,7 @@ import { process_listener } from '@/helpers/events'
 import { install_existing_instance, install_pack_to_existing_instance } from '@/helpers/install'
 import { kill, run } from '@/helpers/instance'
 import { getDisplayInstanceIcon } from '@/helpers/instance-icons'
+import { isInstanceLaunching } from '@/helpers/instance-launch-state'
 import { get_by_instance_id } from '@/helpers/process'
 import { showInstanceInFolder } from '@/helpers/utils.js'
 import { handleSevereError } from '@/store/error.js'
@@ -36,6 +30,7 @@ const formatRelativeTime = useRelativeTime()
 const { formatMessage } = useVIntl()
 const handleMinecraftLaunchError = useMinecraftLaunchError()
 const messages = defineMessages({
+	launchAnother: { id: 'app.instance.launch-another', defaultMessage: 'Launch another window' },
 	loading: { id: 'app.instance.loading', defaultMessage: 'Instance is loading...' },
 	played: { id: 'app.instance.played', defaultMessage: 'Played {time}' },
 	neverPlayed: { id: 'app.instance.never-played', defaultMessage: 'Never played' },
@@ -85,13 +80,8 @@ const isPlaying = computed(() => props.playing ?? internalPlaying.value)
 const displayIcon = computed(() =>
 	getDisplayInstanceIcon(props.instance.icon_path, props.instance.loader),
 )
-const loading = ref(false)
-const modLoading = computed(
-	() =>
-		loading.value ||
-		currentEvent.value === 'installing' ||
-		(currentEvent.value === 'launched' && !isPlaying.value),
-)
+const loading = computed(() => isInstanceLaunching(props.instance.id))
+const modLoading = computed(() => loading.value || installing.value)
 const installing = computed(() => props.instance.install_stage.includes('installing'))
 const installed = computed(() => props.instance.install_stage === 'installed')
 
@@ -105,31 +95,26 @@ const checkProcess = async () => {
 	if (props.playing !== undefined) return
 	const runningProcesses = await get_by_instance_id(props.instance.id).catch(handleError)
 
-	internalPlaying.value = runningProcesses.length > 0
+	if (Array.isArray(runningProcesses)) internalPlaying.value = runningProcesses.length > 0
 }
 
-const play = async (e, context) => {
+const play = async (e) => {
 	e?.stopPropagation()
-	loading.value = true
-	await run(props.instance.id)
-		.catch(async (err) => {
-			const handled = await handleMinecraftLaunchError(err, {
-				instance_id: props.instance.id,
-				instance_name: props.instance.name,
-			})
-			if (!handled) handleSevereError(err, { instanceId: props.instance.id })
+	if (loading.value) return
+	await run(props.instance.id).catch(async (err) => {
+		const handled = await handleMinecraftLaunchError(err, {
+			instance_id: props.instance.id,
+			instance_name: props.instance.name,
 		})
-		.finally(() => {
-		})
-	loading.value = false
+		if (!handled) handleSevereError(err, { instanceId: props.instance.id })
+	})
+	await checkProcess()
 }
 
-const stop = async (e, context) => {
+const stop = async (e) => {
 	e?.stopPropagation()
-	internalPlaying.value = false
-
 	await kill(props.instance.id).catch(handleError)
-
+	await checkProcess()
 }
 
 const repair = async (e) => {
@@ -171,16 +156,11 @@ defineExpose({
 	instance: props.instance,
 })
 
-const currentEvent = ref(null)
-
 const unlisten =
 	props.playing === undefined
 		? await process_listener((e) => {
 				if (e.instance_id === props.instance.id) {
-					currentEvent.value = e.event
-					if (e.event === 'finished') {
-						internalPlaying.value = false
-					}
+					void checkProcess()
 				}
 			})
 		: () => undefined
@@ -212,15 +192,7 @@ onUnmounted(() => unlisten())
 				<span class="line-clamp-2">{{ instance.name }}</span>
 			</div>
 			<div class="flex items-center">
-				<ButtonStyled v-if="isPlaying" color="red" circular @mousehover="checkProcess">
-					<button
-						v-tooltip="formatMessage(commonMessages.stopButton)"
-						@click="(e) => stop(e, 'InstanceCard')"
-					>
-						<StopCircleIcon />
-					</button>
-				</ButtonStyled>
-				<ButtonStyled v-else-if="modLoading" color="standard" circular>
+				<ButtonStyled v-if="modLoading" color="standard" circular>
 					<button v-tooltip="formatMessage(messages.loading)" disabled>
 						<SpinnerIcon class="animate-spin" />
 					</button>
@@ -230,10 +202,10 @@ onUnmounted(() => unlisten())
 						v-tooltip="
 							offline && !installed
 								? formatMessage(messages.offlineInstalledOnly)
-								: formatMessage(commonMessages.playButton)
+								: formatMessage(isPlaying ? messages.launchAnother : commonMessages.playButton)
 						"
 						:disabled="offline && !installed"
-						@click="(e) => play(e, 'InstanceCard')"
+						@click="play"
 						@mousehover="checkProcess"
 					>
 						<!-- Translate for optical centering -->
@@ -290,17 +262,8 @@ onUnmounted(() => unlisten())
 					/>
 				</div>
 				<div class="absolute bottom-1.5 right-1.5 flex size-12 items-center justify-center">
-					<ButtonStyled v-if="isPlaying" size="large" color="red" circular>
-						<button
-							v-tooltip="formatMessage(commonMessages.stopButton)"
-							@click="(e) => stop(e, 'InstanceCard')"
-							@mousehover="checkProcess"
-						>
-							<StopCircleIcon />
-						</button>
-					</ButtonStyled>
 					<ButtonStyled
-						v-else-if="!modLoading && !installing && !installed"
+						v-if="!modLoading && !installing && !installed"
 						size="large"
 						color="brand"
 						circular
@@ -324,13 +287,15 @@ onUnmounted(() => unlisten())
 					</ButtonStyled>
 					<ButtonStyled v-else-if="!modLoading && !installing" size="large" color="brand" circular>
 						<button
-							v-tooltip="formatMessage(commonMessages.playButton)"
+							v-tooltip="
+								formatMessage(isPlaying ? messages.launchAnother : commonMessages.playButton)
+							"
 							:class="{
 								'pointer-events-none scale-75 opacity-0': disabled,
 								'scale-75 opacity-0 transition-all group-hover:scale-100 group-hover:opacity-100':
 									!disabled,
 							}"
-							@click="(e) => play(e, 'InstanceCard')"
+							@click="play"
 							@mousehover="checkProcess"
 						>
 							<PlayIcon class="translate-x-[1px]" />
@@ -369,19 +334,8 @@ onUnmounted(() => unlisten())
 					:class="`transition-all ${modLoading || installing ? `brightness-[0.25] scale-[0.85]` : `group-hover:brightness-75`}`"
 				/>
 				<div class="absolute inset-0 flex items-center justify-center">
-					<ButtonStyled v-if="isPlaying" size="large" color="red" circular>
-						<button
-							v-tooltip="formatMessage(commonMessages.stopButton)"
-							:class="{ 'scale-100 opacity-100': isPlaying }"
-							class="transition-all origin-bottom opacity-0 card-shadow"
-							@click="(e) => stop(e, 'InstanceCard')"
-							@mousehover="checkProcess"
-						>
-							<StopCircleIcon />
-						</button>
-					</ButtonStyled>
 					<SpinnerIcon
-						v-else-if="modLoading || installing"
+						v-if="modLoading || installing"
 						v-tooltip="
 							modLoading
 								? formatMessage(messages.loading)
@@ -406,7 +360,9 @@ onUnmounted(() => unlisten())
 					</ButtonStyled>
 					<ButtonStyled v-else size="large" color="brand" circular>
 						<button
-							v-tooltip="formatMessage(commonMessages.playButton)"
+							v-tooltip="
+								formatMessage(isPlaying ? messages.launchAnother : commonMessages.playButton)
+							"
 							:class="`transition-all scale-75 origin-bottom card-shadow ${disabled ? 'opacity-0 scale-75' : 'opacity-0 group-hover:scale-100 group-hover:opacity-100 group-focus-within:scale-100 group-focus-within:opacity-100'}`"
 							@click="(e) => play(e, 'InstanceCard')"
 							@mousehover="checkProcess"

apps/app-frontend/src/components/ui/MinecraftCrashModal.vue

@@ -522,7 +522,7 @@ async function copyShareUrl(): Promise<void> {
 	}
 }
 
-function _openAIAnalysis(): void {
+function openAIAnalysis(): void {
 	if (!lastAnalysis?.combined_log) {
 		notifyNoLogContent()
 		return
@@ -603,7 +603,7 @@ onUnmounted(() => {
 	unlistenProcess?.()
 })
 
-defineExpose({ handleLaunchError, handleWarning, isLaunchFailure, showPreview, openAIAnalysis: _openAIAnalysis })
+defineExpose({ handleLaunchError, handleWarning, isLaunchFailure, showPreview, openAIAnalysis })
 </script>
 
 <template>

apps/app-frontend/src/components/ui/SkinSiteFrame.vue

@@ -0,0 +1,22 @@
+<script setup lang="ts">
+import { defineMessages, useVIntl } from '@modrinth/ui'
+
+import { skinSiteFrameUrl } from '@/composables/skin-site-session'
+
+const { formatMessage } = useVIntl()
+const messages = defineMessages({
+	frameTitle: {
+		id: 'app.starlight-skin.frame-title',
+		defaultMessage: 'StarLight Skin Site',
+	},
+})
+
+</script>
+
+<template>
+	<iframe
+		:src="skinSiteFrameUrl"
+		:title="formatMessage(messages.frameTitle)"
+		class="block h-full min-h-0 w-full border-0"
+	/>
+</template>

apps/app-frontend/src/components/ui/SkinSiteSessionFrame.vue

@@ -0,0 +1,65 @@
+<script setup lang="ts">
+import { onMounted, onUnmounted, ref, watch } from 'vue'
+
+import {
+	receiveSkinSiteMessage,
+	resetSkinSiteSession,
+	setSkinSiteFrame,
+	SKIN_SITE_ORIGIN,
+	skinSiteStatus,
+	skinSiteUser,
+} from '@/composables/skin-site-session'
+import { clearHostedSession } from '@/helpers/hosted-packs'
+
+const frame = ref<HTMLIFrameElement>()
+let lastMessage = 0
+let expiryTimer: ReturnType<typeof setInterval> | undefined
+
+watch(
+	[skinSiteStatus, () => skinSiteUser.value?.uuid],
+	() => {
+		void clearHostedSession().catch(() => {})
+	},
+	{ flush: 'sync' },
+)
+
+function connect() {
+	resetSkinSiteSession()
+	lastMessage = 0
+	const contentWindow = frame.value?.contentWindow ?? null
+	setSkinSiteFrame(contentWindow)
+	contentWindow?.postMessage({ type: 'starlight-skin-session-connect' }, SKIN_SITE_ORIGIN)
+}
+
+function receive(event: MessageEvent) {
+	if (receiveSkinSiteMessage(event, frame.value?.contentWindow ?? null)) lastMessage = Date.now()
+}
+
+onMounted(() => {
+	window.addEventListener('message', receive)
+	connect()
+	expiryTimer = setInterval(() => {
+		if (lastMessage && Date.now() - lastMessage > 90_000) resetSkinSiteSession()
+	}, 10_000)
+})
+
+onUnmounted(() => {
+	window.removeEventListener('message', receive)
+	clearInterval(expiryTimer)
+	setSkinSiteFrame(null)
+	resetSkinSiteSession()
+	void clearHostedSession().catch(() => {})
+})
+</script>
+
+<template>
+	<iframe
+		ref="frame"
+		:src="`${SKIN_SITE_ORIGIN}/`"
+		title="StarLight Skin Site session"
+		aria-hidden="true"
+		tabindex="-1"
+		class="pointer-events-none fixed -left-[10000px] top-0 h-px w-px opacity-0"
+		@load="connect"
+	/>
+</template>

apps/app-frontend/src/components/ui/about-scene/wither-shield.ts

@@ -0,0 +1,274 @@
+type Point = [number, number]
+type Quad = [Point, Point, Point, Point]
+type ShieldSurface = { plane: Quad; outline?: Point[]; shade?: number }
+
+// Coordinates follow the sharp master with its localized shoulder cleanup,
+// normalized to the scene's 2048 × 682⅔ plate.
+// Each visible bone has its own face: the air between ribs must never receive armor.
+export const witherShieldSurfaces: ShieldSurface[] = [
+	// Only the upper chest remains; the removed side beams have no shield surfaces.
+	{
+		plane: [
+			[1194, 479],
+			[1294, 489],
+			[1283, 516],
+			[1183, 505],
+		],
+	},
+	// Far central skull: face, jaw wall and right side share the same edges.
+	{
+		plane: [
+			[1162, 355],
+			[1319, 352],
+			[1267, 446],
+			[1108, 442],
+		],
+	},
+	{
+		plane: [
+			[1108, 442],
+			[1267, 446],
+			[1280, 489],
+			[1119, 470],
+		],
+		shade: 0.68,
+	},
+	{
+		plane: [
+			[1319, 352],
+			[1356, 443],
+			[1319, 492],
+			[1267, 446],
+		],
+		shade: 0.6,
+	},
+	// Near-left skull, underneath the boot.
+	{
+		plane: [
+			[794, 477],
+			[968, 454],
+			[1003, 549],
+			[833, 602],
+		],
+	},
+	{
+		plane: [
+			[794, 477],
+			[833, 602],
+			[821, 625],
+			[781, 539],
+		],
+		shade: 0.55,
+	},
+	{
+		plane: [
+			[833, 602],
+			[1003, 549],
+			[983, 587],
+			[821, 625],
+		],
+		shade: 0.65,
+	},
+	// Right skull.
+	{
+		plane: [
+			[1482, 399],
+			[1639, 469],
+			[1568, 582],
+			[1402, 507],
+		],
+	},
+	{
+		plane: [
+			[1639, 469],
+			[1650, 557],
+			[1597, 631],
+			[1568, 582],
+		],
+		shade: 0.57,
+	},
+	{
+		plane: [
+			[1402, 507],
+			[1568, 582],
+			[1597, 631],
+			[1414, 583],
+		],
+		shade: 0.66,
+		outline: [
+			[1402, 507],
+			[1568, 582],
+			[1597, 631],
+			[1561, 637],
+			[1444, 621],
+			[1414, 583],
+		],
+	},
+	// Rear rib, left and right of the chest opening.
+	{
+		plane: [
+			[1021, 505],
+			[1129, 484],
+			[1118, 501],
+			[1009, 520],
+		],
+	},
+	{
+		plane: [
+			[1009, 520],
+			[1118, 501],
+			[1112, 515],
+			[1006, 535],
+		],
+		shade: 0.65,
+	},
+	{
+		plane: [
+			[1191, 486],
+			[1300, 510],
+			[1289, 530],
+			[1181, 510],
+		],
+	},
+	{
+		plane: [
+			[1289, 530],
+			[1300, 510],
+			[1310, 611],
+			[1296, 621],
+		],
+		shade: 0.6,
+	},
+	// Middle rib and broken sternum: separate profiles preserve the dark gaps.
+	{
+		plane: [
+			[1052, 514],
+			[1159, 519],
+			[1129, 553],
+			[992, 548],
+		],
+		outline: [
+			[1015, 535],
+			[1052, 520],
+			[1094, 522],
+			[1110, 514],
+			[1159, 519],
+			[1129, 553],
+			[992, 548],
+		],
+	},
+	{
+		plane: [
+			[992, 548],
+			[1129, 553],
+			[1137, 575],
+			[987, 567],
+		],
+		shade: 0.6,
+	},
+	{
+		plane: [
+			[1159, 519],
+			[1170, 560],
+			[1137, 575],
+			[1129, 553],
+		],
+		shade: 0.55,
+	},
+	{
+		plane: [
+			[1180, 513],
+			[1289, 551],
+			[1274, 575],
+			[1159, 538],
+		],
+	},
+	{
+		plane: [
+			[1274, 575],
+			[1289, 551],
+			[1298, 617],
+			[1279, 632],
+		],
+		shade: 0.62,
+	},
+	// Closest right rib; its downturned end stops above the ground.
+	{
+		plane: [
+			[1157, 542],
+			[1261, 581],
+			[1243, 602],
+			[1141, 564],
+		],
+	},
+	{
+		plane: [
+			[1141, 564],
+			[1243, 602],
+			[1255, 641],
+			[1148, 605],
+		],
+		shade: 0.7,
+	},
+	{
+		plane: [
+			[1243, 602],
+			[1261, 581],
+			[1270, 627],
+			[1255, 641],
+		],
+		shade: 0.55,
+	},
+	// Foreground rib and spine.
+	{
+		plane: [
+			[1000, 566],
+			[1140, 581],
+			[1107, 604],
+			[960, 589],
+		],
+	},
+	{
+		plane: [
+			[960, 589],
+			[1107, 604],
+			[1112, 680],
+			[968, 622],
+		],
+		shade: 0.6,
+		outline: [
+			[960, 589],
+			[1107, 604],
+			[1112, 680],
+			[1070, 681],
+			[1066, 619],
+			[968, 611],
+		],
+	},
+	{
+		plane: [
+			[1107, 604],
+			[1140, 581],
+			[1160, 669],
+			[1112, 680],
+		],
+		shade: 0.5,
+	},
+	{
+		plane: [
+			[986, 611],
+			[1070, 617],
+			[967, 684],
+			[874, 671],
+		],
+	},
+	{
+		plane: [
+			[1070, 617],
+			[1074, 668],
+			[1060, 684],
+			[967, 684],
+		],
+		shade: 0.55,
+	},
+]

apps/app-frontend/src/components/ui/about-scene/wither-victory.ts

@@ -0,0 +1,953 @@
+import cloudTextureUrl from '@/assets/about-scene/clouds.png'
+import moonTextureUrl from '@/assets/about-scene/moon-phases.png'
+import swordTextureUrl from '@/assets/about-scene/netherite-sword.png'
+import cleanUrl from '@/assets/about-scene/victory-clean.jpg'
+import originalUrl from '@/assets/about-scene/victory-master.jpg'
+import correctedPoseUrl from '@/assets/about-scene/victory-pose.jpg'
+import removedBeamsUrl from '@/assets/about-scene/wither-beams-removed.png'
+import rebuiltWitherUrl from '@/assets/about-scene/wither-shoulder-cleanup.png'
+
+import { witherShieldSurfaces } from './wither-shield'
+
+type Point = [number, number]
+type Vertex = [number, number, number]
+
+/** The approved artwork and item geometry are kept separate from the animation lifecycle. */
+export function createWitherVictoryScene(canvas: HTMLCanvasElement) {
+	const context = canvas.getContext('2d')
+	if (!context) throw new Error('Unable to initialize about-page canvas')
+	const ctx = context
+	const reducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)')
+	const original = new Image()
+	const clean = new Image()
+	const correctedPose = new Image()
+	const rebuiltWither = new Image()
+	const removedBeams = new Image()
+	const swordTexture = new Image()
+	const cloudTexture = new Image()
+	const moonTexture = new Image()
+	const W = 2048,
+		H = W / 3,
+		artworkWidth = 2172,
+		artworkHeight = 724,
+		artworkScale = artworkWidth / W,
+		TAU = Math.PI * 2
+	let time = 0,
+		last = 0,
+		paused = false,
+		visible = false,
+		ready = false
+	let frame = 0,
+		destroyed = false
+	const makeLayer = (w = W, h = H) => {
+		const layer = document.createElement('canvas')
+		layer.width = Math.ceil(w)
+		layer.height = Math.ceil(h)
+		return layer
+	}
+	const base = makeLayer(artworkWidth, artworkHeight)
+	const shield = makeLayer(artworkWidth, artworkHeight)
+	const star = makeLayer(180, 180)
+	const starFace = makeLayer(180, 180)
+	const swordFace = makeLayer(128, 128)
+	const grippingFingers = makeLayer(64, 80)
+	let cloudField: ReturnType<typeof makeVanillaCloudField>
+	const buriedBlade: Point[] = [
+		[1088, 526],
+		[1099, 505],
+		[1105, 491],
+		[1116, 490],
+		[1124, 483],
+		[1133, 485],
+		[1142, 478],
+		[1158, 477],
+		[1195, 480],
+		[1212, 534],
+		[1169, 567],
+		[1101, 555],
+	]
+	const wound: Point[] = [
+		[1104, 507],
+		[1116, 490],
+		[1136, 490],
+		[1140, 480],
+		[1156, 477],
+		[1178, 479],
+		[1173, 493],
+		[1157, 505],
+		[1152, 524],
+		[1137, 534],
+		[1126, 523],
+	]
+	const starRows = [
+		'....p....',
+		'...pwp...',
+		'..pwYwp..',
+		'.pwYIYwp.',
+		'pwYISIYwp',
+		'.pwYIYwp.',
+		'..pwYwp..',
+		'...pwp...',
+		'....p....',
+	]
+	const starColors: Record<string, string> = {
+		p: '#b692d0',
+		w: '#f8e6cf',
+		Y: '#ffe3a0',
+		I: '#fff6da',
+		S: '#fffef1',
+	}
+	// Irregular failing-lamp events: brief reignitions, weak sputters, and dark gaps.
+	const shieldEvents = [
+		[0, 0.68, 0.48],
+		[0.87, 0.09, 0.82],
+		[1.05, 0.16, 0.27],
+		[1.39, 0.08, 0.61],
+		[2.7, 0.42, 0.2],
+		[3.27, 0.13, 0.65],
+		[4.8, 0.82, 0.42],
+		[5.83, 0.06, 0.82],
+		[6.08, 0.13, 0.29],
+		[6.39, 0.09, 0.7],
+		[8.15, 0.53, 0.26],
+		[9.64, 0.12, 0.69],
+		[9.88, 0.19, 0.34],
+		[10.2, 0.08, 0.73],
+		[11.75, 0.7, 0.45],
+		[12.8, 0.07, 0.87],
+		[13.14, 0.1, 0.24],
+		[15.02, 0.28, 0.5],
+		[15.58, 0.09, 0.86],
+		[15.82, 0.13, 0.31],
+		[17.5, 0.84, 0.22],
+		[18.63, 0.08, 0.68],
+		[18.85, 0.18, 0.39],
+		[20.25, 0.56, 0.53],
+		[21.13, 0.1, 0.86],
+		[21.36, 0.12, 0.35],
+		[22.17, 0.29, 0.18],
+	]
+	const rand = (n: number) => {
+		const v = Math.sin(n * 127.1 + 311.7) * 43758.5453
+		return v - Math.floor(v)
+	}
+	const sparks = Array.from({ length: 34 }, (_, i) => ({
+		seed: i,
+		phase: rand(i),
+		life: 6,
+		size: 2 + rand(i + 9) * 5,
+	}))
+	const dust = Array.from({ length: 56 }, (_, i) => ({
+		seed: i + 80,
+		phase: rand(i + 31),
+		life: 6 + rand(i + 42) * 5,
+		size: 4 + rand(i + 64) * 7,
+	}))
+	const armor: Point[][] = [
+		[
+			[655, 22],
+			[809, 72],
+			[885, 81],
+			[858, 132],
+			[773, 119],
+			[690, 132],
+			[651, 112],
+		],
+		[
+			[693, 214],
+			[768, 223],
+			[805, 385],
+			[727, 398],
+			[712, 301],
+		],
+		[
+			[627, 157],
+			[670, 171],
+			[649, 237],
+			[596, 221],
+		],
+		[
+			[877, 183],
+			[918, 210],
+			[899, 244],
+			[865, 224],
+		],
+	]
+	function path(points: Point[]) {
+		ctx.beginPath()
+		points.forEach((p, i) => (i ? ctx.lineTo(p[0], p[1]) : ctx.moveTo(p[0], p[1])))
+		ctx.closePath()
+	}
+	function glow(x: number, y: number, r: number, color: string, alpha: number) {
+		const gradient = ctx.createRadialGradient(x, y, 0, x, y, r)
+		gradient.addColorStop(0, `rgba(${color},${alpha})`)
+		gradient.addColorStop(0.35, `rgba(${color},${alpha * 0.36})`)
+		gradient.addColorStop(1, `rgba(${color},0)`)
+		ctx.fillStyle = gradient
+		ctx.fillRect(x - r, y - r, r * 2, r * 2)
+	}
+	function prepare() {
+		// Restore the sharp master for all unaffected materials, anatomy and terrain.
+		const b = base.getContext('2d')!
+		b.setTransform(artworkScale, 0, 0, artworkScale, 0, 0)
+		b.imageSmoothingEnabled = false
+		b.drawImage(original, 0, 0, W, H)
+		const sky = makeLayer(artworkWidth, artworkHeight),
+			skyCtx = sky.getContext('2d')!
+		skyCtx.setTransform(artworkScale, 0, 0, artworkScale, 0, 0)
+		skyCtx.drawImage(clean, 0, 0, W, H)
+		skyCtx.globalCompositeOperation = 'destination-in'
+		const skyFade = skyCtx.createLinearGradient(0, 409, 0, 448)
+		skyFade.addColorStop(0, '#fff')
+		skyFade.addColorStop(1, 'transparent')
+		skyCtx.fillStyle = skyFade
+		skyCtx.fillRect(0, 0, W, 442)
+		b.drawImage(sky, 0, 0, W, H)
+		const restore = (source: HTMLImageElement, polygon: Point[]) => {
+			b.save()
+			b.beginPath()
+			polygon.forEach((p, i) => (i ? b.lineTo(...p) : b.moveTo(...p)))
+			b.closePath()
+			b.clip()
+			if (source === correctedPose)
+				b.drawImage(source, (583 * W) / 2172, (212 * W) / 2172, (510 * W) / 2172, (477 * W) / 2172)
+			else b.drawImage(source, 0, 0, W, H)
+			b.restore()
+		}
+		// Crisp original character; only previously corrected hands/boots use their local plate.
+		restore(original, [
+			[687, 8],
+			[906, 81],
+			[884, 173],
+			[919, 183],
+			[923, 209],
+			[876, 242],
+			[854, 273],
+			[862, 314],
+			[918, 308],
+			[938, 385],
+			[950, 424],
+			[930, 480],
+			[817, 480],
+			[805, 399],
+			[747, 399],
+			[720, 491],
+			[627, 502],
+			[651, 423],
+			[625, 452],
+			[590, 437],
+			[574, 410],
+			[594, 386],
+			[572, 374],
+			[577, 341],
+			[574, 331],
+			[593, 270],
+			[605, 237],
+			[588, 237],
+			[607, 159],
+			[650, 139],
+		])
+		// Remove the baked angled moon locally with matching moon-free sky.
+		// The new vanilla moon is a separate, camera-facing layer.
+		const moonSky = makeLayer(280, 270),
+			ms = moonSky.getContext('2d')!
+		ms.drawImage(
+			clean,
+			0,
+			0,
+			(280 * clean.naturalWidth) / W,
+			(270 * clean.naturalHeight) / H,
+			0,
+			0,
+			280,
+			270,
+		)
+		ms.globalCompositeOperation = 'destination-in'
+		ms.save()
+		ms.translate(140, 130)
+		ms.scale(1, 1.13)
+		const moonMask = ms.createRadialGradient(0, 0, 80, 0, 0, 123)
+		moonMask.addColorStop(0, '#fff')
+		moonMask.addColorStop(1, 'transparent')
+		ms.fillStyle = moonMask
+		ms.fillRect(-140, -135, 280, 270)
+		ms.restore()
+		b.drawImage(moonSky, 193, -20)
+		// Restore the sharp skull planes covered by the sky plate.
+		restore(original, [
+			[1159, 355],
+			[1318, 352],
+			[1358, 421],
+			[1315, 498],
+			[1246, 474],
+			[1107, 443],
+		])
+		// Remove the old painted blade without resampling the rest of the creature.
+		restore(clean, [
+			[975, 339],
+			[1002, 334],
+			[1078, 369],
+			[1148, 456],
+			[1185, 469],
+			[1200, 481],
+			[1178, 520],
+			[1144, 562],
+			[1080, 570],
+			[1025, 548],
+			[1053, 502],
+			[1006, 476],
+		])
+		// Retain the previously approved removal of baked lightning below the skulls.
+		restore(clean, [
+			[900, 595],
+			[948, 572],
+			[1000, 588],
+			[982, 615],
+			[914, 630],
+			[877, 625],
+		])
+		restore(clean, [
+			[1380, 420],
+			[1428, 430],
+			[1400, 492],
+			[1375, 535],
+			[1356, 606],
+			[1377, 626],
+			[1294, 639],
+			[1284, 579],
+			[1318, 525],
+			[1320, 470],
+		])
+		// Use regeneration only to erase the two unwanted shoulder slabs. The skulls,
+		// ribs, character and background retain their original sharp source pixels.
+		restore(rebuiltWither, [
+			[963, 423],
+			[1014, 417],
+			[1049, 431],
+			[1074, 479],
+			[1066, 495],
+			[1017, 511],
+			[985, 524],
+			[963, 466],
+		])
+		restore(rebuiltWither, [
+			[1360, 415],
+			[1392, 414],
+			[1429, 427],
+			[1448, 445],
+			[1405, 506],
+			[1398, 532],
+			[1355, 528],
+			[1319, 514],
+			[1324, 494],
+		])
+		// Replace only the removed beam silhouettes with the newly exposed background.
+		// No full-frame regeneration or feathering: unaffected source pixels stay intact.
+		restore(removedBeams, [
+			[976, 480],
+			[1146, 462],
+			[1152, 488],
+			[1124, 508],
+			[999, 530],
+			[990, 542],
+		])
+		restore(removedBeams, [
+			[1294, 489],
+			[1404, 498],
+			[1445, 548],
+			[1452, 629],
+			[1402, 621],
+			[1305, 615],
+			[1299, 549],
+			[1283, 521],
+		])
+		restore(correctedPose, [
+			[811, 377],
+			[951, 377],
+			[975, 415],
+			[987, 481],
+			[952, 496],
+			[813, 486],
+		])
+		restore(correctedPose, [
+			[591, 486],
+			[744, 495],
+			[757, 650],
+			[550, 650],
+			[565, 553],
+		])
+		restore(correctedPose, [
+			[880, 210],
+			[925, 218],
+			[951, 235],
+			[977, 245],
+			[979, 280],
+			[957, 302],
+			[932, 299],
+			[910, 280],
+			[877, 267],
+		])
+		try {
+			cloudField = makeVanillaCloudField()
+		} catch (error) {
+			console.warn('Unable to initialize about-page clouds', error)
+		}
+		// Occlude with skin pixels only: background in the palm must not erase the grip.
+		const fingers = grippingFingers.getContext('2d')!
+		fingers.drawImage(
+			clean,
+			(922 * clean.naturalWidth) / W,
+			(228 * clean.naturalHeight) / H,
+			(64 * clean.naturalWidth) / W,
+			(80 * clean.naturalHeight) / H,
+			0,
+			0,
+			64,
+			80,
+		)
+		const skin = fingers.getImageData(0, 0, 64, 80)
+		for (let pixel = 0; pixel < skin.data.length; pixel += 4) {
+			const [red, green, blue] = skin.data.subarray(pixel, pixel + 3)
+			if (red < 90 || green < 48 || red < green * 1.04 || green < blue * 1.08)
+				skin.data[pixel + 3] = 0
+		}
+		fingers.putImageData(skin, 0, 0)
+		// A small extruded item sprite retains sharp pixels during its vertical-axis turn.
+		const s = star.getContext('2d')!
+		starRows.forEach((row, y) =>
+			[...row].forEach((v, x) => {
+				if (v !== '.') {
+					s.fillStyle = starColors[v]
+					s.fillRect(x * 20, y * 20, 20, 20)
+				}
+			}),
+		)
+	}
+	function enchantedFace(
+		target: HTMLCanvasElement,
+		texture: CanvasImageSource,
+		t: number,
+		strength: number,
+	) {
+		const c = target.getContext('2d')!,
+			size = target.width
+		c.clearRect(0, 0, size, size)
+		c.imageSmoothingEnabled = false
+		c.globalCompositeOperation = 'source-over'
+		c.drawImage(texture, 0, 0, size, size)
+		c.globalCompositeOperation = 'source-atop'
+		c.fillStyle = `rgba(123,63,207,${strength * 0.14})`
+		c.fillRect(0, 0, size, size)
+		// Translation of glint only: the texture coordinates and geometry never change.
+		const shift = ((t / 6) % 1) * size * 1.25
+		for (let band = -2; band < 3; band++) {
+			const x = shift + band * size * 1.25
+			const g = c.createLinearGradient(x - size * 0.7, 0, x + size * 0.3, size)
+			g.addColorStop(0, 'rgba(135,72,236,0)')
+			g.addColorStop(0.34, 'rgba(135,72,236,0)')
+			g.addColorStop(0.46, `rgba(163,99,247,${strength * 0.6})`)
+			g.addColorStop(0.5, `rgba(224,178,255,${strength})`)
+			g.addColorStop(0.55, `rgba(151,81,244,${strength * 0.5})`)
+			g.addColorStop(0.66, 'rgba(135,72,236,0)')
+			g.addColorStop(1, 'rgba(135,72,236,0)')
+			c.fillStyle = g
+			c.fillRect(0, 0, size, size)
+		}
+		c.globalCompositeOperation = 'source-over'
+		return target
+	}
+	function drawSword(t: number) {
+		const face = enchantedFace(swordFace, swordTexture, t, 0.34)
+		ctx.save()
+		// Hide only the buried sword pixels; never paint a base-image patch over the shield.
+		ctx.beginPath()
+		ctx.rect(0, 0, W, H)
+		buriedBlade.forEach((p, i) => (i ? ctx.lineTo(p[0], p[1]) : ctx.moveTo(p[0], p[1])))
+		ctx.closePath()
+		ctx.clip('evenodd')
+		// Original 128x128 asset is rigidly rotated/scaled, with no mesh warp or repainting.
+		// Place the grip's actual texture center inside the corrected curled palm.
+		ctx.translate(938, 268)
+		ctx.rotate((95.5 * Math.PI) / 180)
+		ctx.scale(2.12, 2.12)
+		ctx.imageSmoothingEnabled = false
+		ctx.save()
+		ctx.translate(1.25, 1.25)
+		ctx.filter = 'brightness(.55)'
+		ctx.drawImage(swordTexture, -24, -104, 128, 128)
+		ctx.restore()
+		ctx.drawImage(face, -24, -104, 128, 128)
+		ctx.restore()
+		// The fingers occlude the handle so it remains held, rather than pasted over the hand.
+		ctx.drawImage(grippingFingers, 922, 228)
+	}
+	function drawStar(t: number, angle: number, x: number, y: number) {
+		const front = enchantedFace(starFace, star, t, 0.23)
+		const cosine = Math.cos(angle),
+			sine = Math.sin(angle),
+			halfDepth = 5
+		ctx.save()
+		ctx.translate(x, y)
+		ctx.imageSmoothingEnabled = false
+		// One native item-texel layer of thickness; keep the front's pixel silhouette intact.
+		const edge = sine > 0 ? -1 : 1
+		for (let row = 0; row < 9; row++)
+			for (let col = 0; col < 9; col++) {
+				const color = starRows[row][col]
+				if (color === '.') continue
+				const neighbor = starRows[row][col + edge]
+				if (neighbor && neighbor !== '.') continue
+				const px = ((col + (edge > 0 ? 1 : 0)) / 9 - 0.5) * 160,
+					py = (row / 9 - 0.5) * 160
+				const a = px * cosine - halfDepth * sine,
+					b = px * cosine + halfDepth * sine
+				ctx.fillStyle = color === 'p' ? '#9070b0' : '#d9af67'
+				ctx.beginPath()
+				ctx.moveTo(a, py)
+				ctx.lineTo(b, py)
+				ctx.lineTo(b, py + 160 / 9)
+				ctx.lineTo(a, py + 160 / 9)
+				ctx.closePath()
+				ctx.fill()
+			}
+		ctx.translate(Math.sign(cosine) * halfDepth * sine, 0)
+		ctx.scale(cosine, 1)
+		ctx.filter = 'brightness(1.04)'
+		ctx.shadowColor = '#ffdc98'
+		ctx.shadowBlur = 9
+		ctx.drawImage(front, -80, -80, 160, 160)
+		ctx.restore()
+	}
+	function shieldLevel(t: number) {
+		let level = 0
+		for (const [start, duration, power] of shieldEvents) {
+			const p = (t - start) / duration
+			if (p >= 0 && p < 1) {
+				const envelope = Math.min(1, p * 14, (1 - p) * 10)
+				const sputter = 0.64 + 0.36 * rand(Math.floor(t * 19) + start * 91)
+				level = Math.max(level, power * envelope * sputter)
+			}
+		}
+		return level
+	}
+	function makeVanillaCloudField() {
+		// Minecraft 1.20.6's unmodified clouds.png supplies every occupied cell.
+		// One texel is a 12 x 12 block footprint with the vanilla 4-block thickness.
+		const textureCanvas = makeLayer(256, 256),
+			tc = textureCanvas.getContext('2d')!
+		tc.drawImage(cloudTexture, 0, 0)
+		const pixels = tc.getImageData(0, 0, 256, 256).data
+		const occupied = (x: number, z: number) =>
+			pixels[(((z + 256) % 256) * 256 + ((x + 256) % 256)) * 4 + 3] > 127
+		const layer = makeLayer()
+		const context = layer.getContext('webgl', {
+			alpha: true,
+			antialias: true,
+			premultipliedAlpha: true,
+		})
+		if (!context) return
+		const gl = context
+		const vertices: number[] = []
+		const quad = (a: Vertex, b: Vertex, c: Vertex, d: Vertex, shade: number) => {
+			for (const point of [a, b, c, a, c, d]) vertices.push(...point, shade)
+		}
+		for (let z = 8; z < 96; z++)
+			for (let x = 0; x < 256; x++) {
+				if (!occupied(x, z + 36)) continue
+				const l = (x - 128) * 12,
+					r = l + 12,
+					n = z * 12,
+					f = n + 12,
+					y = 84,
+					h = y + 4
+				quad([l, y, n], [r, y, n], [r, y, f], [l, y, f], 0.7)
+				if (!occupied(x - 1, z + 36)) quad([l, y, n], [l, y, f], [l, h, f], [l, h, n], 0.9)
+				if (!occupied(x + 1, z + 36)) quad([r, y, f], [r, y, n], [r, h, n], [r, h, f], 0.9)
+				if (!occupied(x, z + 35)) quad([r, y, n], [l, y, n], [l, h, n], [r, h, n], 0.8)
+				if (!occupied(x, z + 37)) quad([l, y, f], [r, y, f], [r, h, f], [l, h, f], 0.8)
+			}
+		const shader = (kind: number, source: string) => {
+			const result = gl.createShader(kind)
+			if (!result) throw new Error('Unable to allocate cloud shader')
+			gl.shaderSource(result, source)
+			gl.compileShader(result)
+			if (!gl.getShaderParameter(result, gl.COMPILE_STATUS))
+				throw new Error(gl.getShaderInfoLog(result) ?? 'Cloud shader compilation failed')
+			return result
+		}
+		const vertex = shader(
+			gl.VERTEX_SHADER,
+			`
+      attribute vec4 vertex; uniform float offset;
+      varying float shade; varying float distance;
+      void main(){
+        vec3 p=vertex.xyz+vec3(offset,0.0,0.0);
+        float focal=650.0; float horizon=350.0;
+        gl_Position=vec4(2.0*focal*p.x/2048.0,
+          (1.0-2.0*horizon/682.6667)*p.z+2.0*focal*p.y/682.6667,
+          1.020202*p.z-28.282828,p.z);
+        shade=vertex.w; distance=p.z;
+      }
+    `,
+		)
+		const fragment = shader(
+			gl.FRAGMENT_SHADER,
+			`
+      precision mediump float; varying float shade; varying float distance;
+      void main(){
+        float alpha=.70*(1.0-smoothstep(480.0,1150.0,distance));
+        gl_FragColor=vec4(vec3(.34,.40,.50)*shade*alpha,alpha);
+      }
+    `,
+		)
+		const program = gl.createProgram()
+		if (!program) throw new Error('Unable to allocate cloud program')
+		gl.attachShader(program, vertex)
+		gl.attachShader(program, fragment)
+		gl.linkProgram(program)
+		if (!gl.getProgramParameter(program, gl.LINK_STATUS))
+			throw new Error(gl.getProgramInfoLog(program) ?? 'Cloud program linking failed')
+		gl.useProgram(program)
+		const buffer = gl.createBuffer()
+		gl.bindBuffer(gl.ARRAY_BUFFER, buffer)
+		gl.bufferData(gl.ARRAY_BUFFER, new Float32Array(vertices), gl.STATIC_DRAW)
+		const attribute = gl.getAttribLocation(program, 'vertex')
+		gl.enableVertexAttribArray(attribute)
+		gl.vertexAttribPointer(attribute, 4, gl.FLOAT, false, 16, 0)
+		const offset = gl.getUniformLocation(program, 'offset')
+		gl.enable(gl.DEPTH_TEST)
+		gl.disable(gl.BLEND)
+		gl.clearColor(0, 0, 0, 0)
+		gl.viewport(0, 0, layer.width, layer.height)
+		return {
+			draw(elapsed: number) {
+				if (gl.isContextLost()) return
+				gl.clear(gl.COLOR_BUFFER_BIT | gl.DEPTH_BUFFER_BIT)
+				const travel = (elapsed * 2.4) % 3072
+				for (const tile of [-3072, 0, 3072]) {
+					gl.uniform1f(offset, tile + travel)
+					gl.drawArrays(gl.TRIANGLES, 0, vertices.length / 4)
+				}
+				return layer
+			},
+			resize(width: number, height: number) {
+				layer.width = width
+				layer.height = height
+				gl.viewport(0, 0, width, height)
+			},
+			dispose() {
+				gl.deleteBuffer(buffer)
+				gl.deleteProgram(program)
+				gl.deleteShader(vertex)
+				gl.deleteShader(fragment)
+				gl.getExtension('WEBGL_lose_context')?.loseContext()
+			},
+		}
+	}
+	function drawShield(t: number) {
+		const level = shieldLevel(t)
+		canvas.dataset.shieldIntensity = level.toFixed(3)
+		if (level < 0.003) return
+		const surface = shield.getContext('2d')!
+		surface.setTransform(artworkScale, 0, 0, artworkScale, 0, 0)
+		surface.clearRect(0, 0, W, H + 1)
+		surface.save()
+		surface.globalCompositeOperation = 'source-over'
+		const trace = (points: Point[]) => {
+			surface.beginPath()
+			points.forEach((p, i) => (i ? surface.lineTo(...p) : surface.moveTo(...p)))
+			surface.closePath()
+		}
+		// Tight fractured-cavity contour: blue armor remains on the surrounding ribs.
+		surface.beginPath()
+		surface.rect(0, 0, W, H)
+		wound.forEach((p, i) => (i ? surface.lineTo(p[0], p[1]) : surface.moveTo(p[0], p[1])))
+		surface.closePath()
+		surface.clip('evenodd')
+		witherShieldSurfaces.forEach(({ plane: quad, outline = quad, shade = 1 }, index) => {
+			const map = (u: number, v: number): Point => [
+				(1 - v) * ((1 - u) * quad[0][0] + u * quad[1][0]) +
+					v * ((1 - u) * quad[3][0] + u * quad[2][0]),
+				(1 - v) * ((1 - u) * quad[0][1] + u * quad[1][1]) +
+					v * ((1 - u) * quad[3][1] + u * quad[2][1]),
+			]
+			const alpha = level * shade * (0.79 + 0.21 * rand(index + Math.floor(t * 7)))
+			trace(outline)
+			surface.fillStyle = `rgba(55,126,203,${alpha * 0.38})`
+			surface.fill()
+			surface.save()
+			trace(outline)
+			surface.clip()
+			for (let row = 0; row < 8; row++)
+				for (let col = 0; col < 8; col++) {
+					const grain = rand(row * 17 + col * 5 + index * 139)
+					if (grain < 0.56) continue
+					trace([
+						map(col / 8, row / 8),
+						map((col + 1) / 8, row / 8),
+						map((col + 1) / 8, (row + 1) / 8),
+						map(col / 8, (row + 1) / 8),
+					])
+					surface.fillStyle = `rgba(104,167,223,${alpha * (grain - 0.4) * 0.42})`
+					surface.fill()
+				}
+			// Stepped translucent bands wrap each actual surface, like the supplied armor image.
+			for (let band = -1; band < 3; band++)
+				for (let col = 0; col < 8; col++) {
+					const v = band * 0.48 + (t / 24) * 0.48 + Math.floor(rand(col + index * 11) * 3) / 32
+					const height = 0.034 + rand(col * 3 + band + index) * 0.022
+					trace([
+						map(col / 8, v),
+						map((col + 1) / 8, v),
+						map((col + 1) / 8, v + height),
+						map(col / 8, v + height),
+					])
+					surface.fillStyle = `rgba(210,229,172,${alpha * 0.75})`
+					surface.fill()
+				}
+			surface.restore()
+		})
+		surface.restore()
+		// Composite the fitted faces once, without bright overlaps at shared bone edges.
+		ctx.save()
+		ctx.globalCompositeOperation = 'screen'
+		ctx.drawImage(shield, 0, 0, W, H)
+		ctx.restore()
+	}
+	function drawClouds(elapsed: number) {
+		ctx.save()
+		// Clouds pass behind the character silhouette, never across the face or armor.
+		ctx.beginPath()
+		ctx.rect(0, 0, W, H)
+		;[
+			[687, 7],
+			[907, 80],
+			[884, 175],
+			[918, 182],
+			[921, 208],
+			[980, 246],
+			[980, 299],
+			[945, 306],
+			[899, 280],
+			[864, 260],
+			[861, 325],
+			[573, 325],
+			[594, 241],
+			[588, 238],
+			[607, 159],
+			[650, 139],
+		].forEach((p, i) => (i ? ctx.lineTo(p[0], p[1]) : ctx.moveTo(p[0], p[1])))
+		ctx.closePath()
+		ctx.clip('evenodd')
+		const clouds = cloudField?.draw(elapsed)
+		if (clouds) ctx.drawImage(clouds, 0, 0, W, H)
+		ctx.restore()
+		canvas.dataset.cloudOffset = (elapsed * 2.4).toFixed(2)
+	}
+	function drawMoon() {
+		ctx.save()
+		ctx.globalCompositeOperation = 'screen'
+		ctx.imageSmoothingEnabled = false
+		ctx.filter = 'brightness(2.15)'
+		// Vanilla waning-crescent tile, rendered square-on with no skew or side extrusion.
+		// Retain its original pixel shading and native halo; black texels add no light.
+		ctx.drawImage(moonTexture, 96, 0, 32, 32, 45, -179, 576, 576)
+		ctx.restore()
+	}
+	function draw(elapsed: number) {
+		const t = elapsed % 24
+		const ratio = canvas.width / W
+		ctx.setTransform(ratio, 0, 0, ratio, 0, 0)
+		ctx.clearRect(0, 0, W, H)
+		const cycle = (t * TAU) / 24
+		ctx.save()
+		// Keep the static plate pixel-stable; animate only the independent effects.
+		// The full-resolution master is sampled once, without a floating camera zoom.
+		ctx.imageSmoothingEnabled = true
+		ctx.imageSmoothingQuality = 'high'
+		ctx.drawImage(base, 0, 0, W, H)
+		drawMoon()
+		drawClouds(elapsed)
+		drawShield(t)
+		drawSword(t)
+		const bob = 5.2 * Math.sin(cycle * 3) + 1.3 * Math.sin(cycle * 6 + 0.4)
+		const sx = 1150,
+			sy = 247 + bob
+		const pulse = 0.8 + 0.12 * Math.sin(cycle * 3 + 0.5) + 0.06 * Math.sin(cycle * 7)
+		ctx.save()
+		ctx.globalCompositeOperation = 'screen'
+		glow(sx, sy, 195, '255,195,102', 0.42 * pulse)
+		glow(sx, sy, 88, '255,232,177', 0.15 * pulse)
+		glow(1134, 495, 165, '255,194,101', 0.13 * pulse)
+		glow(790, 191, 90, '255,201,129', 0.055 * pulse)
+		// Narrow rays breathe with the star, instead of rotating the whole scene.
+		ctx.translate(sx, sy)
+		for (let i = 0; i < 8; i++) {
+			ctx.save()
+			ctx.rotate((i * TAU) / 8 + 0.08 * Math.sin(cycle))
+			const g = ctx.createLinearGradient(0, 35, 0, 155)
+			g.addColorStop(0, `rgba(255,228,165,${0.13 * pulse})`)
+			g.addColorStop(1, 'transparent')
+			ctx.fillStyle = g
+			ctx.beginPath()
+			ctx.moveTo(-2, 30)
+			ctx.lineTo(-6, 155)
+			ctx.lineTo(6, 155)
+			ctx.lineTo(2, 30)
+			ctx.fill()
+			ctx.restore()
+		}
+		ctx.restore()
+		ctx.save()
+		ctx.globalCompositeOperation = 'screen'
+		for (const polygon of armor) {
+			ctx.save()
+			path(polygon)
+			ctx.clip()
+			const x = ((t / 8) % 1) * 1350 - 240
+			const glint = ctx.createLinearGradient(x - 100, 0, x + 150, 450)
+			glint.addColorStop(0, 'transparent')
+			glint.addColorStop(0.4, 'rgba(160,88,255,0)')
+			glint.addColorStop(0.5, 'rgba(206,149,255,.28)')
+			glint.addColorStop(0.58, 'rgba(136,81,250,.09)')
+			glint.addColorStop(1, 'transparent')
+			ctx.fillStyle = glint
+			ctx.fillRect(550, 0, 650, 520)
+			ctx.restore()
+		}
+		ctx.restore()
+		// Staggered particles have invisible births/deaths, so the loop has no pop.
+		dust.forEach((d) => {
+			const q = (elapsed / d.life + d.phase) % 1,
+				alpha = Math.pow(Math.sin(Math.PI * q), 0.65) * 0.9
+			const x =
+				1145 +
+				(rand(d.seed) - 0.5) * 170 +
+				Math.sin(q * 4 + d.seed) * 24 +
+				q * (45 + rand(d.seed + 2) * 85)
+			const y = 490 - q * (180 + rand(d.seed + 9) * 130)
+			const size = d.size * (1 - q * 0.4)
+			ctx.fillStyle = `rgba(7,10,16,${alpha})`
+			ctx.fillRect(x, y, size, size)
+			if (d.seed % 3 === 0) {
+				ctx.fillRect(x - size * 0.65, y + size * 0.4, size * 0.7, size * 0.65)
+				ctx.fillRect(x + size * 0.65, y - size * 0.5, size * 0.55, size * 0.6)
+			}
+		})
+		ctx.save()
+		ctx.globalCompositeOperation = 'screen'
+		sparks.forEach((d) => {
+			const q = (t / d.life + d.phase) % 1,
+				alpha = Math.pow(Math.sin(Math.PI * q), 1.7) * 0.55
+			const x = 1140 + (rand(d.seed + 7) - 0.5) * 150 + Math.sin(q * 4 + d.seed) * 14
+			const y = 440 - q * (130 + rand(d.seed + 19) * 120)
+			ctx.fillStyle = `rgba(255,207,122,${alpha})`
+			ctx.fillRect(x, y, d.size * 0.45, d.size * 0.45)
+		})
+		ctx.restore()
+		const angle = cycle * 2 + 0.12 * Math.sin(cycle * 2)
+		drawStar(t, angle, sx, sy)
+		ctx.restore()
+		canvas.dataset.animationTime = elapsed.toFixed(3)
+	}
+
+	function canAnimate() {
+		return ready && !destroyed && !paused && visible && !document.hidden && !reducedMotion.matches
+	}
+	function tick(now: number) {
+		frame = 0
+		if (!canAnimate()) return
+		if (last) time += Math.min((now - last) / 1000, 0.1)
+		last = now
+		draw(time)
+		frame = requestAnimationFrame(tick)
+	}
+	function updatePlayback() {
+		if (frame) cancelAnimationFrame(frame)
+		frame = 0
+		last = 0
+		if (canAnimate()) frame = requestAnimationFrame(tick)
+	}
+	function resize() {
+		if (destroyed) return
+		const width = canvas.getBoundingClientRect().width
+		if (width <= 0) return
+		canvas.width = Math.min(
+			artworkWidth,
+			Math.max(1, Math.round(width * Math.min(2, devicePixelRatio || 1))),
+		)
+		canvas.height = Math.round(canvas.width / 3)
+		cloudField?.resize(canvas.width, canvas.height)
+		if (ready) draw(time)
+	}
+	const observer = new ResizeObserver(resize)
+	observer.observe(canvas)
+	const intersection = new IntersectionObserver((entries) => {
+		visible = entries[0].isIntersecting
+		updatePlayback()
+	})
+	intersection.observe(canvas)
+	document.addEventListener('visibilitychange', updatePlayback)
+	reducedMotion.addEventListener('change', updatePlayback)
+	const loaded = (img: HTMLImageElement, url: string) =>
+		new Promise<void>((resolve, reject) => {
+			img.onload = () => resolve()
+			img.onerror = () => reject(new Error('Unable to load about-page artwork'))
+			img.src = url
+		})
+	const imageAssets = [
+		original,
+		clean,
+		swordTexture,
+		correctedPose,
+		cloudTexture,
+		moonTexture,
+		rebuiltWither,
+		removedBeams,
+	]
+	const loading = Promise.all([
+		loaded(original, originalUrl),
+		loaded(clean, cleanUrl),
+		loaded(swordTexture, swordTextureUrl),
+		loaded(correctedPose, correctedPoseUrl),
+		loaded(cloudTexture, cloudTextureUrl),
+		loaded(moonTexture, moonTextureUrl),
+		loaded(rebuiltWither, rebuiltWitherUrl),
+		loaded(removedBeams, removedBeamsUrl),
+	])
+		.then(() => {
+			if (destroyed) return
+			prepare()
+			ready = true
+			resize()
+			updatePlayback()
+		})
+		.finally(() => {
+			for (const img of imageAssets) {
+				img.onload = null
+				img.onerror = null
+			}
+		})
+	return {
+		ready: loading,
+		setPaused(value: boolean) {
+			paused = value
+			updatePlayback()
+		},
+		dispose() {
+			if (destroyed) return
+			destroyed = true
+			updatePlayback()
+			observer.disconnect()
+			intersection.disconnect()
+			document.removeEventListener('visibilitychange', updatePlayback)
+			reducedMotion.removeEventListener('change', updatePlayback)
+			cloudField?.dispose()
+			cloudField = undefined
+			for (const layer of [base, shield, star, starFace, swordFace, grippingFingers]) {
+				layer.width = 1
+				layer.height = 1
+			}
+		},
+	}
+}

apps/app-frontend/src/components/ui/easteregg/color-mine/ColorMineAvatar.vue

@@ -1,93 +0,0 @@
-<script setup lang="ts">
-import { Avatar } from '@modrinth/ui'
-import { onScopeDispose, ref } from 'vue'
-
-defineProps<{ src: string; name: string; href?: string }>()
-const emit = defineEmits<{ activate: [] }>()
-const holding = ref(false)
-let timer: ReturnType<typeof setTimeout> | undefined
-let origin = { x: 0, y: 0 }
-let suppressClick = false
-
-function cancel() {
-	clearTimeout(timer)
-	timer = undefined
-	holding.value = false
-}
-function begin() {
-	cancel()
-	suppressClick = false
-	holding.value = true
-	timer = setTimeout(() => {
-		cancel()
-		suppressClick = true
-		emit('activate')
-	}, 800)
-}
-function pointerDown(event: PointerEvent) {
-	if (event.button !== 0 || !event.isPrimary) return
-	origin = { x: event.clientX, y: event.clientY }
-	begin()
-}
-function pointerMove(event: PointerEvent) {
-	if (Math.hypot(event.clientX - origin.x, event.clientY - origin.y) > 8) cancel()
-}
-function click(event: MouseEvent) {
-	if (!suppressClick) return
-	event.preventDefault()
-	event.stopPropagation()
-	suppressClick = false
-}
-function keydown(event: KeyboardEvent) {
-	if (event.code === 'Space') {
-		event.preventDefault()
-		if (!event.repeat) begin()
-	}
-}
-window.addEventListener('blur', cancel)
-onScopeDispose(() => {
-	cancel()
-	window.removeEventListener('blur', cancel)
-})
-</script>
-
-<template>
-	<a
-		:href="href"
-		target="_blank"
-		rel="noopener noreferrer"
-		class="mine-avatar"
-		:class="{ holding }"
-		@pointerdown="pointerDown"
-		@pointermove="pointerMove"
-		@pointerup="cancel"
-		@pointercancel="cancel"
-		@pointerleave="cancel"
-		@blur="cancel"
-		@click="click"
-		@contextmenu.prevent
-		@dragstart.prevent
-		@keydown="keydown"
-		@keyup.space.prevent="cancel"
-	>
-		<Avatar :src="src" :alt="name" size="2.5rem" circle no-shadow loading="lazy" />
-	</a>
-</template>
-
-<style scoped>
-.mine-avatar {
-	display: inline-flex;
-	flex-shrink: 0;
-	border-radius: 50%;
-	user-select: none;
-	touch-action: manipulation;
-}
-.mine-avatar.holding {
-	outline: 2px solid var(--color-brand);
-	outline-offset: 3px;
-}
-.mine-avatar:focus-visible {
-	outline: 2px solid var(--color-contrast);
-	outline-offset: 3px;
-}
-</style>

apps/app-frontend/src/components/ui/easteregg/color-mine/ColorMineBoard.vue

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { NewButton as Button, useVIntl } from '@modrinth/ui'
-import { computed, nextTick, onMounted, onScopeDispose, ref } from 'vue'
+import { computed, nextTick, onMounted, onScopeDispose, ref, watch } from 'vue'
 
 import type { Puzzle } from './engine'
 import { messages } from './messages'
@@ -20,7 +20,10 @@ const emit = defineEmits<{
 }>()
 const { formatMessage } = useVIntl()
 const viewport = ref<HTMLElement>()
+const grid = ref<HTMLElement>()
 const view = ref({ left: 0, top: 0, width: 0, height: 0 })
+const brushCursor = ref<string>()
+const brushActive = computed(() => props.playing && props.selected >= 0)
 const large = computed(() => props.puzzle.difficulty !== 'easy')
 const visibleCells = computed(() =>
 	props.puzzle.answer.flatMap((color, i) =>
@@ -85,6 +88,22 @@ function onWheel(event: WheelEvent) {
 	void changeZoom(props.zoom + (event.deltaY < 0 ? 0.1 : -0.1))
 }
 
+let cursorColor = ''
+function updateBrushCursor() {
+	if (!brushActive.value || !grid.value) return
+	const color = getComputedStyle(grid.value).color
+	if (color === cursorColor) return
+	cursorColor = color
+	// Let the native cursor follow the pointer independently of Vue and board rendering.
+	// The hotspot is the same brush tip as the previous 32px floating SVG.
+	const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 1024 1024"><path fill="${color}" d="M358.681 586.386s-90.968 49.4-94.488 126.827c-3.519 77.428-77.427 133.74-102.063 140.778s360.157 22.971 332.002-142.444l-135.45-125.16zm169.099 52.56c14.016 13.601 17.565 32.675 7.929 42.606-9.635 9.93-28.81 6.954-42.823-6.647l-92.767-88.518c-14.015-13.6-17.565-32.675-7.929-42.605 9.636-9.93 28.81-6.955 42.824 6.646l92.766 88.518zm321.734-465.083c-25.144-17.055-47.741-1.763-57.477 3.805-29.097 19.485-237.243 221.77-327.69 315.194-11.105 14.8-18.59 26.294 34.663 79.546 44.95 44.95 65.896 42.012 88.66 22.603 37.906-37.906 199.299-262.926 258.92-348.713 9.792-14.092 29.851-54.17 2.924-72.435z"/></svg>`
+	brushCursor.value = `url("data:image/svg+xml,${encodeURIComponent(svg)}") 5 27, crosshair`
+}
+
+watch(() => [props.playing, props.selected], updateBrushCursor, {
+	flush: 'post',
+})
+
 function label(index: number) {
 	const values = {
 		row: Math.floor(index / props.puzzle.size) + 1,
@@ -101,6 +120,7 @@ function label(index: number) {
 
 let observer: ResizeObserver | undefined
 onMounted(() => {
+	updateBrushCursor()
 	observer = new ResizeObserver(updateView)
 	if (viewport.value) observer.observe(viewport.value)
 })
@@ -108,7 +128,10 @@ onScopeDispose(() => observer?.disconnect())
 defineExpose({
 	centerFirstClue,
 	setView,
-	getView: () => ({ left: viewport.value?.scrollLeft ?? 0, top: viewport.value?.scrollTop ?? 0 }),
+	getView: () => ({
+		left: viewport.value?.scrollLeft ?? 0,
+		top: viewport.value?.scrollTop ?? 0,
+	}),
 })
 </script>
 
@@ -116,10 +139,20 @@ defineExpose({
 	<div class="mine-navigation" :class="{ 'mine-large': large }">
 		<div ref="viewport" class="mine-viewport" @scroll.passive="updateView" @wheel="onWheel">
 			<div
+				ref="grid"
 				class="mine-grid"
-				:class="{ 'mine-grid-small': !large }"
-				:style="{ '--mine-size': puzzle.size, '--mine-cell-size': `${40 * zoom}px` }"
+				:class="{
+					'mine-grid-small': !large,
+					'mine-grid-brush-active': brushActive,
+				}"
+				:style="{
+					'--mine-size': puzzle.size,
+					'--mine-cell-size': `${40 * zoom}px`,
+					'--mine-brush-cursor': brushCursor,
+					color: selected >= 0 ? `var(--mine-color-${selected})` : undefined,
+				}"
 				:aria-label="formatMessage(messages.board, { size: puzzle.size })"
+				@pointerenter="updateBrushCursor"
 			>
 				<button
 					v-for="(_, i) in puzzle.answer"
@@ -200,7 +233,10 @@ defineExpose({
 
 <style scoped>
 .mine-navigation {
+	box-sizing: border-box;
+	width: 100%;
 	min-width: 0;
+	max-width: 100%;
 	display: grid;
 	gap: var(--gap-md);
 }
@@ -208,6 +244,9 @@ defineExpose({
 	grid-template-columns: minmax(0, 1fr) 7rem;
 }
 .mine-viewport {
+	box-sizing: border-box;
+	width: 100%;
+	max-width: 100%;
 	overflow: auto;
 	max-height: min(52vh, 32rem);
 	min-width: 0;
@@ -244,10 +283,14 @@ defineExpose({
 	color: var(--color-contrast);
 	font: inherit;
 	font-weight: 700;
-	cursor: crosshair;
+	cursor: pointer;
 	user-select: none;
 	touch-action: manipulation;
 }
+.mine-grid-brush-active,
+.mine-grid-brush-active .mine-cell:not(.mine-open):not(:disabled) {
+	cursor: var(--mine-brush-cursor, crosshair);
+}
 .mine-cell:hover:not(:disabled) {
 	background: var(--surface-5);
 	border-color: var(--mine-ink);

apps/app-frontend/src/components/ui/easteregg/color-mine/ColorMineModal.vue

@@ -301,6 +301,7 @@ defineExpose({ show })
 		:header="formatMessage(messages.title)"
 		width="56rem"
 		max-width="56rem"
+		scrollable
 		:closable="false"
 		:close-on-esc="false"
 		actions-divider
@@ -455,15 +456,21 @@ defineExpose({ show })
 	justify-content: space-between;
 }
 .mine-frame {
+	box-sizing: border-box;
+	min-width: 0;
+	max-width: 100%;
 	border: 2px solid var(--mine-ink);
 	border-radius: var(--radius-md);
 	padding: var(--gap-md);
 	background: var(--surface-2);
 }
 .mine-status {
+	min-width: 0;
+	max-width: 100%;
 	margin: 0 0 var(--gap-md);
 	color: var(--color-contrast);
 	font-size: 0.875rem;
+	overflow-wrap: anywhere;
 }
 .mine-actions {
 	justify-content: flex-end;

apps/app-frontend/src/components/ui/instance_settings/GeneralSettings.vue

@@ -16,6 +16,8 @@ import { basename, dirname, join } from '@tauri-apps/api/path'
 import { computed, type Ref, ref, watch } from 'vue'
 import { useRouter } from 'vue-router'
 
+import InstanceModeSettings from '@/components/instance/InstanceModeSettings.vue'
+import InstancePlayerSettings from '@/components/instance/InstancePlayerSettings.vue'
 import InstanceIcon from '@/components/ui/InstanceIcon.vue'
 import ConfirmDeleteInstanceModal from '@/components/ui/modal/ConfirmDeleteInstanceModal.vue'
 import { install_duplicate_instance } from '@/helpers/install'
@@ -229,7 +231,7 @@ async function setGameDirMode(mode: GameDirMode) {
 }
 
 const editInstanceObject = computed(() => ({
-	name: title.value.trim().substring(0, 32) ?? 'Instance',
+	name: title.value.trim(),
 }))
 
 watch(
@@ -379,6 +381,8 @@ const messages = defineMessages({
 </script>
 
 <template>
+	<InstanceModeSettings class="mb-6" :instance-id="instance.id" />
+	<InstancePlayerSettings :instance-id="instance.id" />
 	<ConfirmDeleteInstanceModal
 		ref="deleteConfirmModal"
 		:symlink-target="instance.symlink_target"
@@ -437,7 +441,6 @@ const messages = defineMessages({
 				id="instance-name"
 				v-model="title"
 				autocomplete="off"
-				:maxlength="80"
 				wrapper-class="flex-grow"
 			/>
 		</div>

apps/app-frontend/src/components/ui/modal/ConfirmDeleteInstanceModal.vue

@@ -67,6 +67,7 @@ withDefaults(
 	}>(),
 	{
 		count: 1,
+		symlinkTarget: null,
 	},
 )
 

apps/app-frontend/src/components/ui/modal/InstanceIconPickerModal.vue

@@ -127,7 +127,7 @@ interface IconBackground {
 	style: Record<string, string>
 }
 
-function background(
+function makeBackground(
 	id: string,
 	name: MessageDescriptor,
 	top: string,
@@ -171,16 +171,16 @@ const backgrounds = [
 			backgroundSize: '16px 16px',
 		},
 	} satisfies IconBackground,
-	background('grass', backgroundNames.grass, '#7fc95b', '#2f7d32'),
-	background('ocean', backgroundNames.ocean, '#55b7ff', '#3157c8'),
-	background('amethyst', backgroundNames.amethyst, '#c084fc', '#6d28d9'),
-	background('sunset', backgroundNames.sunset, '#ffba52', '#e94b64'),
-	background('cherry', backgroundNames.cherry, '#ff9ec4', '#b93670'),
-	background('nether', backgroundNames.nether, '#ef5a46', '#6d1717'),
-	background('slime', backgroundNames.slime, '#b6ee55', '#44972f'),
-	background('deep-dark', backgroundNames.deepDark, '#245369', '#0c1f2b'),
-	background('stone', backgroundNames.stone, '#aeb5bd', '#525b66'),
-	background('midnight', backgroundNames.midnight, '#4d5f8f', '#171b2d'),
+	makeBackground('grass', backgroundNames.grass, '#7fc95b', '#2f7d32'),
+	makeBackground('ocean', backgroundNames.ocean, '#55b7ff', '#3157c8'),
+	makeBackground('amethyst', backgroundNames.amethyst, '#c084fc', '#6d28d9'),
+	makeBackground('sunset', backgroundNames.sunset, '#ffba52', '#e94b64'),
+	makeBackground('cherry', backgroundNames.cherry, '#ff9ec4', '#b93670'),
+	makeBackground('nether', backgroundNames.nether, '#ef5a46', '#6d1717'),
+	makeBackground('slime', backgroundNames.slime, '#b6ee55', '#44972f'),
+	makeBackground('deep-dark', backgroundNames.deepDark, '#245369', '#0c1f2b'),
+	makeBackground('stone', backgroundNames.stone, '#aeb5bd', '#525b66'),
+	makeBackground('midnight', backgroundNames.midnight, '#4d5f8f', '#171b2d'),
 ]
 
 const { formatMessage } = useVIntl()

apps/app-frontend/src/components/ui/onboarding/onboardingConfig.ts

@@ -41,24 +41,6 @@ export const onboardingMessages = defineMessages({
 		defaultMessage: 'Your last next launcher.',
 	},
 	start: { id: 'app.onboarding.action.start', defaultMessage: 'Take the tour' },
-	homeWidgetsTitle: {
-		id: 'app.onboarding.home-widgets.title',
-		defaultMessage: 'Your Home, your layout',
-	},
-	homeWidgetsDescription: {
-		id: 'app.onboarding.home-widgets.description',
-		defaultMessage:
-			'Information Home is built from widgets for recent activity, playtime, instances, worlds, and servers. The grid reflows as the window or account sidebar changes.',
-	},
-	homeCustomizeTitle: {
-		id: 'app.onboarding.home-customize.title',
-		defaultMessage: 'Arrange it your way',
-	},
-	homeCustomizeDescription: {
-		id: 'app.onboarding.home-customize.description',
-		defaultMessage:
-			'Use the bottom-right edit control to add, resize, and configure widgets. While editing, switch between an automatically packed grid and a free grid that preserves empty cells.',
-	},
 	discoverTitle: { id: 'app.onboarding.discover.title', defaultMessage: 'Find something new' },
 	discoverDescription: {
 		id: 'app.onboarding.discover.description',
@@ -90,12 +72,12 @@ export const onboardingMessages = defineMessages({
 	},
 	homeLayoutTitle: {
 		id: 'app.onboarding.home-layout.title',
-		defaultMessage: 'Change the amount of detail',
+		defaultMessage: 'Switch your home',
 	},
 	homeLayoutDescription: {
 		id: 'app.onboarding.home-layout.description',
 		defaultMessage:
-			'Use the bottom-right control to switch between Information Home and Minimal Home. Widget editing stays with Information Home.',
+			'Use the bottom-right control to switch between the StarLight skin site home and the focused instance launcher.',
 	},
 	continueArea: {
 		id: 'app.onboarding.action.continue-area',
@@ -105,7 +87,7 @@ export const onboardingMessages = defineMessages({
 	skinsDescription: {
 		id: 'app.onboarding.skins.description',
 		defaultMessage:
-			'Keep your Minecraft skins together. Signing in can wait until you feel like it.',
+			'Choose a skin site player or Minecraft account, then preview and apply the skins available to that profile.',
 	},
 	clickSkins: {
 		id: 'app.onboarding.action.click-skins',
@@ -114,16 +96,8 @@ export const onboardingMessages = defineMessages({
 	skinsPageTitle: { id: 'app.onboarding.skins-page.title', defaultMessage: 'Your skin drawer' },
 	skinsPageDescription: {
 		id: 'app.onboarding.skins-page.description',
-		defaultMessage: 'Add, preview, sort, and apply skins here. No pressure to sign in just yet.',
-	},
-	accountTitle: {
-		id: 'app.onboarding.account.title',
-		defaultMessage: 'Accounts, on your schedule',
-	},
-	accountDescription: {
-		id: 'app.onboarding.account.description',
 		defaultMessage:
-			'When you are ready, sign in, switch accounts, or open your profile here. No deadline.',
+			'Select a profile, preview its available skins, and apply changes when that account supports skin management.',
 	},
 	downloadsTitle: { id: 'app.onboarding.downloads.title', defaultMessage: 'Download control room' },
 	downloadsDescription: {
@@ -160,35 +134,6 @@ export const onboardingMessages = defineMessages({
 		defaultMessage:
 			'Theme, accent, backgrounds, and window effects all live here. Make the launcher feel familiar.',
 	},
-	languageTitle: { id: 'app.onboarding.language.title', defaultMessage: 'Speak your language' },
-	languageDescription: {
-		id: 'app.onboarding.language.description',
-		defaultMessage: 'Pick the launcher language and manage translations. No decoder ring required.',
-	},
-	translationTitle: {
-		id: 'app.onboarding.translation.title',
-		defaultMessage: 'Translation, the Starlight way',
-	},
-	translationDescription: {
-		id: 'app.onboarding.translation.description',
-		defaultMessage:
-			'Translate Modrinth project titles, summaries, and descriptions while you browse. Keep the original, show both, or make the translation the main character.',
-	},
-	aiTitle: {
-		id: 'app.onboarding.ai.title',
-		defaultMessage: 'Bring your own AI provider',
-	},
-	aiDescription: {
-		id: 'app.onboarding.ai.description',
-		defaultMessage:
-			'Connect text-model providers once, choose the models you want available, or switch every AI feature off in one place.',
-	},
-	javaTitle: { id: 'app.onboarding.java.title', defaultMessage: 'Java, under the hood' },
-	javaDescription: {
-		id: 'app.onboarding.java.description',
-		defaultMessage:
-			'The Java runtimes that start Minecraft live here. Technical, but well-behaved.',
-	},
 	defaultsTitle: { id: 'app.onboarding.defaults.title', defaultMessage: 'Start ahead' },
 	defaultsDescription: {
 		id: 'app.onboarding.defaults.description',
@@ -204,11 +149,6 @@ export const onboardingMessages = defineMessages({
 		defaultMessage:
 			'Choose how content downloads and installs, from download sources to safety checks.',
 	},
-	updatesTitle: { id: 'app.onboarding.updates.title', defaultMessage: 'Stay in the loop' },
-	updatesDescription: {
-		id: 'app.onboarding.updates.description',
-		defaultMessage: 'Choose when Starlight checks for updates and whether it installs them for you.',
-	},
 	clickTab: { id: 'app.onboarding.action.click-tab', defaultMessage: 'Click this tab to continue' },
 	libraryTitle: { id: 'app.onboarding.library.title', defaultMessage: 'Your launch shelf' },
 	libraryDescription: {
@@ -227,7 +167,7 @@ export const onboardingMessages = defineMessages({
 	libraryPageDescription: {
 		id: 'app.onboarding.library-page.description',
 		defaultMessage:
-			'Filter by modpack, server, or custom setup, then open any instance to manage it.',
+			'Switch between all instances, modpacks, and custom setups, then open any instance to manage it.',
 	},
 	createTitle: { id: 'app.onboarding.create.title', defaultMessage: 'Make a fresh start' },
 	createDescription: {
@@ -239,6 +179,15 @@ export const onboardingMessages = defineMessages({
 		defaultMessage: 'Click Create new instance to continue',
 	},
 	creationTitle: { id: 'app.onboarding.creation.title', defaultMessage: 'Pick your route' },
+	instanceModeTitle: {
+		id: 'app.onboarding.instance-mode.title',
+		defaultMessage: 'Choose your instance type',
+	},
+	instanceModeDescription: {
+		id: 'app.onboarding.instance-mode.description',
+		defaultMessage:
+			'StarLight automatically installs the administrator-selected modpack and versions, then checks and completes updates before every launch. A StarLight login is required. Choose Local to select your own versions and modpacks for other servers or single-player.',
+	},
 	creationDescription: {
 		id: 'app.onboarding.creation.description',
 		defaultMessage:
@@ -293,7 +242,7 @@ export const onboardingMessages = defineMessages({
 	instanceActionsDescription: {
 		id: 'app.onboarding.instance-actions.description',
 		defaultMessage:
-			'Launch, stop, repair, configure, export, or open the instance from its header.',
+			'Launch or configure this instance here. You can launch another window while it is running; use the top bar to stop an individual window. Choose a player on first launch; the instance remembers your choice until you switch it in settings.',
 	},
 	instanceTabsTitle: {
 		id: 'app.onboarding.instance-tabs.title',
@@ -310,7 +259,7 @@ export const onboardingMessages = defineMessages({
 	labDescription: {
 		id: 'app.onboarding.lab.description',
 		defaultMessage:
-			'The Lab keeps local Minecraft tools inside the launcher, without another website or account.',
+			'The Lab keeps Minecraft creation, world, and maintenance tools inside the launcher.',
 	},
 	clickLab: {
 		id: 'app.onboarding.action.click-lab',
@@ -323,63 +272,7 @@ export const onboardingMessages = defineMessages({
 	labToolsDescription: {
 		id: 'app.onboarding.lab-tools.description',
 		defaultMessage:
-			'Create formatted text and recipe data packs, explore Java worlds, and inspect schematic builds without leaving the launcher.',
-	},
-	openGradientText: {
-		id: 'app.onboarding.action.open-gradient-text',
-		defaultMessage: 'Open Gradient text generator to continue',
-	},
-	labEditorTitle: {
-		id: 'app.onboarding.lab-editor.title',
-		defaultMessage: 'Build and copy in one place',
-	},
-	labEditorDescription: {
-		id: 'app.onboarding.lab-editor.description',
-		defaultMessage:
-			'Edit text, choose colors, preview the result, and copy the format your Minecraft setup expects.',
-	},
-	labSeedMapTitle: {
-		id: 'app.onboarding.lab-seed-map.title',
-		defaultMessage: 'Find a world before you load it',
-	},
-	labSeedMapDescription: {
-		id: 'app.onboarding.lab-seed-map.description',
-		defaultMessage:
-			'Enter a seed or load one from an instance, then inspect biomes, structures, and ore layers on the local map.',
-	},
-	returnToLab: {
-		id: 'app.onboarding.action.return-lab',
-		defaultMessage: 'Click Lab to continue',
-	},
-	openSeedMap: {
-		id: 'app.onboarding.action.open-seed-map',
-		defaultMessage: 'Open Seed map to continue',
-	},
-	openSchematicWorkshop: {
-		id: 'app.onboarding.action.open-schematic-workshop',
-		defaultMessage: 'Open Schematic workshop to continue',
-	},
-	openRecipeGenerator: {
-		id: 'app.onboarding.action.open-recipe-generator',
-		defaultMessage: 'Open Recipe generator to continue',
-	},
-	labRecipeGeneratorTitle: {
-		id: 'app.onboarding.lab-recipe-generator.title',
-		defaultMessage: 'Craft data pack recipes',
-	},
-	labRecipeGeneratorDescription: {
-		id: 'app.onboarding.lab-recipe-generator.description',
-		defaultMessage:
-			'Pick a Java version, fill the recipe slots, and copy or export the JSON locally.',
-	},
-	labSchematicTitle: {
-		id: 'app.onboarding.lab-schematic.title',
-		defaultMessage: 'Inspect a build before placing it',
-	},
-	labSchematicDescription: {
-		id: 'app.onboarding.lab-schematic.description',
-		defaultMessage:
-			'Open a local .litematic or .schem file, or choose one from an installed instance. The 3D workspace keeps viewing, measurement, layer controls, materials, and local edits together.',
+			'Create and edit skins, generate formatted text and recipes, explore seeds, inspect schematics, and translate mods locally.',
 	},
 	skip: { id: 'app.onboarding.action.skip', defaultMessage: 'Leave the tour' },
 	mascotAlt: { id: 'app.onboarding.mascot-alt', defaultMessage: 'Starlight guide' },
@@ -447,18 +340,6 @@ export const onboardingTours: Record<OnboardingMode, OnboardingStep[]> = {
 				onboardingMessages.start,
 			),
 		),
-		inspect(
-			'home-widget-grid',
-			'home-widget-grid',
-			onboardingMessages.homeWidgetsTitle,
-			onboardingMessages.homeWidgetsDescription,
-		),
-		inspect(
-			'home-widget-customize',
-			'home-widget-customize',
-			onboardingMessages.homeCustomizeTitle,
-			onboardingMessages.homeCustomizeDescription,
-		),
 		inspect(
 			'home-layout-switch',
 			'home-layout-switch',
@@ -513,16 +394,6 @@ export const onboardingTours: Record<OnboardingMode, OnboardingStep[]> = {
 			onboardingMessages.skinsPageTitle,
 			onboardingMessages.skinsPageDescription,
 		),
-		step(
-			'account',
-			'inspect',
-			copy(
-				onboardingMessages.accountTitle,
-				onboardingMessages.accountDescription,
-				onboardingMessages.continueArea,
-			),
-			control('account-entry'),
-		),
 		step(
 			'lab-navigation',
 			'navigate',
@@ -539,90 +410,6 @@ export const onboardingTours: Record<OnboardingMode, OnboardingStep[]> = {
 			onboardingMessages.labToolsTitle,
 			onboardingMessages.labToolsDescription,
 		),
-		step(
-			'lab-gradient-text-navigation',
-			'navigate',
-			copy(
-				onboardingMessages.labEditorTitle,
-				onboardingMessages.labEditorDescription,
-				onboardingMessages.openGradientText,
-			),
-			control('lab-gradient-text-card', '/lab/gradient-text'),
-		),
-		inspect(
-			'lab-gradient-text-editor',
-			'lab-gradient-text-editor',
-			onboardingMessages.labEditorTitle,
-			onboardingMessages.labEditorDescription,
-		),
-		step(
-			'lab-return-navigation',
-			'navigate',
-			copy(
-				onboardingMessages.labSeedMapTitle,
-				onboardingMessages.labSeedMapDescription,
-				onboardingMessages.returnToLab,
-			),
-			control('nav-lab', '/lab'),
-		),
-		step(
-			'lab-seed-map-navigation',
-			'navigate',
-			copy(
-				onboardingMessages.labSeedMapTitle,
-				onboardingMessages.labSeedMapDescription,
-				onboardingMessages.openSeedMap,
-			),
-			control('lab-seed-map-card', '/lab/seed-map'),
-		),
-		inspect(
-			'lab-seed-map-workspace',
-			'seed-map-workspace',
-			onboardingMessages.labSeedMapTitle,
-			onboardingMessages.labSeedMapDescription,
-		),
-		step(
-			'lab-return-schematic-navigation',
-			'navigate',
-			copy(
-				onboardingMessages.labSchematicTitle,
-				onboardingMessages.labSchematicDescription,
-				onboardingMessages.returnToLab,
-			),
-			control('nav-lab', '/lab'),
-		),
-		step(
-			'lab-schematic-navigation',
-			'navigate',
-			copy(
-				onboardingMessages.labSchematicTitle,
-				onboardingMessages.labSchematicDescription,
-				onboardingMessages.openSchematicWorkshop,
-			),
-			control('lab-schematic-preview-card', '/lab/schematic-preview'),
-		),
-		inspect(
-			'lab-schematic-workspace',
-			'schematic-preview-workspace',
-			onboardingMessages.labSchematicTitle,
-			onboardingMessages.labSchematicDescription,
-		),
-		step(
-			'lab-recipe-generator-navigation',
-			'navigate',
-			copy(
-				onboardingMessages.labRecipeGeneratorTitle,
-				onboardingMessages.labRecipeGeneratorDescription,
-				onboardingMessages.openRecipeGenerator,
-			),
-			control('lab-recipe-generator-card', '/lab/recipe-generator'),
-		),
-		inspect(
-			'lab-recipe-generator-workspace',
-			'recipe-generator-workspace',
-			onboardingMessages.labRecipeGeneratorTitle,
-			onboardingMessages.labRecipeGeneratorDescription,
-		),
 		step(
 			'downloads-navigation',
 			'navigate',
@@ -681,6 +468,12 @@ export const onboardingTours: Record<OnboardingMode, OnboardingStep[]> = {
 			),
 			control('create-instance', '/create'),
 		),
+		inspect(
+			'creation-instance-mode',
+			'creation-instance-mode',
+			onboardingMessages.instanceModeTitle,
+			onboardingMessages.instanceModeDescription,
+		),
 		step(
 			'creation-flow',
 			'activate',
@@ -692,6 +485,7 @@ export const onboardingTours: Record<OnboardingMode, OnboardingStep[]> = {
 			{
 				targetId: 'creation-methods',
 				branchByTarget: {
+					'creation-method-starlight': { next: 'complete' },
 					'creation-method-custom': { creationPath: 'custom', next: 'creation-name' },
 					'creation-method-import': { next: 'complete' },
 				},

apps/app-frontend/src/components/ui/settings/AboutSettings.vue

@@ -5,7 +5,6 @@ import { getVersion } from '@tauri-apps/api/app'
 import { openUrl } from '@tauri-apps/plugin-opener'
 import { defineAsyncComponent, inject, nextTick, onScopeDispose, ref, shallowRef } from 'vue'
 
-import ColorMineAvatar from '@/components/ui/easteregg/color-mine/ColorMineAvatar.vue'
 import EasterEggContributorsModal from '@/components/ui/easteregg/EasterEggContributorsModal.vue'
 import EasterEggGameModal from '@/components/ui/easteregg/EasterEggGameModal.vue'
 import { AxolotlBrandConfig } from '@/config'
@@ -17,7 +16,7 @@ import { type AboutMemberExperience, getAboutMemberExperience } from './about-me
 const { formatMessage } = useVIntl()
 const version = await getVersion()
 const experienceHost = ref<HTMLElement>()
-const activeMemberExperience = shallowRef<AboutMemberExperience>()
+const activeMemberExperience = shallowRef<Extract<AboutMemberExperience, { kind: 'scene' }>>()
 const pressingMemberName = ref<string>()
 let longPressTimer: number | undefined
 let pressStart = { x: 0, y: 0 }
@@ -41,9 +40,13 @@ function startMemberLongPress(member: TeamMember, event: PointerEvent) {
 	pressStart = { x: event.clientX, y: event.clientY }
 	pressingMemberName.value = member.name
 	longPressTimer = window.setTimeout(async () => {
-		activeMemberExperience.value = experience
 		suppressNextMemberClick = true
 		cancelMemberLongPress()
+		if (experience.kind === 'color-mine') {
+			openColorMine()
+			return
+		}
+		activeMemberExperience.value = experience
 		await nextTick()
 		experienceHost.value?.scrollIntoView({ behavior: 'smooth', block: 'center' })
 	}, experience.longPressDuration)
@@ -216,13 +219,13 @@ const messages = defineMessages({
 			<div class="flex flex-col items-center gap-4">
 				<div
 					ref="experienceHost"
-					class="relative m-0 w-full overflow-hidden h-64 rounded-xl"
+					class="relative m-0 aspect-[3/1] w-full overflow-hidden rounded-xl"
 					style="
 						mask-image: linear-gradient(to bottom, black 97%, transparent 100%);
 						-webkit-mask-image: linear-gradient(to bottom, black 97%, transparent 100%);
 					"
 				>
-					<AboutScene />
+					<AboutScene :paused="Boolean(activeMemberExperience)" />
 					<component
 						:is="activeMemberExperience?.component"
 						v-if="activeMemberExperience"
@@ -300,56 +303,37 @@ const messages = defineMessages({
 				{{ formatMessage(messages.developmentTeam) }}
 			</h3>
 			<div class="grid gap-3 sm:grid-cols-2">
-				<template v-for="member in teamMembers" :key="member.name">
-					<div
-						v-if="member.name === 'Disy920'"
-						class="flex min-w-0 items-center gap-3 rounded-xl bg-surface-4 p-3 transition-colors hover:bg-surface-5"
-					>
-						<ColorMineAvatar
-							:src="member.avatarUrl"
-							:name="member.name"
-							:href="member.url"
-							@activate="openColorMine"
-						/>
-						<a
-							:href="member.url"
-							target="_blank"
-							rel="noopener noreferrer"
-							class="flex min-w-0 flex-1 items-center gap-3"
-						>
-							<span class="min-w-0 flex-1 truncate font-semibold text-contrast">{{
-								member.name
-							}}</span>
-							<ExternalIcon v-if="member.url" class="size-4 shrink-0 text-secondary" />
-						</a>
-					</div>
-					<a
-						v-else
-						:href="member.url ?? undefined"
-						target="_blank"
-						rel="noopener noreferrer"
-						class="flex min-w-0 items-center gap-3 rounded-xl bg-surface-4 p-3 transition-colors hover:bg-surface-5"
-						@pointerdown="startMemberLongPress(member, $event)"
-						@pointermove="moveMemberLongPress"
-						@pointerup="cancelMemberLongPress"
-						@pointerleave="cancelMemberLongPress"
-						@click="handleMemberClick"
-						@contextmenu="handleMemberContextMenu(member, $event)"
-					>
-						<Avatar
-							:src="member.avatarUrl"
-							:alt="member.name"
-							size="2.5rem"
-							circle
-							no-shadow
-							loading="lazy"
-						/>
-						<span class="min-w-0 flex-1 truncate font-semibold text-contrast">
-							{{ member.name }}
-						</span>
-						<ExternalIcon v-if="member.url" class="size-4 shrink-0 text-secondary" />
-					</a>
-				</template>
+				<a
+					v-for="member in teamMembers"
+					:key="member.name"
+					:href="member.url ?? undefined"
+					target="_blank"
+					rel="noopener noreferrer"
+					class="flex min-w-0 items-center gap-3 rounded-xl bg-surface-4 p-3 transition-colors hover:bg-surface-5"
+					:class="{ 'member-card-holding': pressingMemberName === member.name }"
+					@pointerdown="startMemberLongPress(member, $event)"
+					@pointermove="moveMemberLongPress"
+					@pointerup="cancelMemberLongPress"
+					@pointercancel="cancelMemberLongPress"
+					@pointerleave="cancelMemberLongPress"
+					@blur="cancelMemberLongPress"
+					@click="handleMemberClick"
+					@contextmenu="handleMemberContextMenu(member, $event)"
+					@dragstart.prevent
+				>
+					<Avatar
+						:src="member.avatarUrl"
+						:alt="member.name"
+						size="2.5rem"
+						circle
+						no-shadow
+						loading="lazy"
+					/>
+					<span class="min-w-0 flex-1 truncate font-semibold text-contrast">
+						{{ member.name }}
+					</span>
+					<ExternalIcon v-if="member.url" class="size-4 shrink-0 text-secondary" />
+				</a>
 			</div>
 		</section>
 		<details class="group pt-4 about-settings-details">
@@ -417,6 +401,11 @@ const messages = defineMessages({
 	padding: var(--gap-lg);
 }
 
+.member-card-holding {
+	outline: 2px solid var(--color-brand);
+	outline-offset: 2px;
+}
+
 .about-page :deep(.rounded-xl.bg-surface-4) {
 	border: 1px solid
 		var(--settings-card-border, color-mix(in srgb, var(--surface-4) 72%, transparent));

apps/app-frontend/src/components/ui/settings/DefaultInstanceSettings.vue

@@ -12,6 +12,15 @@ import SettingsSection from './SettingsSection.vue'
 const { formatMessage } = useVIntl()
 
 const messages = defineMessages({
+	forceUnicodeFont: {
+		id: 'app.settings.defaults.force-unicode-font',
+		defaultMessage: 'Force Unicode font',
+	},
+	forceUnicodeFontDescription: {
+		id: 'app.settings.defaults.force-unicode-font-description',
+		defaultMessage:
+			'Use the Unicode font when initializing a new instance. Off by default; existing font settings are preserved.',
+	},
 	fullscreen: { id: 'app.settings.defaults.fullscreen', defaultMessage: 'Fullscreen' },
 	fullscreenDescription: {
 		id: 'app.settings.defaults.fullscreen-description',
@@ -205,6 +214,24 @@ watch(
 			</SettingsRow>
 		</SettingsSection>
 
+		<SettingsSection>
+			<SettingsRow>
+				<template #label>
+					<span id="settings-target-defaults-unicode-font" tabindex="-1">
+						{{ formatMessage(messages.forceUnicodeFont) }}
+					</span>
+				</template>
+				<template #description>{{ formatMessage(messages.forceUnicodeFontDescription) }}</template>
+				<template #control>
+					<Toggle
+						id="force-unicode-font"
+						v-model="settings.force_unicode_font"
+						:aria-label="formatMessage(messages.forceUnicodeFont)"
+					/>
+				</template>
+			</SettingsRow>
+		</SettingsSection>
+
 		<SettingsSection>
 			<SettingsRow stacked>
 				<template #label>

apps/app-frontend/src/components/ui/settings/UpdateSettings.vue

@@ -12,13 +12,13 @@ import {
 import { getVersion } from '@tauri-apps/api/app'
 import { invoke } from '@tauri-apps/api/core'
 import { fetch as tauriFetch } from '@tauri-apps/plugin-http'
-import { inject, nextTick, ref, watch } from 'vue'
+import { nextTick, ref, watch } from 'vue'
 
 import UpdateAnnouncementHistory from '@/components/ui/announcement/UpdateAnnouncementHistory.vue'
 import {
 	betaDatabaseExists,
-	copyReleaseDatabaseToBeta,
 	copyDatabaseBetweenChannels,
+	copyReleaseDatabaseToBeta,
 	getCurrentAppDatabasePath,
 	getUpdateChannel,
 	getUpdatePreferences,
@@ -294,7 +294,9 @@ async function loadLatestChannelVersions() {
 	const versions = await Promise.all(
 		(['release', 'beta'] as const).map(async (channel) => {
 			try {
-				const response = await tauriFetch(`https://update.axlmc.org/latest?channel=${channel}`)
+				const response = await tauriFetch(
+					`https://skin.starlight.cool/starlight/launcher/latest?channel=${channel}`,
+				)
 				if (!response.ok) return [channel, undefined] as const
 				const payload = (await response.json()) as { version?: string }
 				return [channel, payload.version] as const
@@ -444,11 +446,14 @@ async function confirmDatabaseOperation() {
 			}),
 		})
 	} catch (error) {
+		const detail = error instanceof Error ? error.message : String(error)
 		handleError(
 			new Error(
-				targetChannel === activeChannel
-					? formatMessage(messages.databaseOperationActiveTarget)
-					: formatMessage(messages.databaseOperationFailed),
+				`${
+					targetChannel === activeChannel
+						? formatMessage(messages.databaseOperationActiveTarget)
+						: formatMessage(messages.databaseOperationFailed)
+				}: ${detail}`,
 			),
 		)
 	} finally {
@@ -466,7 +471,7 @@ function cancelDatabaseOperation() {
 	<div class="flex flex-col gap-6">
 		<SettingsSection :title="formatMessage(messages.title)">
 			<div class="update-channel-panel">
-				<p id="settings-target-updates-channel" class="m-0 text-sm leading-[1.45] text-secondary">
+				<p id="settings-target-updates-source" class="m-0 text-sm leading-[1.45] text-secondary">
 					{{ formatMessage(messages.description) }}
 				</p>
 				<div

apps/app-frontend/src/components/ui/settings/about-member-experiences.ts

@@ -1,21 +1,31 @@
-
 import type { Component } from 'vue'
 
 import AboutEasterEgg from '../AboutEasterEgg.vue'
 
-export type AboutMemberExperience = {
-	component: Component
-	longPressDuration: number
-}
+export type AboutMemberExperience =
+	| {
+			kind: 'scene'
+			component: Component
+			longPressDuration: number
+	  }
+	| {
+			kind: 'color-mine'
+			longPressDuration: number
+	  }
 
-// 长按「关于」页成员名字触发的彩蛋体验。
+// 长按「关于」页成员卡片触发的彩蛋体验。
 // 下界之星合成彩蛋（AboutEasterEgg.vue），由长按成员名 / 暗号 / Konami 秘技触发。
 // 若要为特定成员挂载自定义彩蛋，在这里新增条目即可。
 const memberExperiences: Record<string, AboutMemberExperience> = {
 	'easter-egg': {
+		kind: 'scene',
 		component: AboutEasterEgg,
 		longPressDuration: 800,
 	},
+	'color-mine': {
+		kind: 'color-mine',
+		longPressDuration: 800,
+	},
 }
 
 export function getAboutMemberExperience(experience: unknown): AboutMemberExperience | undefined {

apps/app-frontend/src/components/ui/settings/settings-category-definitions.ts

@@ -1,4 +1,4 @@
-import { defineMessage, type MessageDescriptor } from '@modrinth/ui'
+import type { MessageDescriptor } from '@modrinth/ui'
 
 export type SettingsCategoryId =
 	| 'interface'
@@ -28,100 +28,100 @@ export interface SettingsCategoryDefinition {
 export const settingsCategoryDefinitions: SettingsCategoryDefinition[] = [
 	{
 		id: 'interface',
-		name: defineMessage({
+		name: {
 			id: 'app.settings.tabs.interface',
 			defaultMessage: 'Interface & appearance',
-		}),
+		},
 		group: 'launcher',
 		onboardingId: 'settings-tab-interface',
 	},
 	{
 		id: 'home-navigation',
-		name: defineMessage({
+		name: {
 			id: 'app.settings.tabs.home-navigation',
 			defaultMessage: 'Home & navigation',
-		}),
+		},
 		group: 'launcher',
 		onboardingId: 'settings-tab-home-navigation',
 	},
 	{
 		id: 'language-translation',
-		name: defineMessage({
+		name: {
 			id: 'app.settings.tabs.language-translation',
 			defaultMessage: 'Language & translation',
-		}),
+		},
 		group: 'launcher',
 		onboardingId: 'settings-tab-language-translation',
 	},
 	{
 		id: 'ai',
-		name: defineMessage({ id: 'app.settings.tabs.ai', defaultMessage: 'AI' }),
+		name: { id: 'app.settings.tabs.ai', defaultMessage: 'AI' },
 		group: 'launcher',
 		flushContent: true,
 		onboardingId: 'settings-tab-ai',
 	},
 	{
 		id: 'java-performance',
-		name: defineMessage({
+		name: {
 			id: 'app.settings.tabs.java-performance',
 			defaultMessage: 'Java & performance',
-		}),
+		},
 		group: 'game',
 		onboardingId: 'settings-tab-java-performance',
 	},
 	{
 		id: 'launch-defaults',
-		name: defineMessage({
+		name: {
 			id: 'app.settings.tabs.launch-defaults',
 			defaultMessage: 'Launch & instance defaults',
-		}),
+		},
 		group: 'game',
 		onboardingId: 'settings-tab-launch-defaults',
 	},
 	{
 		id: 'content-downloads',
-		name: defineMessage({
+		name: {
 			id: 'app.settings.tabs.content-downloads',
 			defaultMessage: 'Content & downloads',
-		}),
+		},
 		group: 'game',
 		onboardingId: 'settings-tab-content-downloads',
 	},
 	{
 		id: 'network-multiplayer',
-		name: defineMessage({
+		name: {
 			id: 'app.settings.tabs.network-multiplayer',
 			defaultMessage: 'Network & multiplayer',
-		}),
+		},
 		group: 'game',
 		onboardingId: 'settings-tab-network-multiplayer',
 	},
 	{
 		id: 'storage-backups',
-		name: defineMessage({
+		name: {
 			id: 'app.settings.tabs.storage-backups',
 			defaultMessage: 'Storage & backups',
-		}),
+		},
 		group: 'data-privacy',
 		onboardingId: 'settings-tab-storage-backups',
 	},
 	{
 		id: 'updates',
-		name: defineMessage({ id: 'app.settings.tabs.updates', defaultMessage: 'Updates' }),
+		name: { id: 'app.settings.tabs.updates', defaultMessage: 'Updates' },
 		group: 'support',
 		onboardingId: 'settings-tab-updates',
 	},
 	{
 		id: 'about',
-		name: defineMessage({ id: 'app.settings.tabs.about', defaultMessage: 'About' }),
+		name: { id: 'app.settings.tabs.about', defaultMessage: 'About' },
 		group: 'support',
 	},
 	{
 		id: 'feature-flags',
-		name: defineMessage({
+		name: {
 			id: 'settings.feature-flags.title',
 			defaultMessage: 'Feature flags',
-		}),
+		},
 		group: 'developer',
 		developerOnly: true,
 	},

apps/app-frontend/src/components/ui/settings/settings-registry.ts

@@ -15,7 +15,8 @@ import {
 	UsersIcon,
 } from '@modrinth/assets'
 import { commonMessages, defineMessages, type MessageDescriptor } from '@modrinth/ui'
-import { defineAsyncComponent, type Component } from 'vue'
+import { type Component, defineAsyncComponent } from 'vue'
+
 import {
 	getVisibleSettingsCategoryDefinitions,
 	type SettingsCategoryDefinition,

apps/app-frontend/src/components/ui/settings/settings-search-index.ts

@@ -254,6 +254,16 @@ export const settingsSearchEntries: SettingsSearchEntry[] = [
 		targetId: 'settings-target-defaults-environment',
 		label: message('app.settings.defaults.environment-variables', 'Environment variables'),
 	},
+	{
+		id: 'defaults-unicode-font',
+		categoryId: 'launch-defaults',
+		targetId: 'settings-target-defaults-unicode-font',
+		label: message('app.settings.defaults.force-unicode-font', 'Force Unicode font'),
+		description: message(
+			'app.settings.defaults.force-unicode-font-description',
+			'Use the Unicode font when initializing a new instance. Off by default; existing font settings are preserved.',
+		),
+	},
 	{
 		id: 'defaults-launch-hooks',
 		categoryId: 'launch-defaults',

apps/app-frontend/src/components/ui/settings/settings-search.test.ts

@@ -104,6 +104,28 @@ test('settings search index has unique entries with categories', () => {
 	assert.deepEqual(validateSettingsSearchEntries(), [])
 })
 
+test('Unicode font is searchable in Chinese and English', () => {
+	const entry = settingsSearchEntries.find((entry) => entry.id === 'defaults-unicode-font')!
+	assert.equal(entry.categoryId, 'launch-defaults')
+	assert.ok(
+		readFileSync(new URL('./DefaultInstanceSettings.vue', import.meta.url), 'utf8').includes(
+			`id="${getSettingsSearchTargetId(entry)}"`,
+		),
+	)
+	for (const translated of [false, true]) {
+		const documents = settingsSearchEntries.map((entry) => ({
+			item: entry,
+			text: translated
+				? (chineseLocale[entry.label.id]?.message ?? entry.label.defaultMessage ?? '')
+				: (entry.label.defaultMessage ?? ''),
+		}))
+		for (const query of translated ? ['字体', 'Unicode'] : ['font', 'Unicode']) {
+			const matches = filterSettingsSearchDocuments(query, documents)
+			assert.ok(matches.some(({ item }) => item.id === 'defaults-unicode-font'))
+		}
+	}
+})
+
 test('settings search keywords are valid message descriptors', () => {
 	for (const entry of settingsSearchEntries) {
 		for (const keyword of entry.keywords ?? []) {

apps/app-frontend/src/components/ui/skin/VirtualSkinSectionList.vue

@@ -84,6 +84,7 @@ const props = defineProps<{
 	isSkinActive: (skin: Skin) => boolean
 	isAddSkinButtonDragActive: boolean
 	readOnly?: boolean
+	manageSavedSkins?: boolean
 	activeTab?: 'saved' | 'default'
 }>()
 
@@ -182,7 +183,9 @@ const sections = computed<SkinSection[]>(() => {
 
 const draggableSavedSkins = ref<Skin[]>([])
 const isDraggingSavedSkin = ref(false)
-const canReorderSavedSkins = computed(() => draggableSavedSkins.value.length > 1)
+const canReorderSavedSkins = computed(
+	() => props.manageSavedSkins !== false && draggableSavedSkins.value.length > 1,
+)
 const fixedSavedSkins = computed(() => props.savedSkins.filter((skin) => !canDragSavedSkin(skin)))
 
 const sectionLayouts = computed(() => {
@@ -486,7 +489,7 @@ defineExpose({ getAddSkinButtonElement })
 								:is-dragging="isDraggingSavedSkin"
 								@select="emit('select', skin)"
 							>
-								<template v-if="!readOnly" #overlay-buttons>
+								<template v-if="!readOnly && manageSavedSkins !== false" #overlay-buttons>
 									<ButtonStyled color="brand">
 										<button
 											:aria-label="formatMessage(messages.editSkinButton)"
@@ -526,7 +529,7 @@ defineExpose({ getAddSkinButtonElement })
 								:is-dragging="isDraggingSavedSkin"
 								@select="emit('select', skin)"
 							>
-								<template v-if="!readOnly" #overlay-buttons>
+								<template v-if="!readOnly && manageSavedSkins !== false" #overlay-buttons>
 									<ButtonStyled color="brand">
 										<button
 											:aria-label="formatMessage(messages.editSkinButton)"
@@ -568,7 +571,7 @@ defineExpose({ getAddSkinButtonElement })
 						:is-dragging="isDraggingSavedSkin"
 						@select="emit('select', skin)"
 					>
-						<template #overlay-buttons>
+						<template v-if="manageSavedSkins !== false" #overlay-buttons>
 							<ButtonStyled color="brand">
 								<button
 									:aria-label="formatMessage(messages.editSkinButton)"

apps/app-frontend/src/components/ui/world/InstanceItem.vue

@@ -29,6 +29,7 @@ import { useMinecraftLaunchError } from '@/composables/useMinecraftLaunchError'
 import { get_project } from '@/helpers/cache'
 import { process_listener } from '@/helpers/events'
 import { kill, run } from '@/helpers/instance'
+import { isInstanceLaunching } from '@/helpers/instance-launch-state'
 import { get_by_instance_id } from '@/helpers/process'
 import type { GameInstance } from '@/helpers/types'
 import { showInstanceInFolder } from '@/helpers/utils'
@@ -46,10 +47,8 @@ const messages = defineMessages({
 		defaultMessage: 'Loading modpack...',
 	},
 	viewInstance: { id: 'app.instance-item.view-instance', defaultMessage: 'View instance' },
-	alreadyOpen: {
-		id: 'app.instance-item.already-open',
-		defaultMessage: 'Instance is already open',
-	},
+	launchAnother: { id: 'app.instance.launch-another', defaultMessage: 'Launch another window' },
+	stopAll: { id: 'app.instance.stop-all', defaultMessage: 'Stop all windows of this instance' },
 })
 const formatDateTime = useFormatDateTime({
 	timeStyle: 'short',
@@ -91,33 +90,32 @@ const loader = computed(() => {
 	}
 })
 
-const loading = ref(false)
+const stopping = ref(false)
+const loading = computed(() => stopping.value || isInstanceLaunching(props.instance.id))
 const internalPlaying = ref(false)
 const isPlaying = computed(() => props.playing ?? internalPlaying.value)
 
 const play = async (event: MouseEvent) => {
 	event?.stopPropagation()
-	loading.value = true
-	await run(props.instance.id)
-		.catch(async (err) => {
-			const handled = await handleMinecraftLaunchError(err, {
-				instance_id: props.instance.id,
-				instance_name: props.instance.name,
-			})
-			if (!handled) handleSevereError(err, { instanceId: props.instance.id })
-		})
-		.finally(() => {
+	if (loading.value) return
+	await run(props.instance.id).catch(async (err) => {
+		const handled = await handleMinecraftLaunchError(err, {
+			instance_id: props.instance.id,
+			instance_name: props.instance.name,
 		})
+		if (!handled) handleSevereError(err, { instanceId: props.instance.id })
+	})
 	emit('play')
-	loading.value = false
+	await checkProcess()
 }
 
 const stop = async (event: MouseEvent) => {
 	event?.stopPropagation()
-	loading.value = true
+	stopping.value = true
 	await kill(props.instance.id).catch(handleError)
 	emit('stop')
-	loading.value = false
+	stopping.value = false
+	await checkProcess()
 }
 
 const unlistenProcesses =
@@ -131,7 +129,7 @@ const checkProcess = async () => {
 	if (props.playing !== undefined) return
 	const runningProcesses = await get_by_instance_id(props.instance.id).catch(handleError)
 
-	internalPlaying.value = runningProcesses.length > 0
+	if (Array.isArray(runningProcesses)) internalPlaying.value = runningProcesses.length > 0
 }
 
 onMounted(() => {
@@ -155,7 +153,8 @@ onUnmounted(() => {
 			:class="[
 				flat ? 'px-2 py-2 hover:bg-button-bg' : 'card-shadow bg-bg-raised p-3',
 				{
-					'instance-item-dashboard-compact grid grid-cols-[auto_minmax(0,1fr)_auto] gap-2 p-1.5': dashboardDensity === 'compact',
+					'instance-item-dashboard-compact grid grid-cols-[auto_minmax(0,1fr)_auto] gap-2 p-1.5':
+						dashboardDensity === 'compact',
 					'instance-item-dashboard-comfortable p-2': dashboardDensity === 'comfortable',
 				},
 			]"
@@ -214,23 +213,25 @@ onUnmounted(() => {
 					color="red"
 					:circular="dashboardDensity === 'compact'"
 				>
-					<button @click="stop">
+					<button v-tooltip="formatMessage(messages.stopAll)" @click="stop">
 						<StopCircleIcon aria-hidden="true" />
 						<span v-if="dashboardDensity !== 'compact'">
-							{{ formatMessage(commonMessages.stopButton) }}
+							{{ formatMessage(messages.stopAll) }}
 						</span>
 					</button>
 				</ButtonStyled>
-				<ButtonStyled v-else :circular="dashboardDensity === 'compact'">
+				<ButtonStyled :circular="dashboardDensity === 'compact'">
 					<button
-						v-tooltip="isPlaying ? formatMessage(messages.alreadyOpen) : null"
-						:disabled="isPlaying || loading"
+						v-tooltip="
+							formatMessage(isPlaying ? messages.launchAnother : commonMessages.playButton)
+						"
+						:disabled="loading"
 						@click="play"
 					>
 						<SpinnerIcon v-if="loading" class="animate-spin" />
 						<PlayIcon v-else aria-hidden="true" />
 						<span v-if="dashboardDensity !== 'compact'">
-							{{ formatMessage(commonMessages.playButton) }}
+							{{ formatMessage(isPlaying ? messages.launchAnother : commonMessages.playButton) }}
 						</span>
 					</button>
 				</ButtonStyled>
@@ -280,5 +281,4 @@ onUnmounted(() => {
 .instance-item-dashboard-compact > :last-child {
 	gap: 0.125rem;
 }
-
 </style>

apps/app-frontend/src/composables/browse/install-job-notifications.ts

@@ -13,7 +13,6 @@ import type { Router } from 'vue-router'
 import {
 	install_job_dismiss,
 	install_job_repair_cache_and_retry,
-	install_job_retry,
 	install_job_support_details,
 	installJobInstanceId,
 	type InstallJobSnapshot,
@@ -21,6 +20,7 @@ import {
 	type InstallPhaseId,
 	type InstallProgress,
 } from '@/helpers/install'
+import { createInstallJobNotificationFilter } from '@/helpers/install-job-notification-visibility'
 import { effectiveInstallProgress, hasDeterminateInstallProgress } from '@/helpers/install-progress'
 import { get_many as getInstances } from '@/helpers/instance'
 import type { DownloadManager } from '@/providers/download-manager'
@@ -258,15 +258,6 @@ const failureSummaryMessages = defineMessages({
 	},
 })
 
-const visibleJobStatuses = new Set<InstallJobStatus>([
-	'queued',
-	'running',
-	'canceling',
-	'waiting_for_user',
-	'failed',
-	'interrupted',
-])
-const retainedJobStatuses = new Set<InstallJobStatus>(['succeeded', 'canceled'])
 const activeJobStatuses = new Set<InstallJobStatus>([
 	'queued',
 	'running',
@@ -682,7 +673,7 @@ export async function useInstallJobNotifications(opts: {
 				action: async () => {
 					if (repairingJobIds.value.has(job.job_id)) return
 					if (!requiresCacheRepair) {
-						await install_job_retry(job.job_id).catch(opts.handleError)
+						await opts.manager.retry(job.job_id).catch(opts.handleError)
 						await refresh()
 						return
 					}
@@ -724,6 +715,8 @@ export async function useInstallJobNotifications(opts: {
 		return buttons
 	}
 
+	const filterVisibleJobs = createInstallJobNotificationFilter(opts.manager.jobs.value)
+
 	function setJobs(nextJobs: InstallJobSnapshot[]) {
 		for (const job of nextJobs) {
 			if (!jobOrder.has(job.job_id)) {
@@ -731,12 +724,7 @@ export async function useInstallJobNotifications(opts: {
 			}
 		}
 
-		const currentJobIds = new Set(jobs.value.map((job) => job.job_id))
-		const visibleJobs = nextJobs.filter(
-			(job) =>
-				visibleJobStatuses.has(job.status) ||
-				(retainedJobStatuses.has(job.status) && currentJobIds.has(job.job_id)),
-		)
+		const visibleJobs = filterVisibleJobs(nextJobs)
 		syncProgressSnapshots(visibleJobs)
 
 		jobs.value = visibleJobs.sort(

apps/app-frontend/src/composables/console-history.test.ts

@@ -1,23 +0,0 @@
-import assert from 'node:assert/strict'
-import test from 'node:test'
-
-import { mergeLiveLogHistory } from './console-history.ts'
-
-test('retains the persisted latest.log history and appends a live-only tail', () => {
-	assert.equal(
-		mergeLiveLogHistory('first\nsecond\nthird', 'second\nthird\nfourth'),
-		'first\nsecond\nthird\nfourth',
-	)
-})
-
-test('does not duplicate a buffer already persisted in latest.log', () => {
-	assert.equal(mergeLiveLogHistory('first\nsecond\nthird', 'second\nthird'), 'first\nsecond\nthird')
-})
-
-test('keeps live output when it is not present in latest.log', () => {
-	assert.equal(mergeLiveLogHistory('minecraft', 'launcher'), 'minecraft\nlauncher')
-})
-
-test('accepts an unavailable latest.log while the instance is starting', () => {
-	assert.equal(mergeLiveLogHistory('', 'launcher output'), 'launcher output')
-})

apps/app-frontend/src/composables/console-history.ts

@@ -1,31 +0,0 @@
-function nonEmptyLines(content: string): string[] {
-	return content.split(/\r\n|\r|\n/).filter(Boolean)
-}
-
-function overlapLength(history: readonly string[], liveBuffer: readonly string[]): number {
-	const maximum = Math.min(history.length, liveBuffer.length)
-
-	for (let length = maximum; length > 0; length--) {
-		let overlaps = true
-		for (let index = 0; index < length; index++) {
-			if (history[history.length - length + index] !== liveBuffer[index]) {
-				overlaps = false
-				break
-			}
-		}
-		if (overlaps) return length
-	}
-
-	return 0
-}
-
-/**
- * Combines the persisted Minecraft log with output that may not have reached
- * latest.log yet. The ring buffer commonly repeats the tail of latest.log, so
- * retain only its non-overlapping suffix.
- */
-export function mergeLiveLogHistory(latestLog: string, liveBuffer: string): string {
-	const history = nonEmptyLines(latestLog)
-	const buffer = nonEmptyLines(liveBuffer)
-	return [...history, ...buffer.slice(overlapLength(history, buffer))].join('\n')
-}

apps/app-frontend/src/composables/latest-log-reader.test.ts

@@ -0,0 +1,120 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { createLatestLogReader } from './latest-log-reader.ts'
+
+test('follows file-only output after startup, re-entry, clear and file rotation', async () => {
+	let file = ''
+	let displayed = 'stdout startup'
+	const reader = createLatestLogReader(
+		async (cursor) => ({
+			cursor: file.length,
+			output: file.slice(cursor > file.length ? 0 : cursor),
+			new_file: cursor > file.length,
+		}),
+		(output, replace) => {
+			displayed = (replace ? '' : displayed) + output
+		},
+	)
+	await reader.refresh()
+	assert.equal(reader.active, false)
+	file = 'Startup complete\n'
+	await reader.refresh()
+	assert.equal(reader.active, true)
+	assert.equal(displayed, file) // Replaces stdout, not appended a second time.
+	file += 'Joined world\nDisconnected\n'
+	await reader.refresh()
+	await reader.refresh() // Re-entering the view must not replay history.
+	assert.equal(displayed, file)
+	reader.clear()
+	displayed = ''
+	file += 'After clear\n'
+	await reader.refresh()
+	assert.equal(displayed, 'After clear\n')
+	file = 'Rotated\n'
+	await reader.refresh()
+	assert.equal(displayed, file)
+	file = ''
+	await reader.refresh()
+	assert.equal(displayed, '')
+	assert.equal(reader.active, false)
+	file = 'File recreated\n'
+	await reader.refresh()
+	assert.equal(displayed, file)
+	reader.reset()
+	assert.equal(reader.active, false)
+	file = 'New session with a longer file\n'
+	await reader.refresh()
+	assert.equal(displayed, file)
+})
+
+test('serializes reads, ignores pre-restart responses, consumes pre-clear responses', async () => {
+	const resolvers: ((value: { cursor: number; output: string; new_file: boolean }) => void)[] = []
+	const cursors: number[] = []
+	const output: string[] = []
+	const reader = createLatestLogReader(
+		(cursor) => {
+			cursors.push(cursor)
+			return new Promise((resolve) => resolvers.push(resolve))
+		},
+		(text) => output.push(text),
+	)
+	const old = reader.refresh()
+	const concurrent = reader.refresh()
+	assert.deepEqual(cursors, [0])
+	reader.reset()
+	const fresh = reader.refresh()
+	resolvers[0]({ cursor: 100, output: 'old session', new_file: false })
+	await Promise.all([old, concurrent])
+	assert.deepEqual(output, [])
+	reader.clear()
+	resolvers[1]({ cursor: 20, output: 'before clear', new_file: false })
+	await fresh
+	assert.deepEqual(output, [])
+	const next = reader.refresh()
+	assert.deepEqual(cursors, [0, 0, 20])
+	resolvers[2]({ cursor: 40, output: 'after clear\n', new_file: false })
+	await next
+	assert.deepEqual(output, ['after clear\n'])
+})
+
+test('a temporary read failure keeps the cursor and retries without duplicating output', async () => {
+	let failed = true
+	const output: string[] = []
+	const reader = createLatestLogReader(
+		async (cursor) => {
+			assert.equal(cursor, 0)
+			if (failed) throw new Error('file temporarily unavailable')
+			return { cursor: 6, output: 'ready\n', new_file: false }
+		},
+		(text) => output.push(text),
+	)
+	await assert.rejects(reader.refresh())
+	assert.equal(reader.active, false)
+	failed = false
+	await reader.refresh()
+	assert.deepEqual(output, ['ready\n'])
+})
+
+test('joins split lines and flushes the final unterminated line on exit', async () => {
+	let chunk = 'Startup\n[Render thread/INFO] Join'
+	let cursor = 0
+	let displayed = ''
+	const reader = createLatestLogReader(
+		async () => ({
+			cursor: (cursor += chunk.length),
+			output: chunk,
+			new_file: false,
+		}),
+		(text, replace) => {
+			displayed = (replace ? '' : displayed) + text
+		},
+	)
+	await reader.refresh()
+	assert.equal(displayed, 'Startup\n')
+	chunk = 'ed world\nLast line'
+	await reader.refresh()
+	assert.equal(displayed, 'Startup\n[Render thread/INFO] Joined world\n')
+	reader.flush()
+	assert.equal(displayed, 'Startup\n[Render thread/INFO] Joined world\nLast line')
+})

apps/app-frontend/src/composables/latest-log-reader.ts

@@ -0,0 +1,88 @@
+interface LogCursor {
+	cursor: number
+	output: string
+	new_file: boolean
+}
+
+/** One authoritative stream: use process events until latest.log becomes available. */
+export function createLatestLogReader(
+	read: (cursor: number) => Promise<LogCursor>,
+	append: (output: string, replace: boolean) => void,
+) {
+	let cursor = 0
+	let active = false
+	let session = 0
+	let cleared = 0
+	let partialLine = ''
+	let replaceOnAppend = false
+	let pending: Promise<void> | null = null
+
+	function refresh(): Promise<void> {
+		if (pending) return pending
+		const requestSession = session
+		const requestClear = cleared
+		const request = (async () => {
+			const result = await read(cursor)
+			if (requestSession !== session) return
+			const rotated = result.new_file || result.cursor < cursor
+			const replace = !active || rotated
+			cursor = result.cursor
+			if (result.cursor === 0 && !result.output) {
+				if (rotated) {
+					active = false
+					partialLine = ''
+					replaceOnAppend = false
+					if (requestClear === cleared) append('', true)
+				}
+				return
+			}
+			active = true
+			// Clearing during a read consumes its bytes without restoring cleared text.
+			if (requestClear === cleared && (result.output || result.new_file)) {
+				if (replace) {
+					partialLine = ''
+					replaceOnAppend = true
+				}
+				partialLine += result.output
+				// File writes can end mid-line. Do not turn the next chunk into a
+				// separate log entry; bound unterminated output just like the console.
+				const end =
+					partialLine.length > 64 * 1024 ? partialLine.length : partialLine.lastIndexOf('\n') + 1
+				if (end > 0) {
+					append(partialLine.slice(0, end), replaceOnAppend)
+					partialLine = partialLine.slice(end)
+					replaceOnAppend = false
+				}
+			}
+		})()
+		pending = request
+		return request.finally(() => {
+			if (pending === request) pending = null
+		})
+	}
+
+	return {
+		refresh,
+		get active() {
+			return active
+		},
+		clear() {
+			cleared++
+			partialLine = ''
+			replaceOnAppend = false
+		},
+		flush() {
+			if (partialLine) append(partialLine, replaceOnAppend)
+			partialLine = ''
+			replaceOnAppend = false
+		},
+		reset() {
+			session++
+			cursor = 0
+			active = false
+			partialLine = ''
+			replaceOnAppend = false
+			pending = null
+		},
+	}
+}

apps/app-frontend/src/composables/skin-site-session.test.ts

@@ -0,0 +1,562 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import {
+	clearHostedSession,
+	hostedCreate,
+	hostedDefault,
+	hostedSync,
+	onHostedPackAttemptStarted,
+	setInstanceMode,
+} from '../helpers/hosted-packs.ts'
+import {
+	openSkinSiteLogin,
+	receiveSkinSiteMessage,
+	requestSkinSiteDownloadToken,
+	requestSkinSiteLuck,
+	requestSkinSitePlayers,
+	requestSkinSiteSkinUpdate,
+	resetSkinSiteSession,
+	setSkinSiteFrame,
+	SKIN_SITE_ORIGIN,
+	skinSiteFrameUrl,
+	skinSitePlayers,
+	skinSitePlayersStatus,
+	skinSiteStatus,
+	skinSiteUser,
+} from './skin-site-session.ts'
+import { forgetHostedCreation, useHostedCreation } from './useHostedCreation.ts'
+import { useHostedSync } from './useHostedSync.ts'
+
+test('reconnecting the same skin site frame waits for verification instead of reporting signed out', () => {
+	const frame = { postMessage() {} } as unknown as Window
+	resetSkinSiteSession()
+	setSkinSiteFrame(frame)
+	resetSkinSiteSession()
+	setSkinSiteFrame(frame)
+	assert.equal(skinSiteStatus.value, 'checking')
+	setSkinSiteFrame(null)
+	resetSkinSiteSession()
+})
+
+test('hosted installation sends the JWT to native commands while Local needs no session', async () => {
+	const previousWindow = Object.getOwnPropertyDescriptor(globalThis, 'window')
+	const calls: Array<{ command: string; args: Record<string, unknown> }> = []
+	let syncResponse: (() => Promise<unknown>) | undefined
+	let createdId = 'instance'
+	let instanceExists = false
+	let tokenRequests = 0
+	const frame = {
+		postMessage(data: { type: string; requestId: string }) {
+			if (data.type !== 'starlight-pack-token-request') return
+			tokenRequests++
+			receiveSkinSiteMessage(
+				{
+					origin: SKIN_SITE_ORIGIN,
+					source: frame,
+					data: {
+						type: 'starlight-pack-token-result',
+						requestId: data.requestId,
+						token: 'site.jwt.secret',
+					},
+				} as MessageEvent,
+				frame,
+			)
+		},
+	} as unknown as Window
+	Object.defineProperty(globalThis, 'window', {
+		configurable: true,
+		value: {
+			__TAURI_INTERNALS__: {
+				async invoke(command: string, args: Record<string, unknown>) {
+					calls.push({ command, args })
+					if (command === 'plugin:install|hosted_sync' && syncResponse) return syncResponse()
+					if (command === 'plugin:instance|instance_get')
+						return instanceExists ? { id: args.instanceId } : null
+					return command === 'plugin:install|hosted_create' ? createdId : null
+				},
+			},
+		},
+	})
+	try {
+		resetSkinSiteSession()
+		setSkinSiteFrame(frame)
+		receiveSkinSiteMessage(
+			{
+				origin: SKIN_SITE_ORIGIN,
+				source: frame,
+				data: {
+					type: 'starlight-skin-session',
+					status: 'signed-in',
+					user: { uuid: 'site', username: 'Site' },
+				},
+			} as MessageEvent,
+			frame,
+		)
+		await hostedDefault()
+		assert.equal(await hostedCreate(), 'instance')
+		await hostedSync('instance')
+		await setInstanceMode('instance', 'starlight')
+		assert.equal(tokenRequests, 4)
+		assert.deepEqual(
+			calls.map(({ command }) => command),
+			[
+				'hosted_set_session',
+				'hosted_default',
+				'hosted_set_session',
+				'hosted_create',
+				'hosted_set_session',
+				'hosted_sync',
+				'hosted_set_session',
+				'hosted_set_instance_mode',
+			].map((name) => `plugin:install|${name}`),
+		)
+		for (const call of calls.filter(({ command }) => command.endsWith('hosted_set_session'))) {
+			assert.equal(call.args.token, 'site.jwt.secret')
+		}
+		let rejectSync!: (error: unknown) => void
+		let syncCalls = 0
+		syncResponse = () => {
+			syncCalls++
+			return new Promise((_, reject) => {
+				rejectSync = reject
+			})
+		}
+		const originalPage = useHostedSync(() => 'shared-progress-instance')
+		const pendingSync = originalPage.sync()
+		const reopenedPage = useHostedSync(() => 'shared-progress-instance')
+		assert.equal(reopenedPage.busy.value, true)
+		assert.equal(useHostedSync(() => 'other-instance').busy.value, false)
+		await reopenedPage.sync()
+		await new Promise((resolve) => setImmediate(resolve))
+		assert.equal(syncCalls, 1)
+		rejectSync({ message: 'download interrupted' })
+		await pendingSync
+		assert.equal(reopenedPage.busy.value, false)
+		assert.match(reopenedPage.error.value, /download interrupted/)
+		assert.equal(
+			useHostedSync(() => 'shared-progress-instance').error.value,
+			reopenedPage.error.value,
+		)
+		syncResponse = async () => ({ revision: 'new-version' })
+		await reopenedPage.sync()
+		assert.equal(originalPage.error.value, '')
+		assert.deepEqual(originalPage.result.value, { revision: 'new-version' })
+
+		const creation = useHostedCreation()
+		createdId = 'deleted-instance'
+		syncResponse = async () => {
+			throw new Error('download failed')
+		}
+		await creation.install()
+		assert.equal(creation.createdInstance.value, 'deleted-instance')
+		assert.match(creation.installError.value, /download failed/)
+		createdId = 'replacement-instance'
+		syncResponse = async () => ({
+			version: '1',
+			downloadedBytes: 0,
+			changedFiles: 0,
+			preservedFiles: [],
+		})
+		const retryCallStart = calls.length
+		assert.equal(await creation.install(), 'replacement-instance')
+		assert.equal(calls[retryCallStart].command, 'plugin:instance|instance_get')
+		assert.equal(
+			calls.filter((call) => call.command.endsWith('|hosted_sync')).at(-1)?.args.instanceId,
+			'replacement-instance',
+		)
+		assert.equal(creation.installError.value, '')
+		forgetHostedCreation('unrelated-instance')
+		assert.equal(creation.completed.value, true)
+		forgetHostedCreation('replacement-instance')
+		assert.equal(creation.createdInstance.value, undefined)
+		assert.equal(creation.completed.value, false)
+		createdId = 'third-instance'
+		syncResponse = () =>
+			new Promise((_, reject) => {
+				rejectSync = reject
+			})
+		const deletedDuringSync = creation.install()
+		await new Promise((resolve) => setImmediate(resolve))
+		forgetHostedCreation('third-instance')
+		rejectSync(new Error('Unknown instance'))
+		await deletedDuringSync
+		assert.equal(creation.installError.value, '')
+		assert.equal(creation.createdInstance.value, undefined)
+		createdId = 'existing-instance'
+		syncResponse = async () => {
+			throw new Error('download interrupted')
+		}
+		await creation.install()
+		instanceExists = true
+		syncResponse = async () => ({
+			version: '1',
+			downloadedBytes: 0,
+			changedFiles: 0,
+			preservedFiles: [],
+		})
+		const createCount = calls.filter((call) => call.command.endsWith('|hosted_create')).length
+		assert.equal(await creation.install(), 'existing-instance')
+		assert.equal(
+			calls.filter((call) => call.command.endsWith('|hosted_create')).length,
+			createCount,
+		)
+		creation.acknowledge('existing-instance')
+		const requestsBeforeLogout = tokenRequests
+		resetSkinSiteSession()
+		await clearHostedSession()
+		assert.equal(calls.at(-1)!.args.token, null)
+		await setInstanceMode('instance', 'local')
+		assert.equal(tokenRequests, requestsBeforeLogout)
+		const attempts: string[] = []
+		const stopListening = onHostedPackAttemptStarted((id) => attempts.push(id))
+		const unauthenticatedRetry = hostedSync('failed-instance')
+		assert.deepEqual(attempts, ['failed-instance'])
+		await assert.rejects(unauthenticatedRetry)
+		stopListening()
+		await assert.rejects(hostedSync('failed-instance'))
+		assert.equal(attempts.length, 1)
+		await assert.rejects(hostedCreate(), /无需选择玩家/)
+	} finally {
+		resetSkinSiteSession()
+		setSkinSiteFrame(null)
+		if (previousWindow) Object.defineProperty(globalThis, 'window', previousWindow)
+		else Reflect.deleteProperty(globalThis, 'window')
+	}
+})
+
+test('pack download gets the site JWT without choosing a player and rejects stale replies', async () => {
+	const sent: Array<{ type: string; requestId: string }> = []
+	const frame = {
+		postMessage(data: { type: string; requestId: string }) {
+			sent.push(data)
+		},
+	} as unknown as Window
+	const receive = (data: unknown, origin = SKIN_SITE_ORIGIN) =>
+		receiveSkinSiteMessage(
+			{
+				origin,
+				source: frame,
+				data,
+			} as MessageEvent,
+			frame,
+		)
+	resetSkinSiteSession()
+	setSkinSiteFrame(frame)
+	await assert.rejects(requestSkinSiteDownloadToken(), /无需选择玩家/)
+	receive({
+		type: 'starlight-skin-session',
+		status: 'signed-in',
+		user: { uuid: 'site-user', username: 'Site' },
+	})
+	const token = requestSkinSiteDownloadToken()
+	const requestId = sent.at(-1)!.requestId
+	const reply = { type: 'starlight-pack-token-result', requestId, token: 'site.jwt.secret' }
+	assert.equal(receive(reply, 'https://evil.example'), false)
+	assert.equal(receive(reply), true)
+	assert.equal(await token, 'site.jwt.secret')
+	assert.equal(skinSitePlayers.value.length, 0)
+	assert.equal(JSON.stringify(skinSiteUser.value).includes('secret'), false)
+	const stale = requestSkinSiteDownloadToken()
+	const staleId = sent.at(-1)!.requestId
+	const rejected = assert.rejects(stale, /登录状态已变化/)
+	resetSkinSiteSession()
+	await rejected
+	assert.equal(receive({ ...reply, requestId: staleId }), false)
+	setSkinSiteFrame(null)
+})
+
+test('skin site session accepts only the embedded origin and window, and redirects after verification', () => {
+	const frame = {} as Window
+	const message = (status: string, user?: unknown) =>
+		({
+			origin: SKIN_SITE_ORIGIN,
+			source: frame,
+			data: { type: 'starlight-skin-session', status, user },
+		}) as MessageEvent
+	resetSkinSiteSession()
+	openSkinSiteLogin()
+	assert.equal(skinSiteFrameUrl.value, `${SKIN_SITE_ORIGIN}/login`)
+	const signedIn = message('signed-in', {
+		uuid: 'test-user',
+		username: '测试用户',
+		jwt: 'must-not-copy',
+	})
+	assert.equal(
+		receiveSkinSiteMessage({ ...signedIn, origin: 'https://evil.example' } as MessageEvent, frame),
+		false,
+	)
+	assert.equal(receiveSkinSiteMessage(signedIn, {} as Window), false)
+	assert.equal(receiveSkinSiteMessage(message('signed-in', {}), frame), false)
+	assert.equal(skinSiteUser.value, null)
+	assert.equal(receiveSkinSiteMessage(signedIn, frame), true)
+	assert.deepEqual(skinSiteUser.value, { uuid: 'test-user', username: '测试用户' })
+	assert.equal(skinSiteStatus.value, 'signed-in')
+	assert.equal(skinSiteFrameUrl.value, `${SKIN_SITE_ORIGIN}/profile`)
+	assert.equal(receiveSkinSiteMessage(message('checking'), frame), true)
+	assert.equal(skinSiteUser.value, null)
+	receiveSkinSiteMessage(message('signed-in', { uuid: 'second', username: '另一个账号' }), frame)
+	assert.deepEqual(skinSiteUser.value, { uuid: 'second', username: '另一个账号' })
+	receiveSkinSiteMessage(message('signed-out'), frame)
+	assert.equal(skinSiteUser.value, null)
+	assert.equal(skinSiteStatus.value, 'signed-out')
+	receiveSkinSiteMessage(message('error'), frame)
+	assert.equal(skinSiteStatus.value, 'error')
+	resetSkinSiteSession()
+})
+
+test('luck requests use only the connected skin site frame and validate its result', async () => {
+	const sent: Array<{ data: unknown; targetOrigin: string }> = []
+	const frame = {
+		postMessage(data: unknown, targetOrigin: string) {
+			sent.push({ data, targetOrigin })
+		},
+	} as unknown as Window
+	const sessionMessage = {
+		origin: SKIN_SITE_ORIGIN,
+		source: frame,
+		data: {
+			type: 'starlight-skin-session',
+			status: 'signed-in',
+			user: { uuid: 'lucky-user', username: 'Lucky' },
+		},
+	} as MessageEvent
+
+	resetSkinSiteSession()
+	setSkinSiteFrame(frame)
+	receiveSkinSiteMessage(sessionMessage, frame)
+	const automaticPlayersRequest = sent.at(-1)?.data as { type: string; requestId: string }
+	assert.equal(automaticPlayersRequest.type, 'starlight-skin-players-request')
+	receiveSkinSiteMessage(
+		{
+			origin: SKIN_SITE_ORIGIN,
+			source: frame,
+			data: {
+				type: 'starlight-skin-players-result',
+				requestId: automaticPlayersRequest.requestId,
+				ok: true,
+				players: [],
+			},
+		} as MessageEvent,
+		frame,
+	)
+	const result = requestSkinSiteLuck()
+	assert.equal(sent.at(-1)?.targetOrigin, SKIN_SITE_ORIGIN)
+	const request = sent.at(-1)?.data as { type: string; requestId: string }
+	assert.equal(request.type, 'starlight-skin-luck-request')
+	assert.match(request.requestId, /^skin-luck-\d+-\d+$/)
+	assert.equal(
+		receiveSkinSiteMessage(
+			{
+				origin: SKIN_SITE_ORIGIN,
+				source: frame,
+				data: {
+					type: 'starlight-skin-luck-result',
+					requestId: request.requestId,
+					ok: true,
+					luck: 88,
+				},
+			} as MessageEvent,
+			frame,
+		),
+		true,
+	)
+	assert.equal(await result, 88)
+	setSkinSiteFrame(null)
+	resetSkinSiteSession()
+})
+
+test('player requests validate identities and replace the collection atomically', async () => {
+	const sent: Array<{ data: unknown; targetOrigin: string }> = []
+	const frame = {
+		postMessage(data: unknown, targetOrigin: string) {
+			sent.push({ data, targetOrigin })
+		},
+	} as unknown as Window
+
+	resetSkinSiteSession()
+	setSkinSiteFrame(frame)
+	receiveSkinSiteMessage(
+		{
+			origin: SKIN_SITE_ORIGIN,
+			source: frame,
+			data: {
+				type: 'starlight-skin-session',
+				status: 'signed-in',
+				user: { uuid: 'skin-user', username: 'Skin User' },
+			},
+		} as MessageEvent,
+		frame,
+	)
+	const automaticRequest = sent.at(-1)?.data as { requestId: string }
+	assert.equal(skinSitePlayersStatus.value, 'checking')
+	assert.equal(
+		receiveSkinSiteMessage(
+			{
+				origin: SKIN_SITE_ORIGIN,
+				source: frame,
+				data: {
+					type: 'starlight-skin-players-result',
+					requestId: automaticRequest.requestId,
+					ok: true,
+					players: [
+						{
+							uuid: '0123456789abcdef0123456789abcdef',
+							name: 'PlayerOne',
+							isMojang: false,
+							skinState: 'ready',
+							headDataUrl: 'data:image/png;base64,SEVBRERBVEE=',
+							skinDataUrl: 'data:image/png;base64,SEVBRERBVEE=',
+							model: 'slim',
+						},
+						{
+							uuid: 'fedcba9876543210fedcba9876543210',
+							name: 'NoSkinPlayer',
+							isMojang: false,
+							skinState: 'empty',
+						},
+						{ uuid: 'invalid', name: 'Ignored', isMojang: false },
+					],
+				},
+			} as MessageEvent,
+			frame,
+		),
+		true,
+	)
+	assert.deepEqual(skinSitePlayers.value, [
+		{
+			uuid: '0123456789abcdef0123456789abcdef',
+			name: 'PlayerOne',
+			isMojang: false,
+			skinState: 'ready',
+			headDataUrl: 'data:image/png;base64,SEVBRERBVEE=',
+			skinDataUrl: 'data:image/png;base64,SEVBRERBVEE=',
+			model: 'slim',
+		},
+		{
+			uuid: 'fedcba9876543210fedcba9876543210',
+			name: 'NoSkinPlayer',
+			isMojang: false,
+			skinState: 'empty',
+		},
+	])
+	assert.equal(skinSitePlayersStatus.value, 'ready')
+
+	const transientFailure = requestSkinSitePlayers()
+	const transientFailureRequest = sent.at(-1)?.data as { requestId: string }
+	receiveSkinSiteMessage(
+		{
+			origin: SKIN_SITE_ORIGIN,
+			source: frame,
+			data: {
+				type: 'starlight-skin-players-result',
+				requestId: transientFailureRequest.requestId,
+				ok: true,
+				players: [
+					{
+						uuid: '0123456789abcdef0123456789abcdef',
+						name: 'PlayerOne Renamed',
+						isMojang: false,
+						skinState: 'error',
+					},
+				],
+			},
+		} as MessageEvent,
+		frame,
+	)
+	assert.equal((await transientFailure)[0].skinState, 'ready')
+	assert.equal(skinSitePlayers.value[0].name, 'PlayerOne Renamed')
+	assert.equal(skinSitePlayers.value[0].headDataUrl, 'data:image/png;base64,SEVBRERBVEE=')
+
+	const retry = requestSkinSitePlayers()
+	const retryRequest = sent.at(-1)?.data as { requestId: string }
+	receiveSkinSiteMessage(
+		{
+			origin: SKIN_SITE_ORIGIN,
+			source: frame,
+			data: {
+				type: 'starlight-skin-players-result',
+				requestId: retryRequest.requestId,
+				ok: true,
+				players: [],
+			},
+		} as MessageEvent,
+		frame,
+	)
+	assert.deepEqual(await retry, [])
+	assert.deepEqual(skinSitePlayers.value, [])
+	setSkinSiteFrame(null)
+	resetSkinSiteSession()
+})
+
+test('skin updates are restricted to known non-Mojang players and validated results', async () => {
+	const sent: Array<{ data: unknown; targetOrigin: string }> = []
+	const frame = {
+		postMessage(data: unknown, targetOrigin: string) {
+			sent.push({ data, targetOrigin })
+		},
+	} as unknown as Window
+
+	resetSkinSiteSession()
+	setSkinSiteFrame(frame)
+	receiveSkinSiteMessage(
+		{
+			origin: SKIN_SITE_ORIGIN,
+			source: frame,
+			data: {
+				type: 'starlight-skin-session',
+				status: 'signed-in',
+				user: { uuid: 'skin-user', username: 'Skin User' },
+			},
+		} as MessageEvent,
+		frame,
+	)
+	const automaticRequest = sent.at(-1)?.data as { requestId: string }
+	receiveSkinSiteMessage(
+		{
+			origin: SKIN_SITE_ORIGIN,
+			source: frame,
+			data: {
+				type: 'starlight-skin-players-result',
+				requestId: automaticRequest.requestId,
+				ok: true,
+				players: [
+					{
+						uuid: '0123456789abcdef0123456789abcdef',
+						name: 'PlayerOne',
+						isMojang: false,
+						skinState: 'empty',
+					},
+				],
+			},
+		} as MessageEvent,
+		frame,
+	)
+
+	const result = requestSkinSiteSkinUpdate(
+		'0123456789abcdef0123456789abcdef',
+		'data:image/png;base64,SEVBRERBVEE=',
+		'slim',
+	)
+	const request = sent.at(-1)?.data as { type: string; requestId: string; playerId: string }
+	assert.equal(request.type, 'starlight-skin-update-request')
+	assert.equal(request.playerId, '0123456789abcdef0123456789abcdef')
+	receiveSkinSiteMessage(
+		{
+			origin: SKIN_SITE_ORIGIN,
+			source: frame,
+			data: { type: 'starlight-skin-update-result', requestId: request.requestId, ok: true },
+		} as MessageEvent,
+		frame,
+	)
+	await result
+	await assert.rejects(
+		requestSkinSiteSkinUpdate(
+			'fedcba9876543210fedcba9876543210',
+			'data:image/png;base64,SEVBRERBVEE=',
+			'default',
+		),
+	)
+	setSkinSiteFrame(null)
+	resetSkinSiteSession()
+})

apps/app-frontend/src/composables/skin-site-session.ts

@@ -0,0 +1,437 @@
+import { readonly, ref, watch } from 'vue'
+
+export const SKIN_SITE_ORIGIN = 'https://skin.starlight.cool'
+export type SkinSiteUser = { uuid: string; username: string }
+export type SkinSiteStatus = 'checking' | 'signed-out' | 'signed-in' | 'error'
+export type SkinSitePlayer = {
+	uuid: string
+	name: string
+	isMojang: boolean
+	skinState: 'ready' | 'empty' | 'error'
+	headDataUrl?: string
+	skinDataUrl?: string
+	model?: 'default' | 'slim'
+}
+export type SkinSitePlayersStatus = 'idle' | 'checking' | 'ready' | 'error'
+
+const user = ref<SkinSiteUser | null>(null)
+const status = ref<SkinSiteStatus>('signed-out')
+const players = ref<SkinSitePlayer[]>([])
+const playersStatus = ref<SkinSitePlayersStatus>('idle')
+const selectedPlayerId = ref<string | null>(null)
+const frameUrl = ref(`${SKIN_SITE_ORIGIN}/`)
+let connectedFrame: Window | null = null
+let luckRequestSequence = 0
+let playersRequestSequence = 0
+let skinUpdateRequestSequence = 0
+let packTokenRequestSequence = 0
+const pendingPackTokens = new Map<
+	string,
+	{
+		resolve: (token: string) => void
+		reject: (error: Error) => void
+		timeout: ReturnType<typeof setTimeout>
+	}
+>()
+
+function rejectPendingPackTokens() {
+	for (const request of pendingPackTokens.values()) {
+		clearTimeout(request.timeout)
+		request.reject(new Error('StarLight 登录状态已变化，请重试。'))
+	}
+	pendingPackTokens.clear()
+}
+
+export function requestSkinSiteDownloadToken(): Promise<string> {
+	if (!connectedFrame || status.value !== 'signed-in' || !user.value) {
+		return Promise.reject(
+			new Error('请先在启动器中登录 StarLight 皮肤站，再下载整合包。无需选择玩家。'),
+		)
+	}
+	const requestId = `pack-token-${Date.now()}-${++packTokenRequestSequence}`
+	return new Promise((resolve, reject) => {
+		const timeout = setTimeout(() => {
+			pendingPackTokens.delete(requestId)
+			reject(new Error('获取 StarLight 登录凭据超时，请重试。'))
+		}, 10_000)
+		pendingPackTokens.set(requestId, { resolve, reject, timeout })
+		try {
+			connectedFrame?.postMessage(
+				{ type: 'starlight-pack-token-request', requestId },
+				SKIN_SITE_ORIGIN,
+			)
+		} catch {
+			clearTimeout(timeout)
+			pendingPackTokens.delete(requestId)
+			reject(new Error('无法读取 StarLight 登录状态，请重新登录。'))
+		}
+	})
+}
+
+type PendingLuckRequest = {
+	resolve: (luck: number) => void
+	reject: (error: Error) => void
+	timeout: ReturnType<typeof setTimeout>
+}
+
+const pendingLuckRequests = new Map<string, PendingLuckRequest>()
+type PendingPlayersRequest = {
+	resolve: (players: SkinSitePlayer[]) => void
+	reject: (error: Error) => void
+	timeout: ReturnType<typeof setTimeout>
+}
+const pendingPlayersRequests = new Map<string, PendingPlayersRequest>()
+type PendingSkinUpdateRequest = {
+	resolve: () => void
+	reject: (error: Error) => void
+	timeout: ReturnType<typeof setTimeout>
+}
+const pendingSkinUpdateRequests = new Map<string, PendingSkinUpdateRequest>()
+
+function isSafePngDataUrl(value: unknown, maxLength: number) {
+	return (
+		typeof value === 'string' &&
+		value.length <= maxLength &&
+		/^data:image\/png;base64,[a-z0-9+/]+={0,2}$/i.test(value)
+	)
+}
+
+function hasSafeSkinHead(player: SkinSitePlayer) {
+	if (!['ready', 'empty', 'error'].includes(player.skinState)) return false
+	if (player.skinState !== 'ready') return player.headDataUrl === undefined
+	return (
+		isSafePngDataUrl(player.headDataUrl, 100_000) &&
+		(player.skinDataUrl === undefined || isSafePngDataUrl(player.skinDataUrl, 2_000_000)) &&
+		(player.model === undefined || player.model === 'default' || player.model === 'slim')
+	)
+}
+
+export const skinSiteUser = readonly(user)
+export const skinSiteStatus = readonly(status)
+export const skinSitePlayers = readonly(players)
+export const skinSitePlayersStatus = readonly(playersStatus)
+export const selectedSkinSitePlayerId = readonly(selectedPlayerId)
+export const skinSiteFrameUrl = readonly(frameUrl)
+
+export async function waitForSkinSiteSession() {
+	if (status.value !== 'checking') return
+	await new Promise<void>((resolve, reject) => {
+		const stop = watch(status, next => {
+			if (next === 'checking') return
+			clearTimeout(timer)
+			stop()
+			resolve()
+		})
+		const timer = setTimeout(() => {
+			stop()
+			reject(new Error('皮肤站登录状态仍在检查，请稍后重试。'))
+		}, 10_000)
+	})
+}
+
+function rejectPendingLuckRequests(message: string) {
+	for (const request of pendingLuckRequests.values()) {
+		clearTimeout(request.timeout)
+		request.reject(new Error(message))
+	}
+	pendingLuckRequests.clear()
+}
+
+function rejectPendingPlayersRequests(message: string) {
+	for (const request of pendingPlayersRequests.values()) {
+		clearTimeout(request.timeout)
+		request.reject(new Error(message))
+	}
+	pendingPlayersRequests.clear()
+}
+
+function rejectPendingSkinUpdateRequests(message: string) {
+	for (const request of pendingSkinUpdateRequests.values()) {
+		clearTimeout(request.timeout)
+		request.reject(new Error(message))
+	}
+	pendingSkinUpdateRequests.clear()
+}
+
+export function setSkinSiteFrame(frame: Window | null) {
+	if (frame && !user.value) status.value = 'checking'
+	if (connectedFrame === frame) return
+	rejectPendingPackTokens()
+	rejectPendingLuckRequests('The skin site connection changed.')
+	rejectPendingPlayersRequests('The skin site connection changed.')
+	rejectPendingSkinUpdateRequests('The skin site connection changed.')
+	connectedFrame = frame
+}
+
+export function selectSkinSitePlayer(playerId: string | null) {
+	if (playerId === null) {
+		selectedPlayerId.value = null
+		return
+	}
+	if (players.value.some((player) => player.uuid === playerId)) selectedPlayerId.value = playerId
+}
+
+export function openSkinSiteLogin() {
+	frameUrl.value = `${SKIN_SITE_ORIGIN}/login`
+}
+
+export function resetSkinSiteSession() {
+	rejectPendingPackTokens()
+	rejectPendingLuckRequests('The skin site session ended.')
+	rejectPendingPlayersRequests('The skin site session ended.')
+	rejectPendingSkinUpdateRequests('The skin site session ended.')
+	user.value = null
+	status.value = 'signed-out'
+	players.value = []
+	playersStatus.value = 'idle'
+	selectedPlayerId.value = null
+}
+
+export function requestSkinSiteSkinUpdate(
+	playerId: string,
+	textureDataUrl: string,
+	model: 'default' | 'slim',
+) {
+	const player = players.value.find((candidate) => candidate.uuid === playerId)
+	if (!connectedFrame || status.value !== 'signed-in' || !user.value) {
+		return Promise.reject(new Error('Sign in to the skin site before changing a skin.'))
+	}
+	if (!player || player.isMojang) {
+		return Promise.reject(new Error('This skin site player cannot be changed.'))
+	}
+	if (!isSafePngDataUrl(textureDataUrl, 2_000_000)) {
+		return Promise.reject(new Error('The selected skin texture is invalid or too large.'))
+	}
+
+	const requestId = `skin-update-${Date.now()}-${++skinUpdateRequestSequence}`
+	return new Promise<void>((resolve, reject) => {
+		const timeout = setTimeout(() => {
+			pendingSkinUpdateRequests.delete(requestId)
+			reject(new Error('The skin site update timed out.'))
+		}, 20_000)
+		pendingSkinUpdateRequests.set(requestId, { resolve, reject, timeout })
+		try {
+			connectedFrame?.postMessage(
+				{
+					type: 'starlight-skin-update-request',
+					requestId,
+					playerId,
+					textureDataUrl,
+					model,
+				},
+				SKIN_SITE_ORIGIN,
+			)
+		} catch (error) {
+			clearTimeout(timeout)
+			pendingSkinUpdateRequests.delete(requestId)
+			reject(error instanceof Error ? error : new Error(String(error)))
+		}
+	})
+}
+
+export function requestSkinSitePlayers() {
+	if (!connectedFrame || status.value !== 'signed-in' || !user.value) {
+		return Promise.reject(new Error('Sign in to the skin site before requesting players.'))
+	}
+
+	playersStatus.value = 'checking'
+	const requestId = `skin-players-${Date.now()}-${++playersRequestSequence}`
+	return new Promise<SkinSitePlayer[]>((resolve, reject) => {
+		const timeout = setTimeout(() => {
+			pendingPlayersRequests.delete(requestId)
+			playersStatus.value = 'error'
+			reject(new Error('The skin site player request timed out.'))
+		}, 30_000)
+		pendingPlayersRequests.set(requestId, { resolve, reject, timeout })
+		try {
+			connectedFrame?.postMessage(
+				{ type: 'starlight-skin-players-request', requestId },
+				SKIN_SITE_ORIGIN,
+			)
+		} catch (error) {
+			clearTimeout(timeout)
+			pendingPlayersRequests.delete(requestId)
+			playersStatus.value = 'error'
+			reject(error instanceof Error ? error : new Error(String(error)))
+		}
+	})
+}
+
+export function requestSkinSiteLuck() {
+	if (!connectedFrame || status.value !== 'signed-in' || !user.value) {
+		return Promise.reject(new Error('Sign in to the skin site before requesting luck.'))
+	}
+
+	const requestId = `skin-luck-${Date.now()}-${++luckRequestSequence}`
+	return new Promise<number>((resolve, reject) => {
+		const timeout = setTimeout(() => {
+			pendingLuckRequests.delete(requestId)
+			reject(new Error('The skin site luck request timed out.'))
+		}, 12_000)
+		pendingLuckRequests.set(requestId, { resolve, reject, timeout })
+		try {
+			connectedFrame?.postMessage(
+				{ type: 'starlight-skin-luck-request', requestId },
+				SKIN_SITE_ORIGIN,
+			)
+		} catch (error) {
+			clearTimeout(timeout)
+			pendingLuckRequests.delete(requestId)
+			reject(error instanceof Error ? error : new Error(String(error)))
+		}
+	})
+}
+
+export function receiveSkinSiteMessage(event: MessageEvent, frame: Window | null) {
+	if (!frame || event.source !== frame || event.origin !== SKIN_SITE_ORIGIN) return false
+	const data = event.data
+	if (!data || typeof data !== 'object') return false
+	if (data.type === 'starlight-pack-token-result') {
+		const pending = pendingPackTokens.get(data.requestId)
+		if (!pending) return false
+		clearTimeout(pending.timeout)
+		pendingPackTokens.delete(data.requestId)
+		if (
+			status.value === 'signed-in' &&
+			typeof data.token === 'string' &&
+			data.token.length > 0 &&
+			data.token.length <= 16_384 &&
+			!/\s/.test(data.token)
+		) {
+			pending.resolve(data.token)
+		} else pending.reject(new Error('StarLight 登录凭据不可用，请重新登录。'))
+		return true
+	}
+
+	if (data.type === 'starlight-skin-players-result') {
+		if (typeof data.requestId !== 'string') return false
+		const pending = pendingPlayersRequests.get(data.requestId)
+		if (!pending) return false
+		clearTimeout(pending.timeout)
+		pendingPlayersRequests.delete(data.requestId)
+		if (data.ok === true && Array.isArray(data.players)) {
+			const nextPlayers = data.players.filter(
+				(player: unknown): player is SkinSitePlayer =>
+					typeof player === 'object' &&
+					player !== null &&
+					typeof (player as SkinSitePlayer).uuid === 'string' &&
+					/^[0-9a-f-]{32,36}$/i.test((player as SkinSitePlayer).uuid) &&
+					typeof (player as SkinSitePlayer).name === 'string' &&
+					(player as SkinSitePlayer).name.length > 0 &&
+					(player as SkinSitePlayer).name.length <= 64 &&
+					typeof (player as SkinSitePlayer).isMojang === 'boolean' &&
+					hasSafeSkinHead(player as SkinSitePlayer),
+			)
+			const previousPlayers = new Map(players.value.map((player) => [player.uuid, player]))
+			players.value = nextPlayers.map((player) => {
+				const previous = previousPlayers.get(player.uuid)
+				return player.skinState === 'error' && previous?.skinState === 'ready'
+					? { ...player, ...previous, name: player.name, isMojang: player.isMojang }
+					: player
+			})
+			if (
+				selectedPlayerId.value &&
+				!nextPlayers.some((player) => player.uuid === selectedPlayerId.value)
+			) {
+				selectedPlayerId.value = null
+			}
+			playersStatus.value = 'ready'
+			pending.resolve(players.value)
+		} else {
+			playersStatus.value = 'error'
+			pending.reject(
+				new Error(
+					typeof data.error === 'string' && data.error
+						? data.error.slice(0, 300)
+						: 'The skin site returned an invalid player list.',
+				),
+			)
+		}
+		return true
+	}
+
+	if (data.type === 'starlight-skin-luck-result') {
+		if (typeof data.requestId !== 'string') return false
+		const pending = pendingLuckRequests.get(data.requestId)
+		if (!pending) return false
+		clearTimeout(pending.timeout)
+		pendingLuckRequests.delete(data.requestId)
+		if (
+			data.ok === true &&
+			typeof data.luck === 'number' &&
+			Number.isFinite(data.luck) &&
+			data.luck >= 0 &&
+			data.luck <= 100
+		) {
+			pending.resolve(data.luck)
+		} else {
+			pending.reject(
+				new Error(
+					typeof data.error === 'string' && data.error
+						? data.error.slice(0, 300)
+						: 'The skin site returned an invalid luck result.',
+				),
+			)
+		}
+		return true
+	}
+
+	if (data.type === 'starlight-skin-update-result') {
+		if (typeof data.requestId !== 'string') return false
+		const pending = pendingSkinUpdateRequests.get(data.requestId)
+		if (!pending) return false
+		clearTimeout(pending.timeout)
+		pendingSkinUpdateRequests.delete(data.requestId)
+		if (data.ok === true) pending.resolve()
+		else {
+			pending.reject(
+				new Error(
+					typeof data.error === 'string' && data.error
+						? data.error.slice(0, 300)
+						: 'The skin site rejected the skin update.',
+				),
+			)
+		}
+		return true
+	}
+
+	if (data.type !== 'starlight-skin-session') return false
+	if (!['checking', 'signed-out', 'signed-in', 'error'].includes(data.status)) return false
+	let refreshPlayers = false
+	if (data.status === 'signed-in') {
+		if (
+			!data.user ||
+			typeof data.user.uuid !== 'string' ||
+			typeof data.user.username !== 'string' ||
+			!data.user.uuid ||
+			!data.user.username ||
+			data.user.username.length > 256
+		)
+			return false
+		if (user.value?.uuid && user.value.uuid !== data.user.uuid) {
+			rejectPendingPackTokens()
+			rejectPendingPlayersRequests('The skin site account changed.')
+			rejectPendingSkinUpdateRequests('The skin site account changed.')
+			players.value = []
+			playersStatus.value = 'idle'
+			selectedPlayerId.value = null
+		}
+		user.value = { uuid: data.user.uuid, username: data.user.username }
+		if ([`${SKIN_SITE_ORIGIN}/`, `${SKIN_SITE_ORIGIN}/login`].includes(frameUrl.value)) {
+			frameUrl.value = `${SKIN_SITE_ORIGIN}/profile`
+		}
+		refreshPlayers = true
+	} else {
+		rejectPendingPackTokens()
+		rejectPendingLuckRequests('The skin site session is unavailable.')
+		rejectPendingPlayersRequests('The skin site session is unavailable.')
+		rejectPendingSkinUpdateRequests('The skin site session is unavailable.')
+		user.value = null
+		players.value = []
+		playersStatus.value = 'idle'
+		selectedPlayerId.value = null
+	}
+	status.value = data.status
+	if (refreshPlayers) void requestSkinSitePlayers().catch(() => {})
+	return true
+}

apps/app-frontend/src/composables/useDropImport.ts

@@ -13,9 +13,9 @@ import type {
 	SymlinkMethodChoice,
 } from '@modrinth/ui'
 import { useDebugLogger, useGlobalDrop, useInstanceContext, useVIntl } from '@modrinth/ui'
+import { join } from '@tauri-apps/api/path'
 import { computed, type ComputedRef, nextTick, ref } from 'vue'
 import type { Router } from 'vue-router'
-import { join } from '@tauri-apps/api/path'
 
 import {
 	classifyDroppedItem,
@@ -1412,10 +1412,7 @@ export function useDropImport(options: DropImportOptions) {
 		cleanupLauncherZipTemp()
 	}
 
-	function resolvedInstancePath(
-		inst: SelectedInstance,
-		ctx: ImportContext | null,
-	): string | undefined {
+	function resolvedInstancePath(inst: SelectedInstance): string | undefined {
 		if (inst.compatibleMode) return inst.versionPath
 		return inst.path
 	}

apps/app-frontend/src/composables/useHostedCreation.ts

@@ -0,0 +1,73 @@
+import { invoke } from '@tauri-apps/api/core'
+import { ref } from 'vue'
+
+import { hostedCreate } from '../helpers/hosted-packs.ts'
+import { runHostedSync } from './useHostedSync.ts'
+
+const installing = ref(false)
+const installError = ref('')
+const createdInstance = ref<string>()
+const completed = ref(false)
+let generation = 0
+
+export function forgetHostedCreation(instanceId: string) {
+	if (createdInstance.value !== instanceId) return
+	generation++
+	createdInstance.value = undefined
+	completed.value = false
+	installError.value = ''
+}
+
+export function markHostedCreationCompleted(instanceId: string) {
+	if (createdInstance.value !== instanceId) return
+	installError.value = ''
+	completed.value = true
+}
+
+export function markHostedCreationFailed(instanceId: string, cause: unknown) {
+	if (createdInstance.value !== instanceId) return
+	completed.value = false
+	installError.value = String(cause)
+}
+
+export function useHostedCreation() {
+	function acknowledge(instanceId: string) {
+		if (completed.value && createdInstance.value === instanceId) {
+			createdInstance.value = undefined
+			completed.value = false
+		}
+	}
+	async function install(gameDirRoot?: string | null) {
+		if (installing.value) return
+		installing.value = true
+		installError.value = ''
+		const attempt = generation
+		try {
+			if (createdInstance.value) {
+				const instance = await invoke<unknown | null>('plugin:instance|instance_get', {
+					instanceId: createdInstance.value,
+				})
+				if (attempt !== generation) return
+				if (!instance) {
+					createdInstance.value = undefined
+					completed.value = false
+				}
+			}
+			if (completed.value) return createdInstance.value
+			createdInstance.value ??= await hostedCreate(gameDirRoot)
+			const instanceId = createdInstance.value
+			await runHostedSync(instanceId)
+			if (attempt !== generation) return
+			markHostedCreationCompleted(instanceId)
+			return instanceId
+		} catch (cause) {
+			if (attempt === generation) {
+				if (createdInstance.value) markHostedCreationFailed(createdInstance.value, cause)
+				else installError.value = String(cause)
+			}
+		} finally {
+			installing.value = false
+		}
+	}
+	return { installing, installError, createdInstance, completed, acknowledge, install }
+}

apps/app-frontend/src/composables/useHostedSync.ts

@@ -0,0 +1,66 @@
+import { computed, reactive } from 'vue'
+
+import { hostedSync, type HostedSyncResult } from '../helpers/hosted-packs.ts'
+
+const tasks = reactive(
+	new Map<string, { busy: boolean; result: HostedSyncResult | null; error: string }>(),
+)
+const inFlight = new Map<string, Promise<HostedSyncResult>>()
+
+function getTask(instanceId: string) {
+	if (!tasks.has(instanceId)) tasks.set(instanceId, { busy: false, result: null, error: '' })
+	return tasks.get(instanceId)!
+}
+
+/**
+ * Run one authoritative StarLight synchronization per instance. Every retry
+ * surface uses this function so the full pack transaction, its progress and
+ * its final result cannot diverge between pages.
+ */
+export function runHostedSync(instanceId: string): Promise<HostedSyncResult> {
+	const existing = inFlight.get(instanceId)
+	if (existing) return existing
+
+	const current = getTask(instanceId)
+	current.busy = true
+	current.error = ''
+	current.result = null
+	const request = hostedSync(instanceId)
+		.then((result) => {
+			current.result = result
+			return result
+		})
+		.catch((error) => {
+			current.error = String(error)
+			throw error
+		})
+		.finally(() => {
+			current.busy = false
+			inFlight.delete(instanceId)
+		})
+	inFlight.set(instanceId, request)
+	return request
+}
+
+export function useHostedSync(instanceId: () => string) {
+	const task = computed(() => {
+		return getTask(instanceId())
+	})
+
+	async function sync() {
+		const id = instanceId()
+		if (task.value.busy) return undefined
+		try {
+			return await runHostedSync(id)
+		} catch {
+			return undefined
+		}
+	}
+
+	return {
+		busy: computed(() => task.value.busy),
+		result: computed(() => task.value.result),
+		error: computed(() => task.value.error),
+		sync,
+	}
+}

apps/app-frontend/src/composables/useInstanceConsole.ts

@@ -7,7 +7,7 @@ import {
 	get_minecraft_latest_log_cursor,
 } from '@/helpers/logs'
 
-import { mergeLiveLogHistory } from './console-history'
+import { createLatestLogReader } from './latest-log-reader'
 
 type ConsoleState = ReturnType<typeof createConsoleState>
 
@@ -26,6 +26,7 @@ interface InstanceConsoleEntry {
 	historicalCache: Map<string, string>
 	logList: LogEntry[] | null
 	liveHistoryHydration: Promise<void> | null
+	latestLog: ReturnType<typeof createLatestLogReader>
 }
 
 const instances = new Map<string, InstanceConsoleEntry>()
@@ -34,12 +35,20 @@ function getOrCreate(instanceId: string): InstanceConsoleEntry {
 	let entry = instances.get(instanceId)
 	if (entry) return entry
 
+	const liveConsole = createConsoleState()
 	entry = {
-		liveConsole: createConsoleState(),
+		liveConsole,
 		historicalConsole: createConsoleState(),
 		historicalCache: new Map(),
 		logList: null,
 		liveHistoryHydration: null,
+		latestLog: createLatestLogReader(
+			(cursor) => get_minecraft_latest_log_cursor(instanceId, cursor),
+			(output, replace) => {
+				if (replace) liveConsole.clear()
+				void liveConsole.addLegacyLog(output)
+			},
+		),
 	}
 	instances.set(instanceId, entry)
 	return entry
@@ -47,25 +56,17 @@ function getOrCreate(instanceId: string): InstanceConsoleEntry {
 
 async function hydrate(instanceId: string): Promise<void> {
 	const entry = getOrCreate(instanceId)
-	if (entry.liveConsole.output.value.length > 0) return
-
 	if (entry.liveHistoryHydration) {
 		return entry.liveHistoryHydration
 	}
 
 	const hydration = (async () => {
-		const [latestLog, buffer] = await Promise.all([
-			get_minecraft_latest_log_cursor(instanceId, 0)
-				.then((result) => result.output)
-				.catch(() => ''),
-			get_live_log_buffer(instanceId),
-		])
-
-		if (entry.liveConsole.output.value.length > 0) return
-
-		const history = mergeLiveLogHistory(latestLog, buffer)
-		if (history) {
-			await entry.liveConsole.addLegacyLog(history)
+		await entry.latestLog.refresh().catch(console.warn)
+		if (!entry.latestLog.active && entry.liveConsole.output.value.length === 0) {
+			const buffer = await get_live_log_buffer(instanceId)
+			if (!entry.latestLog.active && entry.liveConsole.output.value.length === 0) {
+				await entry.liveConsole.addLegacyLog(buffer)
+			}
 		}
 	})()
 
@@ -108,11 +109,13 @@ function invalidate(instanceId: string): void {
 
 async function clearLive(instanceId: string): Promise<void> {
 	const entry = getOrCreate(instanceId)
+	entry.latestLog.clear()
 	entry.liveConsole.clear()
 	await clear_log_buffer(instanceId).catch(() => {})
 }
 
 async function destroy(instanceId: string): Promise<void> {
+	instances.get(instanceId)?.latestLog.reset()
 	instances.delete(instanceId)
 	await clear_log_buffer(instanceId).catch(() => {})
 }
@@ -127,6 +130,13 @@ export function useInstanceConsole(instanceId: string) {
 		getHistoricalContent: (filename: string) => getHistoricalContent(instanceId, filename),
 		invalidate: () => invalidate(instanceId),
 		clearLive: () => clearLive(instanceId),
+		refreshLive: () => entry.latestLog.refresh(),
+		flushLive: () => entry.latestLog.flush(),
+		acceptsProcessLogs: () => !entry.latestLog.active,
+		resetLive: () => {
+			entry.latestLog.reset()
+			entry.liveConsole.clear()
+		},
 		destroy: () => destroy(instanceId),
 	}
 }

apps/app-frontend/src/composables/useInstanceMode.ts

@@ -0,0 +1,27 @@
+import { useMutation, useQuery, useQueryClient } from '@tanstack/vue-query'
+import { computed, type MaybeRefOrGetter, toValue } from 'vue'
+
+import { getInstanceMode, type InstanceMode, setInstanceMode } from '@/helpers/hosted-packs'
+
+export const instanceModeKey = (instanceId: string) => ['instance-mode', instanceId] as const
+
+export function useInstanceMode(instanceId: MaybeRefOrGetter<string>) {
+	return useQuery({
+		queryKey: computed(() => instanceModeKey(toValue(instanceId))),
+		queryFn: () => getInstanceMode(toValue(instanceId)),
+		enabled: computed(() => !!toValue(instanceId)),
+		staleTime: 30_000,
+	})
+}
+
+export function useSetInstanceMode() {
+	const client = useQueryClient()
+	return useMutation({
+		mutationFn: ({ instanceId, mode }: { instanceId: string; mode: InstanceMode }) =>
+			setInstanceMode(instanceId, mode),
+		onMutate: ({ instanceId }) => client.cancelQueries({ queryKey: instanceModeKey(instanceId) }),
+		onSuccess: (_, { instanceId, mode }) => client.setQueryData(instanceModeKey(instanceId), mode),
+		onError: (_, { instanceId }) =>
+			client.invalidateQueries({ queryKey: instanceModeKey(instanceId) }),
+	})
+}

apps/app-frontend/src/data/about/team.json

@@ -1,4 +1,3 @@
-
 [
   {
     "name": "Ax_Tps",
@@ -9,6 +8,7 @@
   {
     "name": "Disy920",
     "avatar": "Disy920.png",
-    "url": "https://space.bilibili.com/231241189?spm_id_from=333.337.0.0"
+    "url": "https://space.bilibili.com/231241189?spm_id_from=333.337.0.0",
+    "experience": "color-mine"
   }
 ]

apps/app-frontend/src/helpers/auth.js

@@ -14,8 +14,8 @@ import { invoke } from '@tauri-apps/api/core'
 // }
 
 /**
- * Check if the authentication servers are reachable, throwing an exception if
- * not reachable.
+ * Check if the StarLight authentication server is reachable, throwing an
+ * exception if it is not reachable.
  */
 export async function check_reachable() {
 	await invoke('plugin:auth|check_reachable')

apps/app-frontend/src/helpers/hosted-download-failures.test.ts

@@ -0,0 +1,52 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { createHostedDownloadFailures } from './hosted-download-failures.ts'
+
+test('retry clears only its own failure before progress arrives and ignores late old events', () => {
+	const state = createHostedDownloadFailures()
+	const failed = (instanceId: string, loader: string, error: string) => ({
+		fraction: null,
+		loader_uuid: loader,
+		event: { type: 'hosted_pack_sync', instance_id: instanceId, instance_name: instanceId, error },
+	})
+	const oldFailure = failed('one', 'old', 'old failure')
+	state.update(oldFailure)
+	state.update(failed('two', 'other', 'other failure'))
+	state.begin('one', state.values())
+	assert.equal(state.has('one'), false)
+	assert.equal(state.has('two'), true)
+	assert.equal(state.isRetired('old'), true)
+	state.update(oldFailure)
+	assert.equal(state.has('one'), false)
+	state.update(failed('one', 'new', 'new failure'))
+	state.update({ ...oldFailure, fraction: 0.5 })
+	assert.equal(
+		state.values().find((bar) => bar.bar_type?.instance_id === 'one')?.message,
+		'new failure',
+	)
+})
+
+test('a new native task retires the previous failed task without a frontend retry', () => {
+	const state = createHostedDownloadFailures()
+	const old = {
+		fraction: null,
+		loader_uuid: 'old',
+		event: { type: 'hosted_pack_sync', instance_id: 'instance', error: 'old failure' },
+	}
+	state.update(old)
+	state.update({ fraction: 0, loader_uuid: 'new', event: { ...old.event, error: null } })
+	state.update(old)
+	assert.equal(state.has('instance'), false)
+})
+
+test('late failure from an older active task cannot replace the new task', () => {
+	const state = createHostedDownloadFailures()
+	const event = { type: 'hosted_pack_sync', instance_id: 'instance' }
+	state.update({ fraction: 0.5, loader_uuid: 'old', event })
+	state.update({ fraction: 0, loader_uuid: 'new', event })
+	state.update({ fraction: null, loader_uuid: 'old', event: { ...event, error: 'old failure' } })
+	assert.equal(state.has('instance'), false)
+	assert.equal(state.isRetired('old'), true)
+	assert.equal(state.isRetired('new'), false)
+})

apps/app-frontend/src/helpers/hosted-download-failures.ts

@@ -0,0 +1,53 @@
+import type { LoadingBar } from './state.ts'
+
+export function createHostedDownloadFailures() {
+	const failures = new Map<string, LoadingBar>()
+	const retired = new Set<string>()
+	const currentTasks = new Map<string, string>()
+	return {
+		values: () => [...failures.values()],
+		has: (instanceId: string) => failures.has(instanceId),
+		isRetired: (id: string) => retired.has(id),
+		begin(instanceId: string, bars: LoadingBar[]) {
+			const current = currentTasks.get(instanceId)
+			if (current) retired.add(current)
+			currentTasks.delete(instanceId)
+			const previous = failures.get(instanceId)
+			if (previous) retired.add(String(previous.loading_bar_uuid))
+			for (const bar of bars) {
+				if (bar.bar_type?.type === 'hosted_pack_sync' && bar.bar_type.instance_id === instanceId) {
+					retired.add(String(bar.loading_bar_uuid))
+				}
+			}
+			failures.delete(instanceId)
+		},
+		update(payload: {
+			fraction: number | null
+			loader_uuid: string
+			event: LoadingBar['bar_type']
+		}) {
+			const event = payload.event
+			if (
+				event?.type !== 'hosted_pack_sync' ||
+				!event.instance_id ||
+				retired.has(payload.loader_uuid)
+			)
+				return
+			const current = currentTasks.get(event.instance_id)
+			if (current && current !== payload.loader_uuid) retired.add(current)
+			currentTasks.set(event.instance_id, payload.loader_uuid)
+			if (payload.fraction === null && event.error) {
+				failures.set(event.instance_id, {
+					loading_bar_uuid: payload.loader_uuid,
+					bar_type: event,
+					title: event.instance_name,
+					message: event.error,
+					total: 0,
+					current: 0,
+				})
+			} else {
+				failures.delete(event.instance_id)
+			}
+		},
+	}
+}

apps/app-frontend/src/helpers/hosted-install-retry.test.ts

@@ -0,0 +1,124 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import {
+	hostedRetryRoute,
+	hostedRuntimeRetryInstanceId,
+	retryInstallJob,
+} from './hosted-install-retry.ts'
+import type { InstallJobSnapshot } from './install.ts'
+
+function job(overrides: Partial<InstallJobSnapshot> = {}): InstallJobSnapshot {
+	return {
+		job_id: 'job',
+		instance_id: 'local:instance',
+		source_instance_id: null,
+		instance_deleted: false,
+		kind: 'install_existing_instance',
+		status: 'failed',
+		execution_mode: 'normal',
+		provider: 'minecraft',
+		target: { type: 'existing_instance', instance_id: 'local:instance' },
+		phase: 'downloading_minecraft',
+		progress: null,
+		details: { type: 'empty' },
+		parallel: null,
+		display: null,
+		error: null,
+		rollback_error: null,
+		pause_reason: null,
+		upgrade_result: null,
+		created: '2026-09-18T00:00:00Z',
+		modified: '2026-09-18T00:00:00Z',
+		finished: '2026-09-18T00:00:01Z',
+		summary: {
+			files_completed: 0,
+			files_total: null,
+			bytes_downloaded: 0,
+			bytes_total: null,
+			speed_bytes_per_second: null,
+			eta_seconds: null,
+			source: null,
+			fallback_count: 0,
+		},
+		items: [],
+		...overrides,
+	}
+}
+
+test('StarLight runtime retries keep the existing instance identity', () => {
+	assert.equal(hostedRuntimeRetryInstanceId(job()), 'local:instance')
+	assert.equal(
+		hostedRuntimeRetryInstanceId(
+			job({ instance_id: null, target: { type: 'existing_instance', instance_id: 'target' } }),
+		),
+		'target',
+	)
+})
+
+test('deleted and unrelated install jobs do not enter the StarLight runtime retry path', () => {
+	assert.equal(hostedRuntimeRetryInstanceId(job({ instance_deleted: true })), null)
+	assert.equal(hostedRuntimeRetryInstanceId(job({ kind: 'create_instance' })), null)
+})
+
+test('the hosted retry link targets the current instance content route', () => {
+	assert.equal(
+		hostedRetryRoute('local:instance/with space'),
+		'/instance/local%3Ainstance%2Fwith%20space',
+	)
+	assert.doesNotMatch(hostedRetryRoute('local:instance'), /\/mods$/)
+})
+
+test('a StarLight runtime failure retries the complete hosted transaction only', async () => {
+	const calls: string[] = []
+	const result = await retryInstallJob(job(), {
+		getInstanceMode: async (instanceId) => {
+			calls.push(`mode:${instanceId}`)
+			return 'starlight'
+		},
+		retryHosted: async (instanceId, sourceJobId) => {
+			calls.push(`hosted:${instanceId}:${sourceJobId}`)
+		},
+		retryGeneric: async (jobId) => {
+			calls.push(`generic:${jobId}`)
+			return job()
+		},
+	})
+	assert.equal(result, null)
+	assert.deepEqual(calls, ['mode:local:instance', 'hosted:local:instance:job'])
+})
+
+test('a Local runtime failure keeps the generic retry path', async () => {
+	const replacement = job({ job_id: 'replacement', status: 'queued' })
+	const calls: string[] = []
+	const result = await retryInstallJob(job(), {
+		getInstanceMode: async () => 'local',
+		retryHosted: async () => {
+			calls.push('hosted')
+		},
+		retryGeneric: async (jobId) => {
+			calls.push(`generic:${jobId}`)
+			return replacement
+		},
+	})
+	assert.equal(result, replacement)
+	assert.deepEqual(calls, ['generic:job'])
+})
+
+test('mode lookup failures never fall back to an incomplete generic retry', async () => {
+	let genericCalls = 0
+	await assert.rejects(
+		retryInstallJob(job(), {
+			getInstanceMode: async () => {
+				throw new Error('instance unavailable')
+			},
+			retryHosted: async () => {},
+			retryGeneric: async () => {
+				genericCalls++
+				return job()
+			},
+		}),
+		/instance unavailable/,
+	)
+	assert.equal(genericCalls, 0)
+})

apps/app-frontend/src/helpers/hosted-install-retry.ts

@@ -0,0 +1,34 @@
+import type { InstallJobSnapshot } from './install.ts'
+
+interface InstallRetryDependencies {
+	getInstanceMode: (instanceId: string) => Promise<'starlight' | 'local'>
+	retryHosted: (instanceId: string, sourceJobId: string) => Promise<void>
+	retryGeneric: (jobId: string) => Promise<InstallJobSnapshot>
+}
+
+/**
+ * Minecraft installation jobs started by StarLight synchronization are only
+ * one stage of the full operation. Retrying that stage alone leaves the
+ * pending pack journal unapplied, so these jobs must resume through
+ * `hostedSync` instead of the generic install-job retry command.
+ */
+export function hostedRuntimeRetryInstanceId(job: InstallJobSnapshot): string | null {
+	if (job.kind !== 'install_existing_instance' || job.instance_deleted) return null
+	return job.instance_id ?? job.target.instance_id ?? null
+}
+
+export function hostedRetryRoute(instanceId: string): string {
+	return `/instance/${encodeURIComponent(instanceId)}`
+}
+
+export async function retryInstallJob(
+	job: InstallJobSnapshot,
+	dependencies: InstallRetryDependencies,
+): Promise<InstallJobSnapshot | null> {
+	const instanceId = hostedRuntimeRetryInstanceId(job)
+	if (instanceId && (await dependencies.getInstanceMode(instanceId)) === 'starlight') {
+		await dependencies.retryHosted(instanceId, job.job_id)
+		return null
+	}
+	return dependencies.retryGeneric(job.job_id)
+}

apps/app-frontend/src/helpers/hosted-packs.ts

@@ -0,0 +1,112 @@
+import { invoke } from '@tauri-apps/api/core'
+
+import {
+	requestSkinSiteDownloadToken,
+	skinSiteStatus,
+	skinSiteUser,
+	waitForSkinSiteSession,
+} from '../composables/skin-site-session.ts'
+
+let sessionUpdate: Promise<void> = Promise.resolve()
+const attemptListeners = new Set<(instanceId: string) => void>()
+
+export function onHostedPackAttemptStarted(listener: (instanceId: string) => void) {
+	attemptListeners.add(listener)
+	return () => {
+		attemptListeners.delete(listener)
+	}
+}
+
+function startHostedPackAttempt(instanceId: string) {
+	for (const listener of attemptListeners) listener(instanceId)
+}
+
+export function clearHostedSession(): Promise<void> {
+	const update = sessionUpdate
+		.catch(() => {})
+		.then(() => invokeHosted<void>('plugin:install|hosted_set_session', { token: null }))
+	sessionUpdate = update
+	return update
+}
+
+export async function prepareHostedSession(): Promise<void> {
+	await waitForSkinSiteSession()
+	const userId = skinSiteUser.value?.uuid
+	const token = await requestSkinSiteDownloadToken()
+	const update = sessionUpdate
+		.catch(() => {})
+		.then(async () => {
+			if (skinSiteStatus.value !== 'signed-in' || skinSiteUser.value?.uuid !== userId) {
+				throw new Error('StarLight 登录状态已变化，请重试。')
+			}
+			await invokeHosted<void>('plugin:install|hosted_set_session', { token })
+		})
+	sessionUpdate = update
+	await update
+}
+
+async function invokeWithSession<T>(command: string, args?: Record<string, unknown>): Promise<T> {
+	await prepareHostedSession()
+	return invokeHosted<T>(command, args)
+}
+
+async function invokeHosted<T>(command: string, args?: Record<string, unknown>): Promise<T> {
+	try {
+		return await invoke<T>(command, args)
+	} catch (cause) {
+		if (
+			!(cause instanceof Error) &&
+			typeof cause === 'object' &&
+			cause !== null &&
+			'message' in cause &&
+			typeof cause.message === 'string'
+		) {
+			throw new Error(cause.message, { cause })
+		}
+		throw cause
+	}
+}
+
+export type InstanceMode = 'starlight' | 'local'
+export const getInstanceMode = (instanceId: string) =>
+	invokeHosted<InstanceMode>('plugin:install|hosted_instance_mode', { instanceId })
+export const setInstanceMode = (instanceId: string, mode: InstanceMode) => {
+	if (mode === 'starlight') startHostedPackAttempt(instanceId)
+	return (mode === 'starlight' ? invokeWithSession<void> : invokeHosted<void>)(
+		'plugin:install|hosted_set_instance_mode',
+		{ instanceId, mode },
+	)
+}
+
+export interface HostedPublication {
+	packId: string
+	releaseId: number
+	manifest: {
+		name: string
+		version: string
+		format: string
+		runtime: { gameVersion: string; loader: string; loaderVersion: string | null }
+		files: { path: string; size: number; sha256: string }[]
+	}
+}
+export interface HostedBinding {
+	publication: HostedPublication
+}
+export interface HostedSyncResult {
+	version: string
+	downloadedBytes: number
+	changedFiles: number
+	preservedFiles: string[]
+}
+export const hostedDefault = () =>
+	invokeWithSession<HostedPublication>('plugin:install|hosted_default')
+export const hostedCreate = (gameDirRoot?: string | null) =>
+	invokeWithSession<string>('plugin:install|hosted_create', {
+		gameDirRoot: gameDirRoot ?? null,
+	})
+export const hostedBinding = (instanceId: string) =>
+	invokeHosted<HostedBinding | null>('plugin:install|hosted_binding', { instanceId })
+export const hostedSync = (instanceId: string) => {
+	startHostedPackAttempt(instanceId)
+	return invokeWithSession<HostedSyncResult>('plugin:install|hosted_sync', { instanceId })
+}

apps/app-frontend/src/helpers/install-job-notification-visibility.test.ts

@@ -0,0 +1,35 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import type { InstallJobSnapshot, InstallJobStatus } from './install.ts'
+import { createInstallJobNotificationFilter } from './install-job-notification-visibility.ts'
+
+function job(jobId: string, status: InstallJobStatus): InstallJobSnapshot {
+	return { job_id: jobId, status } as InstallJobSnapshot
+}
+
+test('does not resurrect failures that finished before the notification surface started', () => {
+	const oldFailure = job('old-failure', 'failed')
+	const filter = createInstallJobNotificationFilter([oldFailure, job('old-success', 'succeeded')])
+
+	assert.deepEqual(filter([oldFailure, job('old-success', 'succeeded')]), [])
+	assert.deepEqual(filter([oldFailure, job('current', 'running')]).map((item) => item.job_id), [
+		'current',
+	])
+})
+
+test('keeps an observed task visible when it finishes', () => {
+	const filter = createInstallJobNotificationFilter([job('old-failure', 'failed')])
+
+	assert.deepEqual(filter([job('current', 'running')]).map((item) => item.job_id), ['current'])
+	assert.deepEqual(filter([job('current', 'failed')]).map((item) => item.job_id), ['current'])
+	assert.deepEqual(filter([job('current', 'succeeded')]).map((item) => item.job_id), ['current'])
+})
+
+test('shows a newly received failure even if its active phase completed too quickly to observe', () => {
+	const filter = createInstallJobNotificationFilter([job('old-failure', 'failed')])
+
+	assert.deepEqual(filter([job('new-failure', 'failed')]).map((item) => item.job_id), [
+		'new-failure',
+	])
+})

apps/app-frontend/src/helpers/install-job-notification-visibility.ts

@@ -0,0 +1,32 @@
+import type { InstallJobSnapshot, InstallJobStatus } from './install.ts'
+
+const activeStatuses = new Set<InstallJobStatus>([
+	'queued',
+	'running',
+	'canceling',
+	'waiting_for_user',
+])
+const failureStatuses = new Set<InstallJobStatus>(['failed', 'interrupted'])
+
+/**
+ * Keeps the popup scoped to work the user could actually have observed.
+ * Finished jobs already present when the action bar starts belong to download
+ * history; they must not be resurrected by an unrelated loading event.
+ */
+export function createInstallJobNotificationFilter(initialJobs: InstallJobSnapshot[]) {
+	const missedFinishedJobIds = new Set(
+		initialJobs.filter((job) => !activeStatuses.has(job.status)).map((job) => job.job_id),
+	)
+	let visibleJobIds = new Set<string>()
+
+	return (nextJobs: InstallJobSnapshot[]) => {
+		const visibleJobs = nextJobs.filter((job) => {
+			if (activeStatuses.has(job.status)) return true
+			if (visibleJobIds.has(job.job_id)) return true
+			return failureStatuses.has(job.status) && !missedFinishedJobIds.has(job.job_id)
+		})
+
+		visibleJobIds = new Set(visibleJobs.map((job) => job.job_id))
+		return visibleJobs
+	}
+}

apps/app-frontend/src/helpers/install.ts

@@ -32,6 +32,7 @@ export interface InstallModpackPreview {
 }
 
 export interface InstallCreateInstanceRequest {
+	instanceMode?: 'starlight' | 'local'
 	name: string
 	gameVersion: string
 	loader: InstanceLoader

apps/app-frontend/src/helpers/instance-launch-state.test.ts

@@ -0,0 +1,39 @@
+import assert from 'node:assert/strict'
+import { test } from 'node:test'
+
+import { isInstanceLaunching, launchOnce } from './instance-launch-state.ts'
+
+test('launches different instances concurrently and coalesces repeated pending clicks', async () => {
+	let finishA!: (value: string) => void
+	let starts = 0
+	const first = launchOnce('a', () => {
+		starts++
+		return new Promise<string>((resolve) => {
+			finishA = resolve
+		})
+	})
+	assert.equal(
+		launchOnce('a', async () => 'unexpected duplicate'),
+		first,
+	)
+	assert.equal(isInstanceLaunching('a'), true)
+	assert.equal(isInstanceLaunching('b'), false)
+	assert.equal(await launchOnce('b', async () => 'b started'), 'b started')
+	assert.equal(isInstanceLaunching('a'), true)
+	finishA('a started')
+	assert.equal(await first, 'a started')
+	assert.equal(starts, 1)
+	assert.equal(isInstanceLaunching('a'), false)
+	assert.equal(await launchOnce('a', async () => 'second window'), 'second window')
+})
+
+test('failed launch releases only its own pending state and can retry', async () => {
+	await assert.rejects(
+		launchOnce('failed', async () => {
+			throw new Error('launch failed')
+		}),
+		/launch failed/,
+	)
+	assert.equal(isInstanceLaunching('failed'), false)
+	assert.equal(await launchOnce('failed', async () => 'retry'), 'retry')
+})

apps/app-frontend/src/helpers/instance-launch-state.ts

@@ -0,0 +1,20 @@
+import { reactive } from 'vue'
+
+const pending = reactive(new Map<string, Promise<unknown>>())
+
+export function isInstanceLaunching(instanceId: string) {
+	return pending.has(instanceId)
+}
+
+/** Coalesce repeated clicks for one launch without blocking other instances. */
+export function launchOnce<T>(instanceId: string, launch: () => Promise<T>): Promise<T> {
+	const existing = pending.get(instanceId)
+	if (existing) return existing as Promise<T>
+	const task = Promise.resolve()
+		.then(launch)
+		.finally(() => {
+			pending.delete(instanceId)
+		})
+	pending.set(instanceId, task)
+	return task
+}

apps/app-frontend/src/helpers/instance-player.test.ts

@@ -0,0 +1,165 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import {
+	receiveSkinSiteMessage,
+	resetSkinSiteSession,
+	setSkinSiteFrame,
+	SKIN_SITE_ORIGIN,
+} from '../composables/skin-site-session.ts'
+import { useNetworkStatus } from '../composables/useNetworkStatus.ts'
+import {
+	type InstancePlayer,
+	onInstancePlayerChanged,
+	prepareInstancePlayer,
+	registerInstancePlayerPicker,
+	saveInstancePlayer,
+} from './instance-player.ts'
+
+test('instance player selection persists independently from the globally selected account', async () => {
+	const previousNavigator = Object.getOwnPropertyDescriptor(globalThis, 'navigator')
+	Object.defineProperty(globalThis, 'navigator', { configurable: true, value: { onLine: true } })
+	useNetworkStatus().refreshBrowserOffline()
+	const saved: InstancePlayer = { id: 'saved', name: 'Saved', account_type: 'microsoft' }
+	let binding: InstancePlayer | null = saved
+	let accounts = [
+		{ profile: { id: 'other', name: 'Other' }, account_type: 'microsoft' },
+		{ profile: { id: 'saved', name: 'Saved' }, account_type: 'microsoft' },
+	]
+	const previous = Object.getOwnPropertyDescriptor(globalThis, 'window')
+	Object.defineProperty(globalThis, 'window', {
+		configurable: true,
+		value: {
+			__TAURI_INTERNALS__: {
+				invoke: async (command: string) => {
+					if (command === 'plugin:auth|get_instance_player') return binding
+					if (command === 'plugin:auth|get_users') return accounts
+					throw new Error(`Unexpected command ${command}`)
+				},
+			},
+		},
+	})
+	const requests: Array<InstancePlayer | null> = []
+	const unregister = registerInstancePlayerPicker(async (_id, locked) => {
+		requests.push(locked)
+		binding = saved
+		return saved
+	})
+	try {
+		setSkinSiteFrame({ postMessage() {} } as unknown as Window)
+		await prepareInstancePlayer('instance')
+		assert.equal(requests.length, 0)
+		setSkinSiteFrame(null)
+		binding = null
+		await Promise.all([prepareInstancePlayer('instance'), prepareInstancePlayer('instance')])
+		assert.deepEqual(requests, [null])
+		await prepareInstancePlayer('instance')
+		assert.equal(requests.length, 1)
+		accounts = accounts.filter((account) => account.profile.id !== saved.id)
+		await prepareInstancePlayer('instance')
+		assert.equal(
+			requests[1],
+			saved,
+			'Missing saved player must remain locked, not fall back to the other account',
+		)
+	} finally {
+		unregister()
+		if (previousNavigator) Object.defineProperty(globalThis, 'navigator', previousNavigator)
+		else Reflect.deleteProperty(globalThis, 'navigator')
+		if (previous) Object.defineProperty(globalThis, 'window', previous)
+		else Reflect.deleteProperty(globalThis, 'window')
+	}
+})
+
+test('signed-in skin site renews the saved player without prompting and only notifies after saving', async () => {
+	const previous = Object.getOwnPropertyDescriptor(globalThis, 'window')
+	const previousNavigator = Object.getOwnPropertyDescriptor(globalThis, 'navigator')
+	Object.defineProperty(globalThis, 'navigator', { configurable: true, value: { onLine: true } })
+	useNetworkStatus().refreshBrowserOffline()
+	const player: InstancePlayer = {
+		id: '12345678-1234-1234-1234-123456789abc',
+		name: 'Skin',
+		account_type: 'yggdrasil',
+		skin_site_user: 'owner',
+	}
+	const calls: string[] = []
+	let failSave = false
+	const frame = {
+		postMessage(data: { type: string; requestId: string }) {
+			if (data.type === 'starlight-pack-token-request')
+				receiveSkinSiteMessage(
+					{
+						origin: SKIN_SITE_ORIGIN,
+						source: frame,
+						data: {
+							type: 'starlight-pack-token-result',
+							requestId: data.requestId,
+							token: 'fixture.jwt',
+						},
+					} as unknown as MessageEvent,
+					frame,
+				)
+		},
+	} as unknown as Window
+	Object.defineProperty(globalThis, 'window', {
+		configurable: true,
+		value: {
+			__TAURI_INTERNALS__: {
+				async invoke(command: string, args: Record<string, unknown>) {
+					calls.push(command)
+					if (command.endsWith('get_instance_player')) return player
+					if (command.endsWith('login_skin_site_player')) {
+						assert.equal(args.playerId, player.id)
+						assert.equal(args.userId, 'owner')
+						assert.equal(args.token, 'fixture.jwt')
+					} else if (command.endsWith('set_instance_player') && failSave)
+						throw new Error('Save failed')
+				},
+			},
+		},
+	})
+	let prompts = 0
+	const unregister = registerInstancePlayerPicker(async (_id, locked) => {
+		prompts++
+		assert.equal(locked, player)
+		return player
+	})
+	const changes: string[] = []
+	const stop = onInstancePlayerChanged((id) => changes.push(id))
+	try {
+		resetSkinSiteSession()
+		setSkinSiteFrame(frame)
+		receiveSkinSiteMessage(
+			{
+				origin: SKIN_SITE_ORIGIN,
+				source: frame,
+				data: {
+					type: 'starlight-skin-session',
+					status: 'signed-in',
+					user: { uuid: 'owner', username: 'Owner' },
+				},
+			} as unknown as MessageEvent,
+			frame,
+		)
+		await prepareInstancePlayer('one')
+		assert.equal(prompts, 0)
+		assert.ok(calls.includes('plugin:auth|login_skin_site_player'))
+		await saveInstancePlayer('one', player)
+		assert.deepEqual(changes, ['one'])
+		failSave = true
+		await assert.rejects(saveInstancePlayer('two', player), /Save failed/)
+		assert.deepEqual(changes, ['one'])
+		resetSkinSiteSession()
+		await prepareInstancePlayer('one')
+		assert.equal(prompts, 1)
+	} finally {
+		stop()
+		unregister()
+		resetSkinSiteSession()
+		setSkinSiteFrame(null)
+		if (previous) Object.defineProperty(globalThis, 'window', previous)
+		else Reflect.deleteProperty(globalThis, 'window')
+		if (previousNavigator) Object.defineProperty(globalThis, 'navigator', previousNavigator)
+		else Reflect.deleteProperty(globalThis, 'navigator')
+	}
+})

apps/app-frontend/src/helpers/instance-player.ts

@@ -0,0 +1,116 @@
+import { invoke } from '@tauri-apps/api/core'
+
+import {
+	requestSkinSiteDownloadToken,
+	skinSiteStatus,
+	skinSiteUser,
+	waitForSkinSiteSession,
+} from '../composables/skin-site-session.ts'
+import { isOfflineMode } from '../composables/useNetworkStatus.ts'
+import { users } from './auth.js'
+export { waitForSkinSiteSession } from '../composables/skin-site-session.ts'
+
+export type InstancePlayer = {
+	id: string
+	name: string
+	account_type: 'microsoft' | 'yggdrasil' | 'offline'
+	skin_site_user?: string | null
+}
+export type PlayerChoice = InstancePlayer & { head?: string }
+
+/**
+ * Thrown when the player picker is dismissed because the user navigated to the
+ * skin-site login page. Callers should treat this as a silent launch abort
+ * (the user will pick a player next time), not as a real failure.
+ */
+export class PlayerSelectionNavigatedAwayError extends Error {
+	constructor() {
+		super('已跳转至皮肤站登录，请登录后重新启动。')
+		this.name = 'PlayerSelectionNavigatedAwayError'
+	}
+}
+type Picker = (instanceId: string, locked: InstancePlayer | null) => Promise<InstancePlayer>
+let picker: Picker | undefined
+const preparing = new Map<string, Promise<void>>()
+const listeners = new Set<(instanceId: string, player: InstancePlayer) => void>()
+
+export function onInstancePlayerChanged(
+	listener: (instanceId: string, player: InstancePlayer) => void,
+) {
+	listeners.add(listener)
+	return () => {
+		listeners.delete(listener)
+	}
+}
+
+export function registerInstancePlayerPicker(value: Picker) {
+	picker = value
+	return () => {
+		if (picker === value) picker = undefined
+	}
+}
+export const getInstancePlayer = (instanceId: string) =>
+	invoke<InstancePlayer | null>('plugin:auth|get_instance_player', { instanceId })
+
+export async function authenticateInstancePlayer(player: InstancePlayer) {
+	if (!player.skin_site_user) return
+	if (skinSiteStatus.value !== 'signed-in' || skinSiteUser.value?.uuid !== player.skin_site_user) {
+		throw new Error(`请登录实例玩家 ${player.name} 所属的皮肤站账号。`)
+	}
+	const token = await requestSkinSiteDownloadToken()
+	await invoke('plugin:auth|login_skin_site_player', {
+		token,
+		playerId: player.id,
+		userId: player.skin_site_user,
+	})
+	if (skinSiteUser.value?.uuid !== player.skin_site_user || skinSiteStatus.value !== 'signed-in') {
+		throw new Error('皮肤站账号已变化，请重试。')
+	}
+}
+
+export async function saveInstancePlayer(instanceId: string, player: InstancePlayer) {
+	await authenticateInstancePlayer(player)
+	await invoke('plugin:auth|set_instance_player', { instanceId, player })
+	for (const listener of listeners) listener(instanceId, player)
+}
+
+export async function chooseInstancePlayer(
+	instanceId: string,
+	locked: InstancePlayer | null = null,
+) {
+	if (!picker) throw new Error('玩家选择界面尚未就绪，请稍后重试。')
+	return picker(instanceId, locked)
+}
+
+export function prepareInstancePlayer(instanceId: string): Promise<void> {
+	if (isOfflineMode()) return Promise.resolve()
+	const current = preparing.get(instanceId)
+	if (current) return current
+	const task = (async () => {
+		const saved = await getInstancePlayer(instanceId)
+		if (saved && !saved.skin_site_user) {
+			const available = await users()
+			if (
+				available.some(
+					(account) =>
+						account.profile.id === saved.id && account.account_type === saved.account_type,
+				)
+			)
+				return
+		}
+		if (saved?.skin_site_user) await waitForSkinSiteSession()
+		if (
+			saved?.skin_site_user &&
+			skinSiteUser.value?.uuid === saved.skin_site_user &&
+			skinSiteStatus.value === 'signed-in'
+		) {
+			await authenticateInstancePlayer(saved)
+			return
+		}
+		await chooseInstancePlayer(instanceId, saved)
+	})().finally(() => {
+		preparing.delete(instanceId)
+	})
+	preparing.set(instanceId, task)
+	return task
+}

apps/app-frontend/src/helpers/instance.ts

@@ -17,6 +17,9 @@ import { collectGcContext } from '@/helpers/gc/context'
 import { detectGcStrategy, GC_STRATEGY_DEFINITIONS } from '@/helpers/gc/strategies'
 import type { GcContext, ResolvedGcStrategyId } from '@/helpers/gc/types'
 import { setLastGcLaunchReport } from '@/helpers/gc-notice'
+import { getInstanceMode, prepareHostedSession } from '@/helpers/hosted-packs'
+import { launchOnce } from '@/helpers/instance-launch-state'
+import { prepareInstancePlayer } from '@/helpers/instance-player'
 import { AUTO_GC_PRESET_ARG } from '@/helpers/java-arguments'
 import { get_jre, get_memory_status } from '@/helpers/jre.js'
 import { get as getSettings } from '@/helpers/settings'
@@ -1069,10 +1072,19 @@ export async function resolveGcLaunchIntent(
 
 // Run Minecraft using an instance
 // Returns the process metadata plus an optional GC fallback report.
-export async function run(
+export function run(
 	instanceId: string,
 	serverAddress: string | null = null,
 ): Promise<InstanceRunResult> {
+	return launchOnce(instanceId, () => launchInstance(instanceId, serverAddress))
+}
+
+async function launchInstance(
+	instanceId: string,
+	serverAddress: string | null,
+): Promise<InstanceRunResult> {
+	await prepareInstancePlayer(instanceId)
+	if ((await getInstanceMode(instanceId)) === 'starlight') await prepareHostedSession()
 	const { args, gcIntent } = await resolveGcLaunchIntent(instanceId)
 	const result = await invoke<InstanceRunResult>('plugin:instance|instance_run', {
 		instanceId,

apps/app-frontend/src/helpers/post-upgrade-notice.test.ts

@@ -82,20 +82,20 @@ test('notice query uses the target instance value and registered Tauri command',
 	assert.match(tauriSource, /tauri::generate_handler!\[[\s\S]*instance_get_post_upgrade_notice/)
 })
 
-test('result uses Modrinth Card and Accordion for collapsed compatibility warnings', () => {
+test('result collections use Modrinth Card and Accordion for collapsed compatibility warnings', () => {
 	const source = readFileSync(
-		new URL('../pages/instance/upgrade/UpgradeResultDetails.vue', import.meta.url),
+		new URL('../pages/instance/upgrade/UpgradeResultCollections.vue', import.meta.url),
 		'utf8',
 	)
-	assert.match(source, /<Card v-if="warningRows\.length"/)
-	assert.match(source, /<Accordion[\s\S]*:open-by-default="warningsExpandedByDefault"/)
+	assert.match(source, /<Card v-if="warnings\.length"/)
+	assert.match(source, /<Accordion[\s\S]*:open-by-default="warningsDefaultOpen"/)
 	assert.match(source, /<TriangleAlertIcon/)
 })
 
 test('runtime icon references use names exported by the assets package', () => {
 	const downloadsSource = readFileSync(new URL('../pages/Downloads.vue', import.meta.url), 'utf8')
 	const resultSource = readFileSync(
-		new URL('../pages/instance/upgrade/UpgradeResultDetails.vue', import.meta.url),
+		new URL('../pages/instance/upgrade/UpgradeResultCollections.vue', import.meta.url),
 		'utf8',
 	)
 	const assetsSource = readFileSync(

apps/app-frontend/src/helpers/settings.ts

@@ -183,6 +183,7 @@ export type AppSettings = {
 	custom_env_vars: [string, string][]
 	memory: MemorySettings
 	force_fullscreen: boolean
+	force_unicode_font: boolean
 	maximize_window: boolean
 	game_resolution: [number, number]
 	hide_on_process_start: boolean
@@ -227,6 +228,7 @@ function normalizeDownloadSettings(settings: AppSettings & LegacyMirrorSettings)
 	settings.auto_concurrent_downloads ??= true
 	settings.download_engine ??= 'legacy'
 	settings.auto_set_java_high_performance_mode ??= true
+	settings.force_unicode_font ??= false
 	settings.minecraft_metadata_source ??=
 		usesLegacyDefaults || !hasLegacySettings ? 'auto' : legacySource(settings.use_minecraft_mirror)
 	settings.minecraft_file_source ??=

apps/app-frontend/src/helpers/skins.ts

@@ -118,6 +118,10 @@ export async function get_available_skins(): Promise<Skin[]> {
 	return invoke('plugin:minecraft-skins|get_available_skins', {})
 }
 
+export async function get_default_skins(): Promise<Skin[]> {
+	return invoke('plugin:minecraft-skins|get_default_skins', {})
+}
+
 export async function add_and_equip_custom_skin(
 	textureBlob: Uint8Array,
 	variant: SkinModel,

apps/app-frontend/src/helpers/state.ts

@@ -6,6 +6,9 @@
 import { invoke } from '@tauri-apps/api/core'
 
 export interface LoadingBarType {
+	batch_id?: string
+	file_name?: string
+	error?: string | null
 	type?: string
 	version?: string
 	instance_id?: string
@@ -25,12 +28,7 @@ export interface LoadingBar {
 }
 
 export type OpeningCommandEvent =
-	| 'RunMRPack'
-	| 'InstallServer'
-	| 'InstallVersion'
-	| 'InstallMod'
-	| 'InstallModpack'
-	| string
+	'RunMRPack' | 'InstallServer' | 'InstallVersion' | 'InstallMod' | 'InstallModpack' | string
 
 export interface OpeningCommand {
 	event: OpeningCommandEvent

apps/app-frontend/src/helpers/tagged-mod-progress.test.ts

@@ -0,0 +1,76 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { createTaggedModProgress } from './tagged-mod-progress.ts'
+
+const parent = (id = 'parent', fraction: number | null = 0, error = '') => ({
+	loader_uuid: id,
+	fraction,
+	message: 'Applying updates',
+	event: { type: 'hosted_pack_sync', instance_id: 'one', error },
+})
+const file = (id: string, fraction: number | null, batch = 'batch', error = '') => ({
+	loader_uuid: id,
+	fraction,
+	total: 100,
+	message: 'Downloading',
+	event: {
+		type: 'hosted_mod_download',
+		instance_id: 'one',
+		instance_name: 'Server',
+		batch_id: batch,
+		file_name: id,
+		error,
+	},
+})
+
+test('parallel files keep independent progress and wait for installation to complete', () => {
+	const state = createTaggedModProgress()
+	state.update(parent())
+	assert.equal(state.update(file('first', 0.25)), true)
+	assert.equal(state.update(file('second', 0.6)), false)
+	const group = state.groups.get('batch')!
+	assert.equal(group.files.get('first')!.current, 25)
+	assert.equal(group.files.get('second')!.current, 60)
+	state.update(file('first', null))
+	state.update(file('first', 0.1))
+	assert.equal(group.files.get('first')!.current, 100)
+	state.update(file('second', null))
+	assert.equal(group.done, false)
+	state.update(parent('parent', null))
+	assert.equal(group.done, true)
+	assert.equal(group.error, '')
+})
+
+test('failures retain downloaded bytes and retry discards all late events from the old attempt', () => {
+	const state = createTaggedModProgress()
+	state.update(parent())
+	state.update(file('first', 0.4))
+	state.update(file('first', null, 'batch', 'network failed'))
+	state.update(parent('parent', null, 'network failed'))
+	assert.equal(state.groups.get('batch')!.files.get('first')!.current, 40)
+	assert.equal(state.groups.get('batch')!.error, 'network failed')
+	state.reset('one')
+	state.update(parent('new-parent'))
+	state.update(file('new-file', 0.2, 'new-batch'))
+	state.update(parent('parent', 0.9))
+	state.update(parent('parent', null, 'old error'))
+	state.update(file('first', null))
+	assert.deepEqual([...state.groups.keys()], ['new-batch'])
+	assert.equal(state.groups.get('new-batch')!.done, false)
+})
+
+test('native retry and resetting one instance leave other instance downloads alone', () => {
+	const state = createTaggedModProgress()
+	state.update(parent())
+	state.update(file('first', 0))
+	const other = file('other', 0.8, 'other-batch')
+	other.event.instance_id = 'two'
+	state.update(other)
+	state.update(parent('new-parent'))
+	state.update(file('new-file', 0.3, 'new-batch'))
+	state.update(parent('parent', 0.5))
+	assert.deepEqual([...state.groups.keys()], ['other-batch', 'new-batch'])
+	state.reset('one')
+	assert.deepEqual([...state.groups.keys()], ['other-batch'])
+})

apps/app-frontend/src/helpers/tagged-mod-progress.ts

@@ -0,0 +1,102 @@
+import type { LoadingBarType } from './state.ts'
+
+export interface TaggedProgressEvent {
+	loader_uuid: string
+	event?: LoadingBarType
+	fraction: number | null
+	total?: number | null
+	message: string
+}
+export interface TaggedProgressFile {
+	id: string
+	name: string
+	current: number
+	total: number
+	message: string
+	done: boolean
+	error: string
+}
+export interface TaggedProgressGroup {
+	id: string
+	instanceId: string
+	name: string
+	message: string
+	error: string
+	done: boolean
+	files: Map<string, TaggedProgressFile>
+}
+
+export function createTaggedModProgress() {
+	const groups = new Map<string, TaggedProgressGroup>()
+	const parents = new Map<string, string>()
+	const retiredParents = new Set<string>()
+	const retired = new Set<string>()
+	function reset(instanceId: string) {
+		const parent = parents.get(instanceId)
+		if (parent) retiredParents.add(parent)
+		parents.delete(instanceId)
+		for (const [id, group] of groups) {
+			if (group.instanceId === instanceId) {
+				retired.add(id)
+				groups.delete(id)
+			}
+		}
+	}
+	function update(payload: TaggedProgressEvent): boolean {
+		const event = payload.event
+		if (!event?.instance_id) return false
+		if (event.type === 'hosted_pack_sync') {
+			if (retiredParents.has(payload.loader_uuid)) return false
+			if (payload.fraction !== null && parents.get(event.instance_id) !== payload.loader_uuid) {
+				reset(event.instance_id)
+				parents.set(event.instance_id, payload.loader_uuid)
+			}
+			if (parents.get(event.instance_id) !== payload.loader_uuid) return false
+			for (const group of groups.values()) {
+				if (group.instanceId !== event.instance_id) continue
+				if (group.done) continue
+				group.message = payload.message
+				if (payload.fraction === null) {
+					group.done = true
+					group.error = event.error ?? ''
+				}
+			}
+			return false
+		}
+		if (event.type !== 'hosted_mod_download' || !event.batch_id || retired.has(event.batch_id))
+			return false
+		let group = groups.get(event.batch_id)
+		const isNew = !group
+		if (!group) {
+			group = {
+				id: event.batch_id,
+				instanceId: event.instance_id,
+				name: event.instance_name ?? '',
+				message: '',
+				error: '',
+				done: false,
+				files: new Map(),
+			}
+			groups.set(group.id, group)
+		}
+		const previous = group.files.get(payload.loader_uuid)
+		if (previous?.done) return false
+		const total = Math.max(0, payload.total ?? previous?.total ?? 0)
+		group.files.set(payload.loader_uuid, {
+			id: payload.loader_uuid,
+			name: event.file_name ?? '',
+			total,
+			current:
+				payload.fraction === null
+					? event.error
+						? (previous?.current ?? 0)
+						: total
+					: Math.max(0, Math.min(1, payload.fraction)) * total,
+			message: payload.message,
+			done: payload.fraction === null,
+			error: event.error ?? '',
+		})
+		return isNew
+	}
+	return { groups, reset, update }
+}

apps/app-frontend/src/helpers/worlds.ts

@@ -4,7 +4,9 @@ import { invoke } from '@tauri-apps/api/core'
 import dayjs from 'dayjs'
 
 import { isOfflineMode } from '@/composables/useNetworkStatus'
+import { getInstanceMode, prepareHostedSession } from '@/helpers/hosted-packs'
 import { get_full_path, resolveGcLaunchIntent } from '@/helpers/instance'
+import { prepareInstancePlayer } from '@/helpers/instance-player'
 import { openPath } from '@/helpers/utils'
 
 type BaseWorld = {
@@ -18,7 +20,6 @@ type BaseWorld = {
 export type WorldType = 'singleplayer' | 'server'
 export type DisplayStatus = 'normal' | 'hidden' | 'favorite'
 
-
 export type SingleplayerWorld = BaseWorld & {
 	type: 'singleplayer'
 	path: string
@@ -248,6 +249,8 @@ export async function start_join_singleplayer_world(
 	instanceId: string,
 	world: string,
 ): Promise<unknown> {
+	await prepareInstancePlayer(instanceId)
+	if ((await getInstanceMode(instanceId)) === 'starlight') await prepareHostedSession()
 	const { args, gcIntent } = await resolveGcLaunchIntent(instanceId)
 	return await invoke('plugin:worlds|start_join_singleplayer_world', {
 		instanceId,
@@ -259,6 +262,8 @@ export async function start_join_singleplayer_world(
 }
 
 export async function start_join_server(instanceId: string, address: string): Promise<unknown> {
+	await prepareInstancePlayer(instanceId)
+	if ((await getInstanceMode(instanceId)) === 'starlight') await prepareHostedSession()
 	const { args, gcIntent } = await resolveGcLaunchIntent(instanceId)
 	return await invoke('plugin:worlds|start_join_server', {
 		instanceId,

apps/app-frontend/src/locales/en-US/index.json

@@ -1,4 +1,91 @@
 {
+	"app.instance-player.title": { "message": "Choose an instance player" },
+	"app.instance-player.remember": { "message": "This instance will keep using your choice. Switch players in instance settings." },
+	"app.instance-player.restore": { "message": "Sign in again as {name}. To choose someone else, open instance settings." },
+	"app.instance-player.loading": { "message": "Loading signed-in players…" },
+	"app.instance-player.licensed": { "message": "Minecraft account" },
+	"app.instance-player.skin": { "message": "Skin site player" },
+	"app.instance-player.offline": { "message": "Offline player" },
+	"app.instance-player.empty": { "message": "No available skin site players. You can create a player on the skin site." },
+	"app.instance-player.sign-in": { "message": "Sign in to choose a player." },
+	"app.instance-player.retry": { "message": "Retry" },
+	"app.instance-player.skin-login": { "message": "Sign in to skin site" },
+	"app.instance-player.or": { "message": "Or" },
+	"app.instance-player.use-microsoft": { "message": "Use a Minecraft account" },
+	"app.instance-player.saving": { "message": "Saving instance player…" },
+	"app.instance-player.setting": { "message": "Instance player" },
+	"app.instance-player.first-launch": { "message": "Choose a player on first launch" },
+	"app.instance-player.change": { "message": "Switch instance player" },
+  "app.hosted-mods.title": { "message": "Updating server Mods" },
+  "app.hosted-mods.description": { "message": "The game starts after all required updates have been installed." },
+  "app.hosted-mods.complete": { "message": "Downloaded" },
+  "app.hosted-mods.downloads": { "message": "View downloads" },
+  "app.hosted-mods.close": { "message": "Close" },
+  "app.hosted-packs.progress.retry": { "message": "Return to the instance to retry" },
+  "app.hosted-packs.progress.preparing": { "message": "Preparing modpack installation…" },
+  "app.hosted-packs.progress.downloads": { "message": "View downloads" },
+  "app.hosted-packs.open-instance": { "message": "Open installed instance" },
+  "app.hosted-packs.retry-install": { "message": "Retry installation" },
+  "app.hosted-packs.auto-installing": { "message": "Downloading and installing the server modpack…" },
+  "app.hosted-packs.auto-description": { "message": "Download and automatically install the modpack from StarLight to play on the StarLight server with one click." },
+  "app.hosted-packs.auto-install": { "message": "Install the StarLight modpack" },
+  "app.hosted-install.game-dir.header": { "message": "Choose game directory" },
+  "app.hosted-install.game-dir.description": { "message": "StarLight instance data (mods, saves, configs, resource packs) is stored in an external game directory. Pick a root folder — the modpack gets its own subfolder inside it." },
+  "app.hosted-install.game-dir.label": { "message": "Game directory root" },
+  "app.hosted-install.game-dir.browse": { "message": "Browse" },
+  "app.hosted-install.game-dir.no-selection": { "message": "No folder selected" },
+  "app.hosted-install.game-dir.reset-default": { "message": "Use default location" },
+  "app.hosted-install.game-dir.preview": { "message": "Game files will be installed to: {path}" },
+  "app.hosted-install.game-dir.confirm": { "message": "Install" },
+  "app.onboarding.instance-mode.title": { "message": "Choose your instance type" },
+  "app.onboarding.instance-mode.description": { "message": "StarLight automatically installs the administrator-selected modpack and versions, then checks and completes updates before every launch. A StarLight login is required. Choose Local to select your own versions and modpacks for other servers or single-player." },
+  "app.instance-mode.title": { "message": "Instance type" },
+  "app.instance-mode.starlight": { "message": "StarLight instance" },
+  "app.instance-mode.local": { "message": "Local instance" },
+  "app.instance-mode.starlight-description": { "message": "Required for playing on StarLight. Automatically installs the server-selected modpack, Minecraft version, and loader. Every launch requires a StarLight login and checks for updates before starting." },
+  "app.instance-mode.local-description": { "message": "Does not sync StarLight server changes. Skips sync checks for faster startup and lets you choose your own modpacks. Best for third-party servers and personal single-player worlds." },
+  "app.instance-mode.saving": { "message": "Applying instance type and installing the server modpack when needed…" },
+  "app.instance-mode.loading": { "message": "Loading instance type…" },
+  "app.instance-mode.retry": { "message": "Retry" },
+  "app.instance-mode.local-packs-title": { "message": "Local modpacks" },
+  "app.instance-mode.local-packs": { "message": "Choose any modpack to install as a local instance. Existing files and worlds are kept when you switch to Local; StarLight changes will no longer be synchronized." },
+  "app.instance-mode.browse": { "message": "Browse modpacks" },
+  "app.instance-mode.import": { "message": "Import as a local instance" },
+  "app.hosted-packs.title": { "message": "Server-managed modpack" },
+  "app.hosted-packs.description": { "message": "The administrator selects this modpack and its versions. Every launch checks for updates and downloads changes before starting. A valid StarLight login and network connection are required." },
+  "app.hosted-packs.refresh": {"message": "Refresh"},
+  "app.hosted-packs.loading": {"message": "Loading published modpacks…"},
+  "app.hosted-packs.bound": {"message": "Installed: {name} · {version}"},
+  "app.hosted-packs.syncing": {"message": "Comparing files and synchronizing changes…"},
+  "app.hosted-packs.complete": {"message": "Synced to {version}. Changed {count} files; downloaded {size} MiB."},
+  "app.hosted-packs.preserved": {"message": "Preserved {count} locally modified or personal files"},
+  "app.hosted-packs.empty": {"message": "No modpacks have been approved for publication yet."},
+  "app.hosted-packs.update": {"message": "Synchronize now"},
+  "app.hosted-packs.install": { "message": "Retry automatic installation" },
+  "app.hosted-packs.management": {"message": "Content management"},
+  "app.hosted-packs.mods": {"message": "Manage mods"},
+  "app.hosted-packs.packs": {"message": "Manage modpacks"},
+  "app.home.luck.title": { "message": "Daily luck index" },
+  "app.home.luck.get": { "message": "Get with one click" },
+  "app.home.luck.login-to-get": { "message": "Sign in to get it" },
+  "app.home.luck.loading": { "message": "Asking the little sprite..." },
+  "app.home.luck.error": {
+    "message": "The little sprite did not answer. Please try again later."
+  },
+  "app.home.luck.out-of": { "message": "out of 100" },
+  "minecraft-account.skin-site.signed-in": { "message": "Signed in to StarLight Skin Site" },
+  "minecraft-account.skin-site.checking": { "message": "Checking skin site session…" },
+  "minecraft-account.skin-site.sync-error": {
+    "message": "Could not verify the skin site session. Retrying automatically."
+  },
+  "minecraft-account.skin-site.players": { "message": "Skin site players ({count})" },
+  "minecraft-account.skin-site.players.retry": { "message": "Retry" },
+  "minecraft-account.skin-site.players.empty": {
+    "message": "No player profiles are attached to this skin site account."
+  },
+  "minecraft-account.skin-site.players.error": {
+    "message": "Could not refresh the player list. Previously loaded players are kept."
+  },
   "app.easteregg.color-mine.title": {
     "message": "Starlight Mine: Chromatic Realms"
   },
@@ -261,7 +348,7 @@
     "message": "Show more running instances"
   },
   "app.action-bar.stop-instance": {
-    "message": "Stop instance"
+    "message": "Stop window"
   },
   "app.action-bar.update": {
     "message": "Update"
@@ -2876,6 +2963,15 @@
   "app.instance.launch-instance": {
     "message": "Launch instance"
   },
+  "app.instance.launch-another": {
+    "message": "Launch another window"
+  },
+  "app.action-bar.window-started": {
+    "message": "Started {time, time, medium}"
+  },
+  "app.instance.stop-all": {
+    "message": "Stop all windows of this instance"
+  },
   "app.instance.linked-to": {
     "message": "Linked to"
   },
@@ -4979,6 +5075,9 @@
   "app.lab.skin-editor.retry": {
     "message": "Try again"
   },
+  "app.lab.skin-editor.resource-error": {
+    "message": "Skin editor files are missing or damaged. Reinstall the launcher or extract the complete portable archive."
+  },
   "app.lab.skin-editor.title": {
     "message": "Skin editor"
   },
@@ -5279,8 +5378,8 @@
   "app.minecraft-crash.view-mod-changes": {
     "message": "View Mod changes"
   },
-  "app.minecraft.playing-as": {
-    "message": "Playing as"
+  "app.minecraft.user-information": {
+    "message": "User information"
   },
   "app.modal.install-to-play.content-required": {
     "message": "Content required"
@@ -5672,12 +5771,6 @@
   "app.notification.warning": {
     "message": "Warning"
   },
-  "app.onboarding.account.description": {
-    "message": "When you are ready, sign in, switch accounts, or open your profile here. No deadline."
-  },
-  "app.onboarding.account.title": {
-    "message": "Accounts, on your schedule"
-  },
   "app.onboarding.action.click-create": {
     "message": "Click Create new instance to continue"
   },
@@ -5714,33 +5807,12 @@
   "app.onboarding.action.finish-area": {
     "message": "Click anywhere and you are all set"
   },
-  "app.onboarding.action.open-gradient-text": {
-    "message": "Open Gradient text generator to continue"
-  },
-  "app.onboarding.action.open-recipe-generator": {
-    "message": "Open Recipe generator to continue"
-  },
-  "app.onboarding.action.open-schematic-workshop": {
-    "message": "Open Schematic workshop to continue"
-  },
-  "app.onboarding.action.open-seed-map": {
-    "message": "Open Seed map to continue"
-  },
-  "app.onboarding.action.return-lab": {
-    "message": "Click Lab to continue"
-  },
   "app.onboarding.action.skip": {
     "message": "Leave the tour"
   },
   "app.onboarding.action.start": {
     "message": "Take the tour"
   },
-  "app.onboarding.ai.description": {
-    "message": "Connect text-model providers once, choose the models you want available, or switch every AI feature off in one place."
-  },
-  "app.onboarding.ai.title": {
-    "message": "Bring your own AI provider"
-  },
   "app.onboarding.appearance.description": {
     "message": "Theme, accent, backgrounds, and window effects all live here. Make the launcher feel familiar."
   },
@@ -5819,26 +5891,14 @@
   "app.onboarding.favorites.title": {
     "message": "Keep a short list"
   },
-  "app.onboarding.home-customize.description": {
-    "message": "Use the bottom-right edit control to add, resize, and configure widgets. While editing, switch between an automatically packed grid and a free grid that preserves empty cells."
-  },
-  "app.onboarding.home-customize.title": {
-    "message": "Arrange it your way"
-  },
   "app.onboarding.home-layout.description": {
-    "message": "Use the bottom-right control to switch between Information Home and Minimal Home. Widget editing stays with Information Home."
+    "message": "Use the bottom-right control to switch between the StarLight skin site home and the focused instance launcher."
   },
   "app.onboarding.home-layout.title": {
-    "message": "Change the amount of detail"
-  },
-  "app.onboarding.home-widgets.description": {
-    "message": "Information Home is built from widgets for recent activity, playtime, instances, worlds, and servers. The grid reflows as the window or account sidebar changes."
-  },
-  "app.onboarding.home-widgets.title": {
-    "message": "Your Home, your layout"
+    "message": "Switch your home"
   },
   "app.onboarding.instance-actions.description": {
-    "message": "Launch, stop, repair, configure, export, or open the instance from its header."
+    "message": "Launch or configure this instance here. You can launch another window while it is running; use the top bar to stop an individual window. Choose a player on first launch; the instance remembers your choice until you switch it in settings."
   },
   "app.onboarding.instance-actions.title": {
     "message": "The main controls"
@@ -5849,56 +5909,20 @@
   "app.onboarding.instance-tabs.title": {
     "message": "The rest of the workshop"
   },
-  "app.onboarding.java.description": {
-    "message": "The Java runtimes that start Minecraft live here. Technical, but well-behaved."
-  },
-  "app.onboarding.java.title": {
-    "message": "Java, under the hood"
-  },
-  "app.onboarding.lab-editor.description": {
-    "message": "Edit text, choose colors, preview the result, and copy the format your Minecraft setup expects."
-  },
-  "app.onboarding.lab-editor.title": {
-    "message": "Build and copy in one place"
-  },
-  "app.onboarding.lab-recipe-generator.description": {
-    "message": "Pick a Java version, fill the recipe slots, and copy or export the JSON locally."
-  },
-  "app.onboarding.lab-recipe-generator.title": {
-    "message": "Craft data pack recipes"
-  },
-  "app.onboarding.lab-schematic.description": {
-    "message": "Open a local .litematic or .schem file, or choose one from an installed instance. The 3D workspace keeps viewing, measurement, layer controls, materials, and local edits together."
-  },
-  "app.onboarding.lab-schematic.title": {
-    "message": "Inspect a build before placing it"
-  },
-  "app.onboarding.lab-seed-map.description": {
-    "message": "Enter a seed or load one from an instance, then inspect biomes, structures, and ore layers on the local map."
-  },
-  "app.onboarding.lab-seed-map.title": {
-    "message": "Find a world before you load it"
-  },
   "app.onboarding.lab-tools.description": {
-    "message": "Create formatted text and recipe data packs, explore Java worlds, and inspect schematic builds without leaving the launcher."
+    "message": "Create and edit skins, generate formatted text and recipes, explore seeds, inspect schematics, and translate mods locally."
   },
   "app.onboarding.lab-tools.title": {
     "message": "Local tools for Minecraft"
   },
   "app.onboarding.lab.description": {
-    "message": "The Lab keeps local Minecraft tools inside the launcher, without another website or account."
+    "message": "The Lab keeps Minecraft creation, world, and maintenance tools inside the launcher."
   },
   "app.onboarding.lab.title": {
     "message": "Useful tools, built in"
   },
-  "app.onboarding.language.description": {
-    "message": "Pick the launcher language and manage translations. No decoder ring required."
-  },
-  "app.onboarding.language.title": {
-    "message": "Speak your language"
-  },
   "app.onboarding.library-page.description": {
-    "message": "Filter by modpack, server, or custom setup, then open any instance to manage it."
+    "message": "Switch between all instances, modpacks, and custom setups, then open any instance to manage it."
   },
   "app.onboarding.library-page.title": {
     "message": "Everything, in its place"
@@ -5925,29 +5949,17 @@
     "message": "Make it yours"
   },
   "app.onboarding.skins-page.description": {
-    "message": "Add, preview, sort, and apply skins here. No pressure to sign in just yet."
+    "message": "Select a profile, preview its available skins, and apply changes when that account supports skin management."
   },
   "app.onboarding.skins-page.title": {
     "message": "Your skin drawer"
   },
   "app.onboarding.skins.description": {
-    "message": "Keep your Minecraft skins together. Signing in can wait until you feel like it."
+    "message": "Choose a skin site player or Minecraft account, then preview and apply the skins available to that profile."
   },
   "app.onboarding.skins.title": {
     "message": "A new look, maybe"
   },
-  "app.onboarding.translation.description": {
-    "message": "Translate Modrinth project titles, summaries, and descriptions while you browse. Keep the original, show both, or make the translation the main character."
-  },
-  "app.onboarding.translation.title": {
-    "message": "Translation, the Starlight way"
-  },
-  "app.onboarding.updates.description": {
-    "message": "Choose when Starlight checks for updates and whether it installs them for you."
-  },
-  "app.onboarding.updates.title": {
-    "message": "Stay in the loop"
-  },
   "app.onboarding.welcome.description": {
     "message": "Your instances, content, worlds, and downloads now have one home. Let us take a quick lap before you settle in."
   },
@@ -6836,6 +6848,12 @@
   "app.settings.defaults.environment-variables-placeholder": {
     "message": "Enter environment variables..."
   },
+  "app.settings.defaults.force-unicode-font": {
+    "message": "Force Unicode font"
+  },
+  "app.settings.defaults.force-unicode-font-description": {
+    "message": "Use the Unicode font when initializing a new instance. Off by default; existing font settings are preserved."
+  },
   "app.settings.defaults.fullscreen": {
     "message": "Fullscreen"
   },
@@ -7745,6 +7763,27 @@
   "app.skins.section.tiny-takeover": {
     "message": "Tiny Takeover"
   },
+  "app.skins.skin-site-account.description": {
+    "message": "Select a skin below and apply it directly to {player}."
+  },
+  "app.skins.skin-site-account.empty-description": {
+    "message": "This skin site account does not have an available player profile yet."
+  },
+  "app.skins.skin-site-account.empty-title": {
+    "message": "No players available"
+  },
+  "app.skins.skin-site-account.loading-description": {
+    "message": "The launcher is synchronizing the players attached to your account."
+  },
+  "app.skins.skin-site-account.loading-title": {
+    "message": "Loading skin site players…"
+  },
+  "app.skins.skin-site-account.mojang-description": {
+    "message": "{player} is an official Minecraft player. Its skin remains managed by the official account provider."
+  },
+  "app.skins.skin-site-account.title": {
+    "message": "StarLight skin site player"
+  },
   "app.skins.sign-in.axolotl-alt": {
     "message": "Starlight Launcher"
   },
@@ -10074,13 +10113,13 @@
     "message": "World is in use"
   },
   "minecraft-account.add-microsoft-account": {
-    "message": "Add Microsoft account"
+    "message": "Add your own Minecraft account"
   },
   "minecraft-account.add-offline-account": {
     "message": "Add offline account"
   },
-  "minecraft-account.add-third-party-account": {
-    "message": "Add third-party account"
+  "minecraft-account.sign-in-starlight": {
+    "message": "Sign in to StarLight Skin Site"
   },
   "minecraft-account.copy-uuid": {
     "message": "Copy UUID"
@@ -10142,8 +10181,11 @@
   "minecraft-account.offline-mode": {
     "message": "Offline mode"
   },
-  "minecraft-account.offline-mode.description": {
-    "message": "Only offline accounts are available. You can launch fully downloaded instances."
+  "minecraft-account.offline-mode.description.no-internet": {
+    "message": "It looks like this device may not be connected to the internet. You can currently only launch fully downloaded instances and will most likely be unable to connect to StarLight servers. Check your network connection. If you are using a proxy, try disabling or enabling it, then refresh the connection status below."
+  },
+  "minecraft-account.offline-mode.description.server-unavailable": {
+    "message": "Your internet connection is working, but StarLight's authentication server cannot be reached. The StarLight server may be undergoing maintenance, or your proxy may be misconfigured. If you are using a proxy, try disabling or enabling it, then refresh the connection status below. If that does not help, contact a server administrator in the StarLight community group to confirm the maintenance status."
   },
   "minecraft-account.offline-mode.refresh": {
     "message": "Refresh connection status"

apps/app-frontend/src/locales/zh-CN/index.json

@@ -1,4 +1,87 @@
 {
+	"app.instance-player.title": { "message": "选择实例玩家" },
+	"app.instance-player.remember": { "message": "选择后，此实例将一直使用该玩家。可在实例设置中切换。" },
+	"app.instance-player.restore": { "message": "请重新登录 {name}；要更换玩家，请前往实例设置。" },
+	"app.instance-player.loading": { "message": "正在读取已登录的玩家…" },
+	"app.instance-player.licensed": { "message": "正版玩家" },
+	"app.instance-player.skin": { "message": "皮肤站玩家" },
+	"app.instance-player.offline": { "message": "离线玩家" },
+	"app.instance-player.empty": { "message": "当前账号没有可用的皮肤站玩家，可在皮肤站创建玩家。" },
+	"app.instance-player.sign-in": { "message": "请登录账号后选择玩家。" },
+	"app.instance-player.retry": { "message": "重试" },
+	"app.instance-player.skin-login": { "message": "登录皮肤站" },
+	"app.instance-player.or": { "message": "或者" },
+	"app.instance-player.use-microsoft": { "message": "使用正版账号" },
+	"app.instance-player.saving": { "message": "正在保存实例玩家…" },
+	"app.instance-player.setting": { "message": "实例玩家" },
+	"app.instance-player.first-launch": { "message": "首次启动时选择玩家" },
+	"app.instance-player.change": { "message": "切换实例玩家" },
+  "app.hosted-mods.title": { "message": "正在更新服务器 Mod" },
+  "app.hosted-mods.description": { "message": "所有更新安装完成后将继续启动游戏。" },
+  "app.hosted-mods.complete": { "message": "下载完成" },
+  "app.hosted-mods.downloads": { "message": "查看下载" },
+  "app.hosted-mods.close": { "message": "关闭" },
+  "app.hosted-packs.progress.retry": { "message": "返回实例重试" },
+  "app.hosted-packs.progress.preparing": { "message": "正在准备整合包安装…" },
+  "app.hosted-packs.progress.downloads": { "message": "查看下载" },
+  "app.hosted-packs.open-instance": { "message": "打开已安装实例" },
+  "app.hosted-packs.retry-install": { "message": "重试安装" },
+  "app.hosted-packs.auto-installing": { "message": "正在下载并安装服务器整合包…" },
+  "app.hosted-packs.auto-description": { "message": "从StarLight服务器获取整合包并自动安装，可一键游玩StarLight服务器" },
+  "app.hosted-packs.auto-install": { "message": "安装 StarLight 官方整合包" },
+  "app.hosted-install.game-dir.header": { "message": "选择游戏目录" },
+  "app.hosted-install.game-dir.description": { "message": "StarLight 实例的游戏数据（mods、存档、配置、资源包）会存放在外部游戏目录中。请选择一个根目录，整合包会在其中单独建一个子文件夹。" },
+  "app.hosted-install.game-dir.label": { "message": "游戏目录根路径" },
+  "app.hosted-install.game-dir.browse": { "message": "浏览" },
+  "app.hosted-install.game-dir.no-selection": { "message": "尚未选择文件夹" },
+  "app.hosted-install.game-dir.reset-default": { "message": "使用默认位置" },
+  "app.hosted-install.game-dir.preview": { "message": "游戏文件将安装到：{path}" },
+  "app.hosted-install.game-dir.confirm": { "message": "安装" },
+  "app.onboarding.instance-mode.title": { "message": "选择实例类型" },
+  "app.onboarding.instance-mode.description": { "message": "StarLight 实例自动安装管理员指定的整合包和版本，每次启动先检查并完成更新，需要登录 StarLight 账号。本地实例可自选版本和整合包，适合第三方服务器与单人游玩。" },
+  "app.instance-mode.title": { "message": "实例类型" },
+  "app.instance-mode.starlight": { "message": "StarLight 实例" },
+  "app.instance-mode.local": { "message": "本地实例" },
+  "app.instance-mode.starlight-description": { "message": "游玩 StarLight 服务器必选。自动安装服务器指定的整合包、游戏版本和加载器。每次启动需要登录 StarLight，检查并完成更新后再进入游戏。" },
+  "app.instance-mode.local-description": { "message": "不会同步 StarLight 服务器的变更。跳过同步检查，启动更快，可自选整合包安装，更适合第三方服务器与本地个人游玩。" },
+  "app.instance-mode.saving": { "message": "正在应用实例类型，并按需安装服务器整合包…" },
+  "app.instance-mode.loading": { "message": "正在读取实例类型…" },
+  "app.instance-mode.retry": { "message": "重试" },
+  "app.instance-mode.local-packs-title": { "message": "本地整合包" },
+  "app.instance-mode.local-packs": { "message": "可以自选整合包并安装为本地实例。切换为本地后保留现有游戏文件和存档，之后不再同步 StarLight 的变更。" },
+  "app.instance-mode.browse": { "message": "浏览整合包" },
+  "app.instance-mode.import": { "message": "导入为本地实例" },
+  "app.hosted-packs.management": {"message": "内容管理"},
+  "app.hosted-packs.mods": {"message": "管理 Mod"},
+  "app.hosted-packs.packs": {"message": "管理整合包"},
+  "app.hosted-packs.title": { "message": "服务器管理的整合包" },
+  "app.hosted-packs.description": { "message": "整合包和版本由管理员指定。每次启动都会检查服务器更新，有变更时先下载并安装，再启动游戏。需要有效的 StarLight 登录状态和网络连接。" },
+  "app.hosted-packs.refresh": {"message": "刷新"},
+  "app.hosted-packs.loading": {"message": "正在获取已发布整合包…"},
+  "app.hosted-packs.bound": {"message": "已安装：{name} · {version}"},
+  "app.hosted-packs.syncing": {"message": "正在比对文件并同步变动…"},
+  "app.hosted-packs.complete": {"message": "已同步至 {version}，变更 {count} 个文件，下载 {size} MiB。"},
+  "app.hosted-packs.preserved": {"message": "保留了 {count} 个本地修改或个人文件"},
+  "app.hosted-packs.empty": {"message": "暂无审核通过的整合包。"},
+  "app.hosted-packs.update": {"message": "立即同步"},
+  "app.hosted-packs.install": { "message": "重试自动安装" },
+  "app.home.luck.title": { "message": "每日幸运指数" },
+  "app.home.luck.get": { "message": "一键获取" },
+  "app.home.luck.login-to-get": { "message": "登录后获取" },
+  "app.home.luck.loading": { "message": "正在询问小精灵..." },
+  "app.home.luck.error": { "message": "小精灵暂时没有回应，请稍后重试。" },
+  "app.home.luck.out-of": { "message": "满分 100" },
+  "minecraft-account.skin-site.signed-in": { "message": "已登录 StarLight皮肤站" },
+  "minecraft-account.skin-site.checking": { "message": "正在验证皮肤站登录状态…" },
+  "minecraft-account.skin-site.sync-error": {
+    "message": "暂时无法验证皮肤站登录状态，将自动重试。"
+  },
+  "minecraft-account.skin-site.players": { "message": "皮肤站玩家（{count}）" },
+  "minecraft-account.skin-site.players.retry": { "message": "重试" },
+  "minecraft-account.skin-site.players.empty": { "message": "这个皮肤站账号还没有玩家。" },
+  "minecraft-account.skin-site.players.error": {
+    "message": "暂时无法刷新玩家列表，已保留上一次结果。"
+  },
   "app.easteregg.color-mine.title": {
     "message": "星光矿井：彩域"
   },
@@ -297,7 +380,7 @@
     "message": "显示更多运行中的实例"
   },
   "app.action-bar.stop-instance": {
-    "message": "停止实例"
+    "message": "停止当前窗口"
   },
   "app.action-bar.update": {
     "message": "更新"
@@ -2966,6 +3049,15 @@
   "app.instance.launch-instance": {
     "message": "启动实例"
   },
+  "app.instance.launch-another": {
+    "message": "再开一个窗口"
+  },
+  "app.action-bar.window-started": {
+    "message": "{time, time, medium} 启动"
+  },
+  "app.instance.stop-all": {
+    "message": "停止此实例全部窗口"
+  },
   "app.instance.linked-to": {
     "message": "关联到"
   },
@@ -5069,6 +5161,9 @@
   "app.lab.skin-editor.retry": {
     "message": "重试"
   },
+  "app.lab.skin-editor.resource-error": {
+    "message": "皮肤编辑器文件缺失或损坏，请重新安装启动器，或完整解压便携版。"
+  },
   "app.lab.skin-editor.title": {
     "message": "皮肤编辑器"
   },
@@ -5369,8 +5464,8 @@
   "app.minecraft-crash.view-mod-changes": {
     "message": "查看 Mod 变化"
   },
-  "app.minecraft.playing-as": {
-    "message": "当前游玩账号："
+  "app.minecraft.user-information": {
+    "message": "用户信息"
   },
   "app.modal.install-to-play.content-required": {
     "message": "需求内容"
@@ -5762,12 +5857,6 @@
   "app.notification.warning": {
     "message": "警告"
   },
-  "app.onboarding.account.description": {
-    "message": "想登录、切换账号或看看个人资料，随时来这里。没人打卡。"
-  },
-  "app.onboarding.account.title": {
-    "message": "账号，随你安排"
-  },
   "app.onboarding.action.click-create": {
     "message": "点击创建新实例，继续"
   },
@@ -5804,33 +5893,12 @@
   "app.onboarding.action.finish-area": {
     "message": "点击任意位置，收工"
   },
-  "app.onboarding.action.open-gradient-text": {
-    "message": "打开渐变文字生成器，继续"
-  },
-  "app.onboarding.action.open-recipe-generator": {
-    "message": "打开配方生成器，继续"
-  },
-  "app.onboarding.action.open-schematic-workshop": {
-    "message": "打开投影工坊，继续"
-  },
-  "app.onboarding.action.open-seed-map": {
-    "message": "打开种子地图，继续"
-  },
-  "app.onboarding.action.return-lab": {
-    "message": "点击实验室，继续"
-  },
   "app.onboarding.action.skip": {
     "message": "先不逛了"
   },
   "app.onboarding.action.start": {
     "message": "带我逛逛"
   },
-  "app.onboarding.ai.description": {
-    "message": "统一连接文本模型供应商、选择要使用的模型，也可在这里一键关闭所有 AI 功能。"
-  },
-  "app.onboarding.ai.title": {
-    "message": "连接你的 AI 供应商"
-  },
   "app.onboarding.appearance.description": {
     "message": "主题、强调色、背景和窗口效果都在这里。把启动器调成你熟悉的样子。"
   },
@@ -5909,26 +5977,14 @@
   "app.onboarding.favorites.title": {
     "message": "留个清单"
   },
-  "app.onboarding.home-customize.description": {
-    "message": "使用右下角的编辑控件添加、调整和配置小组件。编辑时可在自动排满的网格与保留空格的自由网格之间切换。"
-  },
-  "app.onboarding.home-customize.title": {
-    "message": "按你的方式排列"
-  },
   "app.onboarding.home-layout.description": {
-    "message": "使用右下角控件切换信息主页和极简主页；小组件编辑仅在信息主页中提供。"
+    "message": "使用右下角控件在 StarLight 皮肤站主页与专注的实例启动页之间切换。"
   },
   "app.onboarding.home-layout.title": {
-    "message": "切换信息密度"
-  },
-  "app.onboarding.home-widgets.description": {
-    "message": "信息主页由最近活动、游玩时间、实例、世界和服务器小组件组成。窗口或账号侧边栏变化时，网格会自动重排。"
-  },
-  "app.onboarding.home-widgets.title": {
-    "message": "你的主页，你的布局"
+    "message": "切换主页样式"
   },
   "app.onboarding.instance-actions.description": {
-    "message": "从实例页头部启动、停止、修复、配置、导出或打开这个实例。"
+    "message": "从这里启动或配置实例。运行中可再开一个窗口，顶部运行列表可单独停止某个窗口。首次启动选择玩家后会自动记住，之后可在实例设置中切换。"
   },
   "app.onboarding.instance-actions.title": {
     "message": "主操作台"
@@ -5939,56 +5995,20 @@
   "app.onboarding.instance-tabs.title": {
     "message": "剩下的工作台"
   },
-  "app.onboarding.java.description": {
-    "message": "启动 Minecraft 的 Java 运行环境在这。技术活，但它很听话。"
-  },
-  "app.onboarding.java.title": {
-    "message": "Java，在后台"
-  },
-  "app.onboarding.lab-editor.description": {
-    "message": "编辑文本、选择颜色、实时预览，并复制适用于 Minecraft 配置的格式。"
-  },
-  "app.onboarding.lab-editor.title": {
-    "message": "在同一处编辑和复制"
-  },
-  "app.onboarding.lab-recipe-generator.description": {
-    "message": "选择 Java 版本、填充配方槽位，然后在本地复制或导出 JSON。"
-  },
-  "app.onboarding.lab-recipe-generator.title": {
-    "message": "制作数据包配方"
-  },
-  "app.onboarding.lab-schematic.description": {
-    "message": "打开本地 .litematic 或 .schem 文件，也可以从已安装实例中选择。3D 工作区集中提供查看、测量、图层控制、材料统计和本地编辑。"
-  },
-  "app.onboarding.lab-schematic.title": {
-    "message": "放置前先检查建筑"
-  },
-  "app.onboarding.lab-seed-map.description": {
-    "message": "输入种子或从实例载入，然后在本地地图中查看群系、结构与矿物图层。"
-  },
-  "app.onboarding.lab-seed-map.title": {
-    "message": "加载世界前先找到它"
-  },
   "app.onboarding.lab-tools.description": {
-    "message": "生成带格式的文字、探索 Java 世界，并直接在启动器中检查投影建筑。"
+    "message": "在本地编辑皮肤、生成格式文字与配方、探索种子、检查投影并翻译模组。"
   },
   "app.onboarding.lab-tools.title": {
     "message": "Minecraft 本地工具"
   },
   "app.onboarding.lab.description": {
-    "message": "实验室将本地 Minecraft 工具放进启动器，无需打开其他网站或注册额外账号。"
+    "message": "实验室把 Minecraft 创作、世界与维护工具集中放在启动器里。"
   },
   "app.onboarding.lab.title": {
     "message": "内置的实用工具"
   },
-  "app.onboarding.language.description": {
-    "message": "在这里选择启动器语言和管理翻译。不需要翻译腔。"
-  },
-  "app.onboarding.language.title": {
-    "message": "说你的语言"
-  },
   "app.onboarding.library-page.description": {
-    "message": "按整合包、服务器或自定义配置筛选，再打开任意实例管理。"
+    "message": "在全部实例、整合包和自定义配置之间切换，再打开任意实例进行管理。"
   },
   "app.onboarding.library-page.title": {
     "message": "各就各位"
@@ -6015,29 +6035,17 @@
     "message": "按你的方式使用"
   },
   "app.onboarding.skins-page.description": {
-    "message": "在这里添加、预览、排序和应用皮肤。现在不登录也完全没关系。"
+    "message": "选择玩家资料，预览可用皮肤；账号支持皮肤管理时，还可以直接应用更改。"
   },
   "app.onboarding.skins-page.title": {
     "message": "你的皮肤抽屉"
   },
   "app.onboarding.skins.description": {
-    "message": "把 Minecraft 皮肤放在一起管理。想登录的时候再登录。"
+    "message": "选择皮肤站玩家或 Minecraft 账号，然后预览并应用该玩家可用的皮肤。"
   },
   "app.onboarding.skins.title": {
     "message": "换个造型吧"
   },
-  "app.onboarding.translation.description": {
-    "message": "浏览时直接翻译 Modrinth 项目的标题、摘要和介绍。保留原文、双语同屏，或者让译文站 C 位，都由你决定。"
-  },
-  "app.onboarding.translation.title": {
-    "message": "翻译，是 Starlight 的拿手活"
-  },
-  "app.onboarding.updates.description": {
-    "message": "决定 Starlight 何时检查更新，以及是否替你安装。"
-  },
-  "app.onboarding.updates.title": {
-    "message": "保持在线"
-  },
   "app.onboarding.welcome.description": {
     "message": "实例、内容、世界和下载，现在都有了同一个家。正式开玩之前，先快速逛一圈。"
   },
@@ -6899,6 +6907,12 @@
   "app.settings.defaults.environment-variables-placeholder": {
     "message": "输入环境变量……"
   },
+  "app.settings.defaults.force-unicode-font": {
+    "message": "强制使用 Unicode 字体"
+  },
+  "app.settings.defaults.force-unicode-font-description": {
+    "message": "初始化新实例时使用 Unicode 字体。默认关闭；实例已有的字体设置会保留。"
+  },
   "app.settings.defaults.fullscreen": {
     "message": "全屏"
   },
@@ -7820,6 +7834,27 @@
   "app.skins.section.tiny-takeover": {
     "message": "小鬼当家"
   },
+  "app.skins.skin-site-account.description": {
+    "message": "在下方选择皮肤后，可直接应用到 {player}。"
+  },
+  "app.skins.skin-site-account.empty-description": {
+    "message": "这个皮肤站账号暂时没有可用的玩家角色。"
+  },
+  "app.skins.skin-site-account.empty-title": {
+    "message": "暂无可用玩家"
+  },
+  "app.skins.skin-site-account.loading-description": {
+    "message": "启动器正在同步此账号绑定的玩家。"
+  },
+  "app.skins.skin-site-account.loading-title": {
+    "message": "正在加载皮肤站玩家……"
+  },
+  "app.skins.skin-site-account.mojang-description": {
+    "message": "{player} 是正版 Minecraft 玩家，其皮肤仍由正版账号服务管理。"
+  },
+  "app.skins.skin-site-account.title": {
+    "message": "StarLight 皮肤站玩家"
+  },
   "app.skins.sign-in.axolotl-alt": {
     "message": "Starlight Launcher"
   },
@@ -10155,13 +10190,13 @@
     "message": "世界正在使用中"
   },
   "minecraft-account.add-microsoft-account": {
-    "message": "添加 Microsoft 账户"
+    "message": "添加自己的正版账号"
   },
   "minecraft-account.add-offline-account": {
     "message": "添加离线账户"
   },
-  "minecraft-account.add-third-party-account": {
-    "message": "添加第三方账号"
+  "minecraft-account.sign-in-starlight": {
+    "message": "登录 StarLight皮肤站"
   },
   "minecraft-account.copy-uuid": {
     "message": "复制 UUID"
@@ -10223,8 +10258,11 @@
   "minecraft-account.offline-mode": {
     "message": "离线模式"
   },
-  "minecraft-account.offline-mode.description": {
-    "message": "仅可使用离线账号，并且只能启动已完整下载的实例。这通常是因为你的电脑无法连接到Mojang的认证服务器，请检查网络连接。如果你正在使用代理，请关闭或开启代理后点击下方按钮刷新连接状态。"
+  "minecraft-account.offline-mode.description.no-internet": {
+    "message": "看起来本机似乎并没有连接到互联网，您目前只能启动已完整下载的实例，且极可能无法连接到StarLight服务器，请检查网络连接。如果您正在使用代理，请关闭或开启代理后点击下方按钮刷新连接状态。"
+  },
+  "minecraft-account.offline-mode.description.server-unavailable": {
+    "message": "您目前网络正常，但无法连接到StarLight验证服务器；这可能是由于StarLight服务器正在维护，或者您配置的代理存在问题。如果您正在使用代理，请关闭或开启代理后点击下方按钮刷新连接状态；若该操作不生效，请前往StarLight交流群，联系服务器管理确认服务器的维护状态。"
   },
   "minecraft-account.offline-mode.refresh": {
     "message": "刷新连接状态"
@@ -10259,6 +10297,9 @@
   "minecraft-account.third-party-modal.description": {
     "message": "使用 StarLight 皮肤站账号登录。"
   },
+  "minecraft-account.third-party-modal.littleskin": {
+    "message": "使用 LittleSkin"
+  },
   "minecraft-account.third-party-modal.password": {
     "message": "密码"
   },