chore: 补充 1.0.2-beta7 更新公告

汇总 beta6 以来的改动：实时日志积压修复、更新通道默认值跟随安装
包版本、Linux 游戏目录默认回退到用户主目录。

.github/workflows/changelog-comment.yml

@@ -12,7 +12,7 @@ on:
 
 permissions:
   issues: write
-  pull-requests: read
+  pull-requests: write
 
 jobs:
   comment:
@@ -21,7 +21,7 @@ jobs:
 
     permissions:
       issues: write
-      pull-requests: read
+      pull-requests: write
       contents: read
 
     steps:

.github/workflows/check-rust.yml

@@ -22,5 +22,5 @@ jobs:
           node-version-file: .nvmrc
       - uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable
       - uses: cargo-bins/cargo-binstall@dc19f1e48450eefe5a29b8da6c6b00a87d730b37 # v1.18.1
-      - run: cargo binstall --no-confirm cargo-shear
+      - run: cargo binstall --no-confirm cargo-shear@1.13.4
       - run: cargo shear

Cargo.lock

@@ -6841,7 +6841,7 @@ dependencies = [
 
 [[package]]
 name = "theseus"
-version = "1.0.0-beta15"
+version = "1.0.2-beta7"
 dependencies = [
  "ariadne",
  "async-minecraft-ping",
@@ -6945,7 +6945,7 @@ dependencies = [
 
 [[package]]
 name = "theseus_gui"
-version = "1.0.0-beta15"
+version = "1.0.2-beta7"
 dependencies = [
  "ashpd",
  "async_zip",

_typos.toml

@@ -14,6 +14,8 @@ extend-exclude = [
   "packages/app-lib/src/api/content_search/WikiEntries.txt",
   # Bundled Monaco editor runtime contains upstream generated assets.
   "apps/app-frontend/public/monaco/",
+  # Minecraft language-name data (from mcmeta); contains language codes that look like typos.
+  "apps/app-frontend/src/components/ui/settings/instances/game-settings-modal/languages.ts",
 ]
 
 [default.extend-words]

apps/app-frontend/package.json

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

apps/app-frontend/src/App.vue

@@ -72,6 +72,7 @@ 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 AnniversaryCelebration from '@/components/ui/AnniversaryCelebration.vue'
 import AppActionBar from '@/components/ui/AppActionBar.vue'
 import AxolotlLogo from '@/components/ui/AxolotlLogo.vue'
 import Breadcrumbs from '@/components/ui/Breadcrumbs.vue'
@@ -94,6 +95,7 @@ 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 RemoteAnnouncements from '@/components/ui/RemoteAnnouncements.vue'
 import StartupAnnouncementModal from '@/components/ui/StartupAnnouncementModal.vue'
 import SplashScreen from '@/components/ui/SplashScreen.vue'
 import WindowControls from '@/components/ui/WindowControls.vue'
@@ -167,6 +169,7 @@ import { createServerInstall, provideServerInstall } from '@/providers/server-in
 import { setupProviders } from '@/providers/setup'
 import { setupAuthProvider } from '@/providers/setup/auth'
 import { setupLoadingStateProvider } from '@/providers/setup/loading-state'
+import { setupKeyboardShortcuts } from '@/composables/useKeyboardShortcuts'
 import { useError } from '@/store/error.js'
 import { useTheming } from '@/store/state'
 
@@ -182,6 +185,8 @@ const onSchematicWorkshopPage = computed(() => route.path === '/lab/schematic-pr
 const isSchematicFile = (path: string) => /\.(litematic|schematic|schem)$/i.test(path)
 const APP_LEFT_NAV_WIDTH = '4rem'
 
+setupKeyboardShortcuts()
+
 const discoverContentPath = computed(() => {
 	const projectType = route.params.projectType
 	if (
@@ -2221,10 +2226,12 @@ provideAppUpdateDownloadProgress(appUpdateDownload)
 </script>
 
 <template>
+	<AnniversaryCelebration />
 	<SplashScreen v-if="!stateFailed" ref="splashScreen" data-tauri-drag-region />
 	<SkinSiteSessionFrame v-if="stateInitialized" />
 	<InstancePlayerModal v-if="stateInitialized" />
 	<StartupAnnouncementModal ref="startupAnnouncementModal" />
+	<RemoteAnnouncements :ready="stateInitialized && !showOnboarding && !stateFailed" />
 	<div id="teleports"></div>
 	<div
 		v-if="stateInitialized && themeStore.customBackgroundPath && !themeStore.transparentBackground"

apps/app-frontend/src/announcements/catalog.ts

@@ -32,6 +32,203 @@ export const ANNOUNCEMENT_CHANGE_TYPES: readonly AnnouncementChangeType[] = [
 ]
 
 export const launcherAnnouncements: readonly LauncherAnnouncement[] = [
+	{
+		id: 'launcher-1.0.2-beta7',
+		version: '1.0.2-beta7',
+		publishedAt: '2026-10-17',
+		title: {
+			'en-US': 'Starlight Launcher 1.0.2-beta7',
+			'zh-CN': 'Starlight Launcher 1.0.2-beta7',
+		},
+		changes: {
+			fixed: [
+				{
+					'en-US': 'Fixed real-time log backlog that could stall the console under heavy output.',
+					'zh-CN': '修复实时日志积压导致控制台卡顿的问题。',
+				},
+				{
+					'en-US': 'The update channel now defaults to the build type: installing a Beta build starts on the Beta channel instead of Release.',
+					'zh-CN': '更新通道默认值改为跟随安装包版本：安装 Beta 版后默认使用 Beta 通道，不再回落为 Release。',
+				},
+				{
+					'en-US': 'On Linux, the default game directory for StarLight instances no longer points at the system install path (e.g. /usr/bin); it falls back to the home directory.',
+					'zh-CN': 'Linux 上 StarLight 实例的默认游戏目录不再指向系统安装路径（如 /usr/bin），改为回退到用户主目录。',
+				},
+			],
+		},
+	},
+	{
+		id: 'launcher-1.0.2-beta6',
+		version: '1.0.2-beta6',
+		publishedAt: '2026-10-11',
+		title: {
+			'en-US': 'Starlight Launcher 1.0.2-beta6',
+			'zh-CN': 'Starlight Launcher 1.0.2-beta6',
+		},
+		changes: {
+			added: [
+				{
+					'en-US': 'Added keyboard shortcut settings: enable and rebind navigation and quick-scrolling shortcuts.',
+					'zh-CN': '新增键盘快捷键设置：可启用并自定义导航与快速滚动快捷键。',
+				},
+				{
+					'en-US': 'Added crash log sharing and AI analysis: share crash diagnostics to LogShare for a structured summary and optional AI analysis, with a rebuilt crash window that browses log files and streams the analysis.',
+					'zh-CN': '新增崩溃日志分享与 AI 分析：可将崩溃诊断分享到 LogShare 获取结构化摘要与 AI 分析；崩溃窗口重做为双栏布局，可浏览日志文件并流式查看分析结果。',
+				},
+				{
+					'en-US': 'Crash logs now also collect JVM crash reports (hs_err_pid*.log) and launcher logs.',
+					'zh-CN': '崩溃日志现在也会收集 JVM 崩溃报告（hs_err_pid*.log）与启动器日志。',
+				},
+				{
+					'en-US': 'Added a launcher log export entry.',
+					'zh-CN': '新增启动器日志导出入口。',
+				},
+				{
+					'en-US': 'Instance groups can now be reordered by dragging.',
+					'zh-CN': '实例分组支持拖拽重排。',
+				},
+			],
+			changed: [
+				{
+					'en-US': 'Synced the latest supported AI chat model list from LobeHub.',
+					'zh-CN': '同步 LobeHub 最新的 AI 聊天模型列表。',
+				},
+			],
+			fixed: [
+				{
+					'en-US': 'Fixed remote announcements not refreshing.',
+					'zh-CN': '修复远端公告不刷新的问题。',
+				},
+				{
+					'en-US': 'Completed the Chinese translations for the armor preview feature.',
+					'zh-CN': '补齐盔甲预览功能的中文翻译。',
+				},
+			],
+		},
+	},
+	{
+		id: 'launcher-1.0.2-beta5',
+		version: '1.0.2-beta5',
+		publishedAt: '2026-10-11',
+		title: {
+			'en-US': 'Starlight Launcher 1.0.2-beta5',
+			'zh-CN': 'Starlight Launcher 1.0.2-beta5',
+		},
+		changes: {
+			added: [
+				{
+					'en-US': 'Added a remote announcements center: a bell in the top bar opens a panel listing launcher announcements fetched from the Starlight skin site.',
+					'zh-CN': '新增远程公告中心：顶栏的铃铛可打开公告面板，展示从 Starlight 皮肤站拉取的启动器公告。',
+				},
+				{
+					'en-US': 'Added a custom Minecraft window title option: set a global toggle and default title, and let each instance override it. The game window is renamed on Windows.',
+					'zh-CN': '新增自定义 Minecraft 窗口标题：可设置全局开关与默认标题，并允许各实例单独覆盖；Windows 下会重命名游戏窗口。',
+				},
+			],
+			fixed: [
+				{
+					'en-US': 'Completed the Chinese translations for the armor preview feature.',
+					'zh-CN': '补齐盔甲预览功能的中文翻译。',
+				},
+			],
+		},
+	},
+	{
+		id: 'launcher-1.0.2-beta4',
+		version: '1.0.2-beta4',
+		publishedAt: '2026-10-08',
+		title: {
+			'en-US': 'Starlight Launcher 1.0.2-beta4',
+			'zh-CN': 'Starlight Launcher 1.0.2-beta4',
+		},
+		changes: {
+			added: [
+				{
+					'en-US': 'Added armor and armor-trim rendering to the skin preview, letting you try on armor pieces and trim patterns directly in the skin editor.',
+					'zh-CN': '皮肤预览新增盔甲与盔甲纹饰渲染，可在皮肤编辑器内直接试穿各部位盔甲并调整纹饰图案。',
+				},
+				{
+					'en-US': 'Armor preview selections in the skin editor are now saved locally, so they persist across sessions.',
+					'zh-CN': '皮肤编辑器中的盔甲预览选择现在会保存在本地，跨会话保留。',
+				},
+			],
+			changed: [
+				{
+					'en-US': 'Improved download scheduling to reduce concurrency automatically when tasks are waiting for capacity, making large Minecraft installations more reliable on constrained connections.',
+					'zh-CN': '优化下载任务调度：任务因容量不足排队时会自动降低并发，提升大型 Minecraft 版本在受限网络环境下的安装稳定性。',
+				},
+			],
+			fixed: [
+				{
+					'en-US': 'Fixed downloads timing out while waiting for internal connection capacity, which could cause Minecraft installations to fail even when the network was available.',
+					'zh-CN': '修复下载任务等待内部连接容量时过早超时，导致网络正常的情况下 Minecraft 安装仍可能失败的问题。',
+				},
+				{
+					'en-US': 'Fixed instance group changes not saving for some instances.',
+					'zh-CN': '修复部分实例的分组修改无法保存的问题。',
+				},
+			],
+		},
+	},
+	{
+		id: 'launcher-1.0.2-beta3',
+		version: '1.0.2-beta3',
+		publishedAt: '2026-10-04',
+		title: {
+			'en-US': 'Starlight Launcher 1.0.2-beta3',
+			'zh-CN': 'Starlight Launcher 1.0.2-beta3',
+		},
+		changes: {
+			fixed: [
+				{
+					'en-US': 'Fixed the anniversary celebration banner not showing above the window title bar, and made the banner background semi-transparent so the content behind it stays visible.',
+					'zh-CN': '修复周年庆庆祝横幅被窗口标题栏遮挡、无法显示的问题，并将横幅背景改为半透明，避免遮住下方内容。',
+				},
+			],
+		},
+	},
+	{
+		id: 'launcher-1.0.2-beta2',
+		version: '1.0.2-beta2',
+		publishedAt: '2026-10-04',
+		title: {
+			'en-US': 'Starlight Launcher 1.0.2-beta2',
+			'zh-CN': 'Starlight Launcher 1.0.2-beta2',
+		},
+		changes: {
+			fixed: [
+				{
+					'en-US': 'Fixed the launcher failing to start with "no such table: synced_pack_catalog": the cross-instance sync migration was missing the synced_pack_catalog and synced_pack_instances tables.',
+					'zh-CN': '修复启动器因 "no such table: synced_pack_catalog" 无法启动的问题：跨实例同步迁移遗漏了 synced_pack_catalog 与 synced_pack_instances 两张表。',
+				},
+			],
+		},
+	},
+	{
+		id: 'launcher-1.0.2-beta1',
+		version: '1.0.2-beta1',
+		publishedAt: '2026-10-04',
+		title: {
+			'en-US': 'Starlight Launcher 1.0.2-beta1',
+			'zh-CN': 'Starlight Launcher 1.0.2-beta1',
+		},
+		changes: {
+			added: [
+				{
+					'en-US': 'Cross-instance sync: share game options, resource packs, data packs, multiplayer servers, command history, and creative hotbars across instances, with per-option toggles and a fine-grained game-settings editor.',
+					'zh-CN': '跨实例同步：可跨实例共享游戏选项、资源包、数据包、多人服务器、命令历史与创造模式快捷栏，支持逐项开关与精细的游戏设置编辑器。',
+				},
+				{
+					'en-US': 'Starlight turns 12! On October 4th every year the launcher now shows a celebration banner and falling confetti. The anniversary number is computed from 2014.',
+					'zh-CN': 'Starlight 十二周年！每年 10 月 4 日，启动器会显示庆祝横幅与飘落的彩带、蛋糕，周年数按 2014 年起算。',
+				},
+				{
+					'en-US': 'Added a developer feature flag to preview the anniversary celebration at any time.',
+					'zh-CN': '新增开发者功能开关，可随时预览周年庆效果。',
+				},
+			],
+		},
+	},
 	{
 		id: 'launcher-1.0.1',
 		version: '1.0.1',

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

@@ -0,0 +1,246 @@
+<script setup lang="ts">
+import { defineMessages, useVIntl } from '@modrinth/ui'
+import { computed, onUnmounted, ref, watch } from 'vue'
+
+import { anniversaryYear, ordinal, shouldCelebrate } from '@/helpers/anniversary'
+import { useTheming } from '@/store/state'
+
+const { formatMessage } = useVIntl()
+const themeStore = useTheming()
+
+const messages = defineMessages({
+	banner: {
+		id: 'app.anniversary.banner',
+		defaultMessage: 'Happy {ordinal} Anniversary, Starlight!',
+	},
+})
+
+/** Emoji that drift down from the top of the window. */
+const CONFETTI_EMOJI = ['🎂', '🎉', '🎊', '🎈', '✨', '🧁', '🍰']
+
+type Confetti = {
+	id: number
+	emoji: string
+	left: number
+	delay: number
+	duration: number
+	size: number
+	drift: number
+}
+
+const visible = ref(false)
+const years = ref(0)
+const confetti = ref<Confetti[]>([])
+let spawnTimer: number | undefined
+let nextId = 0
+
+function spawnConfetti(): void {
+	const emoji = CONFETTI_EMOJI[Math.floor(Math.random() * CONFETTI_EMOJI.length)]
+	confetti.value.push({
+		id: nextId++,
+		emoji,
+		left: Math.random() * 100,
+		delay: 0,
+		duration: 6 + Math.random() * 5,
+		size: 1 + Math.random() * 1.4,
+		drift: (Math.random() - 0.5) * 160,
+	})
+	// Keep the DOM small; drop the oldest once we exceed a cap.
+	if (confetti.value.length > 60) confetti.value.splice(0, 10)
+}
+
+const forced = computed(() => themeStore.getFeatureFlag('force_anniversary_celebration'))
+
+function startCelebration(): void {
+	if (spawnTimer !== undefined) return
+	years.value = anniversaryYear()
+	visible.value = true
+	// Seed a few so the screen is not empty on the first frame.
+	for (let i = 0; i < 12; i++) spawnConfetti()
+	spawnTimer = window.setInterval(spawnConfetti, 700)
+}
+
+function stopCelebration(): void {
+	if (spawnTimer !== undefined) {
+		window.clearInterval(spawnTimer)
+		spawnTimer = undefined
+	}
+	confetti.value = []
+	visible.value = false
+}
+
+watch(
+	() => shouldCelebrate(forced.value),
+	(active) => (active ? startCelebration() : stopCelebration()),
+	{ immediate: true },
+)
+
+onUnmounted(stopCelebration)
+
+const bannerText = computed(() =>
+	formatMessage(messages.banner, { ordinal: ordinal(years.value) }),
+)
+</script>
+
+<template>
+	<Transition name="anniversary-fade">
+		<div v-if="visible" class="anniversary-root" aria-live="polite">
+			<!-- Falling confetti layer (click-through). -->
+			<div class="anniversary-confetti" aria-hidden="true">
+				<span
+					v-for="piece in confetti"
+					:key="piece.id"
+					class="anniversary-piece"
+					:style="{
+						left: piece.left + '%',
+						fontSize: piece.size + 'rem',
+						animationDelay: piece.delay + 's',
+						animationDuration: piece.duration + 's',
+						'--drift': piece.drift + 'px',
+					}"
+				>
+					{{ piece.emoji }}
+				</span>
+			</div>
+
+			<!-- Top banner. -->
+			<div class="anniversary-banner">
+				<span class="anniversary-banner-emoji">🎂</span>
+				<span class="anniversary-banner-text">{{ bannerText }}</span>
+				<span class="anniversary-banner-emoji">🎉</span>
+			</div>
+		</div>
+	</Transition>
+</template>
+
+<style scoped>
+.anniversary-root {
+	position: fixed;
+	inset: 0;
+	/* Above content, below modals/drag overlays (which use z-[200]). */
+	z-index: 150;
+	pointer-events: none;
+}
+
+.anniversary-confetti {
+	position: absolute;
+	inset: 0;
+	overflow: hidden;
+}
+
+.anniversary-piece {
+	position: absolute;
+	top: -3rem;
+	will-change: transform;
+	animation-name: anniversary-fall;
+	animation-timing-function: linear;
+	animation-iteration-count: 1;
+	animation-fill-mode: forwards;
+}
+
+@keyframes anniversary-fall {
+	0% {
+		transform: translate3d(0, 0, 0) rotate(0deg);
+		opacity: 0;
+	}
+	10% {
+		opacity: 1;
+	}
+	100% {
+		transform: translate3d(var(--drift, 0), 110vh, 0) rotate(360deg);
+		opacity: 0.85;
+	}
+}
+
+.anniversary-banner {
+	position: absolute;
+	/* 避开原生窗口标题栏（Windows/macOS 系统装饰条会盖住 top:0 的内容）；
+	   titlebar-area-height 是 Tauri 暴露的标题栏高度变量，不支持时降级为 0 */
+	top: env(titlebar-area-height, 0px);
+	left: 0;
+	right: 0;
+	display: flex;
+	align-items: center;
+	justify-content: center;
+	gap: 0.5rem;
+	padding: 0.4rem 1rem;
+	font-weight: 700;
+	font-size: 0.95rem;
+	letter-spacing: 0.02em;
+	color: #fff;
+	/* 半透明深色兜底：即使下面的渐变背景失效，白字也不会在浅色页面上隐形 */
+	background-color: rgba(20, 16, 28, 0.35);
+	/* 半透明彩色渐变：让窗口下方的内容能透出来 */
+	background-image: linear-gradient(
+		90deg,
+		rgba(244, 114, 182, 0.8),
+		rgba(250, 204, 21, 0.8),
+		rgba(74, 222, 128, 0.8),
+		rgba(56, 189, 248, 0.8),
+		rgba(167, 139, 250, 0.8),
+		rgba(244, 114, 182, 0.8)
+	);
+	background-size: 300% 100%;
+	animation: anniversary-gradient 8s linear infinite;
+	box-shadow: 0 2px 12px rgba(0, 0, 0, 0.25);
+	text-shadow:
+		0 1px 2px rgba(0, 0, 0, 0.55),
+		0 0 4px rgba(0, 0, 0, 0.35);
+}
+
+.anniversary-banner-text {
+	animation: anniversary-pulse 1.8s ease-in-out infinite;
+}
+
+.anniversary-banner-emoji {
+	animation: anniversary-bounce 1.4s ease-in-out infinite;
+}
+
+@keyframes anniversary-gradient {
+	0% {
+		background-position: 0% 50%;
+	}
+	100% {
+		background-position: 300% 50%;
+	}
+}
+
+@keyframes anniversary-pulse {
+	0%,
+	100% {
+		transform: scale(1);
+	}
+	50% {
+		transform: scale(1.06);
+	}
+}
+
+@keyframes anniversary-bounce {
+	0%,
+	100% {
+		transform: translateY(0);
+	}
+	50% {
+		transform: translateY(-3px);
+	}
+}
+
+.anniversary-fade-enter-active,
+.anniversary-fade-leave-active {
+	transition: opacity 0.6s ease;
+}
+
+.anniversary-fade-enter-from,
+.anniversary-fade-leave-to {
+	opacity: 0;
+}
+
+@media (prefers-reduced-motion: reduce) {
+	.anniversary-piece,
+	.anniversary-banner,
+	.anniversary-banner-text,
+	.anniversary-banner-emoji {
+		animation: none;
+	}
+}
+</style>

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

@@ -67,6 +67,23 @@
 				</div>
 			</template>
 		</Dropdown>
+		<ButtonStyled
+			v-tooltip="formatMessage(messages.announcements)"
+			type="transparent"
+			circular
+		>
+			<button
+				:aria-label="formatMessage(messages.announcements)"
+				class="relative"
+				@click="openAnnouncementCenter"
+			>
+				<NewspaperIcon />
+				<span
+					v-if="announcementUnreadCount"
+					class="absolute right-0 top-0 size-2 rounded-full bg-red ring-2 ring-bg-raised"
+				/>
+			</button>
+		</ButtonStyled>
 		<ButtonStyled
 			v-if="!isDownloadsPage && hasActiveDownloads && !hasVisibleActiveDownloadToasts"
 			color="brand"
@@ -190,6 +207,7 @@
 <script setup lang="ts">
 import {
 	BellIcon,
+	NewspaperIcon,
 	DownloadIcon,
 	DropdownIcon,
 	OnlineIndicatorIcon,
@@ -211,7 +229,7 @@ import {
 } from '@modrinth/ui'
 import { convertFileSrc } from '@tauri-apps/api/core'
 import { Dropdown } from 'floating-vue'
-import { computed, onBeforeUnmount, ref, watch } from 'vue'
+import { computed, onBeforeUnmount, onMounted, ref, watch } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
 
 import AppUpdateButton from '@/components/ui/app-update-button/index.vue'
@@ -222,6 +240,10 @@ import { get_many as getInstances } from '@/helpers/instance'
 import { get_all as getRunningProcesses, kill as killProcess } from '@/helpers/process'
 import type { LoadingBar } from '@/helpers/state'
 import { progress_bars_list } from '@/helpers/state'
+import {
+	OPEN_REMOTE_ANNOUNCEMENT_CENTER_EVENT,
+	REMOTE_ANNOUNCEMENTS_UPDATED_EVENT,
+} from '@/helpers/remote-announcements'
 import type { GameInstance } from '@/helpers/types'
 import { downloadBarTypes, injectDownloadManager } from '@/providers/download-manager'
 
@@ -231,6 +253,25 @@ const popupNotificationManager = injectPopupNotificationManager()
 const downloadManager = injectDownloadManager()
 const { formatMessage } = useVIntl()
 
+const announcementUnreadCount = ref(0)
+
+function openAnnouncementCenter() {
+	window.dispatchEvent(new CustomEvent(OPEN_REMOTE_ANNOUNCEMENT_CENTER_EVENT))
+}
+
+function updateAnnouncementCount(event: Event) {
+	const detail = (event as CustomEvent<{ unreadKeys?: string[] }>).detail
+	announcementUnreadCount.value = detail?.unreadKeys?.length ?? 0
+}
+
+onMounted(() => {
+	window.addEventListener(REMOTE_ANNOUNCEMENTS_UPDATED_EVENT, updateAnnouncementCount)
+})
+
+onBeforeUnmount(() => {
+	window.removeEventListener(REMOTE_ANNOUNCEMENTS_UPDATED_EVENT, updateAnnouncementCount)
+})
+
 type NotificationHistoryItem = {
 	key: string
 	createdAt?: number
@@ -370,6 +411,10 @@ const messages = defineMessages({
 		id: 'app.action-bar.notifications',
 		defaultMessage: 'Notifications',
 	},
+	announcements: {
+		id: 'app.action-bar.announcements',
+		defaultMessage: 'Announcements',
+	},
 	clearNotifications: {
 		id: 'app.action-bar.notifications.clear',
 		defaultMessage: 'Clear all',

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

@@ -0,0 +1,425 @@
+<script setup lang="ts">
+import {
+	Button,
+	commonMessages,
+	defineMessages,
+	NewModal,
+	useModalStack,
+	useVIntl,
+} from '@modrinth/ui'
+import { renderString } from '@modrinth/utils'
+import { fetch as tauriFetch } from '@tauri-apps/plugin-http'
+import { openUrl } from '@tauri-apps/plugin-opener'
+import { computed, nextTick, onMounted, onUnmounted, reactive, ref, watch } from 'vue'
+
+import {
+	announcementKey,
+	isAnnouncementActive,
+	mapBroadcastAnnouncements,
+	OPEN_REMOTE_ANNOUNCEMENT_CENTER_EVENT,
+	parseAnnouncements,
+	REMOTE_ANNOUNCEMENTS_UPDATED_EVENT,
+	type RemoteAnnouncement,
+	safeAnnouncementUrl,
+} from '@/helpers/remote-announcements'
+
+import {
+	requestSkinSiteDownloadToken,
+	skinSiteStatus,
+	waitForSkinSiteSession,
+} from '@/composables/skin-site-session.ts'
+
+const props = defineProps<{ ready: boolean; previewOnly?: boolean }>()
+const { formatMessage } = useVIntl()
+const { hasModal } = useModalStack()
+const messages = defineMessages({
+	view: { id: 'app.remote-announcements.view', defaultMessage: 'View announcement' },
+	unread: { id: 'app.remote-announcements.unread', defaultMessage: 'Unread' },
+	readAll: {
+		id: 'app.remote-announcements.read-all',
+		defaultMessage: 'Mark all announcements as read',
+	},
+	centerTitle: { id: 'app.remote-announcements.center-title', defaultMessage: 'Announcements' },
+	empty: { id: 'app.remote-announcements.empty', defaultMessage: 'No announcements' },
+	previewTitle: {
+		id: 'app.remote-announcements.preview-title',
+		defaultMessage: 'Announcement style preview',
+	},
+	previewSummary: {
+		id: 'app.remote-announcements.preview-summary',
+		defaultMessage:
+			'This is a local preview. Select View announcement to preview the full Markdown content.',
+	},
+	previewContent: {
+		id: 'app.remote-announcements.preview-content',
+		defaultMessage:
+			'## Announcement preview\n\nThis is **sample content**, not a published announcement.\n\n- Supports headings, lists, and links\n- Close buttons are always available\n\n> Previewing does not change real announcement read status.\n\n| Type | Display |\n| --- | --- |\n| Modal | Full Markdown content |\n| Popup | Summary, then full content |\n\n[Visit the website](https://skin.starlight.cool/)',
+	},
+	previewAction: { id: 'app.remote-announcements.preview-action', defaultMessage: 'Visit website' },
+})
+const modal = ref<InstanceType<typeof NewModal>>()
+const selected = ref<RemoteAnnouncement | null>(null)
+const active = ref(false)
+const centerOpen = ref(false)
+const startupNotice = ref<RemoteAnnouncement | null>(null)
+const html = computed(() => renderString(selected.value?.content ?? ''))
+const stateKey = 'starlight-remote-announcements-v2'
+const read = reactive(new Set<string>())
+const queuedThisSession = new Set<string>()
+const startupNotified = new Set<string>()
+let items: RemoteAnnouncement[] = []
+let pending: RemoteAnnouncement[] = []
+let cacheKey = 'starlight-remote-announcements-cache-v1'
+let cacheLoaded = false
+let disposed = false
+let interval: ReturnType<typeof setInterval> | undefined
+let advanceTimer: ReturnType<typeof setTimeout> | undefined
+
+function persist() {
+	if (props.previewOnly) return
+	try {
+		localStorage.setItem(
+			stateKey,
+			JSON.stringify({
+				read: [...read].slice(-1000),
+			}),
+		)
+	} catch {
+		// localStorage may be unavailable (private mode / quota)
+	}
+}
+function emitState() {
+	window.dispatchEvent(
+		new CustomEvent(REMOTE_ANNOUNCEMENTS_UPDATED_EVENT, {
+			detail: {
+				items,
+				unreadKeys: items.filter((item) => !read.has(announcementKey(item))).map(announcementKey),
+			},
+		}),
+	)
+}
+function openCenter(item?: RemoteAnnouncement) {
+	if (!props.ready || disposed) return
+	void refresh()
+	centerOpen.value = true
+	if (item) {
+		startupNotice.value = null
+		selectAnnouncement(item)
+	} else if (!selected.value && items.length) {
+		selectAnnouncement(items[0])
+	}
+	void nextTick(() => modal.value?.show())
+}
+function handleOpenCenter() {
+	if (props.previewOnly) return
+	openCenter()
+}
+async function show(item: RemoteAnnouncement) {
+	if (
+		disposed ||
+		!props.ready ||
+		!isAnnouncementActive(item) ||
+		(hasModal.value && !active.value && !centerOpen.value)
+	)
+		return
+	centerOpen.value = true
+	active.value = true
+	selectAnnouncement(item)
+	await nextTick()
+	if (!disposed) modal.value?.show()
+}
+function selectAnnouncement(item: RemoteAnnouncement) {
+	selected.value = item
+	const key = announcementKey(item)
+	read.add(key)
+	pending = pending.filter((entry) => announcementKey(entry) !== key)
+	persist()
+	emitState()
+}
+function markAllRead() {
+	for (const item of items) {
+		read.add(announcementKey(item))
+	}
+	pending = []
+	persist()
+	emitState()
+}
+function advance() {
+	if (disposed || !props.ready || hasModal.value || active.value) return
+	const next = pending.shift()
+	if (next) {
+		void show(next)
+		return
+	}
+	for (const item of items) {
+		const key = announcementKey(item)
+		if (
+			item.type === 'notification' &&
+			!startupNotified.has(key) &&
+			!read.has(key) &&
+			isAnnouncementActive(item)
+		) {
+			startupNotice.value = item
+			startupNotified.add(key)
+			setTimeout(() => {
+				if (startupNotice.value === item) {
+					startupNotice.value = null
+					advance()
+				}
+			}, 8000)
+			break
+		}
+	}
+}
+function closed() {
+	active.value = false
+	centerOpen.value = false
+	if (advanceTimer) clearTimeout(advanceTimer)
+	advanceTimer = setTimeout(advance, 350)
+}
+function sync(next: RemoteAnnouncement[], fresh: boolean) {
+	items = next.filter((item) => isAnnouncementActive(item))
+	const keys = new Set(items.map(announcementKey))
+	pending = pending.filter((item) => keys.has(announcementKey(item)))
+	if (selected.value && !keys.has(announcementKey(selected.value))) selected.value = null
+	emitState()
+	if (fresh) {
+		for (const item of items) {
+			const key = announcementKey(item)
+			if (
+				item.type === 'modal' &&
+				!queuedThisSession.has(key) &&
+				(!read.has(key) || item.priority === 'critical')
+			) {
+				queuedThisSession.add(key)
+				pending.push(item)
+			}
+		}
+		advance()
+	}
+}
+function loadCache() {
+	if (cacheLoaded || !cacheKey) return
+	cacheLoaded = true
+	try {
+		const cached = JSON.parse(localStorage.getItem(cacheKey) ?? 'null')
+		if (cached && typeof cached.savedAt === 'number' && Date.now() - cached.savedAt < 86400000) {
+			const parsed = parseAnnouncements(cached.items)
+			if (parsed) sync(parsed, false)
+		}
+	} catch {
+		// Ignore malformed or expired cache payloads
+	}
+}
+function saveCache(next: RemoteAnnouncement[]) {
+	if (!cacheKey) return
+	try {
+		localStorage.setItem(cacheKey, JSON.stringify({ savedAt: Date.now(), items: next }))
+	} catch {
+		// localStorage may be unavailable (private mode / quota)
+	}
+}
+async function refresh() {
+	if (disposed) return
+	loadCache()
+	if (skinSiteStatus.value !== 'signed-in') return
+	try {
+		await waitForSkinSiteSession()
+		const token = await requestSkinSiteDownloadToken()
+		const response = await tauriFetch('https://skin.starlight.cool/starlight/skin/broadcast/all', {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${token}` },
+		})
+		if (!response.ok) return
+		const data = await response.json()
+		const parsed = mapBroadcastAnnouncements((data as { payload?: unknown } | null)?.payload)
+		if (parsed && !disposed) {
+			sync(parsed, true)
+			saveCache(parsed)
+		}
+	} catch {
+		// Remote fetch failed; previously cached items remain displayed
+	}
+}
+async function openLink(value: unknown) {
+	const url = safeAnnouncementUrl(value)
+	if (!url) return
+	try {
+		await openUrl(url)
+	} catch {
+		// Opener may reject unknown schemes
+	}
+}
+function contentClick(event: MouseEvent) {
+	const link = event.target instanceof Element ? event.target.closest('a') : null
+	if (!link) return
+	event.preventDefault()
+	event.stopPropagation()
+	void openLink(link.getAttribute('href'))
+}
+function preview(type: RemoteAnnouncement['type'], withAction = false) {
+	if (!props.previewOnly || !props.ready || hasModal.value || disposed) return
+	const now = new Date().toISOString()
+	const item: RemoteAnnouncement = {
+		id: 'local-preview-' + type,
+		title: formatMessage(messages.previewTitle),
+		summary: formatMessage(messages.previewSummary),
+		content: formatMessage(messages.previewContent),
+		type,
+		priority: 'normal',
+		starts_at: now,
+		ends_at: null,
+		published_at: now,
+		action_label: withAction ? formatMessage(messages.previewAction) : null,
+		action_url: withAction ? 'https://skin.starlight.cool/' : null,
+	}
+	read.clear()
+	queuedThisSession.clear()
+	sync([item], true)
+}
+defineExpose({ preview })
+onMounted(() => {
+	if (props.previewOnly) return
+	try {
+		const saved = JSON.parse(localStorage.getItem(stateKey) ?? 'null')
+		if (saved && Array.isArray(saved.read))
+			for (const key of saved.read) if (typeof key === 'string') read.add(key)
+	} catch {
+		// Ignore malformed local read-state
+	}
+	window.addEventListener(OPEN_REMOTE_ANNOUNCEMENT_CENTER_EVENT, handleOpenCenter)
+	const start = () => {
+		if (disposed) return
+		void refresh()
+		interval = setInterval(() => {
+			sync(items, false)
+			advance()
+		}, 15000)
+	}
+	// Defer the startup request until after first paint.
+	if (typeof requestIdleCallback === 'function') {
+		requestIdleCallback(start, { timeout: 2000 })
+	} else {
+		setTimeout(start, 500)
+	}
+})
+watch(skinSiteStatus, (status) => {
+	if (disposed || props.previewOnly) return
+	if (status === 'signed-in') void refresh()
+})
+watch([() => props.ready, hasModal], () => {
+	if (advanceTimer) clearTimeout(advanceTimer)
+	advanceTimer = setTimeout(advance, 350)
+})
+onUnmounted(() => {
+	disposed = true
+	if (interval) clearInterval(interval)
+	if (advanceTimer) clearTimeout(advanceTimer)
+	window.removeEventListener(OPEN_REMOTE_ANNOUNCEMENT_CENTER_EVENT, handleOpenCenter)
+})
+</script>
+
+<template>
+	<div
+		v-if="startupNotice"
+		class="fixed right-4 top-16 z-50 w-[22rem] max-w-[calc(100vw-2rem)] rounded-xl border border-surface-5 bg-surface-3 p-3 shadow-lg"
+	>
+		<button class="w-full text-left" @click="startupNotice && openCenter(startupNotice)">
+			<div class="mb-1 text-xs font-semibold uppercase text-brand">
+				{{ formatMessage(messages.unread) }}
+			</div>
+			<div class="font-semibold text-[var(--color-text-primary)]">{{ startupNotice.title }}</div>
+			<div
+				v-if="startupNotice.summary"
+				class="mt-1 line-clamp-2 text-sm text-[var(--color-text-tertiary)]"
+			>
+				{{ startupNotice.summary }}
+			</div>
+		</button>
+	</div>
+	<NewModal
+		ref="modal"
+		:header="formatMessage(messages.centerTitle)"
+		:on-hide="closed"
+		max-width="80vw"
+		width="80vw"
+		max-content-height="calc(80vh - 8rem)"
+		scrollable
+	>
+		<div class="flex h-[calc(80vh-8rem)] min-h-0 gap-3">
+			<aside class="flex min-h-0 w-[32%] min-w-[14rem] flex-col border-r border-surface-5 pr-3">
+				<div class="mb-2 flex items-center justify-between">
+					<span class="font-semibold text-[var(--color-text-primary)]">{{
+						formatMessage(messages.centerTitle)
+					}}</span>
+					<Button
+						v-if="items.some((item) => !read.has(announcementKey(item)))"
+						@click="markAllRead"
+						>{{ formatMessage(messages.readAll) }}</Button
+					>
+				</div>
+				<div
+					v-if="!items.length"
+					class="py-8 text-center text-sm text-[var(--color-text-tertiary)]"
+				>
+					{{ formatMessage(messages.empty) }}
+				</div>
+				<div v-else class="flex min-h-0 flex-col gap-1 overflow-auto">
+					<button
+						v-for="item in items"
+						:key="announcementKey(item)"
+						class="flex items-start gap-2 rounded-lg p-2 text-left hover:bg-surface-4"
+						:class="{
+							'bg-surface-4': selected && announcementKey(selected) === announcementKey(item),
+						}"
+						@click="selectAnnouncement(item)"
+					>
+						<span
+							class="mt-1.5 size-2 shrink-0 rounded-full"
+							:class="read.has(announcementKey(item)) ? 'opacity-0' : 'bg-red'"
+						/>
+						<span class="min-w-0 flex-1">
+							<span class="block truncate font-medium text-[var(--color-text-primary)]">{{
+								item.title
+							}}</span>
+							<span class="block line-clamp-2 text-xs text-[var(--color-text-tertiary)]">{{
+								item.summary || item.content
+							}}</span>
+						</span>
+					</button>
+				</div>
+			</aside>
+			<section v-if="selected" class="min-h-0 min-w-0 flex-1 overflow-auto px-1">
+				<h2 class="mb-4 text-xl font-semibold text-[var(--color-text-primary)]">
+					{{ selected.title }}
+				</h2>
+				<div
+					class="markdown-body break-words"
+					@click="contentClick"
+					@auxclick="contentClick"
+					v-html="html"
+				/>
+				<div class="mt-4 flex justify-end">
+					<Button
+						v-if="selected.action_url && selected.action_label"
+						type="colored"
+						color="brand"
+						@click="openLink(selected.action_url)"
+						>{{ selected.action_label }}</Button
+					>
+				</div>
+			</section>
+			<div
+				v-else
+				class="flex flex-1 items-center justify-center text-sm text-[var(--color-text-tertiary)]"
+			>
+				{{ formatMessage(messages.empty) }}
+			</div>
+		</div>
+		<template #actions>
+			<div class="flex flex-wrap justify-end gap-2">
+				<Button @click="modal?.hide()">{{ formatMessage(commonMessages.closeButton) }} </Button>
+			</div>
+		</template>
+	</NewModal>
+</template>

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

@@ -0,0 +1,618 @@
+<script setup lang="ts">
+import { EditIcon } from '@modrinth/assets'
+import {
+	commonMessages,
+	defineMessages,
+	IconButton,
+	injectNotificationManager,
+	Toggle,
+	useVIntl,
+} from '@modrinth/ui'
+import { useMutation, useQuery, useQueryClient } from '@tanstack/vue-query'
+import { computed, nextTick, onScopeDispose, ref } from 'vue'
+
+import { gameSettingsKeys } from '@/helpers/game-options'
+import {
+	type GlobalSyncedOptions,
+	isSyncedOptionAvailable,
+	set_global_synced_option,
+	type SyncedOption,
+} from '@/helpers/instance'
+import {
+	canSourceMultiplayerServers,
+	gameOptionsSyncSourcesQueryOptions,
+	globalSyncedOptionsQueryOptions,
+	initializedSyncedOptionsQueryOptions,
+	syncedOptionsKeys,
+	syncedServersQueryOptions,
+} from '@/helpers/synced-options'
+import { syncedPackKeys, syncedPackQueryOptions } from '@/helpers/synced-packs'
+import { instanceKeys, instanceListQueryOptions } from '@/pages/instance/query-options'
+
+import SettingsRow from '../settings/SettingsRow.vue'
+import SettingsSection from '../settings/SettingsSection.vue'
+import CommandHistoryModal from '../settings/instances/command-history-modal.vue'
+import SyncedServersModal from '../settings/instances/servers-modal.vue'
+import SyncedPacksModal from '../settings/instances/SyncedPacksModal.vue'
+import SyncSourceModal from '../settings/instances/SyncSourceModal.vue'
+import GameSettingsModal from '../settings/instances/game-settings-modal/index.vue'
+
+const { handleError } = injectNotificationManager()
+const { formatMessage } = useVIntl()
+const queryClient = useQueryClient()
+const syncedPacksModal = ref<InstanceType<typeof SyncedPacksModal>>()
+const commandHistoryModal = ref<InstanceType<typeof CommandHistoryModal>>()
+const syncedServersModal = ref<InstanceType<typeof SyncedServersModal>>()
+const gameSettingsModal = ref<InstanceType<typeof GameSettingsModal> | null>(null)
+
+const messages = defineMessages({
+	globalOptionsTitle: {
+		id: 'app.settings.synced-options.title',
+		defaultMessage: 'Options synced across all instances',
+	},
+	resourcePacks: {
+		id: 'app.settings.synced-options.resource-packs',
+		defaultMessage: 'Sync resource packs',
+	},
+	resourcePacksDescription: {
+		id: 'app.settings.synced-options.resource-packs.description',
+		defaultMessage: 'Use the same resource packs across your instances.',
+	},
+	dataPacks: { id: 'app.settings.synced-options.data-packs', defaultMessage: 'Sync data packs' },
+	dataPacksDescription: {
+		id: 'app.settings.synced-options.data-packs.description',
+		defaultMessage: 'Use the same datapacks across your instances',
+	},
+	packsDisabled: {
+		id: 'app.settings.synced-options.packs.disabled',
+		defaultMessage: 'Enable syncing before editing shared packs.',
+	},
+	gameSettings: {
+		id: 'app.settings.synced-options.game-settings',
+		defaultMessage: 'Sync game options',
+	},
+	gameSettingsDescription: {
+		id: 'app.settings.synced-options.game-settings.description',
+		defaultMessage: 'Use the same game options across your instances.',
+	},
+	gameSettingsButton: {
+		id: 'app.settings.synced-options.game-settings.button',
+		defaultMessage: 'Edit game settings',
+	},
+	gameSettingsDisabledTooltip: {
+		id: 'app.settings.synced-options.game-settings.disabled-tooltip',
+		defaultMessage: 'Enable game settings sync before choosing individual settings.',
+	},
+	noGameOptionsToEdit: {
+		id: 'app.settings.synced-options.game-settings.no-options-to-edit',
+		defaultMessage: "You haven't got any options yet to edit",
+	},
+	multiplayerServers: {
+		id: 'app.settings.synced-options.multiplayer-servers',
+		defaultMessage: 'Sync multiplayer servers',
+	},
+	multiplayerServersDescription: {
+		id: 'app.settings.synced-options.multiplayer-servers.description',
+		defaultMessage: 'Use the same multiplayer servers across your instances.',
+	},
+	commandHistory: {
+		id: 'app.settings.synced-options.command-history',
+		defaultMessage: 'Sync command history',
+	},
+	commandHistoryDescription: {
+		id: 'app.settings.synced-options.command-history.description',
+		defaultMessage: 'Use the same command history across your instances.',
+	},
+	creativeHotbars: {
+		id: 'app.settings.synced-options.creative-hotbars',
+		defaultMessage: 'Sync saved creative hotbars',
+	},
+	creativeHotbarsDescription: {
+		id: 'app.settings.synced-options.creative-hotbars.description',
+		defaultMessage: 'Use the same saved creative hotbars across your instances.',
+	},
+	gameSettingsSyncSourceTitle: {
+		id: 'app.settings.synced-options.choose-sync-source.game-settings-title',
+		defaultMessage: 'Choose game settings source',
+	},
+	multiplayerServersSyncSourceDescription: {
+		id: 'app.settings.synced-options.choose-sync-source.multiplayer-servers-description',
+		defaultMessage:
+			'Choose which instance to copy your multiplayer servers from. These servers are only used for the initial sync, and you can edit them from any instance afterward.',
+	},
+	multiplayerServersSyncSourceTitle: {
+		id: 'app.settings.synced-options.choose-sync-source.multiplayer-servers-title',
+		defaultMessage: 'Choose multiplayer servers source',
+	},
+	commandHistorySyncSourceDescription: {
+		id: 'app.settings.synced-options.choose-sync-source.command-history-description',
+		defaultMessage:
+			'Choose which instance to copy your command history from. This history is only used for the initial sync, and you can edit it from any instance afterward.',
+	},
+	commandHistorySyncSourceTitle: {
+		id: 'app.settings.synced-options.choose-sync-source.command-history-title',
+		defaultMessage: 'Choose command history source',
+	},
+	creativeHotbarsSyncSourceDescription: {
+		id: 'app.settings.synced-options.choose-sync-source.creative-hotbars-description',
+		defaultMessage:
+			'Choose which instance to copy your saved creative hotbars from. These hotbars are only used for the initial sync, and you can edit them from any instance afterward.',
+	},
+	creativeHotbarsSyncSourceTitle: {
+		id: 'app.settings.synced-options.choose-sync-source.creative-hotbars-title',
+		defaultMessage: 'Choose creative hotbars source',
+	},
+	gameSettingsSyncSourceDescription: {
+		id: 'app.settings.synced-options.choose-sync-source.game-settings-description',
+		defaultMessage:
+			'Choose which instance to copy your game settings from. These settings are only used for the initial sync, and you can edit them from any instance afterward.',
+	},
+	resourcePacksSyncSourceTitle: {
+		id: 'app.settings.synced-options.choose-sync-source.resource-packs-title',
+		defaultMessage: 'Choose resource packs source',
+	},
+	resourcePacksSyncSourceDescription: {
+		id: 'app.sync-instances-update.choose-source.resource-packs',
+		defaultMessage:
+			'Choose which instance to copy your resource packs from. These packs are only used for the initial sync, and you can edit them from any instance afterward.',
+	},
+	dataPacksSyncSourceTitle: {
+		id: 'app.settings.synced-options.choose-sync-source.data-packs-title',
+		defaultMessage: 'Choose data packs source',
+	},
+	dataPacksSyncSourceDescription: {
+		id: 'app.sync-instances-update.choose-source.data-packs',
+		defaultMessage:
+			'Choose which instance to copy your data packs from. These packs are only used for the initial sync, and you can edit them from any instance afterward.',
+	},
+	noServersSyncedYet: {
+		id: 'app.settings.synced-options.multiplayer-servers.none-synced-yet',
+		defaultMessage: "You haven't synced any servers yet",
+	},
+	noResourcePacksSyncedYet: {
+		id: 'app.settings.synced-options.resource-packs.none-synced-yet',
+		defaultMessage: "You haven't synced any resource packs yet",
+	},
+	noDataPacksSyncedYet: {
+		id: 'app.settings.synced-options.data-packs.none-synced-yet',
+		defaultMessage: "You haven't synced any data packs yet",
+	},
+	noInstancesToEdit: {
+		id: 'app.settings.synced-options.edit.no-instances',
+		defaultMessage: 'Add an instance before editing synced data.',
+	},
+	noSyncedDataToEdit: {
+		id: 'app.settings.synced-options.edit.no-synced-data',
+		defaultMessage: 'Choose a sync source before editing this setting.',
+	},
+})
+
+const globalRows: Array<{
+	option: SyncedOption
+	title: keyof typeof messages
+	description?: keyof typeof messages
+	editable?: 'game-settings' | 'servers' | 'commands' | 'resourcepack' | 'datapack'
+}> = [
+	{
+		option: 'game_options',
+		title: 'gameSettings',
+		description: 'gameSettingsDescription',
+		editable: 'game-settings',
+	},
+	{
+		option: 'multiplayer_servers',
+		title: 'multiplayerServers',
+		description: 'multiplayerServersDescription',
+		editable: 'servers',
+	},
+	{
+		option: 'resource_packs',
+		title: 'resourcePacks',
+		description: 'resourcePacksDescription',
+		editable: 'resourcepack',
+	},
+	{
+		option: 'data_packs',
+		title: 'dataPacks',
+		description: 'dataPacksDescription',
+		editable: 'datapack',
+	},
+	{
+		option: 'command_history',
+		title: 'commandHistory',
+		description: 'commandHistoryDescription',
+		editable: 'commands',
+	},
+	{
+		option: 'creative_hotbars',
+		title: 'creativeHotbars',
+		description: 'creativeHotbarsDescription',
+	},
+]
+
+const availableGlobalRows = globalRows.filter((row) => isSyncedOptionAvailable(row.option))
+
+const defaultGlobalOptions: GlobalSyncedOptions = {
+	resource_packs: false,
+	data_packs: false,
+	game_options: false,
+	command_history: false,
+	multiplayer_servers: false,
+	creative_hotbars: false,
+	screenshots: false,
+}
+
+const globalOptionsQuery = useQuery(globalSyncedOptionsQueryOptions())
+const initializedOptionsQuery = useQuery(initializedSyncedOptionsQueryOptions())
+const gameOptionSourcesQuery = useQuery(gameOptionsSyncSourcesQueryOptions())
+const resourcePacksQuery = useQuery(syncedPackQueryOptions('resourcepack'))
+const dataPacksQuery = useQuery(syncedPackQueryOptions('datapack'))
+const globalOptions = computed(() => globalOptionsQuery.data.value ?? defaultGlobalOptions)
+const initializedOptions = computed(
+	() => initializedOptionsQuery.data.value ?? defaultGlobalOptions,
+)
+const gameOptionSources = computed(() => gameOptionSourcesQuery.data.value ?? [])
+const instancesQuery = useQuery(instanceListQueryOptions())
+const instances = computed(() => instancesQuery.data.value ?? [])
+const serversQuery = useQuery(syncedServersQueryOptions())
+const syncedServers = computed(() => serversQuery.data.value ?? [])
+const eligibleGameOptionSourceIds = computed(
+	() =>
+		new Set(
+			gameOptionSources.value.filter((source) => source.eligible).map((source) => source.source_id),
+		),
+)
+const hasGameOptionsToEdit = computed(
+	() =>
+		initializedOptions.value.game_options ||
+		instances.value.some(
+			(instance) =>
+				instance?.synced_options?.game_options &&
+				eligibleGameOptionSourceIds.value.has(instance.id),
+		),
+)
+const baseOption = ref<SyncedOption | null>(null)
+const baseInstanceId = ref('')
+const baseModal = ref<InstanceType<typeof SyncSourceModal> | null>(null)
+const baseSourcesLoading = computed(() =>
+	baseOption.value === null
+		? false
+		: baseOption.value === 'game_options'
+			? gameOptionSourcesQuery.isPending.value
+			: instancesQuery.isPending.value,
+)
+const baseSourcesError = computed(() =>
+	baseOption.value === 'game_options'
+		? gameOptionSourcesQuery.isError.value && !gameOptionSourcesQuery.data.value
+		: instancesQuery.isError.value && !instancesQuery.data.value,
+)
+let baseSourceGeneration = 0
+
+const baseInstanceTitle = computed(() => {
+	switch (baseOption.value) {
+		case 'game_options':
+			return formatMessage(messages.gameSettingsSyncSourceTitle)
+		case 'multiplayer_servers':
+			return formatMessage(messages.multiplayerServersSyncSourceTitle)
+		case 'command_history':
+			return formatMessage(messages.commandHistorySyncSourceTitle)
+		case 'creative_hotbars':
+			return formatMessage(messages.creativeHotbarsSyncSourceTitle)
+		case 'resource_packs':
+			return formatMessage(messages.resourcePacksSyncSourceTitle)
+		case 'data_packs':
+			return formatMessage(messages.dataPacksSyncSourceTitle)
+		default:
+			return ''
+	}
+})
+
+const baseInstanceDescription = computed(() => {
+	switch (baseOption.value) {
+		case 'game_options':
+			return formatMessage(messages.gameSettingsSyncSourceDescription)
+		case 'multiplayer_servers':
+			return formatMessage(messages.multiplayerServersSyncSourceDescription)
+		case 'command_history':
+			return formatMessage(messages.commandHistorySyncSourceDescription)
+		case 'creative_hotbars':
+			return formatMessage(messages.creativeHotbarsSyncSourceDescription)
+		case 'resource_packs':
+			return formatMessage(messages.resourcePacksSyncSourceDescription)
+		case 'data_packs':
+			return formatMessage(messages.dataPacksSyncSourceDescription)
+		default:
+			return ''
+	}
+})
+
+const baseInstances = computed(() =>
+	baseOption.value === 'game_options'
+		? gameOptionSources.value.map((source) => ({
+				id: source.source_id,
+				name: source.name,
+				icon_path: source.icon_path,
+				eligible: source.eligible,
+			}))
+		: instances.value.map((instance) => ({
+				id: instance.id,
+				name: instance.name,
+				icon_path: instance.icon_path,
+				eligible:
+					!instance.quarantined &&
+					(baseOption.value !== 'multiplayer_servers' || canSourceMultiplayerServers(instance)),
+			})),
+)
+
+async function invalidateSyncedOptions() {
+	await Promise.all([
+		queryClient.invalidateQueries({ queryKey: instanceKeys.all }),
+		queryClient.invalidateQueries({ queryKey: ['instance-synced-options'] }),
+		queryClient.invalidateQueries({ queryKey: syncedOptionsKeys.global }),
+		queryClient.invalidateQueries({ queryKey: syncedOptionsKeys.initialized }),
+		queryClient.invalidateQueries({ queryKey: syncedOptionsKeys.gameSources }),
+		queryClient.invalidateQueries({ queryKey: ['worlds'] }),
+		queryClient.invalidateQueries({ queryKey: syncedPackKeys.all }),
+	])
+}
+
+function emptySyncedContentMessage(row: (typeof globalRows)[number]) {
+	if (
+		row.editable === 'servers' &&
+		(instances.value.length === 0 || syncedServers.value.length === 0)
+	) {
+		return messages.noServersSyncedYet
+	}
+	if (row.editable === 'resourcepack' && !resourcePacksQuery.data.value?.length) {
+		return messages.noResourcePacksSyncedYet
+	}
+	if (row.editable === 'datapack' && !dataPacksQuery.data.value?.length) {
+		return messages.noDataPacksSyncedYet
+	}
+}
+
+function canEditGlobalOption(row: (typeof globalRows)[number]): boolean {
+	if (!row.editable || !globalOptions.value[row.option]) return false
+	if (emptySyncedContentMessage(row)) return false
+	if (row.editable === 'resourcepack' || row.editable === 'datapack') return true
+	if (row.editable === 'game-settings') return hasGameOptionsToEdit.value
+	return instances.value.length > 0 && initializedOptions.value[row.option]
+}
+
+function editGlobalOptionTooltip(row: (typeof globalRows)[number]): string {
+	const emptyMessage = emptySyncedContentMessage(row)
+	if (emptyMessage) return formatMessage(emptyMessage)
+	if (row.editable === 'resourcepack' || row.editable === 'datapack') {
+		return formatMessage(
+			globalOptions.value[row.option] ? commonMessages.editButton : messages.packsDisabled,
+		)
+	}
+	if (row.editable === 'game-settings') {
+		if (!hasGameOptionsToEdit.value) return formatMessage(messages.noGameOptionsToEdit)
+		if (!globalOptions.value[row.option]) {
+			return formatMessage(messages.gameSettingsDisabledTooltip)
+		}
+		return formatMessage(messages.gameSettingsButton)
+	}
+	if (instances.value.length === 0) {
+		return formatMessage(messages.noInstancesToEdit)
+	}
+	if (!initializedOptions.value[row.option]) {
+		return formatMessage(messages.noSyncedDataToEdit)
+	}
+	return formatMessage(commonMessages.editButton)
+}
+
+type GlobalOptionMutationVariables = {
+	option: SyncedOption
+	enabled: boolean
+	baseInstanceId?: string
+}
+
+const globalOptionMutation = useMutation({
+	mutationKey: syncedOptionsKeys.set,
+	mutationFn: ({ option, enabled, baseInstanceId }: GlobalOptionMutationVariables) =>
+		set_global_synced_option(option, enabled, baseInstanceId),
+	onError: handleError,
+	onSuccess: async (options, { option, enabled }) => {
+		queryClient.setQueryData(syncedOptionsKeys.global, options)
+		if (option === 'game_options') {
+			await queryClient.invalidateQueries({ queryKey: gameSettingsKeys.synced })
+		}
+		if (enabled && option === 'multiplayer_servers') {
+			await queryClient.invalidateQueries({ queryKey: syncedOptionsKeys.servers })
+		}
+	},
+	onSettled: async (_data, _error, { option }) => {
+		if (queryClient.isMutating({ mutationKey: syncedOptionsKeys.set }) === 1) {
+			if (option === 'resource_packs' || option === 'data_packs') {
+				void Promise.all([
+					queryClient.invalidateQueries({ queryKey: instanceKeys.all }),
+					queryClient.invalidateQueries({ queryKey: ['instance-synced-options'] }),
+					queryClient.invalidateQueries({ queryKey: syncedOptionsKeys.global }),
+					queryClient.invalidateQueries({ queryKey: syncedOptionsKeys.initialized }),
+					queryClient.invalidateQueries({ queryKey: syncedPackKeys.all }),
+				])
+				return
+			}
+			await invalidateSyncedOptions()
+		}
+	},
+})
+
+const canToggleGlobalOptions = computed(
+	() =>
+		!!globalOptionsQuery.data.value &&
+		!globalOptionMutation.isPending.value &&
+		!baseSourcesLoading.value,
+)
+
+async function chooseBaseInstance(option: SyncedOption) {
+	const generation = ++baseSourceGeneration
+	baseOption.value = option
+	baseInstanceId.value = ''
+
+	try {
+		if (option === 'game_options') {
+			await queryClient.fetchQuery(gameOptionsSyncSourcesQueryOptions())
+		} else {
+			await queryClient.fetchQuery({ ...instanceListQueryOptions(), staleTime: 0 })
+		}
+	} catch (error) {
+		if (generation !== baseSourceGeneration) return
+		handleError(error)
+		baseModal.value?.show()
+		return
+	}
+
+	if (generation !== baseSourceGeneration) return
+	const eligibleSources = baseInstances.value.filter((source) => source.eligible)
+	baseInstanceId.value = eligibleSources[0]?.id ?? ''
+	if (eligibleSources.length > 1) {
+		baseModal.value?.show()
+		return
+	}
+
+	try {
+		await globalOptionMutation.mutateAsync({
+			option,
+			enabled: true,
+			baseInstanceId: eligibleSources[0]?.id,
+		})
+		await nextTick()
+		if (!baseModal.value?.hide()) clearBaseSource()
+	} catch {
+		return
+	}
+}
+
+function toggleGlobalOption(option: SyncedOption, enabled: boolean) {
+	if (!isSyncedOptionAvailable(option) || !canToggleGlobalOptions.value) return
+	if (enabled && option !== 'screenshots') {
+		void chooseBaseInstance(option)
+		return
+	}
+	globalOptionMutation.mutate({ option, enabled })
+}
+
+async function confirmBaseInstance() {
+	if (!baseOption.value || !baseInstanceId.value) return
+	try {
+		await globalOptionMutation.mutateAsync({
+			option: baseOption.value,
+			enabled: true,
+			baseInstanceId: baseInstanceId.value,
+		})
+		await nextTick()
+		baseModal.value?.hide()
+	} catch {
+		return
+	}
+}
+
+function editGlobalOption(row: (typeof globalRows)[number]) {
+	if (!isSyncedOptionAvailable(row.option)) return
+	if (row.editable === 'resourcepack' || row.editable === 'datapack') {
+		void syncedPacksModal.value?.show(row.editable)
+	} else if (row.editable === 'game-settings') {
+		openGameSettings()
+	} else if (row.editable === 'commands') {
+		void commandHistoryModal.value?.show()
+	} else {
+		void syncedServersModal.value?.show()
+	}
+}
+
+function openGameSettings() {
+	if (!hasGameOptionsToEdit.value) return
+	gameSettingsModal.value?.show()
+}
+
+async function handleGameSettingsSaved() {
+	await invalidateSyncedOptions()
+}
+
+
+
+function clearBaseSource() {
+	baseSourceGeneration++
+	baseOption.value = null
+}
+
+onScopeDispose(clearBaseSource)
+</script>
+
+<template>
+	<div class="flex flex-col gap-6">
+		<SyncedPacksModal ref="syncedPacksModal" />
+		<CommandHistoryModal ref="commandHistoryModal" />
+		<SyncedServersModal ref="syncedServersModal" />
+		<GameSettingsModal ref="gameSettingsModal" @saved="handleGameSettingsSaved" />
+
+		<SyncSourceModal
+			ref="baseModal"
+			v-model="baseInstanceId"
+			:title="baseInstanceTitle"
+			:description="baseInstanceDescription"
+			:sources="baseInstances"
+			:loading="baseSourcesLoading"
+			:error="baseSourcesError"
+			:pending="globalOptionMutation.isPending.value"
+			@confirm="confirmBaseInstance"
+			@close="clearBaseSource"
+			@retry="baseOption && chooseBaseInstance(baseOption)"
+		/>
+
+		<SettingsSection>
+			<template #header>
+				<h2
+					id="settings-target-instance-sync-options"
+					tabindex="-1"
+					class="m-0 text-lg font-semibold text-[var(--color-text-primary)]"
+				>
+					{{ formatMessage(messages.globalOptionsTitle) }}
+				</h2>
+			</template>
+			<SettingsRow v-for="row in availableGlobalRows" :key="row.option">
+				<template #label>
+					<span :id="`settings-target-instance-sync-${row.option}`" tabindex="-1">
+						{{ formatMessage(messages[row.title]) }}
+					</span>
+				</template>
+				<template v-if="row.description" #description>
+					{{ formatMessage(messages[row.description]) }}
+				</template>
+				<template #control>
+					<span v-if="row.editable" v-tooltip="editGlobalOptionTooltip(row)" class="flex">
+						<IconButton
+							type="outlined"
+							circular
+							:disabled="
+								!canEditGlobalOption(row) ||
+								initializedOptionsQuery.isPending.value ||
+								globalOptionMutation.isPending.value
+							"
+							:label="
+								formatMessage(
+									row.editable === 'game-settings'
+										? messages.gameSettingsButton
+										: commonMessages.editButton,
+								)
+							"
+							@click="editGlobalOption(row)"
+						>
+							<EditIcon aria-hidden="true" />
+						</IconButton>
+					</span>
+					<Toggle
+						:id="`global-sync-${row.option}`"
+						:model-value="globalOptions[row.option]"
+						:disabled="!canToggleGlobalOptions"
+						:aria-label="formatMessage(messages[row.title])"
+						@update:model-value="(enabled) => toggleGlobalOption(row.option, enabled)"
+					/>
+				</template>
+			</SettingsRow>
+		</SettingsSection>
+	</div>
+</template>

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

@@ -36,24 +36,29 @@ const fullscreenSetting: Ref<boolean> = ref(
 	instance.value.force_fullscreen ?? globalSettings.force_fullscreen,
 )
 const maximizeWindowSetting = ref(instance.value.maximize_window ?? globalSettings.maximize_window)
+const windowTitle = ref(instance.value.window_title ?? '')
 
 const editInstanceObject = computed(() => {
+	const title = windowTitle.value.trim() ? windowTitle.value.trim() : null
 	if (!overrideWindowSettings.value) {
 		return {
 			force_fullscreen: null,
 			maximize_window: null,
 			game_resolution: null,
+			// The title is independent of the window-size override checkbox.
+			window_title: title,
 		}
 	}
 	return {
 		force_fullscreen: fullscreenSetting.value,
 		maximize_window: maximizeWindowSetting.value,
 		game_resolution: fullscreenSetting.value ? null : resolution.value,
+		window_title: title,
 	}
 })
 
 watch(
-	[overrideWindowSettings, resolution, fullscreenSetting, maximizeWindowSetting],
+	[overrideWindowSettings, resolution, fullscreenSetting, maximizeWindowSetting, windowTitle],
 	async () => {
 		await edit(instance.value.id, editInstanceObject.value)
 	},
@@ -109,6 +114,18 @@ const messages = defineMessages({
 		id: 'instance.settings.tabs.window.height.enter',
 		defaultMessage: 'Enter height...',
 	},
+	windowTitle: {
+		id: 'instance.settings.tabs.window.window-title',
+		defaultMessage: 'Window title',
+	},
+	windowTitleDescription: {
+		id: 'instance.settings.tabs.window.window-title.description',
+		defaultMessage: 'Customize the Minecraft window title. Leave empty to keep the default.',
+	},
+	enterWindowTitle: {
+		id: 'instance.settings.tabs.window.window-title.enter',
+		defaultMessage: 'Enter window title...',
+	},
 })
 </script>
 
@@ -200,5 +217,25 @@ const messages = defineMessages({
 				:placeholder="formatMessage(messages.enterHeight)"
 			/>
 		</div>
+		<div
+			v-if="globalSettings.custom_window_title_enabled"
+			class="flex items-center gap-4 justify-between"
+		>
+			<div class="flex flex-col gap-1">
+				<h2 class="m-0 inline-flex items-center gap-2 text-lg font-semibold text-contrast">
+					{{ formatMessage(messages.windowTitle) }}
+				</h2>
+				<p class="m-0">
+					{{ formatMessage(messages.windowTitleDescription) }}
+				</p>
+			</div>
+			<StyledInput
+				id="window-title"
+				v-model="windowTitle"
+				autocomplete="off"
+				type="text"
+				:placeholder="formatMessage(messages.enterWindowTitle)"
+			/>
+		</div>
 	</div>
 </template>

apps/app-frontend/src/components/ui/library/DraggableInstanceCard.vue

@@ -0,0 +1,92 @@
+<script setup lang="ts">
+import { KeyboardSensor, PointerSensor, useDraggable } from '@dnd-kit/vue'
+import { useEventListener } from '@vueuse/core'
+import { computed, ref } from 'vue'
+
+import type { GameInstance } from '@/helpers/types'
+
+const props = defineProps<{
+	instance: GameInstance
+	instanceGroupId: string
+	disabled: boolean
+}>()
+
+const emit = defineEmits<{
+	(e: 'contextmenu' | 'card-click', event: MouseEvent): void
+	(e: 'start-long-press' | 'cancel-long-press'): void
+}>()
+
+const cardElement = ref<HTMLElement>()
+
+const instanceCardSensors = [
+	PointerSensor.configure({
+		preventActivation: () => false,
+	}),
+	KeyboardSensor,
+]
+
+const dragDisabled = computed(() => props.disabled)
+
+const { isDragging } = useDraggable({
+	id: computed(() => `instance:${props.instanceGroupId}:${props.instance.id}`),
+	element: cardElement,
+	disabled: dragDisabled,
+	sensors: instanceCardSensors,
+	data: computed(() => ({
+		instanceId: props.instance.id,
+		fromGroup: props.instanceGroupId,
+	})),
+})
+
+let wantsClick = false
+
+useEventListener(window, 'pointerdown', () => {
+	wantsClick = true
+})
+useEventListener(window, 'pointerup', () => {
+	if (isDragging.value) {
+		wantsClick = false
+	}
+})
+useEventListener(window, 'blur', () => {
+	wantsClick = false
+})
+
+function onCardClick(event: MouseEvent) {
+	if (!wantsClick || isDragging.value) return
+	wantsClick = false
+	emit('card-click', event)
+}
+
+function onContextMenu(event: MouseEvent) {
+	emit('contextmenu', event)
+}
+
+function onMouseDown() {
+	if (!dragDisabled.value) {
+		emit('start-long-press')
+	}
+}
+
+function onMouseUp() {
+	emit('cancel-long-press')
+}
+</script>
+
+<template>
+	<div
+		ref="cardElement"
+		class="group relative min-w-0 w-full"
+		@click="onCardClick"
+		@mousedown="onMouseDown"
+		@mouseup="onMouseUp"
+		@mouseleave="onMouseUp"
+		@touchstart="!dragDisabled && onMouseDown()"
+		@touchend="onMouseUp"
+		@touchcancel="onMouseUp"
+		@contextmenu.prevent.stop="onContextMenu"
+	>
+		<slot :is-dragging="isDragging" />
+		<slot v-if="!isDragging" name="overlay" />
+	</div>
+</template>

apps/app-frontend/src/components/ui/library/InstanceGroup.vue

@@ -0,0 +1,521 @@
+<script setup lang="ts">
+import { useDroppable } from '@dnd-kit/vue'
+import {
+	ArrowDownIcon,
+	ArrowUpIcon,
+	DropdownIcon,
+	EditIcon,
+	PlusIcon,
+	TrashIcon,
+	XIcon,
+} from '@modrinth/assets'
+import {
+	Button,
+	Checkbox,
+	commonMessages,
+	defineMessages,
+	IconButton,
+	InlineEditableText,
+	NewModal,
+	TagItem,
+	useVIntl,
+} from '@modrinth/ui'
+import { computed, nextTick, ref, watch } from 'vue'
+
+import ContextMenu from '@/components/ui/ContextMenu.vue'
+import Instance from '@/components/ui/Instance.vue'
+import DraggableInstanceCard from '@/components/ui/library/DraggableInstanceCard.vue'
+import { UNGROUPED_GROUP_KEY } from '@/composables/useGridGrouping'
+import { FAVORITES_GROUP_ID } from '@/composables/useInstanceGroups'
+import type { GameInstance } from '@/helpers/types'
+
+const MAX_GROUP_NAME_LENGTH = 256
+
+const { formatMessage } = useVIntl()
+
+const messages = defineMessages({
+	ungrouped: { id: 'app.instances.group.ungrouped', defaultMessage: 'No group' },
+	pinned: { id: 'app.instances.group.pinned', defaultMessage: 'Pinned' },
+	emptyGroup: {
+		id: 'app.instances.group.empty',
+		defaultMessage: 'Drag and drop to add instances.',
+	},
+	editGroupName: {
+		id: 'app.instances.group.edit-name',
+		defaultMessage: 'Edit group name',
+	},
+	deleteGroup: {
+		id: 'app.instances.group.delete-group',
+		defaultMessage: 'Delete group',
+	},
+	deleteGroupDescription: {
+		id: 'app.instances.group.delete-description',
+		defaultMessage: 'Instances in this group will be ungrouped.',
+	},
+	moveGroupUp: {
+		id: 'app.instances.group.move-up',
+		defaultMessage: 'Move group up',
+	},
+	moveGroupDown: {
+		id: 'app.instances.group.move-down',
+		defaultMessage: 'Move group down',
+	},
+	addToGroup: {
+		id: 'app.instances.group.add-to-group',
+		defaultMessage: 'Add to group',
+	},
+	newInstance: {
+		id: 'app.instances.group.new-instance',
+		defaultMessage: 'New instance',
+	},
+	collapseGroup: {
+		id: 'app.instances.group.collapse',
+		defaultMessage: 'Collapse group',
+	},
+	expandGroup: {
+		id: 'app.instances.group.expand',
+		defaultMessage: 'Expand group',
+	},
+	renameGroup: {
+		id: 'app.instances.group.rename-group',
+		defaultMessage: 'Rename group',
+	},
+	groupNameEmpty: {
+		id: 'app.instances.group.name-empty',
+		defaultMessage: 'Group names cannot be empty.',
+	},
+	groupNameTooLong: {
+		id: 'app.instances.group.name-too-long',
+		defaultMessage: 'Group names cannot be longer than {maxLength} characters.',
+	},
+})
+
+const props = defineProps<{
+	sectionKey: string
+	groupName?: string
+	instances: GameInstance[]
+	grouping: string
+	isCollapsed: boolean
+	displayMode: string
+	selectMode: boolean
+	selectedInstanceIds: Set<string>
+	isSortAscending?: boolean
+	hideHeader?: boolean
+	canMoveUp?: boolean
+	canMoveDown?: boolean
+	groupPendingNameEdit?: string | null
+}>()
+
+// Events are grouped only where the payload shapes genuinely match; the
+// per-event names are documentation, not part of the type.
+const emit = defineEmits<{
+	(e: 'toggleCollapse' | 'deleteGroup' | 'addToGroup' | 'startLongPress', id: string): void
+	(e: 'handleCheckboxClick' | 'handleCardClick', instanceId: string, event: MouseEvent): void
+	(e: 'handleContextMenu', event: MouseEvent, instanceId: string, sectionKey: string): void
+	(e: 'renameGroup', oldKey: string, newKey: string): void
+	(e: 'cancelLongPress' | 'newInstance' | 'renameComplete'): void
+	(e: 'moveGroup', groupKey: string, direction: -1 | 1): void
+}>()
+
+const groupOptions = ref<InstanceType<typeof ContextMenu>>()
+const groupContainerRef = ref<HTMLElement>()
+const groupNameInput = ref<InstanceType<typeof InlineEditableText>>()
+const deletingGroup = ref(false)
+const confirmDeleteGroupModal = ref<InstanceType<typeof NewModal>>()
+const groupName = ref(props.groupName ?? props.sectionKey)
+
+const isUngrouped = computed(() => props.sectionKey === UNGROUPED_GROUP_KEY)
+const isFavorites = computed(() => props.sectionKey === FAVORITES_GROUP_ID)
+const isCustomGroup = computed(
+	() => props.grouping === 'Group' && !isUngrouped.value && !isFavorites.value,
+)
+const isGroupDragActive = computed(() => props.grouping === 'Group')
+const effectiveCollapsed = computed(() => (props.hideHeader ? false : props.isCollapsed))
+
+const { isDropTarget } = useDroppable({
+	id: computed(() => `instance-group:${props.sectionKey}`),
+	element: groupContainerRef,
+	disabled: computed(() => props.hideHeader || !isGroupDragActive.value),
+	data: computed(() => ({
+		groupId: props.sectionKey,
+	})),
+})
+
+watch(
+	() => [props.sectionKey, props.groupName],
+	() => {
+		groupName.value = props.groupName ?? props.sectionKey
+	},
+)
+
+watch(
+	() => props.groupPendingNameEdit,
+	async (pendingId) => {
+		if (pendingId !== props.sectionKey) return
+
+		await nextTick()
+		groupContainerRef.value?.scrollIntoView({ block: 'nearest' })
+		await groupNameInput.value?.startEditing()
+		emit('renameComplete')
+	},
+	{ immediate: true, flush: 'post' },
+)
+
+function validateGroupName(value: string) {
+	const normalized = value.trim()
+	if (normalized.length === 0) return false
+	if (normalized.length > MAX_GROUP_NAME_LENGTH) return false
+	return true
+}
+
+async function updateGroupName(value: string) {
+	const newName = value.trim()
+	if (!newName || newName === groupName.value) return false
+	emit('renameGroup', props.sectionKey, newName)
+	return true
+}
+
+function openGroupContextMenu(event: MouseEvent) {
+	groupOptions.value?.showMenu(
+		event,
+		props.sectionKey,
+		isCustomGroup.value
+			? [
+					{ name: 'new_instance' },
+					{ name: 'add_instances' },
+					{ name: 'edit_name' },
+					{ type: 'divider' },
+					{ name: 'delete_group', color: 'danger' },
+				]
+			: [{ name: 'new_instance' }],
+	)
+}
+
+async function handleGroupOption({ option }: { option: string }) {
+	if (option === 'new_instance') {
+		emit('newInstance')
+	} else if (option === 'add_instances') {
+		emit('addToGroup', props.sectionKey)
+	} else if (option === 'edit_name') {
+		groupNameInput.value?.startEditing()
+	} else if (option === 'delete_group') {
+		requestGroupDeletion()
+	}
+}
+
+function requestGroupDeletion() {
+	if (isUngrouped.value || isFavorites.value) return
+
+	if (props.instances.length > 0) {
+		confirmDeleteGroupModal.value?.show()
+	} else {
+		void removeGroup()
+	}
+}
+
+async function removeGroup() {
+	if (deletingGroup.value) return
+
+	deletingGroup.value = true
+	emit('deleteGroup', props.sectionKey)
+	setTimeout(() => {
+		deletingGroup.value = false
+		confirmDeleteGroupModal.value?.hide()
+	}, 300)
+}
+
+function onCardClick(instanceId: string, event: MouseEvent) {
+	emit('handleCardClick', instanceId, event)
+}
+
+function onStartLongPress(instanceId: string) {
+	emit('startLongPress', instanceId)
+}
+</script>
+
+<template>
+	<div
+		ref="groupContainerRef"
+		class="instance-group group/instance-container relative select-none pb-3"
+		@contextmenu.prevent.stop="openGroupContextMenu"
+	>
+		<div
+			v-if="!hideHeader && isDropTarget && isGroupDragActive"
+			class="pointer-events-none absolute -inset-2 inset-y-0 z-20 rounded-xl border-2 border-dashed border-contrast opacity-40 bg-transparent transition-opacity duration-150"
+		/>
+		<div
+			v-if="!hideHeader && (grouping === 'Group' || sectionKey !== UNGROUPED_GROUP_KEY)"
+			class="group/header flex h-10 w-full items-center gap-2 border-0 border-b border-solid border-b-surface-5"
+			:class="{ 'group-drag-handle cursor-grab': isCustomGroup }"
+		>
+			<div
+				class="flex min-w-0 cursor-pointer items-center gap-2"
+				@click="emit('toggleCollapse', sectionKey)"
+			>
+				<button
+					class="flex shrink-0 items-center border-0 bg-transparent p-0 cursor-pointer"
+					type="button"
+					:aria-expanded="!effectiveCollapsed"
+					:aria-label="
+						formatMessage(effectiveCollapsed ? messages.expandGroup : messages.collapseGroup)
+					"
+					@click.stop="emit('toggleCollapse', sectionKey)"
+				>
+					<DropdownIcon
+						class="size-5 shrink-0 text-[var(--color-text-tertiary)] transition-transform duration-300"
+						:class="{ 'rotate-180': !effectiveCollapsed }"
+					/>
+				</button>
+				<InlineEditableText
+					v-if="!isUngrouped && !isFavorites"
+					ref="groupNameInput"
+					v-model="groupName"
+					activation-mode="manual"
+					class="text-base font-semibold !h-10 text-[var(--color-text-default)] select-none"
+					max-width="24rem"
+					:max-length="MAX_GROUP_NAME_LENGTH"
+					:on-change="updateGroupName"
+					:validate="validateGroupName"
+				/>
+				<span v-else class="text-base font-semibold text-[var(--color-text-default)] select-none">
+					{{ isFavorites ? formatMessage(messages.pinned) : formatMessage(messages.ungrouped) }}
+				</span>
+				<TagItem v-if="instances.length" class="shrink-0 border-surface-3 bg-surface-2">
+					{{ instances.length }}
+				</TagItem>
+			</div>
+			<div class="min-w-0 flex-1" />
+			<div
+				v-if="isCustomGroup"
+				class="flex shrink-0 items-center opacity-0 transition-opacity duration-250 group-hover/header:opacity-100 focus-within:opacity-100"
+			>
+				<IconButton
+					v-tooltip="formatMessage(messages.moveGroupUp)"
+					:label="formatMessage(messages.moveGroupUp)"
+					type="quiet"
+					size="sm"
+					:disabled="!canMoveUp"
+					@click.stop="emit('moveGroup', sectionKey, -1)"
+				>
+					<ArrowUpIcon />
+				</IconButton>
+				<IconButton
+					v-tooltip="formatMessage(messages.moveGroupDown)"
+					:label="formatMessage(messages.moveGroupDown)"
+					type="quiet"
+					size="sm"
+					:disabled="!canMoveDown"
+					@click.stop="emit('moveGroup', sectionKey, 1)"
+				>
+					<ArrowDownIcon />
+				</IconButton>
+				<IconButton
+					v-tooltip="formatMessage(messages.editGroupName)"
+					:label="formatMessage(messages.editGroupName)"
+					type="quiet"
+					size="sm"
+					@click.stop="groupNameInput?.startEditing()"
+				>
+					<EditIcon />
+				</IconButton>
+				<IconButton
+					v-tooltip="formatMessage(messages.addToGroup)"
+					:label="formatMessage(messages.addToGroup)"
+					type="quiet"
+					size="sm"
+					@click.stop="emit('addToGroup', sectionKey)"
+				>
+					<PlusIcon />
+				</IconButton>
+				<IconButton
+					v-tooltip="formatMessage(messages.deleteGroup)"
+					:label="formatMessage(messages.deleteGroup)"
+					type="quiet"
+					size="sm"
+					:disabled="deletingGroup"
+					@click.stop="handleGroupOption({ option: 'delete_group' })"
+				>
+					<TrashIcon />
+				</IconButton>
+			</div>
+		</div>
+		<div v-if="!effectiveCollapsed" class="mt-2.5">
+			<section
+				class="grid grid-cols-[repeat(auto-fill,minmax(16rem,1fr))] w-full gap-3 mr-auto scroll-smooth overflow-y-auto"
+				:class="{
+					'grid-cols-[repeat(auto-fill,minmax(13rem,1fr))] gap-4': displayMode === 'cards',
+				}"
+			>
+				<template v-for="instance in instances" :key="instance.id">
+					<DraggableInstanceCard
+						v-if="isGroupDragActive"
+						:instance="instance"
+						:instance-group-id="sectionKey"
+						:disabled="selectMode"
+						@card-click="(event: MouseEvent) => onCardClick(instance.id, event)"
+						@contextmenu="
+							(event: MouseEvent) => emit('handleContextMenu', event, instance.id, props.sectionKey)
+						"
+						@start-long-press="onStartLongPress(instance.id)"
+						@cancel-long-press="emit('cancelLongPress')"
+					>
+						<template #default="{ isDragging }">
+							<div
+								:class="{
+									'pointer-events-none': selectMode,
+									'relative cursor-pointer select-none rounded-lg transition-all hover:brightness-90 active:scale-[0.98]': true,
+								}"
+								@click.capture="
+									(event: MouseEvent) => {
+										if (event.shiftKey && !selectMode) {
+											event.stopPropagation()
+											emit('handleCardClick', instance.id, event)
+										}
+									}
+								"
+							>
+								<Instance
+									:instance="instance"
+									:disabled="selectMode || isDragging"
+									:variant="displayMode === 'cards' ? 'library' : 'standard'"
+									:class="{
+										'opacity-50': selectMode && !selectedInstanceIds.has(instance.id),
+									}"
+								/>
+							</div>
+						</template>
+						<template #overlay>
+							<div
+								class="absolute right-2 bottom-2 z-10 transition-opacity"
+								:class="
+									selectMode && selectedInstanceIds.has(instance.id)
+										? ''
+										: 'opacity-0 group-hover:opacity-100'
+								"
+								@click.stop="emit('handleCheckboxClick', instance.id, $event)"
+							>
+								<Checkbox :model-value="selectedInstanceIds.has(instance.id)" />
+							</div>
+							<div
+								v-if="!selectMode"
+								class="absolute right-2 top-2 opacity-0 group-hover:opacity-100 transition-opacity"
+								@click.stop="
+									emit('handleContextMenu', $event as MouseEvent, instance.id, props.sectionKey)
+								"
+							>
+								<Button type="quiet" size="2xs" circular icon-only
+									><slot name="moreIcon" />
+								</Button>
+							</div>
+						</template>
+					</DraggableInstanceCard>
+
+					<div v-else class="group relative">
+						<div
+							class="relative cursor-pointer select-none rounded-lg transition-all hover:brightness-90 active:scale-[0.98]"
+							@click.capture="
+								(event: MouseEvent) => {
+									if (event.shiftKey && !selectMode) {
+										event.stopPropagation()
+										emit('handleCardClick', instance.id, event)
+									}
+								}
+							"
+							@click="emit('handleCardClick', instance.id, $event as MouseEvent)"
+							@mousedown="!selectMode && emit('startLongPress', instance.id)"
+							@mouseup="emit('cancelLongPress')"
+							@mouseleave="emit('cancelLongPress')"
+							@touchstart="!selectMode && emit('startLongPress', instance.id)"
+							@touchend="emit('cancelLongPress')"
+							@touchcancel="emit('cancelLongPress')"
+						>
+							<div :class="{ 'pointer-events-none': selectMode }">
+								<Instance
+									:instance="instance"
+									:disabled="selectMode"
+									:variant="displayMode === 'cards' ? 'library' : 'standard'"
+									:class="{
+										'opacity-50': selectMode && !selectedInstanceIds.has(instance.id),
+									}"
+									@contextmenu.prevent.stop="
+										(event: MouseEvent) =>
+											emit('handleContextMenu', event, instance.id, props.sectionKey)
+									"
+								/>
+							</div>
+						</div>
+						<div
+							class="absolute right-2 bottom-2 z-10 transition-opacity"
+							:class="
+								selectMode && selectedInstanceIds.has(instance.id)
+									? ''
+									: 'opacity-0 group-hover:opacity-100'
+							"
+							@click.stop="emit('handleCheckboxClick', instance.id, $event)"
+						>
+							<Checkbox :model-value="selectedInstanceIds.has(instance.id)" />
+						</div>
+						<div
+							v-if="!selectMode"
+							class="absolute right-2 top-2 opacity-0 group-hover:opacity-100 transition-opacity"
+							@click.stop="
+								emit('handleContextMenu', $event as MouseEvent, instance.id, props.sectionKey)
+							"
+						>
+							<Button type="quiet" size="2xs" circular icon-only><slot name="moreIcon" /> </Button>
+						</div>
+					</div>
+				</template>
+				<p
+					v-if="instances.length === 0"
+					class="col-span-full m-0 pt-1 pl-0.5 text-base font-base text-[var(--color-text-tertiary)] opacity-80"
+				>
+					{{ formatMessage(messages.emptyGroup) }}
+				</p>
+			</section>
+		</div>
+	</div>
+
+	<ContextMenu ref="groupOptions" @option-clicked="handleGroupOption">
+		<template #new_instance>
+			<PlusIcon />
+			{{ formatMessage(messages.newInstance) }}
+		</template>
+		<template #add_instances>
+			<PlusIcon />
+			{{ formatMessage(messages.addToGroup) }}
+		</template>
+		<template #edit_name>
+			<EditIcon />
+			{{ formatMessage(messages.editGroupName) }}
+		</template>
+		<template #delete_group>
+			<TrashIcon />
+			{{ formatMessage(messages.deleteGroup) }}
+		</template>
+	</ContextMenu>
+
+	<NewModal
+		ref="confirmDeleteGroupModal"
+		:header="formatMessage(messages.deleteGroup)"
+		fade="danger"
+		width="500px"
+	>
+		<p class="m-0 text-base text-[var(--color-text-default)]">
+			{{ formatMessage(messages.deleteGroupDescription) }}
+		</p>
+
+		<template #actions>
+			<div class="flex justify-end gap-2">
+				<Button type="outlined" @click="confirmDeleteGroupModal?.hide()">
+					<XIcon />
+					{{ formatMessage(commonMessages.cancelButton) }}
+				</Button>
+				<Button type="colored" color="red" :disabled="deletingGroup" @click="removeGroup">
+					<TrashIcon />
+					{{ formatMessage(messages.deleteGroup) }}
+				</Button>
+			</div>
+		</template>
+	</NewModal>
+</template>

apps/app-frontend/src/components/ui/minecraft-crash-logs.ts

@@ -0,0 +1,62 @@
+export interface CrashLogFile {
+	age: number
+	filename: string
+	log_type: 'InfoLog' | 'CrashReport' | 'JvmCrash' | 'LauncherLog'
+	output?: string | null
+}
+
+const RUN_ASSOCIATION_WINDOW_SECONDS = 3 * 60
+
+export function shouldUseLogShareAutoAnalysis(settings: {
+	ai_source: 'logshare' | 'custom'
+	auto_upload: boolean
+	no_storage?: boolean
+}): boolean {
+	return settings.ai_source === 'logshare' && settings.auto_upload
+}
+
+function isRelevantLog(file: CrashLogFile): boolean {
+	const lower = file.filename.toLowerCase()
+	if (file.log_type === 'CrashReport') return lower.endsWith('.txt')
+	if (file.log_type === 'JvmCrash') return lower.startsWith('hs_err') && lower.endsWith('.log')
+	return ['latest.log', 'debug.log', 'launcher_log.txt', 'latest_stdout.log'].includes(lower)
+}
+
+export function selectCrashLogFiles(files: CrashLogFile[]): CrashLogFile[] {
+	const sorted = files.filter(isRelevantLog).sort((left, right) => right.age - left.age)
+	const anchor = sorted[0]?.age
+	if (anchor === undefined) return []
+
+	const singletonTypes = new Set<CrashLogFile['log_type']>()
+	return sorted.filter((file) => {
+		if (anchor - file.age > RUN_ASSOCIATION_WINDOW_SECONDS) return false
+		if (file.log_type !== 'CrashReport' && file.log_type !== 'JvmCrash') return true
+		if (singletonTypes.has(file.log_type)) return false
+		singletonTypes.add(file.log_type)
+		return true
+	})
+}
+
+export function crashLogKey(file: CrashLogFile): string {
+	return `${file.log_type}:${file.filename}`
+}
+
+export function crashLogLabel(file: CrashLogFile): string {
+	return file.log_type === 'CrashReport' ? `crash-reports/${file.filename}` : file.filename
+}
+
+export function preferredCrashLogKey(files: CrashLogFile[]): string {
+	const preferred =
+		files.find((file) => file.log_type === 'CrashReport') ??
+		files.find((file) => file.log_type === 'JvmCrash') ??
+		files.find((file) => file.filename.toLowerCase() === 'latest.log') ??
+		files[0]
+	return preferred ? crashLogKey(preferred) : ''
+}
+
+export function combineCrashLogs(files: CrashLogFile[]): string {
+	return files
+		.filter((file) => file.output)
+		.map((file) => `===== ${crashLogLabel(file)} =====\n${file.output}`)
+		.join('\n\n')
+}

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

@@ -0,0 +1,313 @@
+<template>
+	<NewModal ref="modal" no-padding scrollable actions-divider max-width="560px" width="560px">
+		<template #title>
+			<span class="text-2xl font-semibold text-[var(--color-text-primary)]">
+				{{
+					existingGroupName
+						? formatMessage(messages.addToGroupTitle, { groupName: existingGroupName })
+						: formatMessage(messages.header)
+				}}
+			</span>
+		</template>
+
+		<template v-if="!existingGroupName">
+			<div class="flex flex-col gap-2.5 p-6">
+				<label for="new-group-name" class="font-semibold text-[var(--color-text-primary)]">
+					{{ formatMessage(messages.groupName) }}
+				</label>
+				<StyledInput
+					id="new-group-name"
+					ref="groupNameInput"
+					v-model="newGroupName"
+					:placeholder="formatMessage(messages.groupNamePlaceholder)"
+					:maxlength="32"
+					@click="groupNameInput?.select()"
+				/>
+			</div>
+
+			<div class="h-px bg-divider" />
+		</template>
+
+		<div class="flex h-[400px] flex-col gap-3 overflow-y-auto bg-surface-2 py-4">
+			<div class="px-6">
+				<StyledInput
+					v-model="newGroupSearch"
+					:icon="SearchIcon"
+					:placeholder="formatMessage(messages.searchInstance)"
+					class="w-full"
+				/>
+			</div>
+
+			<div
+				v-if="newGroupInstances.length === 0"
+				class="flex items-center justify-center py-12 text-[var(--color-text-tertiary)]"
+			>
+				{{ formatMessage(messages.noInstancesFound) }}
+			</div>
+			<div v-else class="flex flex-col gap-1">
+				<div
+					v-for="instance in newGroupInstances"
+					:key="instance.id"
+					class="flex items-center justify-between gap-4 px-6 py-1.5 hover:bg-surface-3"
+					:class="{ 'opacity-60': selectedNewGroupInstanceIds.has(instance.id) }"
+				>
+					<div class="flex min-w-0 items-center gap-2.5">
+						<InstanceIcon
+							:icon-path="instance.icon_path"
+							:instance-id="instance.id"
+							:loader="instance.loader"
+							class="!size-[2rem] !rounded-md"
+						/>
+						<div class="flex min-w-0 items-center gap-2">
+							<span class="truncate font-semibold text-[var(--color-text-primary)]">{{
+								instance.name
+							}}</span>
+							<TagItem v-if="instance.groups && instance.groups.length > 0" class="shrink-0">
+								{{ getGroupName(instance.groups[0]) }}
+							</TagItem>
+						</div>
+					</div>
+					<Button
+						:type="selectedNewGroupInstanceIds.has(instance.id) ? 'outlined' : 'base'"
+						@click="toggleNewGroupInstance(instance.id)"
+					>
+						<CheckIcon v-if="selectedNewGroupInstanceIds.has(instance.id)" />
+						{{
+							formatMessage(
+								selectedNewGroupInstanceIds.has(instance.id) ? messages.added : messages.add,
+							)
+						}}
+					</Button>
+				</div>
+			</div>
+		</div>
+
+		<template #actions>
+			<div class="flex items-center justify-end gap-2">
+				<Button type="outlined" @click="modal?.hide()">
+					<XIcon />
+					{{ formatMessage(messages.cancel) }}
+				</Button>
+				<Button
+					type="colored"
+					color="brand"
+					:disabled="existingGroupName ? !canSaveGroups : !canCreateGroup"
+					@click="existingGroupName ? handleSaveGroups() : handleCreateGroup()"
+				>
+					<SpinnerIcon v-if="creatingGroup" class="animate-spin" />
+					<CheckIcon v-else-if="existingGroupName" />
+					<PlusIcon v-else />
+					{{ formatMessage(existingGroupName ? messages.saveChanges : messages.createGroup) }}
+				</Button>
+			</div>
+		</template>
+	</NewModal>
+</template>
+
+<script setup lang="ts">
+import { CheckIcon, PlusIcon, SearchIcon, SpinnerIcon, XIcon } from '@modrinth/assets'
+import { Button, defineMessages, NewModal, StyledInput, TagItem, useVIntl } from '@modrinth/ui'
+import { computed, ref } from 'vue'
+
+import InstanceIcon from '@/components/ui/InstanceIcon.vue'
+import { FAVORITES_GROUP_ID } from '@/composables/useInstanceGroups'
+import { list } from '@/helpers/instance'
+import { create_group, list_groups, set_group_memberships } from '@/helpers/instance-groups'
+import type { GameInstance } from '@/helpers/types'
+
+const { formatMessage } = useVIntl()
+
+const props = defineProps<{
+	instanceIds: string[]
+	existingGroupName?: string
+	existingGroupId?: string
+}>()
+
+const emit = defineEmits<{
+	(e: 'applied'): void
+}>()
+
+const messages = defineMessages({
+	header: {
+		id: 'app.instances.batch-edit-groups.header',
+		defaultMessage: 'Create group',
+	},
+	addToGroupTitle: {
+		id: 'app.instances.batch-edit-groups.add-to-group-title',
+		defaultMessage: 'Add instances to "{groupName}"',
+	},
+	groupName: {
+		id: 'app.instances.batch-edit-groups.group-name',
+		defaultMessage: 'Group name',
+	},
+	groupNamePlaceholder: {
+		id: 'app.instances.batch-edit-groups.group-name-placeholder',
+		defaultMessage: 'Enter group name',
+	},
+	searchInstance: {
+		id: 'app.instances.batch-edit-groups.search-instance',
+		defaultMessage: 'Search instances',
+	},
+	noInstancesFound: {
+		id: 'app.instances.batch-edit-groups.no-instances-found',
+		defaultMessage: 'No instances found',
+	},
+	add: {
+		id: 'app.instances.batch-edit-groups.add',
+		defaultMessage: 'Add',
+	},
+	added: {
+		id: 'app.instances.batch-edit-groups.added',
+		defaultMessage: 'Added',
+	},
+	cancel: {
+		id: 'app.instances.batch-edit-groups.cancel',
+		defaultMessage: 'Cancel',
+	},
+	createGroup: {
+		id: 'app.instances.batch-edit-groups.create',
+		defaultMessage: 'Create group',
+	},
+	pinnedGroupName: {
+		id: 'app.instances.group.pinned',
+		defaultMessage: 'Pinned',
+	},
+	saveChanges: {
+		id: 'app.instances.batch-edit-groups.save-changes',
+		defaultMessage: 'Save',
+	},
+})
+
+const modal = ref<InstanceType<typeof NewModal>>()
+const groupNameInput = ref<InstanceType<typeof StyledInput>>()
+const newGroupName = ref('')
+const newGroupSearch = ref('')
+const creatingGroup = ref(false)
+const allInstances = ref<GameInstance[]>([])
+const groupNameMap = ref(new Map<string, string>())
+const selectedNewGroupInstanceIds = ref(new Set<string>())
+
+const canCreateGroup = computed(() => newGroupName.value.trim().length > 0)
+
+const canSaveGroups = computed(() => {
+	if (!props.existingGroupName) return false
+	const groupId = props.existingGroupId
+	if (!groupId) return false
+	return allInstances.value.some((instance) => {
+		const isSelected = selectedNewGroupInstanceIds.value.has(instance.id)
+		const hasGroup = (instance.groups || []).includes(groupId)
+		return isSelected !== hasGroup
+	})
+})
+
+const newGroupInstances = computed(() => {
+	const search = newGroupSearch.value.toLowerCase()
+	return allInstances.value.filter((instance) => {
+		if (!search) return true
+		return instance.name.toLowerCase().includes(search)
+	})
+})
+
+function getGroupName(groupId: string) {
+	if (groupId === FAVORITES_GROUP_ID) {
+		return formatMessage(messages.pinnedGroupName)
+	}
+	return groupNameMap.value.get(groupId) || groupId
+}
+
+function show(ids?: string[]) {
+	newGroupSearch.value = ''
+	creatingGroup.value = false
+	Promise.all([list(), list_groups()]).then(([instances, groups]) => {
+		allInstances.value = instances as GameInstance[]
+		const map = new Map<string, string>()
+		for (const g of groups) {
+			map.set(g.id, g.name)
+		}
+		groupNameMap.value = map
+
+		if (!props.existingGroupName) {
+			const customGroups = groups.filter((g: { id: string }) => g.id !== 'group:favorites')
+			let groupNumber = customGroups.length + 1
+			const existingNames = new Set(groups.map((g: { name: string }) => g.name.toLowerCase()))
+			while (existingNames.has(`group ${groupNumber}`)) {
+				groupNumber++
+			}
+			newGroupName.value = `Group ${groupNumber}`
+		}
+
+		if (props.existingGroupName) {
+			const groupId = props.existingGroupId
+			selectedNewGroupInstanceIds.value = new Set(
+				allInstances.value.filter((i) => (i.groups || []).includes(groupId || '')).map((i) => i.id),
+			)
+		} else {
+			selectedNewGroupInstanceIds.value = new Set(ids ?? props.instanceIds)
+		}
+	})
+	modal.value?.show()
+}
+
+function toggleNewGroupInstance(instanceId: string) {
+	const next = new Set(selectedNewGroupInstanceIds.value)
+	if (next.has(instanceId)) {
+		next.delete(instanceId)
+	} else {
+		next.add(instanceId)
+	}
+	selectedNewGroupInstanceIds.value = next
+}
+
+async function handleCreateGroup() {
+	const name = newGroupName.value.trim()
+	if (!name || selectedNewGroupInstanceIds.value.size === 0) return
+
+	creatingGroup.value = true
+
+	const group = await create_group(name).catch(() => null)
+	if (!group) {
+		creatingGroup.value = false
+		return
+	}
+
+	if (selectedNewGroupInstanceIds.value.size > 0) {
+		const updates = [...selectedNewGroupInstanceIds.value].map((instanceId) => ({
+			instance_id: instanceId,
+			group_ids: [group.id],
+		}))
+		await set_group_memberships(updates).catch(() => {})
+	}
+
+	creatingGroup.value = false
+	modal.value?.hide()
+	emit('applied')
+}
+
+async function handleSaveGroups() {
+	if (!props.existingGroupName) return
+
+	creatingGroup.value = true
+	const groupId = props.existingGroupId
+
+	const changedInstances = allInstances.value.filter((instance) => {
+		const isSelected = selectedNewGroupInstanceIds.value.has(instance.id)
+		const hasGroup = (instance.groups || []).includes(groupId || '')
+		return isSelected !== hasGroup
+	})
+
+	const updates = changedInstances.map((instance) => {
+		const isSelected = selectedNewGroupInstanceIds.value.has(instance.id)
+		return {
+			instance_id: instance.id,
+			group_ids: isSelected ? [groupId!] : [],
+		}
+	})
+	await set_group_memberships(updates).catch(() => {})
+
+	creatingGroup.value = false
+	modal.value?.hide()
+	emit('applied')
+}
+
+defineExpose({ show })
+</script>

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

@@ -7,6 +7,7 @@ import {
 	FileArchiveIcon,
 	InfoIcon,
 	MonitorIcon,
+	RefreshCwIcon,
 	WrenchIcon,
 } from '@modrinth/assets'
 import {
@@ -23,6 +24,7 @@ import { computed, nextTick, ref, watch } from 'vue'
 import BackupSettings from '@/components/ui/instance_settings/BackupSettings.vue'
 import CoreComponentsSettings from '@/components/ui/instance_settings/CoreComponentsSettings.vue'
 import GeneralSettings from '@/components/ui/instance_settings/GeneralSettings.vue'
+import SyncSettings from '@/components/ui/instance_settings/SyncSettings.vue'
 import HooksSettings from '@/components/ui/instance_settings/HooksSettings.vue'
 import InstallationSettings from '@/components/ui/instance_settings/InstallationSettings.vue'
 import JavaSettings from '@/components/ui/instance_settings/JavaSettings.vue'
@@ -53,8 +55,9 @@ let serverMetadataGeneration = 0
 const instanceRef = computed(() => props.instance)
 const tabbedModal = ref<InstanceType<typeof TabbedModal> | null>(null)
 
-function hide() {
+function hide(onAfterClose?: () => void) {
 	tabbedModal.value?.hide()
+	if (onAfterClose) nextTick(onAfterClose)
 }
 
 provideInstanceSettings({
@@ -147,6 +150,14 @@ const tabs = computed<TabbedModalTab[]>(() => [
 		icon: CodeIcon,
 		content: HooksSettings,
 	},
+	{
+		name: defineMessage({
+			id: 'instance.settings.tabs.sync',
+			defaultMessage: 'Sync',
+		}),
+		icon: RefreshCwIcon,
+		content: SyncSettings,
+	},
 ])
 
 function getSupportedModpackLoaders() {

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

@@ -6,6 +6,8 @@ import { ref, watch } from 'vue'
 import { get, set } from '@/helpers/settings.ts'
 
 import CrashAnalysisAISettings from './CrashAnalysisAISettings.vue'
+import LogShareSettings from './LogShareSettings.vue'
+import SharedLogsSettings from './SharedLogsSettings.vue'
 import SettingsRow from './SettingsRow.vue'
 import SettingsSection from './SettingsSection.vue'
 
@@ -38,6 +40,26 @@ const messages = defineMessages({
 		id: 'app.settings.defaults.maximize-window.unsupported',
 		defaultMessage: 'Not supported on this operating system.',
 	},
+	windowTitleEnabled: {
+		id: 'app.settings.defaults.window-title.enabled',
+		defaultMessage: 'Custom Minecraft window title',
+	},
+	windowTitleEnabledDescription: {
+		id: 'app.settings.defaults.window-title.enabled-description',
+		defaultMessage: 'Allow instances to customize the Minecraft window title.',
+	},
+	defaultWindowTitle: {
+		id: 'app.settings.defaults.window-title.default',
+		defaultMessage: 'Default window title',
+	},
+	defaultWindowTitleDescription: {
+		id: 'app.settings.defaults.window-title.default-description',
+		defaultMessage: 'Used when an instance leaves its window title empty.',
+	},
+	defaultWindowTitlePlaceholder: {
+		id: 'app.settings.defaults.window-title.default-placeholder',
+		defaultMessage: 'Enter default window title...',
+	},
 	width: { id: 'app.settings.defaults.width', defaultMessage: 'Width' },
 	widthDescription: {
 		id: 'app.settings.defaults.width-description',
@@ -212,6 +234,36 @@ watch(
 					/>
 				</template>
 			</SettingsRow>
+			<SettingsRow>
+				<template #label>
+					<span id="settings-target-defaults-window-title" tabindex="-1">
+						{{ formatMessage(messages.windowTitleEnabled) }}
+					</span>
+				</template>
+				<template #description>{{
+					formatMessage(messages.windowTitleEnabledDescription)
+				}}</template>
+				<template #control>
+					<Toggle id="custom-window-title-enabled" v-model="settings.custom_window_title_enabled" />
+				</template>
+			</SettingsRow>
+			<SettingsRow stacked>
+				<template #label>{{ formatMessage(messages.defaultWindowTitle) }}</template>
+				<template #description>{{
+					formatMessage(messages.defaultWindowTitleDescription)
+				}}</template>
+				<template #control>
+					<StyledInput
+						id="default-window-title"
+						v-model="settings.default_window_title"
+						:disabled="!settings.custom_window_title_enabled"
+						autocomplete="off"
+						type="text"
+						:placeholder="formatMessage(messages.defaultWindowTitlePlaceholder)"
+						wrapper-class="w-full"
+					/>
+				</template>
+			</SettingsRow>
 		</SettingsSection>
 
 		<SettingsSection>
@@ -341,5 +393,7 @@ watch(
 		</SettingsSection>
 
 		<CrashAnalysisAISettings />
+		<LogShareSettings />
+		<SharedLogsSettings />
 	</div>
 </template>

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

@@ -71,6 +71,7 @@ const featureFlagLabels: Record<FeatureFlag, string> = {
 	advanced_filters_collapsed: '高级筛选默认折叠',
 	multiplayer_in_app: '多人联机',
 	auto_install_dependencies: '自动安装依赖',
+	force_anniversary_celebration: '强制显示周年庆庆祝（调试）',
 }
 
 const settings = ref(await getSettings())

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

@@ -0,0 +1,231 @@
+<script setup lang="ts">
+import {
+	defineMessages,
+	type KeyBinding,
+	KeybindingChips,
+	KeybindingModal,
+	Toggle,
+	useVIntl,
+} from '@modrinth/ui'
+import { computed, ref } from 'vue'
+
+import { getNavShortcutEnabled, setNavShortcutEnabled } from '@/helpers/nav-shortcut-state'
+import { getQuickScrollEnabled, setQuickScrollEnabled } from '@/helpers/scroll-top-state'
+import { NAV_ACTIONS, SCROLL_ACTIONS, type ShortcutAction } from '@/helpers/shortcut-actions'
+import {
+	buildConflicts,
+	clearStoredBinding,
+	resolveAllBindings,
+	storeBinding,
+} from '@/helpers/shortcut-bindings'
+import { useTheming } from '@/store/theme'
+
+import SettingsRow from './SettingsRow.vue'
+import SettingsSection from './SettingsSection.vue'
+
+const { formatMessage } = useVIntl()
+const themeStore = useTheming()
+
+themeStore.quickScrollEnabled = getQuickScrollEnabled()
+themeStore.shortcutBindings = resolveAllBindings()
+for (const action of NAV_ACTIONS) {
+	themeStore[action.enabledField] = getNavShortcutEnabled(action.id)
+}
+
+const messages = defineMessages({
+	scrollTitle: {
+		id: 'app.shortcut-settings.scroll-title',
+		defaultMessage: 'Quick scrolling',
+	},
+	scrollDescription: {
+		id: 'app.shortcut-settings.scroll-description',
+		defaultMessage: 'Move through long pages with the keyboard.',
+	},
+	enable: { id: 'app.shortcut-settings.enable', defaultMessage: 'Enable quick scrolling' },
+	navTitle: {
+		id: 'app.shortcut-settings.nav-title',
+		defaultMessage: 'Navigation shortcuts',
+	},
+	navDescription: {
+		id: 'app.shortcut-settings.nav-description',
+		defaultMessage: 'Jump to a menu item with its shortcut. Each shortcut is off until enabled.',
+	},
+	changeShortcut: {
+		id: 'app.shortcut-settings.change-shortcut',
+		defaultMessage: 'Change the shortcut for {action}',
+	},
+})
+
+function actionLabel(action: ShortcutAction) {
+	return formatMessage(action.label)
+}
+
+function actionDescription(action: ShortcutAction) {
+	return formatMessage(action.description)
+}
+
+function bindingFor(action: ShortcutAction): KeyBinding {
+	return themeStore.shortcutBindings[action.id] ?? action.defaultBinding
+}
+
+function sameBinding(left: KeyBinding, right: KeyBinding) {
+	return (
+		left.device === right.device &&
+		left.code === right.code &&
+		left.mod === right.mod &&
+		left.shift === right.shift &&
+		left.alt === right.alt
+	)
+}
+
+const editing = ref<ShortcutAction | null>(null)
+const keybindingModal = ref<InstanceType<typeof KeybindingModal>>()
+
+const editingLabel = computed(() => (editing.value ? actionLabel(editing.value) : undefined))
+const editingBinding = computed(() => (editing.value ? bindingFor(editing.value) : null))
+const editingDefault = computed(() => editing.value?.defaultBinding ?? null)
+const editingConflicts = computed(() =>
+	editing.value
+		? buildConflicts(editing.value.id, (id) => {
+				const action = [...SCROLL_ACTIONS, ...NAV_ACTIONS].find((candidate) => candidate.id === id)
+				return action ? actionLabel(action) : id
+			})
+		: [],
+)
+
+function openShortcut(action: ShortcutAction) {
+	editing.value = action
+	keybindingModal.value?.show()
+}
+
+function saveShortcut(binding: KeyBinding) {
+	const action = editing.value
+	if (!action) return
+
+	// A combination matching the default is stored as "not changed", so a later
+	// change to the default still reaches this shortcut.
+	if (sameBinding(binding, action.defaultBinding)) clearStoredBinding(action.id)
+	else storeBinding(action.id, binding)
+
+	themeStore.shortcutBindings = { ...themeStore.shortcutBindings, [action.id]: binding }
+}
+
+function toggleQuickScroll(value: unknown) {
+	themeStore.quickScrollEnabled = !!value
+	setQuickScrollEnabled(themeStore.quickScrollEnabled)
+}
+
+function toggleNavShortcut(action: ShortcutAction, value: unknown) {
+	themeStore[action.enabledField] = !!value
+	setNavShortcutEnabled(action.id, !!value)
+}
+</script>
+
+<template>
+	<div class="flex flex-col gap-6">
+		<SettingsSection>
+			<template #header>
+				<h2 class="m-0 text-lg font-semibold text-[var(--color-text-primary)]">
+					{{ formatMessage(messages.scrollTitle) }}
+				</h2>
+				<p class="m-0 mt-1 text-sm leading-relaxed text-[var(--color-text-tertiary)]">
+					{{ formatMessage(messages.scrollDescription) }}
+				</p>
+			</template>
+			<SettingsRow>
+				<template #label>
+					<span id="settings-target-shortcuts-enable" tabindex="-1">
+						{{ formatMessage(messages.enable) }}
+					</span>
+				</template>
+				<template #control>
+					<Toggle
+						id="quick-scroll-enabled"
+						:model-value="themeStore.quickScrollEnabled"
+						@update:model-value="toggleQuickScroll"
+					/>
+				</template>
+			</SettingsRow>
+			<SettingsRow v-for="action in SCROLL_ACTIONS" :key="action.id">
+				<template #label>
+					<span :id="`settings-target-${action.id}`" tabindex="-1">{{ actionLabel(action) }}</span>
+				</template>
+				<template #description>{{ actionDescription(action) }}</template>
+				<template #control>
+					<button
+						type="button"
+						class="keybinding-trigger"
+						:aria-label="formatMessage(messages.changeShortcut, { action: actionLabel(action) })"
+						@click="openShortcut(action)"
+					>
+						<KeybindingChips :binding="bindingFor(action)" />
+					</button>
+				</template>
+			</SettingsRow>
+		</SettingsSection>
+
+		<SettingsSection>
+			<template #header>
+				<h2
+					id="settings-target-shortcuts-nav"
+					tabindex="-1"
+					class="m-0 text-lg font-semibold text-[var(--color-text-primary)]"
+				>
+					{{ formatMessage(messages.navTitle) }}
+				</h2>
+				<p class="m-0 mt-1 text-sm leading-relaxed text-[var(--color-text-tertiary)]">
+					{{ formatMessage(messages.navDescription) }}
+				</p>
+			</template>
+			<SettingsRow v-for="action in NAV_ACTIONS" :key="action.id">
+				<template #label>{{ actionLabel(action) }}</template>
+				<template #description>{{ actionDescription(action) }}</template>
+				<template #control>
+					<div class="flex flex-wrap items-center justify-end gap-3">
+						<button
+							type="button"
+							class="keybinding-trigger"
+							:aria-label="formatMessage(messages.changeShortcut, { action: actionLabel(action) })"
+							@click="openShortcut(action)"
+						>
+							<KeybindingChips :binding="bindingFor(action)" />
+						</button>
+						<Toggle
+							:id="`nav-shortcut-${action.id}`"
+							:model-value="themeStore[action.enabledField]"
+							@update:model-value="(value) => toggleNavShortcut(action, value)"
+						/>
+					</div>
+				</template>
+			</SettingsRow>
+		</SettingsSection>
+
+		<KeybindingModal
+			ref="keybindingModal"
+			:action-label="editingLabel"
+			:binding="editingBinding"
+			:default-binding="editingDefault"
+			:conflicts="editingConflicts"
+			@save="saveShortcut"
+		/>
+	</div>
+</template>
+
+<style scoped>
+.keybinding-trigger {
+	cursor: pointer;
+	border-radius: var(--radius-md);
+	border: 1px solid transparent;
+	background: transparent;
+	padding: 0.25rem 0.375rem;
+	transition:
+		background-color 0.15s ease,
+		border-color 0.15s ease;
+}
+
+.keybinding-trigger:hover,
+.keybinding-trigger:focus-visible {
+	border-color: var(--surface-4);
+	background: var(--surface-3);
+}
+</style>

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

@@ -0,0 +1,192 @@
+<script setup lang="ts">
+import { DownloadIcon, FolderOpenIcon, XIcon } from '@modrinth/assets'
+import {
+	Button,
+	Checkbox,
+	Combobox,
+	commonMessages,
+	defineMessages,
+	injectNotificationManager,
+	injectPopupNotificationManager,
+	NewModal,
+	useVIntl,
+} from '@modrinth/ui'
+import { computed, ref } from 'vue'
+
+import { exportLauncherLogs, highlightInFolder } from '@/helpers/utils'
+
+const { formatMessage } = useVIntl()
+const { handleError } = injectNotificationManager()
+const popupNotificationManager = injectPopupNotificationManager()
+
+const modal = ref<InstanceType<typeof NewModal>>()
+const exporting = ref(false)
+const selectedRange = ref<'last30Minutes' | 'last2Hours' | 'all'>('last2Hours')
+const selectedLevel = ref<'all' | 'debug' | 'info'>('all')
+const includeSystemInfo = ref(true)
+const includeInstanceLogs = ref(false)
+const includeCrashAnalysis = ref(false)
+
+const messages = defineMessages({
+	title: { id: 'app.settings.logs.export.modal.title', defaultMessage: 'Export logs' },
+	description: {
+		id: 'app.settings.logs.export.modal.description',
+		defaultMessage:
+			'Choose how much detail to include. Exported logs have access tokens, Minecraft tokens, and IP addresses replaced with placeholders.',
+	},
+	rangeLabel: { id: 'app.settings.logs.export.modal.range', defaultMessage: 'Time range' },
+	rangeLast30Minutes: {
+		id: 'app.settings.logs.export.modal.range.30-minutes',
+		defaultMessage: 'Last 30 minutes',
+	},
+	rangeLast2Hours: {
+		id: 'app.settings.logs.export.modal.range.2-hours',
+		defaultMessage: 'Last 2 hours',
+	},
+	rangeAll: { id: 'app.settings.logs.export.modal.range.all', defaultMessage: 'All sessions' },
+	levelLabel: { id: 'app.settings.logs.export.modal.level', defaultMessage: 'Log level' },
+	levelAll: { id: 'app.settings.logs.export.modal.level.all', defaultMessage: 'All levels' },
+	levelDebug: {
+		id: 'app.settings.logs.export.modal.level.debug',
+		defaultMessage: 'Debug and above',
+	},
+	levelInfo: { id: 'app.settings.logs.export.modal.level.info', defaultMessage: 'Info and above' },
+	extrasLabel: {
+		id: 'app.settings.logs.export.modal.extras',
+		defaultMessage: 'Additional information',
+	},
+	systemInfo: {
+		id: 'app.settings.logs.export.modal.system-info',
+		defaultMessage: 'System and environment summary',
+	},
+	instanceLogs: {
+		id: 'app.settings.logs.export.modal.instance-logs',
+		defaultMessage: 'Most recent instance log',
+	},
+	crashAnalysis: {
+		id: 'app.settings.logs.export.modal.crash-analysis',
+		defaultMessage: 'Crash analysis (when a crash is detected)',
+	},
+	cancel: { id: 'app.settings.logs.export.modal.cancel', defaultMessage: 'Cancel' },
+	confirm: { id: 'app.settings.logs.export.modal.confirm', defaultMessage: 'Export' },
+	exportedTitle: {
+		id: 'app.settings.logs.export.notification-title',
+		defaultMessage: 'Logs exported',
+	},
+	exportedText: {
+		id: 'app.settings.logs.export.notification-text',
+		defaultMessage: 'The log archive was saved to {path}',
+	},
+})
+
+const rangeOptions = computed(() => [
+	{ value: 'last30Minutes', label: formatMessage(messages.rangeLast30Minutes) },
+	{ value: 'last2Hours', label: formatMessage(messages.rangeLast2Hours) },
+	{ value: 'all', label: formatMessage(messages.rangeAll) },
+])
+
+const levelOptions = computed(() => [
+	{ value: 'all', label: formatMessage(messages.levelAll) },
+	{ value: 'debug', label: formatMessage(messages.levelDebug) },
+	{ value: 'info', label: formatMessage(messages.levelInfo) },
+])
+
+async function exportLogs() {
+	exporting.value = true
+	try {
+		const path = await exportLauncherLogs({
+			range: selectedRange.value,
+			level: selectedLevel.value,
+			includeSystemInfo: includeSystemInfo.value,
+			includeInstanceLogs: includeInstanceLogs.value,
+			includeCrashAnalysis: includeCrashAnalysis.value,
+		})
+
+		if (path) {
+			modal.value?.hide()
+			popupNotificationManager.addPopupNotification({
+				title: formatMessage(messages.exportedTitle),
+				text: formatMessage(messages.exportedText, { path }),
+				type: 'success',
+				buttons: [
+					{
+						label: formatMessage(commonMessages.openInFolderButton),
+						icon: FolderOpenIcon,
+						action: () => highlightInFolder(path).catch(handleError),
+					},
+				],
+			})
+		}
+	} catch (error) {
+		handleError(error)
+	} finally {
+		exporting.value = false
+	}
+}
+
+defineExpose({
+	show: () => modal.value?.show(),
+	hide: () => modal.value?.hide(),
+})
+</script>
+
+<template>
+	<NewModal
+		ref="modal"
+		:header="formatMessage(messages.title)"
+		:closable="true"
+		:close-on-click-outside="true"
+		width="40rem"
+		scrollable
+	>
+		<div class="flex flex-col gap-4">
+			<p class="m-0">{{ formatMessage(messages.description) }}</p>
+
+			<div class="flex flex-col gap-2">
+				<span class="font-semibold text-[var(--color-text-primary)]">{{
+					formatMessage(messages.rangeLabel)
+				}}</span>
+				<Combobox
+					id="log-export-range"
+					v-model="selectedRange"
+					:name="formatMessage(messages.rangeLabel)"
+					:options="rangeOptions"
+				/>
+			</div>
+
+			<div class="flex flex-col gap-2">
+				<span class="font-semibold text-[var(--color-text-primary)]">{{
+					formatMessage(messages.levelLabel)
+				}}</span>
+				<Combobox
+					id="log-export-level"
+					v-model="selectedLevel"
+					:name="formatMessage(messages.levelLabel)"
+					:options="levelOptions"
+				/>
+			</div>
+
+			<div class="flex flex-col gap-2">
+				<span class="font-semibold text-[var(--color-text-primary)]">{{
+					formatMessage(messages.extrasLabel)
+				}}</span>
+				<Checkbox v-model="includeSystemInfo" :label="formatMessage(messages.systemInfo)" />
+				<Checkbox v-model="includeInstanceLogs" :label="formatMessage(messages.instanceLogs)" />
+				<Checkbox v-model="includeCrashAnalysis" :label="formatMessage(messages.crashAnalysis)" />
+			</div>
+		</div>
+
+		<template #actions>
+			<div class="flex justify-end gap-2">
+				<Button type="outlined" :disabled="exporting" @click="modal?.hide()"
+					><XIcon />
+					{{ formatMessage(messages.cancel) }}
+				</Button>
+				<Button type="colored" color="brand" :disabled="exporting" @click="exportLogs"
+					><DownloadIcon />
+					{{ formatMessage(messages.confirm) }}
+				</Button>
+			</div>
+		</template>
+	</NewModal>
+</template>

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

@@ -0,0 +1,354 @@
+<script setup lang="ts">
+import { Combobox, defineMessages, injectNotificationManager, Toggle, useVIntl } from '@modrinth/ui'
+import { computed, onMounted, ref } from 'vue'
+
+import { type AIState, getAIState, sharedAIState } from '@/helpers/ai'
+import {
+	get_crash_analysis_ai_settings,
+	get_log_share_settings,
+	update_crash_analysis_ai_settings,
+	update_log_share_settings,
+} from '@/helpers/logs'
+
+import SettingsRow from './SettingsRow.vue'
+import SettingsSection from './SettingsSection.vue'
+
+type CrashAISettings = {
+	enabled: boolean
+	provider_id: string
+	model_id: string
+	ai_source: 'logshare' | 'custom'
+}
+
+type LogShareSettings = {
+	share_provider: 'logshare' | 'mclogs'
+	ai_source: string
+	auto_upload: boolean
+	multi_file: boolean
+	no_storage: boolean
+	show_progress: boolean
+}
+
+const { formatMessage } = useVIntl()
+const { handleError } = injectNotificationManager()
+const settings = ref<LogShareSettings>({
+	share_provider: 'logshare',
+	ai_source: 'logshare',
+	auto_upload: true,
+	multi_file: true,
+	no_storage: false,
+	show_progress: true,
+})
+const aiSettings = ref<CrashAISettings>({
+	enabled: false,
+	provider_id: '',
+	model_id: '',
+	ai_source: 'logshare',
+})
+const loading = ref(true)
+const saving = ref(false)
+
+const messages = defineMessages({
+	title: { id: 'app.log-share.settings.title', defaultMessage: 'Log sharing & AI analysis' },
+	description: {
+		id: 'app.log-share.settings.description',
+		defaultMessage:
+			'Share crash diagnostics with LogShare for a structured summary and optional AI analysis. LogShare is preferred; mclo.gs is used as a fallback.',
+	},
+	shareProvider: {
+		id: 'app.log-share.settings.share-provider',
+		defaultMessage: 'Log sharing service',
+	},
+	shareProviderDescription: {
+		id: 'app.log-share.settings.share-provider-description',
+		defaultMessage: 'Where the diagnostic link is uploaded when you share it.',
+	},
+	aiSource: { id: 'app.log-share.settings.ai-source', defaultMessage: 'AI analysis source' },
+	aiSourceLogShare: {
+		id: 'app.log-share.settings.ai-source-logshare',
+		defaultMessage: 'LogShare AI',
+	},
+	aiSourceCustom: {
+		id: 'app.log-share.settings.ai-source-custom',
+		defaultMessage: 'Custom AI provider',
+	},
+	aiSourceDescription: {
+		id: 'app.log-share.settings.ai-source-description',
+		defaultMessage:
+			'Both sources send a sanitized and shortened crash context. AI output may be inaccurate.',
+	},
+	enabled: {
+		id: 'app.crash-analysis.ai.settings.enabled',
+		defaultMessage: 'Enable AI explanations',
+	},
+	enabledDescription: {
+		id: 'app.crash-analysis.ai.settings.enabled-description',
+		defaultMessage: 'Local rule-based crash analysis remains available without AI.',
+	},
+	provider: { id: 'app.crash-analysis.ai.settings.provider', defaultMessage: 'AI provider' },
+	model: { id: 'app.crash-analysis.ai.settings.model', defaultMessage: 'Text model' },
+	noProviders: {
+		id: 'app.crash-analysis.ai.settings.no-providers',
+		defaultMessage: 'Enable a provider and a text model above before using AI crash explanations.',
+	},
+	autoUpload: {
+		id: 'app.log-share.settings.auto-upload',
+		defaultMessage: 'Upload to get a structured summary automatically',
+	},
+	autoUploadDescription: {
+		id: 'app.log-share.settings.auto-upload-description',
+		defaultMessage: 'Only effective in LogShare AI mode.',
+	},
+	multiFile: { id: 'app.log-share.settings.multi-file', defaultMessage: 'Multi-file upload' },
+	multiFileDescription: {
+		id: 'app.log-share.settings.multi-file-description',
+		defaultMessage: 'Upload latest.log, crash reports, hs_err and launcher logs together.',
+	},
+	noStorage: {
+		id: 'app.log-share.settings.no-storage',
+		defaultMessage: 'Analyze without storing logs',
+	},
+	noStorageDescription: {
+		id: 'app.log-share.settings.no-storage-description',
+		defaultMessage:
+			'Submit content directly for analysis and skip the stored upload. Disables the automatic summary.',
+	},
+	showProgress: {
+		id: 'app.log-share.settings.show-progress',
+		defaultMessage: 'Show AI analysis progress',
+	},
+	showProgressDescription: {
+		id: 'app.log-share.settings.show-progress-description',
+		defaultMessage: 'Display thinking, tool and limit status while LogShare AI is working.',
+	},
+})
+
+const emptyState: AIState = { settings: { enabled: false }, catalog_source: '', providers: [] }
+const aiState = computed(() => sharedAIState.value ?? emptyState)
+const providers = computed(() =>
+	aiState.value.providers.filter(
+		(provider) => provider.enabled && provider.models.some((model) => model.enabled),
+	),
+)
+const providerOptions = computed(() =>
+	providers.value.map((provider) => ({
+		value: provider.provider_id,
+		label: provider.custom_name || provider.provider_id,
+	})),
+)
+const modelOptions = computed(
+	() =>
+		providers.value
+			.find((provider) => provider.provider_id === aiSettings.value.provider_id)
+			?.models.filter((model) => model.enabled)
+			.map((model) => ({ value: model.id, label: model.name || model.id })) ?? [],
+)
+
+const isCustom = computed(() => aiSettings.value.ai_source === 'custom')
+const noStorageEnabled = computed(() => aiSettings.value.ai_source === 'logshare')
+
+const shareProviderOptions = [
+	{ value: 'logshare', label: 'LogShare' },
+	{ value: 'mclogs', label: 'mclo.gs' },
+]
+const aiSourceOptions = [
+	{ value: 'logshare', label: formatMessage(messages.aiSourceLogShare) },
+	{ value: 'custom', label: formatMessage(messages.aiSourceCustom) },
+]
+
+async function saveShare(next: LogShareSettings): Promise<void> {
+	saving.value = true
+	try {
+		await update_log_share_settings(next)
+		settings.value = next
+	} catch (error) {
+		handleError(error)
+	} finally {
+		saving.value = false
+	}
+}
+
+async function saveAI(next: CrashAISettings): Promise<void> {
+	saving.value = true
+	try {
+		await update_crash_analysis_ai_settings(next)
+		aiSettings.value = next
+		settings.value = { ...settings.value, ai_source: next.ai_source }
+	} catch (error) {
+		handleError(error)
+	} finally {
+		saving.value = false
+	}
+}
+
+function updateShare(patch: Partial<LogShareSettings>): void {
+	void saveShare({ ...settings.value, ...patch })
+}
+
+function selectShareProvider(value: unknown): void {
+	const provider = value === 'mclogs' ? 'mclogs' : 'logshare'
+	updateShare({ share_provider: provider, ai_source: aiSettings.value.ai_source })
+}
+
+function selectAiSource(value: unknown): void {
+	const source = value === 'custom' ? 'custom' : 'logshare'
+	void saveAI({ ...aiSettings.value, ai_source: source })
+}
+
+function updateEnabled(enabled: boolean): void {
+	void saveAI({ ...aiSettings.value, enabled })
+}
+
+function updateProvider(providerId: string): void {
+	const provider = providers.value.find((item) => item.provider_id === providerId)
+	const modelId = provider?.models.find((model) => model.enabled)?.id ?? ''
+	void saveAI({ ...aiSettings.value, provider_id: providerId, model_id: modelId })
+}
+
+function updateModel(modelId: string): void {
+	void saveAI({ ...aiSettings.value, model_id: modelId })
+}
+
+onMounted(async () => {
+	try {
+		const [nextShare, nextAI] = await Promise.all([
+			get_log_share_settings(),
+			get_crash_analysis_ai_settings(),
+			getAIState(),
+		])
+		settings.value = { ...nextShare, ai_source: nextAI.ai_source }
+		aiSettings.value = nextAI
+	} catch (error) {
+		handleError(error)
+	} finally {
+		loading.value = false
+	}
+})
+</script>
+
+<template>
+	<SettingsSection
+		v-if="!loading"
+		id="settings-target-log-share"
+		:title="formatMessage(messages.title)"
+		:description="formatMessage(messages.description)"
+	>
+		<SettingsRow>
+			<template #label>{{ formatMessage(messages.shareProvider) }}</template>
+			<template #description>{{ formatMessage(messages.shareProviderDescription) }}</template>
+			<template #control>
+				<Combobox
+					id="log-share-provider"
+					:model-value="settings.share_provider"
+					:options="shareProviderOptions"
+					:disabled="saving"
+					@update:model-value="selectShareProvider($event)"
+				/>
+			</template>
+		</SettingsRow>
+		<SettingsRow>
+			<template #label>{{ formatMessage(messages.aiSource) }}</template>
+			<template #description>{{ formatMessage(messages.aiSourceDescription) }}</template>
+			<template #control>
+				<Combobox
+					id="log-share-ai-source"
+					:model-value="aiSettings.ai_source"
+					:options="aiSourceOptions"
+					:disabled="saving"
+					@update:model-value="selectAiSource($event)"
+				/>
+			</template>
+		</SettingsRow>
+		<template v-if="isCustom">
+			<SettingsRow>
+				<template #label>{{ formatMessage(messages.enabled) }}</template>
+				<template #description>{{ formatMessage(messages.enabledDescription) }}</template>
+				<template #control>
+					<Toggle
+						id="crash-analysis-ai-enabled"
+						:model-value="aiSettings.enabled"
+						:disabled="saving || !aiState.settings.enabled || !providers.length"
+						@update:model-value="updateEnabled(!!$event)"
+					/>
+				</template>
+			</SettingsRow>
+			<template v-if="providers.length">
+				<SettingsRow>
+					<template #label>{{ formatMessage(messages.provider) }}</template>
+					<template #control>
+						<Combobox
+							id="crash-analysis-ai-provider"
+							:model-value="aiSettings.provider_id"
+							:options="providerOptions"
+							:disabled="saving"
+							@update:model-value="updateProvider(String($event))"
+						/>
+					</template>
+				</SettingsRow>
+				<SettingsRow>
+					<template #label>{{ formatMessage(messages.model) }}</template>
+					<template #control>
+						<Combobox
+							id="crash-analysis-ai-model"
+							:model-value="aiSettings.model_id"
+							:options="modelOptions"
+							:disabled="saving || !aiSettings.provider_id"
+							@update:model-value="updateModel(String($event))"
+						/>
+					</template>
+				</SettingsRow>
+			</template>
+			<p v-else class="m-0 p-4 text-sm text-[var(--color-text-tertiary)]">
+				{{ formatMessage(messages.noProviders) }}
+			</p>
+		</template>
+		<SettingsRow>
+			<template #label>{{ formatMessage(messages.autoUpload) }}</template>
+			<template #description>{{ formatMessage(messages.autoUploadDescription) }}</template>
+			<template #control>
+				<Toggle
+					id="log-share-auto-upload"
+					:model-value="settings.auto_upload"
+					:disabled="saving || !noStorageEnabled || settings.no_storage"
+					@update:model-value="updateShare({ auto_upload: !!$event })"
+				/>
+			</template>
+		</SettingsRow>
+		<SettingsRow>
+			<template #label>{{ formatMessage(messages.multiFile) }}</template>
+			<template #description>{{ formatMessage(messages.multiFileDescription) }}</template>
+			<template #control>
+				<Toggle
+					id="log-share-multi-file"
+					:model-value="settings.multi_file"
+					:disabled="saving"
+					@update:model-value="updateShare({ multi_file: !!$event })"
+				/>
+			</template>
+		</SettingsRow>
+		<SettingsRow>
+			<template #label>{{ formatMessage(messages.noStorage) }}</template>
+			<template #description>{{ formatMessage(messages.noStorageDescription) }}</template>
+			<template #control>
+				<Toggle
+					id="log-share-no-storage"
+					:model-value="settings.no_storage"
+					:disabled="saving || !noStorageEnabled"
+					@update:model-value="updateShare({ no_storage: !!$event })"
+				/>
+			</template>
+		</SettingsRow>
+		<SettingsRow>
+			<template #label>{{ formatMessage(messages.showProgress) }}</template>
+			<template #description>{{ formatMessage(messages.showProgressDescription) }}</template>
+			<template #control>
+				<Toggle
+					id="log-share-show-progress"
+					:model-value="settings.show_progress"
+					:disabled="saving"
+					@update:model-value="updateShare({ show_progress: !!$event })"
+				/>
+			</template>
+		</SettingsRow>
+	</SettingsSection>
+</template>

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

@@ -0,0 +1,66 @@
+<script setup lang="ts">
+import { FolderOpenIcon, UploadIcon } from '@modrinth/assets'
+import { Button, defineMessages, injectNotificationManager, useVIntl } from '@modrinth/ui'
+import { ref } from 'vue'
+
+import { showLauncherLogsFolder } from '@/helpers/utils'
+
+import LogExportModal from './LogExportModal.vue'
+import SettingsRow from './SettingsRow.vue'
+import SettingsSection from './SettingsSection.vue'
+
+const { formatMessage } = useVIntl()
+const { handleError } = injectNotificationManager()
+
+const exportModal = ref<InstanceType<typeof LogExportModal>>()
+
+const messages = defineMessages({
+	exportTitle: { id: 'app.settings.logs.export.title', defaultMessage: 'Export logs' },
+	exportDescription: {
+		id: 'app.settings.logs.export.description',
+		defaultMessage:
+			'Package launcher logs with an optional environment summary, instance log, and crash analysis.',
+	},
+	exportButton: { id: 'app.settings.logs.export.button', defaultMessage: 'Export logs…' },
+	openFolder: { id: 'app.settings.logs.open-folder', defaultMessage: 'Open logs folder' },
+})
+
+async function openLogsFolder() {
+	try {
+		await showLauncherLogsFolder()
+	} catch (error) {
+		handleError(error)
+	}
+}
+</script>
+
+<template>
+	<div class="flex flex-col gap-6">
+		<SettingsSection
+			:title="formatMessage(messages.exportTitle)"
+			:description="formatMessage(messages.exportDescription)"
+			title-id="settings-target-logs-export"
+		>
+			<SettingsRow stacked>
+				<template #label>
+					<span>{{ formatMessage(messages.exportTitle) }}</span>
+				</template>
+				<template #description>{{ formatMessage(messages.exportDescription) }}</template>
+				<template #control>
+					<div class="flex flex-wrap gap-2">
+						<Button type="colored" color="brand" @click="exportModal?.show()"
+							><UploadIcon />
+							{{ formatMessage(messages.exportButton) }}
+						</Button>
+						<Button @click="openLogsFolder"
+							><FolderOpenIcon />
+							{{ formatMessage(messages.openFolder) }}
+						</Button>
+					</div>
+				</template>
+			</SettingsRow>
+		</SettingsSection>
+
+		<LogExportModal ref="exportModal" />
+	</div>
+</template>

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

@@ -0,0 +1,129 @@
+<script setup lang="ts">
+import { Button, defineMessages, injectNotificationManager, useVIntl } from '@modrinth/ui'
+import { onMounted, ref } from 'vue'
+
+import { delete_shared_log, list_shared_logs } from '@/helpers/logs'
+
+import SettingsRow from './SettingsRow.vue'
+import SettingsSection from './SettingsSection.vue'
+
+type SharedLog = {
+	id: string
+	url: string
+	raw: string
+	token: string
+	provider: string
+	instance_id: string | null
+	instance_name: string | null
+	truncated: boolean
+	created_at: number
+}
+
+const { formatMessage } = useVIntl()
+const { addNotification, handleError } = injectNotificationManager()
+const logs = ref<SharedLog[]>([])
+const loading = ref(true)
+const deletingId = ref<string | null>(null)
+
+const messages = defineMessages({
+	title: { id: 'app.log-share.shared-logs.title', defaultMessage: 'Shared logs' },
+	description: {
+		id: 'app.log-share.shared-logs.description',
+		defaultMessage:
+			'Every diagnostic you have shared is listed here. Delete an entry to remove it from your history and request its removal from the sharing service.',
+	},
+	empty: { id: 'app.log-share.shared-logs.empty', defaultMessage: 'No shared logs yet.' },
+	delete: { id: 'app.log-share.shared-logs.delete', defaultMessage: 'Delete' },
+	deleting: { id: 'app.log-share.shared-logs.deleting', defaultMessage: 'Deleting…' },
+	deleted: {
+		id: 'app.log-share.shared-logs.deleted',
+		defaultMessage: 'Shared log removed.',
+	},
+	deleteFailed: {
+		id: 'app.log-share.shared-logs.delete-failed',
+		defaultMessage: 'Failed to delete the shared log.',
+	},
+	truncated: { id: 'app.log-share.shared-logs.truncated', defaultMessage: 'Truncated' },
+})
+
+async function refresh(): Promise<void> {
+	try {
+		logs.value = await list_shared_logs()
+	} catch (error) {
+		handleError(error)
+	} finally {
+		loading.value = false
+	}
+}
+
+async function remove(log: SharedLog): Promise<void> {
+	if (deletingId.value) return
+	deletingId.value = log.id
+	try {
+		await delete_shared_log(log.id, log.token)
+		logs.value = logs.value.filter((item) => item.id !== log.id)
+		addNotification({ title: formatMessage(messages.deleted), type: 'success' })
+	} catch (error) {
+		handleError(error)
+		addNotification({ title: formatMessage(messages.deleteFailed), type: 'error' })
+	} finally {
+		deletingId.value = null
+	}
+}
+
+function formatDate(timestamp: number): string {
+	return new Date(timestamp * 1000).toLocaleString()
+}
+
+onMounted(refresh)
+</script>
+
+<template>
+	<SettingsSection
+		id="settings-target-shared-logs"
+		:title="formatMessage(messages.title)"
+		:description="formatMessage(messages.description)"
+	>
+		<SettingsRow stacked>
+			<template #control>
+				<div class="flex w-full min-w-0 flex-col gap-2">
+					<p v-if="loading" class="m-0 p-2 text-sm text-[var(--color-text-tertiary)]">…</p>
+					<p v-else-if="!logs.length" class="m-0 p-2 text-sm text-[var(--color-text-tertiary)]">
+						{{ formatMessage(messages.empty) }}
+					</p>
+					<ul v-else class="m-0 flex max-h-72 list-none flex-col gap-1 overflow-y-auto p-2">
+						<li
+							v-for="log in logs"
+							:key="log.id"
+							class="flex items-center gap-3 rounded-lg bg-surface-2 px-3 py-2"
+						>
+							<a
+								:href="log.url || `https://logshare.cn/${log.id}`"
+								target="_blank"
+								rel="noopener noreferrer"
+								class="min-w-0 flex-1 truncate text-[var(--color-text-default)] underline"
+							>
+								{{ log.url || log.id }}
+							</a>
+							<span class="shrink-0 text-xs text-[var(--color-text-tertiary)]">
+								{{ log.provider }}
+								<template v-if="log.truncated">
+									· {{ formatMessage(messages.truncated) }}
+								</template>
+								<template v-if="log.instance_name"> · {{ log.instance_name }} </template>
+								· {{ formatDate(log.created_at) }}
+							</span>
+							<Button type="outlined" :disabled="deletingId === log.id" @click="remove(log)"
+								>{{
+									deletingId === log.id
+										? formatMessage(messages.deleting)
+										: formatMessage(messages.delete)
+								}}
+							</Button>
+						</li>
+					</ul>
+				</div>
+			</template>
+		</SettingsRow>
+	</SettingsSection>
+</template>

apps/app-frontend/src/components/ui/settings/instances/SyncSourceModal.vue

@@ -0,0 +1,181 @@
+<script setup lang="ts">
+import { RefreshCwIcon, SearchIcon, SpinnerIcon, XIcon } from '@modrinth/assets'
+import {
+	Avatar,
+	Button,
+	CheckCircleButton,
+	commonMessages,
+	defineMessages,
+	NewModal,
+	StyledInput,
+	useVIntl,
+} from '@modrinth/ui'
+import { computed, ref, useTemplateRef } from 'vue'
+
+import { getInstanceIconUrl } from '@/helpers/instance'
+
+const props = defineProps<{
+	title: string
+	description: string
+	sources: {
+		id: string
+		name: string
+		icon_path?: string | null
+		eligible: boolean
+	}[]
+	loading?: boolean
+	pending?: boolean
+	error?: boolean
+}>()
+
+const emit = defineEmits<{
+	confirm: []
+	close: []
+	retry: []
+}>()
+
+const selectedInstanceId = defineModel<string>({ required: true })
+const modal = useTemplateRef<InstanceType<typeof NewModal>>('modal')
+const search = ref('')
+const { formatMessage } = useVIntl()
+
+const messages = defineMessages({
+	ineligible: {
+		id: 'app.settings.synced-options.choose-sync-source.ineligible',
+		defaultMessage: 'You cannot choose this instance as a sync source',
+	},
+	search: {
+		id: 'app.settings.synced-options.choose-sync-source.search-placeholder',
+		defaultMessage: 'Search instance',
+	},
+	empty: {
+		id: 'app.settings.synced-options.choose-sync-source.no-instances-found',
+		defaultMessage: 'No instances found',
+	},
+	sync: {
+		id: 'app.settings.synced-options.choose-sync-source.sync',
+		defaultMessage: 'Sync',
+	},
+	loadError: {
+		id: 'app.settings.synced-options.choose-sync-source.load-error',
+		defaultMessage: 'Could not load sync sources. Please try again.',
+	},
+	retry: {
+		id: 'app.settings.synced-options.choose-sync-source.retry',
+		defaultMessage: 'Try again',
+	},
+})
+
+const filteredSources = computed(() => {
+	const query = search.value.trim().toLocaleLowerCase()
+	return props.sources.filter((source) => source.name.toLocaleLowerCase().includes(query))
+})
+const canConfirm = computed(
+	() =>
+		!props.loading &&
+		!props.pending &&
+		!props.error &&
+		props.sources.some((source) => source.id === selectedInstanceId.value && source.eligible),
+)
+
+function show() {
+	search.value = ''
+	modal.value?.show()
+}
+
+function hide() {
+	return modal.value?.hide()
+}
+
+defineExpose({ show, hide })
+</script>
+
+<template>
+	<NewModal
+		ref="modal"
+		:header="title"
+		no-padding
+		actions-divider
+		max-width="560px"
+		width="560px"
+		:disable-close="pending"
+		:on-after-hide="() => emit('close')"
+	>
+		<p
+			class="m-0 border-0 border-b border-solid border-surface-5 p-6 text-[var(--color-text-default)]"
+		>
+			{{ description }}
+		</p>
+
+		<div class="flex h-[400px] flex-col gap-3 overflow-y-auto bg-surface-2 px-6 py-4">
+			<StyledInput
+				v-model="search"
+				:icon="SearchIcon"
+				type="search"
+				autocomplete="off"
+				:placeholder="formatMessage(messages.search)"
+				:aria-label="formatMessage(messages.search)"
+				class="shrink-0"
+			/>
+
+			<div v-if="loading" class="flex flex-1 items-center justify-center" aria-busy="true">
+				<SpinnerIcon class="size-5 animate-spin text-[var(--color-text-tertiary)]" />
+			</div>
+			<div v-else-if="error" class="flex flex-1 flex-col items-center justify-center gap-3">
+				<p role="alert" class="m-0 text-center text-[var(--color-text-default)]">
+					{{ formatMessage(messages.loadError) }}
+				</p>
+				<Button @click="emit('retry')">{{ formatMessage(messages.retry) }}</Button>
+			</div>
+			<div
+				v-else-if="filteredSources.length === 0"
+				class="flex flex-1 items-center justify-center text-[var(--color-text-tertiary)]"
+			>
+				{{ formatMessage(messages.empty) }}
+			</div>
+			<div v-else role="radiogroup" :aria-label="title" class="flex flex-col gap-1">
+				<div
+					v-for="source in filteredSources"
+					:key="source.id"
+					v-tooltip="!source.eligible ? formatMessage(messages.ineligible) : undefined"
+				>
+					<CheckCircleButton
+						:checked="selectedInstanceId === source.id"
+						:disabled="pending || !source.eligible"
+						class="min-h-10"
+						@click="selectedInstanceId = source.id"
+					>
+						<span class="size-5 shrink-0 overflow-hidden rounded-[6px]">
+							<Avatar
+								:src="getInstanceIconUrl(source.icon_path)"
+								:alt="source.name"
+								:tint-by="source.id"
+								size="1.25rem"
+								no-shadow
+							/>
+						</span>
+						<span class="min-w-0 flex-1 truncate">{{ source.name }}</span>
+					</CheckCircleButton>
+				</div>
+			</div>
+		</div>
+		<template #actions>
+			<div class="flex justify-end gap-2 p-2">
+				<Button type="outlined" :disabled="pending" @click="hide">
+					<XIcon aria-hidden="true" />
+					{{ formatMessage(commonMessages.cancelButton) }}
+				</Button>
+				<Button
+					type="colored"
+					color="brand"
+					:disabled="!canConfirm"
+					:loading="pending"
+					@click="canConfirm && emit('confirm')"
+				>
+					<RefreshCwIcon :class="{ 'animate-spin': pending }" aria-hidden="true" />
+					{{ formatMessage(messages.sync) }}
+				</Button>
+			</div>
+		</template>
+	</NewModal>
+</template>

apps/app-frontend/src/components/ui/settings/instances/SyncedPacksModal.vue

@@ -0,0 +1,81 @@
+<script setup lang="ts">
+import { Button, defineMessages, NewModal, useVIntl } from '@modrinth/ui'
+import { useMutation, useQuery, useQueryClient } from '@tanstack/vue-query'
+import { computed, ref } from 'vue'
+
+import {
+	remove_synced_pack,
+	set_synced_pack_enabled,
+	syncedPackKeys,
+	syncedPackQueryOptions,
+	type SyncedPackType,
+} from '@/helpers/synced-packs'
+
+const modal = ref<InstanceType<typeof NewModal>>()
+const type = ref<SyncedPackType>('resourcepack')
+const queryClient = useQueryClient()
+const { formatMessage } = useVIntl()
+const messages = defineMessages({
+	resourcePacks: {
+		id: 'app.settings.synced-packs.resource-packs',
+		defaultMessage: 'Resource packs',
+	},
+	dataPacks: { id: 'app.settings.synced-packs.data-packs', defaultMessage: 'Data packs' },
+	enable: { id: 'app.settings.synced-packs.enable', defaultMessage: 'Enable' },
+	disable: { id: 'app.settings.synced-packs.disable', defaultMessage: 'Disable' },
+	remove: { id: 'app.settings.synced-packs.remove', defaultMessage: 'Remove' },
+	empty: { id: 'app.settings.synced-packs.empty', defaultMessage: 'No synced packs' },
+})
+const query = useQuery(computed(() => syncedPackQueryOptions(type.value)))
+const packs = computed(() => query.value.data.value ?? [])
+const mutation = useMutation({
+	mutationFn: async (request: { id: string; enabled?: boolean; remove?: boolean }) => {
+		if (request.remove) await remove_synced_pack(request.id)
+		else await set_synced_pack_enabled(request.id, request.enabled ?? true)
+	},
+	onSuccess: () => queryClient.invalidateQueries({ queryKey: syncedPackKeys.all }),
+})
+
+async function show(nextType: SyncedPackType) {
+	type.value = nextType
+	modal.value?.show()
+	await queryClient.invalidateQueries({ queryKey: syncedPackKeys.list(nextType) })
+}
+
+function hide() {
+	modal.value?.hide()
+}
+
+defineExpose({ show, hide })
+</script>
+
+<template>
+	<NewModal
+		ref="modal"
+		:header="formatMessage(type === 'resourcepack' ? messages.resourcePacks : messages.dataPacks)"
+		max-width="42rem"
+	>
+		<div v-if="packs.length" class="flex flex-col gap-2">
+			<div
+				v-for="pack in packs"
+				:key="pack.id"
+				class="flex items-center gap-3 border-b border-solid border-surface-4 py-2"
+			>
+				<span class="min-w-0 flex-1 truncate">{{ pack.file_name }}</span>
+				<Button
+					:disabled="mutation.isPending.value"
+					@click="mutation.mutate({ id: pack.id, enabled: !pack.enabled })"
+					>{{ formatMessage(pack.enabled ? messages.disable : messages.enable) }}
+				</Button>
+				<Button
+					type="colored"
+					color="red"
+					:disabled="mutation.isPending.value"
+					@click="mutation.mutate({ id: pack.id, remove: true })"
+					>{{ formatMessage(messages.remove) }}
+				</Button>
+			</div>
+		</div>
+		<p v-else class="m-0 text-[var(--color-text-tertiary)]">{{ formatMessage(messages.empty) }}</p>
+	</NewModal>
+</template>

apps/app-frontend/src/components/ui/settings/instances/command-history-modal.vue

@@ -0,0 +1,93 @@
+<script setup lang="ts">
+import { SaveIcon, XIcon } from '@modrinth/assets'
+import {
+	Button,
+	commonMessages,
+	defineMessages,
+	injectNotificationManager,
+	NewModal,
+	useVIntl,
+} from '@modrinth/ui'
+import { useMutation, useQuery, useQueryClient } from '@tanstack/vue-query'
+import { nextTick, ref } from 'vue'
+
+import StudioEditor from '@/components/instance/studio/StudioEditor.vue'
+import { set_command_history } from '@/helpers/instance'
+import { commandHistoryQueryOptions, syncedOptionsKeys } from '@/helpers/synced-options'
+
+const { formatMessage } = useVIntl()
+const { handleError } = injectNotificationManager()
+const queryClient = useQueryClient()
+const modal = ref<InstanceType<typeof NewModal> | null>(null)
+const commandHistory = ref('')
+const historyQuery = useQuery({ ...commandHistoryQueryOptions(), enabled: false })
+const saveMutation = useMutation({
+	mutationFn: set_command_history,
+	onSuccess: (history) => {
+		queryClient.setQueryData(syncedOptionsKeys.commandHistory, history)
+	},
+	onError: handleError,
+})
+
+const messages = defineMessages({
+	commandHistoryEditorTitle: {
+		id: 'app.settings.synced-options.command-history.editor-title',
+		defaultMessage: 'Edit command history',
+	},
+})
+
+async function show() {
+	const result = await historyQuery.refetch()
+	if (result.isError) {
+		handleError(result.error)
+		return
+	}
+	if (!result.isSuccess) return
+	commandHistory.value = result.data
+	modal.value?.show()
+}
+
+async function saveCommandHistory() {
+	if (saveMutation.isPending.value) return
+	try {
+		await saveMutation.mutateAsync(commandHistory.value)
+		await nextTick()
+		modal.value?.hide()
+	} catch {
+		return
+	}
+}
+
+defineExpose({ show })
+</script>
+
+<template>
+	<NewModal
+		ref="modal"
+		:header="formatMessage(messages.commandHistoryEditorTitle)"
+		:disable-close="saveMutation.isPending.value"
+		no-padding
+		actions-divider
+		max-width="700px"
+		width="700px"
+	>
+		<StudioEditor
+			v-model:content="commandHistory"
+			file-path="command_history.txt"
+			language="plaintext"
+			class="h-[420px] text-sm"
+		/>
+		<template #actions>
+			<div class="flex justify-end gap-2">
+				<Button type="outlined" @click="modal?.hide()">
+					<XIcon aria-hidden="true" />
+					{{ formatMessage(commonMessages.cancelButton) }}
+				</Button>
+				<Button type="colored" :loading="saveMutation.isPending.value" @click="saveCommandHistory">
+					<SaveIcon aria-hidden="true" />
+					{{ formatMessage(commonMessages.saveButton) }}
+				</Button>
+			</div>
+		</template>
+	</NewModal>
+</template>

apps/app-frontend/src/components/ui/settings/instances/game-settings-modal/boolean-control.vue

@@ -0,0 +1,62 @@
+<script setup lang="ts">
+import { Button } from '@modrinth/ui'
+
+defineProps<{
+	modelValue?: boolean
+	disabled?: boolean
+	label: string
+	onLabel: string
+	offLabel: string
+	placeholder?: string
+}>()
+
+const emit = defineEmits<{
+	'update:model-value': [value: boolean]
+}>()
+</script>
+
+<template>
+	<div
+		v-tooltip="modelValue === undefined ? placeholder : undefined"
+		role="group"
+		:aria-label="label"
+		class="inline-flex h-9 items-center gap-0.5 rounded-xl border border-solid border-surface-5 p-px shadow-[0_1px_3px_rgba(0,0,0,0.15)]"
+		:class="{ 'opacity-50': disabled }"
+	>
+		<Button
+			type="quiet"
+			size="sm"
+			:interaction="modelValue === true ? 'none' : 'surface'"
+			class="boolean-control-on !rounded-[10px] !px-3 !font-medium disabled:!opacity-100"
+			:class="modelValue === true ? '!text-green' : '!text-[var(--color-text-primary)]'"
+			:aria-pressed="modelValue === true"
+			:disabled="disabled"
+			@click="emit('update:model-value', true)"
+		>
+			{{ onLabel }}
+		</Button>
+		<Button
+			type="quiet"
+			size="sm"
+			:interaction="modelValue === false ? 'none' : 'surface'"
+			class="boolean-control-off !rounded-[10px] !px-3 !font-medium !text-[var(--color-text-primary)] disabled:!opacity-100"
+			:aria-pressed="modelValue === false"
+			:disabled="disabled"
+			@click="emit('update:model-value', false)"
+		>
+			{{ offLabel }}
+		</Button>
+	</div>
+</template>
+
+<style scoped>
+.boolean-control-on[aria-pressed='true'] {
+	background-color: color-mix(in srgb, var(--color-green) 30%, var(--surface-3));
+	box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--color-green) 60%, transparent);
+}
+
+.boolean-control-off[aria-pressed='true'] {
+	background-color: var(--surface-4);
+	box-shadow: inset 0 0 0 1px var(--surface-5);
+}
+</style>

apps/app-frontend/src/components/ui/settings/instances/game-settings-modal/editors.ts

@@ -0,0 +1,163 @@
+import { toRaw } from 'vue'
+
+import type {
+	EditableGameSetting,
+	GameOptionCanonicalValue,
+	GameSettingChange,
+	GameSettingsEditorState,
+} from '@/helpers/game-options'
+
+function clonePlainValue(value: unknown): unknown {
+	if (Array.isArray(value)) {
+		return toRaw(value).map(clonePlainValue)
+	}
+	if (value !== null && typeof value === 'object') {
+		return Object.fromEntries(
+			Object.entries(toRaw(value)).map(([key, nestedValue]) => [key, clonePlainValue(nestedValue)]),
+		)
+	}
+	return value
+}
+
+export function cloneGameSettingsState(state: GameSettingsEditorState): GameSettingsEditorState {
+	return clonePlainValue(state) as GameSettingsEditorState
+}
+
+export function canonicalValuesEqual(
+	left: GameOptionCanonicalValue | null | undefined,
+	right: GameOptionCanonicalValue | null | undefined,
+): boolean {
+	return JSON.stringify(left ?? null) === JSON.stringify(right ?? null)
+}
+
+export function gameSettingChanges(
+	base: GameSettingsEditorState | null,
+	draft: GameSettingsEditorState | null,
+	forcedValueOptionIds: ReadonlySet<string> = new Set(),
+): GameSettingChange[] {
+	if (!base || !draft) return []
+
+	const baseSettings = new Map(base.settings.map((setting) => [setting.option_id, setting]))
+	return draft.settings.flatMap((setting) => {
+		const previous = baseSettings.get(setting.option_id)
+		if (!previous) return []
+
+		const syncChanged = previous.sync_enabled !== setting.sync_enabled
+		const valueChanged = !canonicalValuesEqual(previous.canonical_value, setting.canonical_value)
+		const promoteLocalValue =
+			forcedValueOptionIds.has(setting.option_id) &&
+			previous.value_state !== 'canonical' &&
+			setting.canonical_value !== null &&
+			setting.canonical_value !== undefined
+		if (!syncChanged && !valueChanged && !promoteLocalValue) return []
+
+		return [
+			{
+				option_id: setting.option_id,
+				base_option_revision: previous.option_revision,
+				...(syncChanged ? { sync_enabled: setting.sync_enabled } : {}),
+				...(valueChanged || promoteLocalValue
+					? { canonical_value: setting.canonical_value ?? null }
+					: {}),
+			},
+		]
+	})
+}
+
+export function gameSettingNumberScale(setting: EditableGameSetting): number {
+	if (setting.editor.unit !== 'percent') return 1
+	return setting.option_id === 'sensitivity' ? 200 : 100
+}
+
+export function canonicalValueText(setting: EditableGameSetting): string {
+	const value = setting.canonical_value
+	if (!value) return ''
+
+	switch (value.type) {
+		case 'bool':
+			return value.value ? 'true' : 'false'
+		case 'integer':
+		case 'decimal':
+			return setting.editor.unit === 'percent'
+				? String(Number((Number(value.value) * gameSettingNumberScale(setting)).toFixed(8)))
+				: String(value.value)
+		case 'string_list':
+			return value.value.join(', ')
+		default:
+			return value.value
+	}
+}
+
+export function canonicalBooleanValue(setting: EditableGameSetting): boolean | undefined {
+	return setting.canonical_value?.type === 'bool' ? setting.canonical_value.value : undefined
+}
+
+export function isKeybindSetting(setting: EditableGameSetting): boolean {
+	return (
+		setting.editor.type === 'key_binding' ||
+		(setting.editor.type === 'external_raw' && !!setting.raw_key?.startsWith('key_'))
+	)
+}
+
+export function canonicalValueFromInput(
+	setting: EditableGameSetting,
+	value: string | number | boolean | undefined,
+): GameOptionCanonicalValue | null {
+	if (value === undefined || value === '') return null
+
+	switch (setting.editor.type) {
+		case 'bool':
+			return { type: 'bool', value: Boolean(value) }
+		case 'integer': {
+			const parsed = Number(value)
+			return Number.isSafeInteger(parsed) ? { type: 'integer', value: parsed } : null
+		}
+		case 'decimal': {
+			const parsed = Number(value)
+			if (!Number.isFinite(parsed)) return null
+			return {
+				type: 'decimal',
+				value:
+					setting.editor.unit === 'percent'
+						? String(Number((parsed / gameSettingNumberScale(setting)).toFixed(8)))
+						: String(value),
+			}
+		}
+		case 'enum':
+			return { type: 'enum', value: String(value) }
+		case 'string_list':
+			return {
+				type: 'string_list',
+				value: String(value)
+					.split(',')
+					.map((item) => item.trim())
+					.filter(Boolean),
+			}
+		case 'key_binding':
+			return { type: 'key_binding', value: String(value) }
+		case 'external_raw':
+			return { type: 'external_raw', value: String(value) }
+		default:
+			return { type: 'text', value: String(value) }
+	}
+}
+
+export function settingSearchText(
+	setting: EditableGameSetting,
+	label: string,
+	description: string,
+): string {
+	return [label, description, setting.option_id, setting.raw_key]
+		.filter(Boolean)
+		.join(' ')
+		.toLocaleLowerCase()
+}
+
+export function settingCanBeEnabled(setting: EditableGameSetting): boolean {
+	return (
+		!setting.controlled &&
+		!setting.validation_error &&
+		!['mixed', 'unset', 'invalid'].includes(setting.value_state) &&
+		(setting.compatibility.total_participating === 0 || setting.compatibility.will_receive > 0)
+	)
+}

apps/app-frontend/src/components/ui/settings/instances/game-settings-modal/index.vue

@@ -0,0 +1,483 @@
+<script setup lang="ts">
+import {
+	EyeIcon,
+	LanguagesIcon,
+	LinkIcon,
+	MessageIcon,
+	MonitorIcon,
+	RefreshCwIcon,
+	SaveIcon,
+	SearchIcon,
+	SettingsIcon,
+	ShirtIcon,
+	TagCategoryAudioIcon,
+	TagCategoryGamepad2Icon,
+	UnlinkIcon,
+	WrenchIcon,
+	XIcon,
+} from '@modrinth/assets'
+import {
+	Button,
+	commonMessages,
+	defineMessages,
+	FloatingActionBar,
+	StyledInput,
+	TabbedModal,
+	type TabbedModalTab,
+	useVIntl,
+} from '@modrinth/ui'
+import type { Component } from 'vue'
+import { computed, inject, ref, watch } from 'vue'
+import { type RouteLocationRaw, useRouter } from 'vue-router'
+
+import type { EditableGameSetting, GameSettingCategory } from '@/helpers/game-options'
+import { injectInstanceSettings } from '@/pages/instance/components/settings-modal/instance-settings-context'
+import { appSettingsModalContextKey } from '@/providers/app-settings-modal'
+
+import {
+	canonicalValueText,
+	isKeybindSetting,
+	settingCanBeEnabled,
+	settingSearchText,
+} from './editors'
+import { minecraftKeybindConflictKey } from './keybinds'
+import {
+	formatGameSettingDescription,
+	formatGameSettingLabel,
+	gameSettingCategoryMessage,
+} from './messages'
+import GameSettingRow from './row.vue'
+import { useGameSettingsEditor } from './use-editor'
+import { useGameSettingLabels } from './use-labels'
+
+const props = defineProps<{
+	instanceId?: string
+}>()
+
+const emit = defineEmits<{
+	saved: []
+}>()
+
+const { formatMessage } = useVIntl()
+const router = useRouter()
+const appSettingsModal = inject(appSettingsModalContextKey, null)
+const instanceSettings = injectInstanceSettings(null)
+
+const messages = defineMessages({
+	title: {
+		id: 'app.settings.synced-options.game-settings.title',
+		defaultMessage: 'Game settings',
+	},
+	syncTitle: {
+		id: 'app.settings.synced-options.game-settings.sync-title',
+		defaultMessage: 'Sync game settings',
+	},
+	syncedOptionsDescription: {
+		id: 'app.settings.synced-options.game-settings.sync-description',
+		defaultMessage:
+			'Synced options are applied to every instance and override the values included with a modpack.',
+	},
+	search: {
+		id: 'app.settings.synced-options.game-settings.search',
+		defaultMessage: 'Search settings...',
+	},
+	enableAll: {
+		id: 'app.settings.synced-options.game-settings.enable-all',
+		defaultMessage: 'Sync all',
+	},
+	disableAll: {
+		id: 'app.settings.synced-options.game-settings.disable-all',
+		defaultMessage: 'Unsync all',
+	},
+	customEmpty: {
+		id: 'app.settings.synced-options.game-settings.custom-empty',
+		defaultMessage:
+			'Settings added by mods will appear here after Modrinth finds them in one of your instances.',
+	},
+	empty: {
+		id: 'app.settings.synced-options.game-settings.empty',
+		defaultMessage: 'No settings match your search or filter.',
+	},
+	loading: {
+		id: 'app.settings.synced-options.game-settings.loading',
+		defaultMessage: 'Loading settings...',
+	},
+	loadFailed: {
+		id: 'app.settings.synced-options.game-settings.load-failed',
+		defaultMessage: 'We couldn’t load your game settings.',
+	},
+	retry: {
+		id: 'app.settings.synced-options.game-settings.retry',
+		defaultMessage: 'Retry',
+	},
+	saveSettings: {
+		id: 'app.settings.synced-options.game-settings.save',
+		defaultMessage: 'Save settings',
+	},
+	unsavedChanges: {
+		id: 'app.settings.synced-options.game-settings.unsaved-changes',
+		defaultMessage: 'You have unsaved changes.',
+	},
+})
+
+const modal = ref<InstanceType<typeof TabbedModal> | null>(null)
+const activeCategoryId = ref('')
+const search = ref('')
+const opened = ref(false)
+let allowClose = false
+
+const {
+	draftState,
+	isLocalEditor,
+	isDirty,
+	hasBlockingDraft,
+	loading,
+	loadError,
+	saving,
+	load,
+	reset: resetEditor,
+	cancelChanges,
+	setSyncEnabled,
+	setCanonicalValue,
+	save,
+	saveAndWait,
+} = useGameSettingsEditor(
+	() => props.instanceId,
+	() => emit('saved'),
+)
+
+const categoryIcons: Record<string, Component> = {
+	skin_customization: ShirtIcon,
+	video: MonitorIcon,
+	video_settings: MonitorIcon,
+	language: LanguagesIcon,
+	music_and_sound: TagCategoryAudioIcon,
+	controls: TagCategoryGamepad2Icon,
+	chat: MessageIcon,
+	chat_settings: MessageIcon,
+	accessibility: EyeIcon,
+	custom: WrenchIcon,
+	custom_settings: WrenchIcon,
+}
+
+const localeLabels = useGameSettingLabels(
+	opened,
+	() => props.instanceId,
+	() => draftState.value?.settings ?? [],
+)
+
+function settingLabel(setting: EditableGameSetting) {
+	if (setting.kind === 'external') {
+		return (
+			localeLabels.value[setting.option_id]?.label ?? formatGameSettingLabel(formatMessage, setting)
+		)
+	}
+	return formatGameSettingLabel(formatMessage, setting)
+}
+
+const categories = computed<GameSettingCategory[]>(() => {
+	if (!draftState.value) return []
+
+	const settings = draftState.value.settings
+	const visible = draftState.value.categories.filter(
+		(category) =>
+			category.is_custom || settings.some((setting) => setting.category_id === category.id),
+	)
+	if (!visible.some((category) => category.is_custom || category.id === 'custom_settings')) {
+		visible.push({
+			id: 'custom_settings',
+			is_custom: true,
+		})
+	}
+	return visible
+})
+
+const categoryTabs = computed<TabbedModalTab[]>(() =>
+	categories.value.map((category) => ({
+		name: gameSettingCategoryMessage(category),
+		icon: categoryIcon(category),
+	})),
+)
+
+const activeCategory = computed(() =>
+	categories.value.find((category) => category.id === activeCategoryId.value),
+)
+
+const categorySettings = computed(() => {
+	if (!draftState.value) return []
+
+	const query = search.value.trim().toLocaleLowerCase()
+	return draftState.value.settings.filter((setting) => {
+		if (!query && setting.category_id !== activeCategoryId.value) return false
+		if (
+			query &&
+			!settingSearchText(
+				setting,
+				settingLabel(setting),
+				setting.kind === 'external'
+					? (localeLabels.value[setting.option_id]?.source?.project?.title ??
+							localeLabels.value[setting.option_id]?.source?.file_name ??
+							'')
+					: formatGameSettingDescription(formatMessage, setting),
+			).includes(query)
+		)
+			return false
+		return true
+	})
+})
+
+const keybindConflicts = computed(() => {
+	if (!draftState.value) return new Map<string, string[]>()
+
+	const bindings = new Map<string, EditableGameSetting[]>()
+	for (const setting of draftState.value.settings) {
+		if (!isKeybindSetting(setting)) continue
+		const key = minecraftKeybindConflictKey(setting.option_id, canonicalValueText(setting))
+		if (!key) continue
+		bindings.set(key, [...(bindings.get(key) ?? []), setting])
+	}
+
+	const conflicts = new Map<string, string[]>()
+	for (const settings of bindings.values()) {
+		if (settings.length < 2) continue
+		for (const setting of settings) {
+			conflicts.set(
+				setting.option_id,
+				settings
+					.filter((candidate) => candidate.option_id !== setting.option_id)
+					.map((candidate) => settingLabel(candidate)),
+			)
+		}
+	}
+	return conflicts
+})
+
+const enableCandidates = computed(() =>
+	categorySettings.value.filter((setting) => !setting.sync_enabled && settingCanBeEnabled(setting)),
+)
+const disableCandidates = computed(() =>
+	categorySettings.value.filter((setting) => setting.sync_enabled && !setting.controlled),
+)
+const toggleableCategorySettings = computed(() =>
+	categorySettings.value.filter((setting) => !setting.controlled),
+)
+const allCategorySettingsSynced = computed(
+	() =>
+		toggleableCategorySettings.value.length > 0 &&
+		toggleableCategorySettings.value.every((setting) => setting.sync_enabled),
+)
+const modalTitle = computed(() =>
+	formatMessage(isLocalEditor.value ? messages.title : messages.syncTitle),
+)
+
+function categoryIcon(category: GameSettingCategory): Component {
+	return categoryIcons[category.id] ?? SettingsIcon
+}
+
+function changeCategory(_fromIndex: number, toIndex: number): boolean {
+	const category = categories.value[toIndex]
+	if (!category) return false
+	activeCategoryId.value = category.id
+	search.value = ''
+	return true
+}
+
+watch(
+	categories,
+	() => {
+		if (!categories.value.some((category) => category.id === activeCategoryId.value)) {
+			activeCategoryId.value = categories.value[0]?.id ?? 'custom_settings'
+		}
+		const index = categories.value.findIndex((category) => category.id === activeCategoryId.value)
+		if (index >= 0) modal.value?.setTab(index)
+	},
+	{ flush: 'sync' },
+)
+
+function show() {
+	opened.value = true
+	allowClose = false
+	search.value = ''
+	void load()
+	modal.value?.show()
+}
+
+function hide() {
+	modal.value?.hide()
+}
+
+function reset() {
+	opened.value = false
+	resetEditor()
+	allowClose = false
+}
+
+function beforeHide(): boolean {
+	if (allowClose || !isDirty.value) return true
+	void saveBeforeClose()
+	return false
+}
+
+async function saveBeforeClose() {
+	const saved = await saveAndWait()
+	if (!saved) return
+	allowClose = true
+	modal.value?.hide()
+}
+
+async function openSource(location: RouteLocationRaw) {
+	if (isDirty.value || saving.value) return
+	if (appSettingsModal && !appSettingsModal.close()) return
+	allowClose = true
+	modal.value?.hide()
+	if (instanceSettings?.closeModal) {
+		instanceSettings.closeModal(() => void router.push(location))
+	} else {
+		await router.push(location)
+	}
+}
+
+function toggleVisibleSync() {
+	const enabled = !allCategorySettingsSynced.value
+	const candidates = enabled ? enableCandidates.value : disableCandidates.value
+	setSyncEnabled(
+		candidates.map((setting) => setting.option_id),
+		enabled,
+	)
+}
+
+defineExpose({ show, hide })
+</script>
+
+<template>
+	<TabbedModal
+		ref="modal"
+		:tabs="categoryTabs"
+		:header="modalTitle"
+		:before-hide="beforeHide"
+		:before-tab-change="changeCategory"
+		:hide-tab-selection="search.trim().length > 0"
+		:on-after-hide="reset"
+		:floating-action-bar-shown="isDirty"
+		max-width="min(1080px, calc(95vw - 2rem))"
+		width="min(1080px, calc(95vw - 2rem))"
+	>
+		<template #sidebar-header>
+			<div class="pb-4">
+				<StyledInput
+					v-model="search"
+					:icon="SearchIcon"
+					type="search"
+					autocomplete="off"
+					:placeholder="formatMessage(messages.search)"
+					:aria-label="formatMessage(messages.search)"
+					wrapper-class="w-full shrink-0"
+				/>
+			</div>
+		</template>
+
+		<template #content>
+			<div class="flex min-h-full min-w-0 flex-col">
+				<div
+					v-if="!isLocalEditor && (loading || loadError || categorySettings.length > 0)"
+					class="mb-4 flex shrink-0 flex-wrap items-start justify-between gap-4 border-0 border-b border-solid border-surface-4 pb-4"
+				>
+					<p class="m-0 min-w-60 flex-1 text-[var(--color-text-default)]">
+						{{ formatMessage(messages.syncedOptionsDescription) }}
+					</p>
+					<div class="ml-auto flex w-48 justify-end">
+						<Button
+							size="lg"
+							:disabled="
+								allCategorySettingsSynced
+									? disableCandidates.length === 0
+									: enableCandidates.length === 0
+							"
+							@click="toggleVisibleSync"
+						>
+							<LinkIcon v-if="allCategorySettingsSynced" aria-hidden="true" />
+							<UnlinkIcon v-else aria-hidden="true" />
+							{{
+								formatMessage(allCategorySettingsSynced ? messages.disableAll : messages.enableAll)
+							}}
+						</Button>
+					</div>
+				</div>
+
+				<div
+					v-if="loading"
+					role="status"
+					:aria-label="formatMessage(messages.loading)"
+					class="flex flex-1 flex-col gap-4"
+				>
+					<div
+						v-for="row in 5"
+						:key="row"
+						class="h-20 animate-pulse rounded-xl bg-surface-3"
+						aria-hidden="true"
+					/>
+				</div>
+				<div
+					v-else-if="loadError"
+					class="flex min-h-40 flex-1 flex-col items-center justify-center gap-3 text-[var(--color-text-tertiary)]"
+				>
+					<p class="m-0">{{ formatMessage(messages.loadFailed) }}</p>
+					<Button @click="load">
+						<RefreshCwIcon aria-hidden="true" />
+						{{ formatMessage(messages.retry) }}
+					</Button>
+				</div>
+				<div v-else class="min-h-0 flex-1">
+					<div
+						v-if="categorySettings.length === 0"
+						class="flex h-full min-h-40 items-center justify-center px-8 text-center text-[var(--color-text-tertiary)]"
+					>
+						{{
+							activeCategory?.is_custom && !search
+								? formatMessage(messages.customEmpty)
+								: formatMessage(messages.empty)
+						}}
+					</div>
+					<div v-else class="flex flex-col gap-4">
+						<GameSettingRow
+							v-for="setting in categorySettings"
+							:key="setting.option_id"
+							:setting="setting"
+							:locale-label="localeLabels[setting.option_id]"
+							:keybind-conflicts="keybindConflicts.get(setting.option_id)"
+							:show-sync-toggle="!isLocalEditor"
+							:source-navigation-disabled="isDirty || saving"
+							@open-source="openSource"
+							@update:sync-enabled="setSyncEnabled([setting.option_id], $event)"
+							@update:canonical-value="setCanonicalValue(setting.option_id, $event)"
+						/>
+					</div>
+				</div>
+			</div>
+		</template>
+
+		<template #floating-action-bar>
+			<FloatingActionBar v-if="isDirty" shown inline :aria-label="modalTitle">
+				<p class="m-0 text-sm font-semibold md:text-base">
+					{{ formatMessage(messages.unsavedChanges) }}
+				</p>
+				<div class="ml-auto flex gap-2">
+					<Button type="outlined" @click="cancelChanges">
+						<XIcon aria-hidden="true" />
+						{{ formatMessage(commonMessages.cancelButton) }}
+					</Button>
+					<Button
+						type="colored"
+						color="brand"
+						:disabled="!isDirty || loading || saving || hasBlockingDraft"
+						:loading="saving"
+						@click="save"
+					>
+						<SaveIcon aria-hidden="true" />
+						{{ formatMessage(messages.saveSettings) }}
+					</Button>
+				</div>
+			</FloatingActionBar>
+		</template>
+	</TabbedModal>
+</template>

apps/app-frontend/src/components/ui/settings/instances/game-settings-modal/keybind-input.vue

@@ -0,0 +1,235 @@
+<script setup lang="ts">
+import { TriangleAlertIcon } from '@modrinth/assets'
+import { Button, defineMessages, useVIntl } from '@modrinth/ui'
+import { computed, onBeforeUnmount, ref, useId, watch } from 'vue'
+
+import {
+	activateKeybindRecording,
+	deactivateKeybindRecording,
+	formatMinecraftKeybind,
+	minecraftKeyTokenFromKeyboardEvent,
+	minecraftMouseTokenFromButton,
+} from './keybinds'
+
+const props = withDefaults(
+	defineProps<{
+		modelValue: string
+		settingLabel: string
+		conflicts?: string[]
+		mixed?: boolean
+		disabled?: boolean
+	}>(),
+	{
+		conflicts: () => [],
+		mixed: false,
+		disabled: false,
+	},
+)
+
+const emit = defineEmits<{
+	'update:model-value': [value: string]
+}>()
+
+const { formatMessage, locale } = useVIntl()
+const statusId = useId()
+const conflictId = useId()
+const recording = ref(false)
+const statusMessage = ref('')
+const controlElement = ref<HTMLElement | null>(null)
+let suppressNextClick = false
+
+const messages = defineMessages({
+	listen: {
+		id: 'app.settings.game-options.keybind.listen',
+		defaultMessage: 'Press a key…',
+	},
+	choose: {
+		id: 'app.settings.game-options.keybind.choose',
+		defaultMessage: 'Choose a key',
+	},
+	mixed: {
+		id: 'app.settings.game-options.keybind.mixed',
+		defaultMessage: 'Different across instances',
+	},
+	change: {
+		id: 'app.settings.game-options.keybind.change',
+		defaultMessage: '{setting}: {binding}. Activate to change the binding.',
+	},
+	listeningStatus: {
+		id: 'app.settings.game-options.keybind.listening-status',
+		defaultMessage: 'Listening for a key or mouse button. Press Escape to clear this binding.',
+	},
+	recordingLabel: {
+		id: 'app.settings.game-options.keybind.recording-label',
+		defaultMessage:
+			'{setting}: listening for a key or mouse button. Press Escape to clear this binding.',
+	},
+	unsupportedStatus: {
+		id: 'app.settings.game-options.keybind.unsupported-status',
+		defaultMessage: 'That input cannot be used by Minecraft. Press another key.',
+	},
+	cancelledStatus: {
+		id: 'app.settings.game-options.keybind.cancelled-status',
+		defaultMessage: 'Key binding change cancelled.',
+	},
+	assignedStatus: {
+		id: 'app.settings.game-options.keybind.assigned-status',
+		defaultMessage: '{setting} is now bound to {binding}.',
+	},
+	conflict: {
+		id: 'app.settings.game-options.keybind.conflict-description',
+		defaultMessage: 'This is already used by {settings}.',
+	},
+})
+
+const isMac = /Mac|iPhone|iPad|iPod/.test(navigator.platform)
+const bindingLabel = computed(() => {
+	if (props.mixed) return formatMessage(messages.mixed)
+	if (!props.modelValue) return formatMessage(messages.choose)
+	return formatMinecraftKeybind(formatMessage, props.modelValue, isMac)
+})
+const visibleLabel = computed(() =>
+	recording.value ? formatMessage(messages.listen) : bindingLabel.value,
+)
+const conflictSettings = computed(() =>
+	new Intl.ListFormat(locale.value, { style: 'long', type: 'conjunction' }).format(
+		props.conflicts.map((setting) => `‘${setting}’`),
+	),
+)
+const conflictMessage = computed(() =>
+	props.conflicts.length
+		? formatMessage(messages.conflict, { settings: conflictSettings.value })
+		: '',
+)
+const accessibleLabel = computed(() =>
+	formatMessage(recording.value ? messages.recordingLabel : messages.change, {
+		setting: props.settingLabel,
+		binding: bindingLabel.value,
+	}),
+)
+
+function startRecording() {
+	if (props.disabled || recording.value) return
+	activateKeybindRecording(cancelRecording)
+	recording.value = true
+	statusMessage.value = formatMessage(messages.listeningStatus)
+	window.addEventListener('keydown', handleKeydown, true)
+	window.addEventListener('pointerdown', handlePointerDown, true)
+	window.addEventListener('blur', cancelRecording)
+}
+
+function stopRecording() {
+	recording.value = false
+	window.removeEventListener('keydown', handleKeydown, true)
+	window.removeEventListener('pointerdown', handlePointerDown, true)
+	window.removeEventListener('blur', cancelRecording)
+	deactivateKeybindRecording(cancelRecording)
+}
+
+function cancelRecording() {
+	if (!recording.value) return
+	stopRecording()
+	statusMessage.value = formatMessage(messages.cancelledStatus)
+}
+
+function assign(value: string) {
+	if (!recording.value) return
+	stopRecording()
+	emit('update:model-value', value)
+	statusMessage.value = formatMessage(messages.assignedStatus, {
+		setting: props.settingLabel,
+		binding: formatMinecraftKeybind(formatMessage, value, isMac),
+	})
+}
+
+function handleClick(event: MouseEvent) {
+	if (suppressNextClick) {
+		suppressNextClick = false
+		event.preventDefault()
+		event.stopPropagation()
+		return
+	}
+	startRecording()
+}
+
+function handleKeydown(event: KeyboardEvent) {
+	if (!recording.value) return
+
+	event.preventDefault()
+	event.stopPropagation()
+	if (event.code === 'Escape') {
+		assign('key.keyboard.unknown')
+		return
+	}
+	if (event.repeat) return
+
+	const token = event.isComposing ? null : minecraftKeyTokenFromKeyboardEvent(event)
+	if (!token) {
+		statusMessage.value = formatMessage(messages.unsupportedStatus)
+		return
+	}
+	assign(token)
+}
+
+function handlePointerDown(event: PointerEvent) {
+	if (!recording.value) return
+	if (event.pointerType !== 'mouse') return
+	const otherKeybindControl =
+		event.target instanceof Element
+			? event.target.closest<HTMLElement>('[data-game-keybind-control]')
+			: null
+	if (otherKeybindControl && otherKeybindControl !== controlElement.value) return
+
+	event.preventDefault()
+	event.stopPropagation()
+	const token = minecraftMouseTokenFromButton(event.button)
+	if (!token) {
+		statusMessage.value = formatMessage(messages.unsupportedStatus)
+		return
+	}
+	suppressNextClick = event.button === 0 && otherKeybindControl === controlElement.value
+	assign(token)
+}
+
+watch(
+	() => props.disabled,
+	(disabled) => {
+		if (disabled) cancelRecording()
+	},
+)
+onBeforeUnmount(cancelRecording)
+</script>
+
+<template>
+	<div class="flex w-full min-w-0 items-center gap-1.5">
+		<span
+			ref="controlElement"
+			v-tooltip="!recording && conflictMessage ? conflictMessage : undefined"
+			data-game-keybind-control
+			class="flex min-w-0 flex-1"
+		>
+			<Button
+				:type="recording || conflicts.length ? 'outlined' : 'base'"
+				:color="recording ? 'brand' : conflicts.length ? 'orange' : undefined"
+				size="md"
+				:disabled="disabled"
+				:aria-label="accessibleLabel"
+				:aria-describedby="recording ? statusId : conflicts.length ? conflictId : undefined"
+				class="w-full overflow-hidden"
+				@click="handleClick"
+				@contextmenu.prevent.stop
+				@auxclick.prevent.stop
+			>
+				<TriangleAlertIcon v-if="!recording && conflicts.length" aria-hidden="true" />
+				<span class="min-w-0 truncate">{{ visibleLabel }}</span>
+			</Button>
+		</span>
+
+		<span :id="statusId" class="visually-hidden" role="status" aria-live="polite">
+			{{ statusMessage }}
+		</span>
+		<span v-if="conflicts.length" :id="conflictId" class="visually-hidden">
+			{{ conflictMessage }}
+		</span>
+	</div>
+</template>

apps/app-frontend/src/components/ui/settings/instances/game-settings-modal/keybinds.ts

@@ -0,0 +1,426 @@
+import { defineMessages, type MessageDescriptor, type VIntlFormatters } from '@modrinth/ui'
+
+type FormatMessage = VIntlFormatters['formatMessage']
+
+type StopKeybindRecording = () => void
+let stopActiveKeybindRecording: StopKeybindRecording | null = null
+
+export function activateKeybindRecording(stop: StopKeybindRecording) {
+	if (stopActiveKeybindRecording === stop) return
+	const stopPrevious = stopActiveKeybindRecording
+	stopActiveKeybindRecording = stop
+	stopPrevious?.()
+}
+
+export function deactivateKeybindRecording(stop: StopKeybindRecording) {
+	if (stopActiveKeybindRecording === stop) {
+		stopActiveKeybindRecording = null
+	}
+}
+
+const keyMessages = defineMessages({
+	unbound: {
+		id: 'app.settings.game-options.keybind.key.unbound',
+		defaultMessage: 'Unbound',
+	},
+	escape: {
+		id: 'app.settings.game-options.keybind.key.escape',
+		defaultMessage: 'Escape',
+	},
+	backspace: {
+		id: 'app.settings.game-options.keybind.key.backspace',
+		defaultMessage: 'Backspace',
+	},
+	tab: {
+		id: 'app.settings.game-options.keybind.key.tab',
+		defaultMessage: 'Tab',
+	},
+	enter: {
+		id: 'app.settings.game-options.keybind.key.enter',
+		defaultMessage: 'Enter',
+	},
+	leftControl: {
+		id: 'app.settings.game-options.keybind.key.left-control',
+		defaultMessage: 'Left Ctrl',
+	},
+	rightControl: {
+		id: 'app.settings.game-options.keybind.key.right-control',
+		defaultMessage: 'Right Ctrl',
+	},
+	leftShift: {
+		id: 'app.settings.game-options.keybind.key.left-shift',
+		defaultMessage: 'Left Shift',
+	},
+	rightShift: {
+		id: 'app.settings.game-options.keybind.key.right-shift',
+		defaultMessage: 'Right Shift',
+	},
+	leftAlt: {
+		id: 'app.settings.game-options.keybind.key.left-alt',
+		defaultMessage: 'Left Alt',
+	},
+	rightAlt: {
+		id: 'app.settings.game-options.keybind.key.right-alt',
+		defaultMessage: 'Right Alt',
+	},
+	space: {
+		id: 'app.settings.game-options.keybind.key.space',
+		defaultMessage: 'Space',
+	},
+	capsLock: {
+		id: 'app.settings.game-options.keybind.key.caps-lock',
+		defaultMessage: 'Caps Lock',
+	},
+	numLock: {
+		id: 'app.settings.game-options.keybind.key.num-lock',
+		defaultMessage: 'Num Lock',
+	},
+	scrollLock: {
+		id: 'app.settings.game-options.keybind.key.scroll-lock',
+		defaultMessage: 'Scroll Lock',
+	},
+	printScreen: {
+		id: 'app.settings.game-options.keybind.key.print-screen',
+		defaultMessage: 'Print Screen',
+	},
+	pause: {
+		id: 'app.settings.game-options.keybind.key.pause',
+		defaultMessage: 'Pause',
+	},
+	home: {
+		id: 'app.settings.game-options.keybind.key.home',
+		defaultMessage: 'Home',
+	},
+	end: {
+		id: 'app.settings.game-options.keybind.key.end',
+		defaultMessage: 'End',
+	},
+	pageUp: {
+		id: 'app.settings.game-options.keybind.key.page-up',
+		defaultMessage: 'Page Up',
+	},
+	pageDown: {
+		id: 'app.settings.game-options.keybind.key.page-down',
+		defaultMessage: 'Page Down',
+	},
+	insert: {
+		id: 'app.settings.game-options.keybind.key.insert',
+		defaultMessage: 'Insert',
+	},
+	delete: {
+		id: 'app.settings.game-options.keybind.key.delete',
+		defaultMessage: 'Delete',
+	},
+	arrowUp: {
+		id: 'app.settings.game-options.keybind.key.arrow-up',
+		defaultMessage: 'Up Arrow',
+	},
+	arrowDown: {
+		id: 'app.settings.game-options.keybind.key.arrow-down',
+		defaultMessage: 'Down Arrow',
+	},
+	arrowLeft: {
+		id: 'app.settings.game-options.keybind.key.arrow-left',
+		defaultMessage: 'Left Arrow',
+	},
+	arrowRight: {
+		id: 'app.settings.game-options.keybind.key.arrow-right',
+		defaultMessage: 'Right Arrow',
+	},
+	leftSuper: {
+		id: 'app.settings.game-options.keybind.key.left-super',
+		defaultMessage: 'Left Super',
+	},
+	rightSuper: {
+		id: 'app.settings.game-options.keybind.key.right-super',
+		defaultMessage: 'Right Super',
+	},
+	leftCommand: {
+		id: 'app.settings.game-options.keybind.key.left-command',
+		defaultMessage: 'Left Command',
+	},
+	rightCommand: {
+		id: 'app.settings.game-options.keybind.key.right-command',
+		defaultMessage: 'Right Command',
+	},
+	menu: {
+		id: 'app.settings.game-options.keybind.key.menu',
+		defaultMessage: 'Menu',
+	},
+	keypadKey: {
+		id: 'app.settings.game-options.keybind.key.keypad-key',
+		defaultMessage: 'Numpad {key}',
+	},
+	leftMouse: {
+		id: 'app.settings.game-options.keybind.mouse.left',
+		defaultMessage: 'Left Mouse',
+	},
+	rightMouse: {
+		id: 'app.settings.game-options.keybind.mouse.right',
+		defaultMessage: 'Right Mouse',
+	},
+	middleMouse: {
+		id: 'app.settings.game-options.keybind.mouse.middle',
+		defaultMessage: 'Middle Mouse',
+	},
+	mouseButton: {
+		id: 'app.settings.game-options.keybind.mouse.button',
+		defaultMessage: 'Mouse {button}',
+	},
+	scancode: {
+		id: 'app.settings.game-options.keybind.scancode',
+		defaultMessage: 'Scancode {code}',
+	},
+	unknownKey: {
+		id: 'app.settings.game-options.keybind.key.unknown',
+		defaultMessage: 'Unknown key',
+	},
+	controlModifier: {
+		id: 'app.settings.game-options.keybind.modifier.control',
+		defaultMessage: 'Ctrl',
+	},
+	shiftModifier: {
+		id: 'app.settings.game-options.keybind.modifier.shift',
+		defaultMessage: 'Shift',
+	},
+	altModifier: {
+		id: 'app.settings.game-options.keybind.modifier.alt',
+		defaultMessage: 'Alt',
+	},
+	commandModifier: {
+		id: 'app.settings.game-options.keybind.modifier.command',
+		defaultMessage: 'Command',
+	},
+	superModifier: {
+		id: 'app.settings.game-options.keybind.modifier.super',
+		defaultMessage: 'Super',
+	},
+})
+
+const keyboardCodeTokens: Record<string, string> = {
+	Escape: 'escape',
+	Minus: 'minus',
+	Equal: 'equal',
+	Backspace: 'backspace',
+	Tab: 'tab',
+	BracketLeft: 'left.bracket',
+	BracketRight: 'right.bracket',
+	Enter: 'enter',
+	ControlLeft: 'left.control',
+	Semicolon: 'semicolon',
+	Quote: 'apostrophe',
+	Backquote: 'grave.accent',
+	ShiftLeft: 'left.shift',
+	Backslash: 'backslash',
+	Comma: 'comma',
+	Period: 'period',
+	Slash: 'slash',
+	ShiftRight: 'right.shift',
+	AltLeft: 'left.alt',
+	Space: 'space',
+	CapsLock: 'caps.lock',
+	NumLock: 'num.lock',
+	ScrollLock: 'scroll.lock',
+	NumpadSubtract: 'keypad.subtract',
+	NumpadAdd: 'keypad.add',
+	NumpadDecimal: 'keypad.decimal',
+	NumpadComma: 'keypad.decimal',
+	NumpadEqual: 'keypad.equal',
+	NumpadEnter: 'keypad.enter',
+	ControlRight: 'right.control',
+	NumpadDivide: 'keypad.divide',
+	NumpadMultiply: 'keypad.multiply',
+	PrintScreen: 'print.screen',
+	AltRight: 'right.alt',
+	Pause: 'pause',
+	Home: 'home',
+	ArrowUp: 'up',
+	PageUp: 'page.up',
+	ArrowLeft: 'left',
+	ArrowRight: 'right',
+	End: 'end',
+	ArrowDown: 'down',
+	PageDown: 'page.down',
+	Insert: 'insert',
+	Delete: 'delete',
+	MetaLeft: 'left.win',
+	MetaRight: 'right.win',
+	ContextMenu: 'menu',
+}
+
+const keyboardLabels: Record<string, MessageDescriptor | string> = {
+	escape: keyMessages.escape,
+	minus: '-',
+	equal: '=',
+	backspace: keyMessages.backspace,
+	tab: keyMessages.tab,
+	'left.bracket': '[',
+	'right.bracket': ']',
+	enter: keyMessages.enter,
+	'left.control': keyMessages.leftControl,
+	semicolon: ';',
+	apostrophe: "'",
+	'grave.accent': '`',
+	'left.shift': keyMessages.leftShift,
+	backslash: '\\',
+	comma: ',',
+	period: '.',
+	slash: '/',
+	'right.shift': keyMessages.rightShift,
+	'left.alt': keyMessages.leftAlt,
+	space: keyMessages.space,
+	'caps.lock': keyMessages.capsLock,
+	'num.lock': keyMessages.numLock,
+	'scroll.lock': keyMessages.scrollLock,
+	'keypad.subtract': '-',
+	'keypad.add': '+',
+	'keypad.decimal': '.',
+	'keypad.equal': '=',
+	'keypad.enter': keyMessages.enter,
+	'right.control': keyMessages.rightControl,
+	'keypad.divide': '/',
+	'keypad.multiply': '*',
+	'print.screen': keyMessages.printScreen,
+	'right.alt': keyMessages.rightAlt,
+	pause: keyMessages.pause,
+	home: keyMessages.home,
+	up: keyMessages.arrowUp,
+	'page.up': keyMessages.pageUp,
+	left: keyMessages.arrowLeft,
+	right: keyMessages.arrowRight,
+	end: keyMessages.end,
+	down: keyMessages.arrowDown,
+	'page.down': keyMessages.pageDown,
+	insert: keyMessages.insert,
+	delete: keyMessages.delete,
+	menu: keyMessages.menu,
+}
+
+function splitKeybind(value: string): [key: string, modifier?: string] {
+	const separator = value.indexOf(':')
+	return separator === -1 ? [value] : [value.slice(0, separator), value.slice(separator + 1)]
+}
+
+function keyboardIdentifierFromCode(code: string): string | null {
+	const letter = /^Key([A-Z])$/.exec(code)
+	if (letter) return letter[1].toLowerCase()
+
+	const digit = /^Digit([0-9])$/.exec(code)
+	if (digit) return digit[1]
+
+	const functionKey = /^F([1-9]|1[0-9]|2[0-5])$/.exec(code)
+	if (functionKey) return `f${functionKey[1]}`
+
+	const keypadDigit = /^Numpad([0-9])$/.exec(code)
+	if (keypadDigit) return `keypad.${keypadDigit[1]}`
+
+	return keyboardCodeTokens[code] ?? null
+}
+
+export function minecraftKeyTokenFromKeyboardEvent(event: KeyboardEvent): string | null {
+	const identifier = keyboardIdentifierFromCode(event.code)
+	return identifier ? `key.keyboard.${identifier}` : null
+}
+
+export function minecraftMouseTokenFromButton(button: number): string | null {
+	if (!Number.isInteger(button) || button < 0 || button > 15) return null
+	if (button === 0) return 'key.mouse.left'
+	if (button === 1) return 'key.mouse.middle'
+	if (button === 2) return 'key.mouse.right'
+	return `key.mouse.${button + 1}`
+}
+
+function formatKeyboardLabel(
+	formatMessage: FormatMessage,
+	identifier: string,
+	isMac: boolean,
+): string {
+	if (identifier === 'unknown') return formatMessage(keyMessages.unbound)
+	if (/^[a-z]$/.test(identifier)) return identifier.toUpperCase()
+	if (/^[0-9]$/.test(identifier)) return identifier
+	if (/^f([1-9]|1[0-9]|2[0-5])$/.test(identifier)) return identifier.toUpperCase()
+
+	const keypad = /^keypad\.(.+)$/.exec(identifier)
+	if (keypad) {
+		const label = keyboardLabels[identifier]
+		const key = typeof label === 'string' ? label : label ? formatMessage(label) : keypad[1]
+		return formatMessage(keyMessages.keypadKey, { key })
+	}
+
+	if (identifier === 'left.win') {
+		return formatMessage(isMac ? keyMessages.leftCommand : keyMessages.leftSuper)
+	}
+	if (identifier === 'right.win') {
+		return formatMessage(isMac ? keyMessages.rightCommand : keyMessages.rightSuper)
+	}
+
+	const label = keyboardLabels[identifier]
+	if (typeof label === 'string') return label
+	if (label) return formatMessage(label)
+	return identifier
+		.split('.')
+		.map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`)
+		.join(' ')
+}
+
+function formatModifier(formatMessage: FormatMessage, modifier: string, isMac: boolean): string {
+	switch (modifier.toUpperCase()) {
+		case 'CONTROL':
+		case 'CTRL':
+			return formatMessage(keyMessages.controlModifier)
+		case 'SHIFT':
+			return formatMessage(keyMessages.shiftModifier)
+		case 'ALT':
+			return formatMessage(keyMessages.altModifier)
+		case 'META':
+		case 'SUPER':
+			return formatMessage(isMac ? keyMessages.commandModifier : keyMessages.superModifier)
+		default:
+			return modifier
+	}
+}
+
+export function formatMinecraftKeybind(
+	formatMessage: FormatMessage,
+	value: string,
+	isMac: boolean,
+): string {
+	const [key, modifier] = splitKeybind(value)
+	let label: string
+
+	if (key.startsWith('key.keyboard.')) {
+		label = formatKeyboardLabel(formatMessage, key.slice('key.keyboard.'.length), isMac)
+	} else if (key === 'key.mouse.left') {
+		label = formatMessage(keyMessages.leftMouse)
+	} else if (key === 'key.mouse.right') {
+		label = formatMessage(keyMessages.rightMouse)
+	} else if (key === 'key.mouse.middle') {
+		label = formatMessage(keyMessages.middleMouse)
+	} else if (key.startsWith('key.mouse.')) {
+		label = formatMessage(keyMessages.mouseButton, {
+			button: key.slice('key.mouse.'.length),
+		})
+	} else if (key.startsWith('scancode.')) {
+		label = formatMessage(keyMessages.scancode, { code: key.slice('scancode.'.length) })
+	} else {
+		label = formatMessage(keyMessages.unknownKey)
+	}
+
+	if (!modifier || key === 'key.keyboard.unknown') return label
+	const modifiers = modifier
+		.split(/[+:]/)
+		.filter(Boolean)
+		.map((part) => formatModifier(formatMessage, part, isMac))
+	return [...modifiers, label].join(' + ')
+}
+
+export function minecraftKeybindConflictKey(optionId: string, value: string): string | null {
+	const normalized = value.trim().toLowerCase()
+	if (!normalized || normalized === 'key.keyboard.unknown') return null
+
+	if (optionId === 'key.debug.modifier') return null
+	if (optionId.startsWith('key.debug.') && optionId !== 'key.debug.overlay') {
+		return `debug:${normalized}`
+	}
+	return `direct:${normalized}`
+}

apps/app-frontend/src/components/ui/settings/instances/game-settings-modal/languages.ts

@@ -0,0 +1,152 @@
+import type { ComboboxOption } from '@modrinth/ui'
+
+/** Java Edition language names and regions from https://github.com/misode/mcmeta/blob/assets/pack.mcmeta. */
+const languageNames: Record<string, string> = {
+	en_us: 'English (US)',
+	af_za: 'Afrikaans (Suid-Afrika)',
+	esan: 'Andalûh (Andaluçía)',
+	enp: 'Anglish (Oned Riches)',
+	ast_es: 'Asturianu (Asturies)',
+	az_az: 'Azərbaycanca (Azərbaycan)',
+	id_id: 'Bahasa Indonesia (Indonesia)',
+	ms_my: 'Bahasa Melayu (Malaysia)',
+	tzo_mx: "Bats'i k'op (Jobel)",
+	qid: 'Bhs. Indonesia edjaän lama (Indonesia tempo doeloe)',
+	be_latn: 'Biełaruskaja (Biełaruś)',
+	bar: 'Boarisch (Bayern)',
+	bs_ba: 'Bosanski (Bosna i Hercegovina)',
+	brb: 'Braobans (Braobant)',
+	br_fr: 'Brezhoneg (Breizh)',
+	ca_es: 'Català (Catalunya)',
+	val_es: 'Català (Valencià) (País Valencià)',
+	cy_gb: 'Cymraeg (Cymru)',
+	qcb_es: 'Cántabru/Montañés (Cantabria)',
+	da_dk: 'Dansk (Danmark)',
+	se_no: 'Davvisámegiella (Sápmi)',
+	de_at: 'Deitsch (Österreich)',
+	de_de: 'Deutsch (Deutschland)',
+	et_ee: 'Eesti keel (Eesti)',
+	en_au: 'English (Australia)',
+	en_ca: 'English (Canada)',
+	en_nz: 'English (New Zealand)',
+	en_gb: 'English (United Kingdom)',
+	es_ar: 'Español (Argentina)',
+	es_cl: 'Español (Chile)',
+	es_ec: 'Español (Ecuador)',
+	es_es: 'Español (España)',
+	es_mx: 'Español (México)',
+	es_uy: 'Español (Uruguay)',
+	es_ve: 'Español (Venezuela)',
+	eo_uy: 'Esperanto (Esperantujo)',
+	eu_es: 'Euskara (Euskal Herria)',
+	fil_ph: 'Filipino (Pilipinas)',
+	fr_ca: 'Français (Canada)',
+	fr_fr: 'Français (France)',
+	fr_ch: 'Français (Suisse)',
+	fy_nl: 'Frysk (Fryslân)',
+	fra_de: 'Fränggisch (Franggn)',
+	fur_it: 'Furlan (Friûl)',
+	fo_fo: 'Føroyskt (Føroyar)',
+	ga_ie: 'Gaeilge (Éire)',
+	gl_es: 'Galego (Galicia / Galiza)',
+	go_fr: 'Galo (Bertègn)',
+	gd_gb: 'Gàidhlig (Alba)',
+	hr_hr: 'Hrvatski (Hrvatska)',
+	hn_no: 'Høgnorsk (Norig)',
+	io_en: 'Ido (Idia)',
+	ig_ng: 'Igbo (Naigeria)',
+	it_it: 'Italiano (Italia)',
+	kw_gb: 'Kernewek (Kernow)',
+	ksh: 'Kölsch/Ripoarisch (Rhingland)',
+	lol_us: 'LOLCAT (Kingdom of Cats)',
+	la_la: 'Latina (Latium)',
+	lv_lv: 'Latviešu (Latvija)',
+	lt_lt: 'Lietuvių (Lietuva)',
+	li_li: 'Limburgs (Limburg)',
+	lmo: 'Lombard (Lombardia)',
+	lb_lu: 'Lëtzebuergesch (Lëtzebuerg)',
+	hu_hu: 'Magyar (Magyarország)',
+	mt_mt: 'Malti (Malta)',
+	isv: 'Medžuslovjansky (Slovjanščina)',
+	nah: 'Mēxikatlahtōlli (Mēxiko)',
+	nl_nl: 'Nederlands (Nederland)',
+	pls: 'Ngiiwà (Ndanìꞌngà)',
+	no_no: 'Norsk bokmål (Norge)',
+	nn_no: 'Norsk nynorsk (Noreg)',
+	uz_uz: "O'zbekcha (O'zbekiston)",
+	oc_fr: 'Occitan (Occitània)',
+	en_pt: 'Pirate Speak (The Seven Seas)',
+	nds_de: 'Plattdüütsch (Düütschland)',
+	pl_pl: 'Polski (Polska)',
+	pt_br: 'Português (Brasil)',
+	pt_pt: 'Português (Portugal)',
+	qya_aa: 'Quenya (Arda)',
+	ro_ro: 'Română (România)',
+	de_ch: 'Schwiizerdütsch (Schwiiz)',
+	enws: 'Shakespearean English (Kingdom of England)',
+	sq_al: 'Shqip (Shqipëri)',
+	sk_sk: 'Slovenčina (Slovensko)',
+	sl_si: 'Slovenščina (Slovenija)',
+	so_so: 'Soomaali (Soomaaliya)',
+	sr_cs: 'Srpski (Srbija)',
+	fi_fi: 'Suomi (Suomi)',
+	sv_se: 'Svenska (Sverige)',
+	sxu: 'Säggs’sch (Saggsn)',
+	tl_ph: 'Tagalog (Pilipinas)',
+	vi_vn: 'Tiếng Việt (Việt Nam)',
+	tr_tr: 'Türkçe (Türkiye)',
+	vp_vl: 'Viossa (Vilant)',
+	nl_be: 'Vlaams (België)',
+	vec_it: 'Vèneto (Veneto)',
+	vro: 'Võro (Eesti)',
+	yo_ng: 'Yorùbá (Nàìjíríà)',
+	jbo_en: "la .lojban. (la jbogu'e)",
+	tlh_aa: "tlhIngan Hol (tlhIngan wo')",
+	tok: 'toki pona (kulupu pona)',
+	is_is: 'Íslenska (Ísland)',
+	ovd: 'Övdalska (Swerre)',
+	cs_cz: 'Čeština (Česko)',
+	szl: 'Ślōnski (Gōrny Ślōnsk)',
+	en_ud: 'ɥsᴉꞁᵷuƎ (uʍoᗡ ǝpᴉsd∩)',
+	haw_us: 'ʻŌlelo Hawaiʻi (Hawaiʻi)',
+	el_gr: 'Ελληνικά (Ελλάδα)',
+	ba_ru: 'Башҡортса (Башҡортостан, Рәсәй)',
+	be_by: 'Беларуская (Беларусь)',
+	bg_bg: 'Български (България)',
+	hal_ua: 'Галицка (Галичина, Вкраїна)',
+	ky_kg: 'Кыргызча (Кыргызстан)',
+	mk_mk: 'Македонски (Северна Македонија)',
+	mn_mn: 'Монгол (Монгол Улс)',
+	ry_ua: 'Руснацькый (Пудкарпатя, Украина)',
+	ru_ru: 'Русский (Россия)',
+	rpr: 'Русскій дореформенный (Россійская имперія)',
+	sah_sah: 'Сахалыы (Cаха Сирэ)',
+	sr_sp: 'Српски (Србија)',
+	tt_ru: 'Татарча (Татарстан, Рәсәй)',
+	uk_ua: 'Українська (Україна)',
+	cv_cu: 'Чӑвашла (Чӑваш Ен, Раҫҫей)',
+	kk_kz: 'Қазақша (Қазақстан)',
+	hy_am: 'Հայերեն (Հայաստան)',
+	yi_de: 'ייִדיש (אשכנזיש יידן)',
+	he_il: 'עברית (ישראל)',
+	ar_sa: 'العربية (العالم العربي)',
+	zlm_arab: 'بهاس ملايو (مليسيا)',
+	fa_ir: 'فارسی (ايران)',
+	hi_in: 'हिंदी (भारत)',
+	ta_in: 'தமிழ் (இந்தியா)',
+	kn_in: 'ಕನ್ನಡ (ಭಾರತ)',
+	th_th: 'ไทย (ประเทศไทย)',
+	lo_la: 'ລາວ (ປະເທດລາວ)',
+	ka_ge: 'ქართული (საქართველო)',
+	lzh: '文言 (華夏)',
+	ja_jp: '日本語 (日本)',
+	zh_cn: '简体中文 (中国大陆)',
+	zh_tw: '繁體中文 (台灣)',
+	zh_hk: '繁體中文 (香港特別行政區)',
+	ko_kr: '한국어 (대한민국)',
+	got_de: '𐌲𐌿𐍄𐍂𐌰𐌶𐌳𐌰 (𐌲𐌿𐍄𐌸𐌹𐌿𐌳𐌰)',
+}
+
+export const minecraftLanguageOptions: ComboboxOption<string>[] = Object.entries(languageNames)
+	.map(([value, label]) => ({ value, label, searchTerms: [value] }))
+	.sort((a, b) => a.label.localeCompare(b.label))

apps/app-frontend/src/components/ui/settings/instances/game-settings-modal/row.vue

@@ -0,0 +1,384 @@
+<script setup lang="ts">
+import { LinkIcon, UnknownIcon, UnlinkIcon } from '@modrinth/assets'
+import {
+	Avatar,
+	Combobox,
+	type ComboboxOption,
+	defineMessages,
+	IconButton,
+	Slider,
+	StyledInput,
+	truncatedTooltip,
+	useVIntl,
+} from '@modrinth/ui'
+import { computed, ref } from 'vue'
+import { type RouteLocationRaw, RouterLink } from 'vue-router'
+
+import type {
+	EditableGameSetting,
+	GameOptionCanonicalValue,
+	GameSettingLocaleLabel,
+} from '@/helpers/game-options'
+
+import GameSettingBooleanControl from './boolean-control.vue'
+import {
+	canonicalBooleanValue,
+	canonicalValueFromInput,
+	canonicalValueText,
+	gameSettingNumberScale,
+	isKeybindSetting,
+	settingCanBeEnabled,
+} from './editors'
+import GameKeybindInput from './keybind-input.vue'
+import { minecraftLanguageOptions } from './languages'
+import {
+	formatGameSettingChoice,
+	formatGameSettingDescription,
+	formatGameSettingLabel,
+	formatGameSettingValidation,
+	presentationMessages,
+} from './messages'
+
+const props = withDefaults(
+	defineProps<{
+		setting: EditableGameSetting
+		localeLabel?: GameSettingLocaleLabel
+		keybindConflicts?: string[]
+		disabled?: boolean
+		showSyncToggle?: boolean
+		sourceNavigationDisabled?: boolean
+	}>(),
+	{
+		keybindConflicts: () => [],
+		disabled: false,
+		showSyncToggle: true,
+		sourceNavigationDisabled: false,
+	},
+)
+
+const emit = defineEmits<{
+	'update:sync-enabled': [enabled: boolean]
+	'update:canonical-value': [value: GameOptionCanonicalValue | null]
+	'open-source': [location: RouteLocationRaw]
+}>()
+
+const { formatMessage } = useVIntl()
+const settingLabelRef = ref<HTMLElement | null>(null)
+
+const messages = defineMessages({
+	on: {
+		id: 'app.settings.synced-options.game-settings.value-on',
+		defaultMessage: 'On',
+	},
+	off: {
+		id: 'app.settings.synced-options.game-settings.value-off',
+		defaultMessage: 'Off',
+	},
+	mixed: {
+		id: 'app.settings.synced-options.game-settings.value-mixed',
+		defaultMessage: 'Different across instances',
+	},
+	unset: {
+		id: 'app.settings.synced-options.game-settings.value-unset',
+		defaultMessage: 'Choose a value',
+	},
+	syncSetting: {
+		id: 'app.settings.synced-options.game-settings.sync-setting',
+		defaultMessage: 'Sync {setting} across instances',
+	},
+	unsyncSetting: {
+		id: 'app.settings.synced-options.game-settings.unsync-setting',
+		defaultMessage: 'Stop syncing {setting} across instances',
+	},
+	syncedAcrossInstances: {
+		id: 'app.settings.synced-options.game-settings.synced-across-instances',
+		defaultMessage: 'Synced across instances',
+	},
+	notBeingSynced: {
+		id: 'app.settings.synced-options.game-settings.not-being-synced',
+		defaultMessage: 'Not being synced',
+	},
+})
+
+const settingLabel = computed(() => {
+	if (props.setting.kind === 'external') {
+		return props.localeLabel?.label ?? formatGameSettingLabel(formatMessage, props.setting)
+	}
+	return formatGameSettingLabel(formatMessage, props.setting)
+})
+const settingDescription = computed(() =>
+	formatGameSettingDescription(formatMessage, props.setting),
+)
+const settingSource = computed(() =>
+	props.setting.kind === 'external' ? props.localeLabel?.source : undefined,
+)
+const sourceLocation = computed<RouteLocationRaw>(() => {
+	const source = settingSource.value
+	if (source?.project) {
+		return { path: `/project/${source.project.id}` }
+	}
+	return {
+		name: 'InstanceContent',
+		params: { id: source?.instance_id },
+		query: { highlight: source?.file_path },
+	}
+})
+const valueText = computed(() => canonicalValueText(props.setting))
+const languageOptions = computed<ComboboxOption<string>[]>(() => {
+	const value = valueText.value
+	if (value && !minecraftLanguageOptions.some((option) => option.value === value)) {
+		return [{ value, label: value }, ...minecraftLanguageOptions]
+	}
+	return minecraftLanguageOptions
+})
+const enumOptions = computed<ComboboxOption<string>[]>(() =>
+	(props.setting.editor.choices ?? []).map((choice) => ({
+		value: choice.value,
+		label:
+			props.setting.kind === 'external'
+				? (props.localeLabel?.choices[choice.value] ?? choice.value)
+				: formatGameSettingChoice(formatMessage, props.setting.option_id, choice.value),
+	})),
+)
+const isNumber = computed(
+	() => props.setting.editor.type === 'integer' || props.setting.editor.type === 'decimal',
+)
+const isSlider = computed(
+	() => isNumber.value && props.setting.editor.min != null && props.setting.editor.max != null,
+)
+const booleanValue = computed(() => canonicalBooleanValue(props.setting))
+const numberScale = computed(() => gameSettingNumberScale(props.setting))
+const inputMin = computed(() =>
+	props.setting.editor.min === null || props.setting.editor.min === undefined
+		? undefined
+		: props.setting.editor.min * numberScale.value,
+)
+const inputMax = computed(() =>
+	props.setting.editor.max === null || props.setting.editor.max === undefined
+		? undefined
+		: props.setting.editor.max * numberScale.value,
+)
+const inputStep = computed(() =>
+	props.setting.editor.step === null || props.setting.editor.step === undefined
+		? undefined
+		: props.setting.editor.step * numberScale.value,
+)
+const sliderValue = computed(() => {
+	if (valueText.value === '') return null
+	const value = Number(valueText.value)
+	return Number.isFinite(value) ? value : null
+})
+const inputValue = computed(() =>
+	isNumber.value ? (sliderValue.value ?? undefined) : valueText.value,
+)
+const editorDisabled = computed(
+	() =>
+		props.disabled ||
+		props.setting.controlled ||
+		(props.showSyncToggle && !props.setting.sync_enabled),
+)
+const syncToggleDisabled = computed(
+	() =>
+		props.disabled ||
+		props.setting.controlled ||
+		(!props.setting.sync_enabled && !settingCanBeEnabled(props.setting)),
+)
+const placeholder = computed(() => {
+	if (props.setting.value_state === 'mixed') return formatMessage(messages.mixed)
+	if (props.setting.value_state === 'unset') return formatMessage(messages.unset)
+	if (props.setting.editor.type === 'external_raw') {
+		return formatMessage(presentationMessages.customValuePlaceholder)
+	}
+	return undefined
+})
+const validationMessage = computed(() =>
+	formatGameSettingValidation(formatMessage, props.setting.validation_error),
+)
+const syncDisabledReason = computed(() => {
+	if (validationMessage.value) return validationMessage.value
+	if (props.setting.value_state === 'invalid') {
+		return formatMessage(presentationMessages.validationInvalidValue)
+	}
+	if (props.setting.value_state === 'mixed' || props.setting.value_state === 'unset') {
+		return formatMessage(presentationMessages.validationMissingValue)
+	}
+	if (props.setting.controlled) {
+		return formatMessage(presentationMessages.bucketLauncherControlled, { count: 1 })
+	}
+	if (
+		props.setting.compatibility.total_participating > 0 &&
+		props.setting.compatibility.will_receive === 0
+	) {
+		return formatMessage(presentationMessages.compatibilityNone)
+	}
+	return undefined
+})
+const syncActionLabel = computed(() =>
+	formatMessage(props.setting.sync_enabled ? messages.unsyncSetting : messages.syncSetting, {
+		setting: settingLabel.value,
+	}),
+)
+const syncStatusTooltip = computed(() =>
+	formatMessage(
+		props.setting.sync_enabled ? messages.syncedAcrossInstances : messages.notBeingSynced,
+	),
+)
+
+function updateValue(value: string | number | boolean | undefined) {
+	emit('update:canonical-value', canonicalValueFromInput(props.setting, value))
+}
+</script>
+
+<template>
+	<div
+		class="grid min-h-[54px] min-w-0 items-center gap-2"
+		:class="
+			isSlider
+				? showSyncToggle
+					? 'grid-cols-[minmax(10rem,0.65fr)_minmax(0,1.35fr)_2.25rem]'
+					: 'grid-cols-[minmax(10rem,0.65fr)_minmax(0,1.35fr)]'
+				: showSyncToggle
+					? 'grid-cols-[minmax(0,1fr)_12rem_2.25rem]'
+					: 'grid-cols-[minmax(0,1fr)_12rem]'
+		"
+	>
+		<div class="min-w-0 pr-2">
+			<div class="flex items-center gap-2">
+				<h3
+					ref="settingLabelRef"
+					v-tooltip="truncatedTooltip(settingLabelRef, settingLabel)"
+					class="m-0 truncate text-lg font-semibold text-[var(--color-text-primary)]"
+				>
+					{{ settingLabel }}
+				</h3>
+				<span
+					v-if="validationMessage"
+					v-tooltip="validationMessage"
+					tabindex="0"
+					role="img"
+					class="flex shrink-0 rounded-md text-orange outline-none focus-visible:ring-4 focus-visible:ring-brand-shadow"
+				>
+					<UnknownIcon class="size-4" aria-hidden="true" />
+				</span>
+			</div>
+			<RouterLink v-if="settingSource" v-slot="{ href }" :to="sourceLocation" custom>
+				<a
+					:href="sourceNavigationDisabled ? undefined : href"
+					:aria-disabled="sourceNavigationDisabled || undefined"
+					class="mt-2 inline-flex max-w-full items-center gap-1.5 text-[var(--color-text-default)]"
+					:class="sourceNavigationDisabled ? 'cursor-default' : 'hover:underline'"
+					@click.prevent="!sourceNavigationDisabled && emit('open-source', sourceLocation)"
+				>
+					<Avatar
+						v-if="settingSource.project"
+						:src="settingSource.project.icon_url"
+						size="1.25rem"
+						no-shadow
+					/>
+					<span class="truncate">{{
+						settingSource.project?.title ?? settingSource.file_name
+					}}</span>
+				</a>
+			</RouterLink>
+			<p v-else-if="settingDescription" class="m-0 mt-0.5 text-[var(--color-text-default)]">
+				{{ settingDescription }}
+			</p>
+		</div>
+
+		<div class="flex min-w-0 items-center justify-end">
+			<Slider
+				v-if="isSlider"
+				size="standard"
+				:model-value="sliderValue"
+				:min="inputMin ?? 0"
+				:max="inputMax ?? 100"
+				:step="inputStep ?? 1"
+				:snap-points="setting.category_id === 'music_and_sound' ? [0, 50, 100] : []"
+				:snap-range="5"
+				:unit="setting.editor.unit === 'percent' ? '%' : undefined"
+				:placeholder="placeholder"
+				:aria-label="settingLabel"
+				:disabled="editorDisabled"
+				@update:model-value="updateValue"
+			/>
+
+			<GameSettingBooleanControl
+				v-else-if="setting.editor.type === 'bool'"
+				:model-value="booleanValue"
+				:label="settingLabel"
+				:on-label="formatMessage(messages.on)"
+				:off-label="formatMessage(messages.off)"
+				:placeholder="placeholder"
+				:disabled="editorDisabled"
+				@update:model-value="updateValue"
+			/>
+
+			<Combobox
+				v-else-if="setting.option_id === 'language'"
+				:model-value="valueText"
+				:options="languageOptions"
+				:placeholder="placeholder"
+				:disabled="editorDisabled"
+				:aria-label="settingLabel"
+				:search-input-attrs="{ 'aria-label': settingLabel }"
+				searchable
+				select-search-text-on-focus
+				class="min-w-0"
+				@update:model-value="updateValue"
+			/>
+
+			<Combobox
+				v-else-if="setting.editor.type === 'enum'"
+				:model-value="valueText"
+				:options="enumOptions"
+				:placeholder="placeholder"
+				:disabled="editorDisabled"
+				:aria-label="settingLabel"
+				class="min-w-0"
+				@update:model-value="updateValue"
+			/>
+
+			<GameKeybindInput
+				v-else-if="isKeybindSetting(setting)"
+				:model-value="valueText"
+				:setting-label="settingLabel"
+				:conflicts="keybindConflicts"
+				:mixed="setting.value_state === 'mixed'"
+				:disabled="editorDisabled"
+				@update:model-value="updateValue"
+			/>
+
+			<StyledInput
+				v-else
+				:model-value="inputValue"
+				:type="isNumber ? 'number' : 'text'"
+				:min="inputMin"
+				:max="inputMax"
+				:step="inputStep"
+				:placeholder="placeholder"
+				:disabled="editorDisabled"
+				:aria-label="settingLabel"
+				wrapper-class="w-full"
+				@update:model-value="updateValue"
+			/>
+		</div>
+
+		<span
+			v-if="showSyncToggle"
+			v-tooltip="syncToggleDisabled && syncDisabledReason ? syncDisabledReason : syncStatusTooltip"
+			class="flex justify-center"
+		>
+			<IconButton
+				:type="setting.sync_enabled ? 'chip' : 'base'"
+				:color="setting.sync_enabled ? 'blue' : undefined"
+				:label="syncActionLabel"
+				:disabled="syncToggleDisabled"
+				:aria-pressed="setting.sync_enabled"
+				@click="emit('update:sync-enabled', !setting.sync_enabled)"
+			>
+				<LinkIcon v-if="setting.sync_enabled" aria-hidden="true" />
+				<UnlinkIcon v-else aria-hidden="true" />
+			</IconButton>
+		</span>
+	</div>
+</template>

apps/app-frontend/src/components/ui/settings/instances/game-settings-modal/use-editor.ts

@@ -0,0 +1,448 @@
+import { defineMessages, injectNotificationManager, useVIntl } from '@modrinth/ui'
+import { useMutation, useQuery, useQueryClient } from '@tanstack/vue-query'
+import { computed, type MaybeRefOrGetter, nextTick, onScopeDispose, ref, toValue, watch } from 'vue'
+
+import {
+	type EditableGameSetting,
+	type GameOptionCanonicalValue,
+	type GameSettingChange,
+	type GameSettingsEditorState,
+	gameSettingsKeys,
+	gameSettingsQueryOptions,
+	get_local_game_options_config,
+	get_synced_game_options_config,
+	preview_local_game_option_changes,
+	preview_synced_game_option_changes,
+	save_local_game_option_changes,
+	save_synced_game_option_changes,
+	type UpdateGameSettingsRequest,
+} from '@/helpers/game-options'
+
+import { canonicalValuesEqual, cloneGameSettingsState, gameSettingChanges } from './editors'
+
+export function useGameSettingsEditor(
+	instanceId: MaybeRefOrGetter<string | undefined>,
+	onSaved: () => void,
+) {
+	const { addNotification, handleError } = injectNotificationManager()
+	const { formatMessage } = useVIntl()
+	const queryClient = useQueryClient()
+	const messages = defineMessages({
+		conflictTitle: {
+			id: 'app.settings.synced-options.game-settings.conflict-title',
+			defaultMessage: 'These settings changed elsewhere',
+		},
+		conflictText: {
+			id: 'app.settings.synced-options.game-settings.conflict-text',
+			defaultMessage: 'We loaded the latest settings. Check your changes, then save again.',
+		},
+	})
+
+	const baseState = ref<GameSettingsEditorState | null>(null)
+	const draftState = ref<GameSettingsEditorState | null>(null)
+	const touchedValueOptionIds = ref<Set<string>>(new Set())
+	let previewTimer: ReturnType<typeof setTimeout> | null = null
+	let previewGeneration = 0
+	let loadGeneration = 0
+	let saveGeneration = 0
+
+	const editorInstanceId = ref<string>()
+	const isLocalEditor = computed(() => !!editorInstanceId.value)
+
+	const dirtyChanges = computed(() =>
+		gameSettingChanges(baseState.value, draftState.value, touchedValueOptionIds.value),
+	)
+	const isDirty = computed(() => dirtyChanges.value.length > 0)
+	const dirtyOptionIds = computed(
+		() => new Set(dirtyChanges.value.map((change) => change.option_id)),
+	)
+	const hasBlockingDraft = computed(
+		() =>
+			draftState.value?.settings.some(
+				(setting) =>
+					dirtyOptionIds.value.has(setting.option_id) &&
+					(isLocalEditor.value || setting.sync_enabled) &&
+					(!!setting.validation_error ||
+						['mixed', 'unset', 'invalid'].includes(setting.value_state)),
+			) ?? false,
+	)
+	const stateQuery = useQuery(
+		computed(() => ({
+			...gameSettingsQueryOptions(editorInstanceId.value),
+			enabled: false,
+		})),
+	)
+	const loading = computed(
+		() => !draftState.value && (stateQuery.isPending.value || stateQuery.isFetching.value),
+	)
+	const loadError = computed(() => !draftState.value && stateQuery.isError.value)
+	const previewMutation = useMutation({
+		mutationFn: ({
+			instanceId,
+			request,
+		}: {
+			instanceId?: string
+			request: UpdateGameSettingsRequest
+		}) =>
+			instanceId
+				? preview_local_game_option_changes(instanceId, request)
+				: preview_synced_game_option_changes(request),
+	})
+	const saveMutation = useMutation({
+		mutationFn: saveDraft,
+		onError: handleError,
+	})
+
+	function applyState(state: GameSettingsEditorState) {
+		baseState.value = cloneGameSettingsState(state)
+		draftState.value = cloneGameSettingsState(state)
+		touchedValueOptionIds.value = new Set()
+	}
+
+	watch(stateQuery.data, (state) => {
+		if (state && draftState.value && !isDirty.value && !saveMutation.isPending.value) {
+			applyState(state)
+		}
+	})
+
+	async function load() {
+		const generation = ++loadGeneration
+		cancelPreview()
+		editorInstanceId.value = toValue(instanceId)
+		const options = gameSettingsQueryOptions(editorInstanceId.value)
+		const cached = !editorInstanceId.value && queryClient.getQueryData(options.queryKey)
+		if (cached) {
+			applyState(cached)
+			try {
+				// A previously cached empty state is common immediately after enabling
+				// sync. Refresh it before returning so the editor does not stay empty.
+				const refreshed = await queryClient.fetchQuery({ ...options, staleTime: 0 })
+				if (generation !== loadGeneration) return false
+				applyState(refreshed)
+				return true
+			} catch (error) {
+				if (generation !== loadGeneration) return false
+				handleError(error)
+				return true
+			}
+		}
+		await nextTick()
+		const result = await queryClient
+			.fetchQuery({ ...options, staleTime: 0 })
+			.then((data) => ({ data, isError: false, error: null as unknown }))
+			.catch((error) => ({ data: undefined, isError: true, error }))
+		if (generation !== loadGeneration) return false
+		if (result.isError) {
+			handleError(result.error)
+			return false
+		}
+		if (!result.data) return false
+		applyState(result.data)
+		return true
+	}
+
+	function cancelPreview() {
+		if (previewTimer) clearTimeout(previewTimer)
+		previewTimer = null
+		previewGeneration++
+	}
+
+	function reset() {
+		cancelPreview()
+		loadGeneration++
+		saveGeneration++
+		baseState.value = null
+		draftState.value = null
+		touchedValueOptionIds.value = new Set()
+		saveMutation.reset()
+	}
+
+	function cancelChanges() {
+		if (!baseState.value) return
+		cancelPreview()
+		draftState.value = cloneGameSettingsState(baseState.value)
+		touchedValueOptionIds.value = new Set()
+	}
+
+	function setSyncEnabled(optionIds: readonly string[], enabled: boolean) {
+		if (!draftState.value) return
+		const ids = new Set(optionIds)
+		draftState.value.settings = draftState.value.settings.map((setting) =>
+			ids.has(setting.option_id)
+				? { ...setting, sync_enabled: enabled, validation_error: null }
+				: setting,
+		)
+		schedulePreview()
+	}
+
+	function schedulePreview() {
+		cancelPreview()
+		previewTimer = setTimeout(() => void preview(), 350)
+	}
+
+	function save() {
+		if (saveMutation.isPending.value || loading.value || hasBlockingDraft.value || !isDirty.value)
+			return
+		saveMutation.mutate()
+	}
+
+	async function saveAndWait(): Promise<boolean> {
+		if (loading.value || hasBlockingDraft.value || !isDirty.value) return !hasBlockingDraft.value
+		try {
+			await saveMutation.mutateAsync()
+			return true
+		} catch {
+			return false
+		}
+	}
+
+	function editorRequest(): UpdateGameSettingsRequest | null {
+		if (!baseState.value || !draftState.value) return null
+		return {
+			expected_summary_revision: draftState.value.summary_revision,
+			expected_canonical_revision: draftState.value.canonical_revision,
+			expected_catalog_revision: draftState.value.catalog_revision,
+			changes: dirtyChanges.value,
+		}
+	}
+
+	function setCanonicalValue(optionId: string, value: GameOptionCanonicalValue | null) {
+		if (!draftState.value) return
+		const currentSetting = draftState.value.settings.find(
+			(setting) => setting.option_id === optionId,
+		)
+		const baseSetting = baseState.value?.settings.find((setting) => setting.option_id === optionId)
+		if (!currentSetting) return
+
+		const revertedToBase =
+			!!baseSetting &&
+			!canonicalValuesEqual(currentSetting.canonical_value, baseSetting.canonical_value) &&
+			canonicalValuesEqual(value, baseSetting.canonical_value)
+		const touchedOptionIds = new Set(touchedValueOptionIds.value)
+		if (revertedToBase) {
+			touchedOptionIds.delete(optionId)
+		} else {
+			touchedOptionIds.add(optionId)
+		}
+		touchedValueOptionIds.value = touchedOptionIds
+		draftState.value.settings = draftState.value.settings.map((setting) =>
+			setting.option_id === optionId
+				? {
+						...setting,
+						canonical_value: value,
+						value_state: revertedToBase ? baseSetting.value_state : value ? 'canonical' : 'unset',
+						validation_error: revertedToBase ? baseSetting.validation_error : null,
+					}
+				: setting,
+		)
+		schedulePreview()
+	}
+
+	function mergePreview(preview: GameSettingsEditorState) {
+		if (!baseState.value || !draftState.value) return
+		const previousBase = cloneGameSettingsState(baseState.value)
+		const previousDraft = cloneGameSettingsState(draftState.value)
+		const dirtyIds = new Set(
+			gameSettingChanges(previousBase, previousDraft, touchedValueOptionIds.value).map(
+				(change) => change.option_id,
+			),
+		)
+		const stagedSettings = new Map(
+			previousDraft.settings
+				.filter((setting) => dirtyIds.has(setting.option_id))
+				.map((setting) => [setting.option_id, setting]),
+		)
+		const previousBaseSettings = new Map(
+			previousBase.settings.map((setting) => [setting.option_id, setting]),
+		)
+		const nextBase = cloneGameSettingsState(preview)
+		const nextDraft = cloneGameSettingsState(preview)
+		nextBase.settings = nextBase.settings.map((setting) =>
+			dirtyIds.has(setting.option_id)
+				? { ...(previousBaseSettings.get(setting.option_id) ?? setting) }
+				: setting,
+		)
+		nextDraft.settings = nextDraft.settings.map((setting): EditableGameSetting => {
+			const staged = stagedSettings.get(setting.option_id)
+			if (!staged) return setting
+			return {
+				...setting,
+				sync_enabled: staged.sync_enabled,
+				canonical_value: staged.canonical_value,
+				option_revision: staged.option_revision,
+			}
+		})
+		baseState.value = nextBase
+		draftState.value = nextDraft
+	}
+
+	async function preview() {
+		const request = editorRequest()
+		if (!request || request.changes.length === 0) {
+			previewGeneration++
+			if (baseState.value) draftState.value = cloneGameSettingsState(baseState.value)
+			return
+		}
+
+		const generation = ++previewGeneration
+		try {
+			const previewState = await previewMutation.mutateAsync({
+				instanceId: editorInstanceId.value,
+				request,
+			})
+			if (generation !== previewGeneration) return
+			mergePreview(previewState)
+		} catch {
+			return
+		}
+	}
+
+	function applyChangesToRefreshedState(
+		refreshed: GameSettingsEditorState,
+		stagedDraft: GameSettingsEditorState,
+		changes: GameSettingChange[],
+		touchedOptionIds: ReadonlySet<string>,
+		conflictOptionIds: ReadonlySet<string> = new Set(),
+	) {
+		const changesById = new Map(changes.map((change) => [change.option_id, change]))
+		const stagedSettings = new Map(
+			stagedDraft.settings.map((setting) => [setting.option_id, setting]),
+		)
+		const nextBase = cloneGameSettingsState(refreshed)
+		const nextDraft = cloneGameSettingsState(refreshed)
+
+		nextDraft.settings = nextDraft.settings.map((setting) => {
+			const change = changesById.get(setting.option_id)
+			const staged = stagedSettings.get(setting.option_id)
+			if (!change || !staged) return setting
+
+			return {
+				...setting,
+				...(change.sync_enabled !== undefined ? { sync_enabled: staged.sync_enabled } : {}),
+				...(change.canonical_value !== undefined
+					? {
+							canonical_value: staged.canonical_value,
+							value_state: staged.value_state,
+						}
+					: {}),
+				validation_error: conflictOptionIds.has(setting.option_id)
+					? 'changed_since_opened'
+					: staged.validation_error,
+			}
+		})
+
+		baseState.value = nextBase
+		draftState.value = nextDraft
+		touchedValueOptionIds.value = new Set(
+			[...touchedOptionIds].filter(
+				(optionId) => changesById.get(optionId)?.canonical_value !== undefined,
+			),
+		)
+	}
+
+	async function saveDraft() {
+		const request = editorRequest()
+		if (!request || request.changes.length === 0 || !baseState.value || !draftState.value) return
+
+		cancelPreview()
+		const targetInstanceId = editorInstanceId.value
+		const generation = ++saveGeneration
+		const previousBase = cloneGameSettingsState(baseState.value)
+		const optimisticState = cloneGameSettingsState(draftState.value)
+		const previouslyTouchedOptionIds = new Set(touchedValueOptionIds.value)
+		baseState.value = cloneGameSettingsState(optimisticState)
+		touchedValueOptionIds.value = new Set()
+		try {
+			await queryClient.cancelQueries({
+				queryKey: gameSettingsQueryOptions(targetInstanceId).queryKey,
+			})
+			const result = targetInstanceId
+				? await save_local_game_option_changes(targetInstanceId, request)
+				: await save_synced_game_option_changes(request)
+			const refreshed =
+				result.state ??
+				(targetInstanceId
+					? await get_local_game_options_config(targetInstanceId)
+					: await get_synced_game_options_config())
+			queryClient.setQueryData(gameSettingsQueryOptions(targetInstanceId).queryKey, refreshed)
+			if (targetInstanceId) {
+				void queryClient.invalidateQueries({ queryKey: gameSettingsKeys.synced })
+			}
+			if (result.conflicts?.length) {
+				if (generation !== saveGeneration || !draftState.value) return
+				previewGeneration++
+				const stagedDraft = cloneGameSettingsState(draftState.value)
+				const retainedTouchedOptionIds = new Set([
+					...previouslyTouchedOptionIds,
+					...touchedValueOptionIds.value,
+				])
+				const stagedChanges = gameSettingChanges(
+					previousBase,
+					stagedDraft,
+					retainedTouchedOptionIds,
+				)
+				const conflicts = new Set(result.conflicts)
+				applyChangesToRefreshedState(
+					refreshed,
+					stagedDraft,
+					stagedChanges,
+					retainedTouchedOptionIds,
+					conflicts,
+				)
+
+				addNotification({
+					type: 'warning',
+					title: formatMessage(messages.conflictTitle),
+					text: formatMessage(messages.conflictText),
+				})
+				if (isDirty.value) {
+					schedulePreview()
+				}
+				return
+			}
+
+			if (generation !== saveGeneration) {
+				onSaved()
+				return
+			}
+			if (!baseState.value || !draftState.value) return
+			previewGeneration++
+			const stagedDraft = cloneGameSettingsState(draftState.value)
+			const touchedSinceSave = new Set(touchedValueOptionIds.value)
+			const changesSinceSave = gameSettingChanges(optimisticState, stagedDraft, touchedSinceSave)
+			applyChangesToRefreshedState(refreshed, stagedDraft, changesSinceSave, touchedSinceSave)
+			if (changesSinceSave.length > 0) schedulePreview()
+			onSaved()
+		} catch (error) {
+			if (generation === saveGeneration && draftState.value) {
+				previewGeneration++
+				baseState.value = previousBase
+				touchedValueOptionIds.value = new Set([
+					...previouslyTouchedOptionIds,
+					...touchedValueOptionIds.value,
+				])
+				if (dirtyChanges.value.length > 0) schedulePreview()
+			}
+			throw error
+		}
+	}
+
+	onScopeDispose(reset)
+
+	return {
+		draftState,
+		isLocalEditor,
+		isDirty,
+		hasBlockingDraft,
+		loading,
+		loadError,
+		saving: saveMutation.isPending,
+		load,
+		reset,
+		cancelChanges,
+		setSyncEnabled,
+		setCanonicalValue,
+		save,
+		saveAndWait,
+	}
+}

apps/app-frontend/src/components/ui/settings/instances/game-settings-modal/use-labels.ts

@@ -0,0 +1,138 @@
+import { useDebugLogger, useVIntl } from '@modrinth/ui'
+import { listen, type UnlistenFn } from '@tauri-apps/api/event'
+import { computed, type MaybeRefOrGetter, onScopeDispose, shallowRef, toValue, watch } from 'vue'
+
+import {
+	type EditableGameSetting,
+	type GameSettingLocaleLabel,
+	get_game_setting_locale_labels,
+} from '@/helpers/game-options'
+
+export function useGameSettingLabels(
+	opened: MaybeRefOrGetter<boolean>,
+	instanceId: MaybeRefOrGetter<string | undefined>,
+	settings: MaybeRefOrGetter<EditableGameSetting[]>,
+) {
+	const debug = useDebugLogger('GameSettingLabels')
+	const { locale } = useVIntl()
+	const labels = shallowRef<Record<string, GameSettingLocaleLabel>>({})
+	const optionIds = computed(() =>
+		toValue(settings)
+			.filter((setting) => setting.kind === 'external')
+			.map((setting) => setting.option_id)
+			.sort(),
+	)
+	let generation = 0
+	let stopListening: UnlistenFn | undefined
+	let refreshSources = false
+
+	debug('setup', { opened: toValue(opened), instanceId: toValue(instanceId), locale: locale.value })
+
+	async function refresh(reason: string) {
+		if (!toValue(opened) || !optionIds.value.length) {
+			debug('refresh skipped', {
+				reason,
+				opened: toValue(opened),
+				optionCount: optionIds.value.length,
+			})
+			return
+		}
+		const request = ++generation
+		const reindex = refreshSources
+		const requestedIds = [...optionIds.value]
+		const started = performance.now()
+		refreshSources = false
+		debug('request started', {
+			request,
+			reason,
+			instanceId: toValue(instanceId),
+			locale: locale.value,
+			reindex,
+			optionIds: requestedIds,
+		})
+		try {
+			const result = await get_game_setting_locale_labels(
+				toValue(instanceId),
+				locale.value,
+				requestedIds,
+				reindex,
+			)
+			const applied = request === generation && toValue(opened)
+			debug('request completed', {
+				request,
+				generation,
+				applied,
+				opened: toValue(opened),
+				elapsedMs: Math.round(performance.now() - started),
+				returnedCount: Object.keys(result.settings).length,
+				missingOptionIds: requestedIds.filter((id) => !result.settings[id]),
+				labelSample: Object.entries(result.settings).slice(0, 8),
+			})
+			if (applied) labels.value = result.settings
+		} catch (error) {
+			debug('request failed', {
+				request,
+				reason,
+				elapsedMs: Math.round(performance.now() - started),
+				error,
+			})
+		}
+	}
+
+	watch(
+		() => toValue(opened),
+		(active, _, onCleanup) => {
+			debug('modal state changed', { active, generation, optionCount: optionIds.value.length })
+			let cancelled = false
+			onCleanup(() => {
+				cancelled = true
+				stopListening?.()
+				stopListening = undefined
+				generation++
+				labels.value = {}
+				debug('modal cleanup: listener removed and labels cleared', { generation })
+			})
+			if (!active) return
+			refreshSources = true
+			debug('registering locale update listener')
+			void listen('game-option-locales-updated', () => {
+				debug('received game-option-locales-updated')
+				void refresh('locale update event')
+			})
+				.then((unlisten) => {
+					debug('locale update listener registered', { cancelled })
+					if (cancelled) unlisten()
+					else {
+						stopListening = unlisten
+						void refresh('listener registered')
+					}
+				})
+				.catch((error) => {
+					debug('locale update listener failed', { cancelled, error })
+					if (!cancelled) void refresh('listener failed')
+				})
+		},
+		{ flush: 'sync' },
+	)
+
+	watch([locale, () => toValue(instanceId), () => optionIds.value.join('\n')], () => {
+		generation++
+		labels.value = {}
+		debug('locale, instance or option IDs changed: labels cleared', {
+			generation,
+			locale: locale.value,
+			instanceId: toValue(instanceId),
+			optionCount: optionIds.value.length,
+		})
+		void refresh('request inputs changed')
+	})
+
+	onScopeDispose(() => {
+		generation++
+		stopListening?.()
+		labels.value = {}
+		debug('scope disposed', { generation })
+	})
+
+	return labels
+}

apps/app-frontend/src/components/ui/settings/instances/servers-modal.vue

@@ -0,0 +1,476 @@
+<script setup lang="ts">
+import {
+	ClipboardCopyIcon,
+	EditIcon,
+	MoreVerticalIcon,
+	NoSignalIcon,
+	RefreshCwIcon,
+	SaveIcon,
+	SearchIcon,
+	SignalIcon,
+	TrashIcon,
+	XIcon,
+} from '@modrinth/assets'
+import {
+	Avatar,
+	Button,
+	type ButtonMenuOption,
+	commonMessages,
+	defineMessages,
+	FilterPills,
+	injectNotificationManager,
+	NewModal,
+	StyledInput,
+	Table,
+	type TableColumn,
+	TeleportOverflowMenu,
+	useVIntl,
+} from '@modrinth/ui'
+import { useMutation, useQuery, useQueryClient } from '@tanstack/vue-query'
+import { computed, nextTick, ref } from 'vue'
+
+import { remove_synced_server, type SyncedServer, update_synced_server } from '@/helpers/instance'
+import { syncedOptionsKeys, syncedServersQueryOptions } from '@/helpers/synced-options'
+import { copyToClipboard } from '@/helpers/utils'
+import {
+	refreshServerData,
+	refreshServers,
+	type ServerData,
+	type ServerWorld,
+} from '@/helpers/worlds'
+
+const { handleError } = injectNotificationManager()
+const { formatMessage } = useVIntl()
+const queryClient = useQueryClient()
+const serverEditorModal = ref<InstanceType<typeof NewModal> | null>(null)
+const editServerModal = ref<InstanceType<typeof NewModal> | null>(null)
+const editedServer = ref<SyncedServer | null>(null)
+const serversQuery = useQuery(syncedServersQueryOptions())
+const syncedServers = computed(() => serversQuery.data.value ?? [])
+const serverData = ref<Record<string, ServerData>>({})
+const serverSearch = ref('')
+const selectedServerFilters = ref<string[]>([])
+
+const messages = defineMessages({
+	serverEditorTitle: {
+		id: 'app.settings.synced-options.multiplayer-servers.editor-title',
+		defaultMessage: 'Edit synced servers',
+	},
+	editServerTitle: {
+		id: 'instance.edit-server.title',
+		defaultMessage: 'Edit server',
+	},
+	serverName: {
+		id: 'app.settings.synced-options.multiplayer-servers.name',
+		defaultMessage: 'Server name',
+	},
+	serverAddress: {
+		id: 'app.settings.synced-options.multiplayer-servers.address',
+		defaultMessage: 'Server address',
+	},
+	searchServers: {
+		id: 'app.settings.synced-options.multiplayer-servers.search',
+		defaultMessage:
+			'Search {count, number} {count, plural, one {synced server} other {synced servers}}...',
+	},
+	serverStatus: {
+		id: 'app.settings.synced-options.multiplayer-servers.status',
+		defaultMessage: 'Status',
+	},
+	onlineFilter: {
+		id: 'app.settings.synced-options.multiplayer-servers.filter-online',
+		defaultMessage: 'Online',
+	},
+	offlineFilter: {
+		id: 'app.settings.synced-options.multiplayer-servers.filter-offline',
+		defaultMessage: 'Offline',
+	},
+	playersOnline: {
+		id: 'app.settings.synced-options.multiplayer-servers.players-online',
+		defaultMessage: '{count, number} online',
+	},
+	noMatchingServers: {
+		id: 'app.settings.synced-options.multiplayer-servers.no-results',
+		defaultMessage: 'No synced servers match your search or filters.',
+	},
+	serverCount: {
+		id: 'app.settings.synced-options.multiplayer-servers.count',
+		defaultMessage: '{count, plural, one {# server} other {# servers}}',
+	},
+	moreServerOptions: {
+		id: 'app.settings.synced-options.multiplayer-servers.more-options',
+		defaultMessage: 'More server options',
+	},
+	copyServerAddress: {
+		id: 'app.settings.synced-options.multiplayer-servers.copy-address',
+		defaultMessage: 'Copy address',
+	},
+	noSyncedServers: {
+		id: 'app.settings.synced-options.multiplayer-servers.empty',
+		defaultMessage: 'No user-added servers are currently synced.',
+	},
+})
+
+const serverWorlds = computed<ServerWorld[]>(() =>
+	syncedServers.value.map((server, index) => ({
+		name: server.name,
+		type: 'server',
+		index,
+		server_id: server.id,
+		address: server.address,
+		pack_status:
+			server.accept_textures === true
+				? 'enabled'
+				: server.accept_textures === false
+					? 'disabled'
+					: 'prompt',
+		display_status: 'normal',
+	})),
+)
+
+type SyncedServerTableColumn = 'server' | 'status' | 'version' | 'actions'
+type SyncedServerTableRow = SyncedServer & {
+	server: string
+	status: 'online' | 'offline'
+	version: string
+	actions: null
+}
+
+const syncedServerColumns = computed<TableColumn<SyncedServerTableColumn>[]>(() => [
+	{
+		key: 'server',
+		label: formatMessage(commonMessages.serverLabel),
+		width: '45%',
+		cellClass: '!h-16',
+	},
+	{
+		key: 'status',
+		label: formatMessage(messages.serverStatus),
+		width: '25%',
+		cellClass: '!h-16',
+	},
+	{
+		key: 'version',
+		label: formatMessage(commonMessages.versionLabel),
+		width: '22%',
+		cellClass: '!h-16',
+	},
+	{
+		key: 'actions',
+		label: formatMessage(commonMessages.actionsLabel),
+		align: 'right',
+		width: '6rem',
+		cellClass: '!h-16',
+	},
+])
+
+const syncedServerFilterOptions = computed(() => [
+	{ id: 'online', label: formatMessage(messages.onlineFilter) },
+	{ id: 'offline', label: formatMessage(messages.offlineFilter) },
+])
+
+const syncedServerRows = computed<SyncedServerTableRow[]>(() =>
+	syncedServers.value.map((server) => ({
+		...server,
+		server: server.name,
+		status: serverData.value[server.address]?.status ? 'online' : 'offline',
+		version: serverData.value[server.address]?.status?.version?.name ?? '',
+		actions: null,
+	})),
+)
+
+const statusFilteredSyncedServerRows = computed(() => {
+	if (selectedServerFilters.value.length === 0) return syncedServerRows.value
+	return syncedServerRows.value.filter((server) =>
+		selectedServerFilters.value.includes(server.status),
+	)
+})
+
+const filteredSyncedServerRows = computed(() => {
+	const search = serverSearch.value.trim().toLocaleLowerCase()
+	if (!search) return statusFilteredSyncedServerRows.value
+	return statusFilteredSyncedServerRows.value.filter(
+		(server) =>
+			server.name.toLocaleLowerCase().includes(search) ||
+			server.address.toLocaleLowerCase().includes(search),
+	)
+})
+
+const refreshMutation = useMutation({
+	mutationFn: () => refreshServers(serverWorlds.value, serverData.value, null),
+	onError: handleError,
+})
+const refreshingAllSyncedServers = refreshMutation.isPending
+const saveMutation = useMutation({
+	mutationFn: update_synced_server,
+	onSuccess: async (_, server) => {
+		queryClient.setQueryData<SyncedServer[]>(syncedOptionsKeys.servers, (servers) =>
+			servers?.map((current) => (current.id === server.id ? { ...server } : current)),
+		)
+		await queryClient.invalidateQueries({ queryKey: ['worlds'] })
+		void refreshSyncedServer(server.address).catch(handleError)
+	},
+	onError: handleError,
+})
+const removeMutation = useMutation({
+	mutationFn: remove_synced_server,
+	onSuccess: async (_, serverId) => {
+		queryClient.setQueryData<SyncedServer[]>(syncedOptionsKeys.servers, (servers) =>
+			servers?.filter((server) => server.id !== serverId),
+		)
+		await queryClient.invalidateQueries({ queryKey: ['worlds'] })
+	},
+	onError: handleError,
+})
+
+async function show() {
+	const result = await serversQuery.refetch()
+	if (result.isError) {
+		handleError(result.error)
+		return
+	}
+	serverSearch.value = ''
+	selectedServerFilters.value = []
+	serverData.value = {}
+	serverEditorModal.value?.show()
+	refreshAllSyncedServers()
+}
+
+function openSyncedServerEditor(server: SyncedServer) {
+	editedServer.value = { ...server }
+	editServerModal.value?.show()
+}
+
+async function saveSyncedServer() {
+	if (!editedServer.value || saveMutation.isPending.value) return
+	try {
+		await saveMutation.mutateAsync({ ...editedServer.value })
+		await nextTick()
+		editServerModal.value?.hide()
+	} catch {
+		return
+	}
+}
+
+async function refreshSyncedServer(address: string) {
+	serverData.value[address] ??= { refreshing: true }
+	await refreshServerData(serverData.value[address], null, address)
+}
+
+function refreshAllSyncedServers() {
+	if (!refreshingAllSyncedServers.value) refreshMutation.mutate()
+}
+
+function syncedServerMenuOptions(server: SyncedServer): ButtonMenuOption[] {
+	return [
+		{
+			id: 'refresh',
+			label: formatMessage(commonMessages.refreshButton),
+			icon: RefreshCwIcon,
+			action: () => refreshSyncedServer(server.address).catch(handleError),
+		},
+		{
+			id: 'copy-address',
+			label: formatMessage(messages.copyServerAddress),
+			icon: ClipboardCopyIcon,
+			action: () => copyToClipboard(server.address),
+		},
+		{
+			id: 'edit',
+			label: formatMessage(commonMessages.editButton),
+			icon: EditIcon,
+			action: () => openSyncedServerEditor(server),
+		},
+		{ type: 'divider' },
+		{
+			id: 'remove',
+			label: formatMessage(commonMessages.removeButton),
+			icon: TrashIcon,
+			tone: 'red',
+			disabled: removeMutation.isPending.value,
+			action: () => removeMutation.mutate(server.id),
+		},
+	]
+}
+
+defineExpose({ show })
+</script>
+
+<template>
+	<NewModal
+		ref="serverEditorModal"
+		:header="formatMessage(messages.serverEditorTitle)"
+		no-padding
+		max-width="min(928px, calc(100vw - 2rem))"
+		width="min(928px, calc(100vw - 2rem))"
+	>
+		<div class="flex max-h-[min(600px,calc(95vh-10rem))] flex-col">
+			<div
+				class="flex shrink-0 flex-col gap-4 border-0 border-b border-solid border-surface-4 px-6 py-4"
+			>
+				<StyledInput
+					v-model="serverSearch"
+					:icon="SearchIcon"
+					type="search"
+					autocomplete="off"
+					:spellcheck="false"
+					:placeholder="formatMessage(messages.searchServers, { count: syncedServers.length })"
+					size="medium"
+					:aria-label="formatMessage(messages.searchServers, { count: syncedServers.length })"
+					:clear-label="formatMessage(commonMessages.clearButton)"
+					clearable
+				/>
+
+				<div class="flex flex-wrap items-center justify-between gap-3">
+					<FilterPills v-model="selectedServerFilters" :options="syncedServerFilterOptions">
+						<template #all>
+							{{ formatMessage(commonMessages.allProjectType) }}
+						</template>
+					</FilterPills>
+					<Button
+						type="quiet"
+						:disabled="refreshingAllSyncedServers || syncedServers.length === 0"
+						interaction="none"
+						@click="refreshAllSyncedServers"
+					>
+						<RefreshCwIcon
+							:class="{ 'animate-spin': refreshingAllSyncedServers }"
+							aria-hidden="true"
+						/>
+						{{ formatMessage(commonMessages.refreshButton) }}
+					</Button>
+				</div>
+			</div>
+
+			<div class="flex min-h-0 flex-1 flex-col overflow-hidden">
+				<div
+					v-if="syncedServers.length === 0"
+					class="flex flex-1 items-center justify-center p-8 text-center text-[var(--color-text-tertiary)]"
+				>
+					{{ formatMessage(messages.noSyncedServers) }}
+				</div>
+				<div
+					v-else-if="filteredSyncedServerRows.length === 0"
+					class="flex flex-1 items-center justify-center p-8 text-center text-[var(--color-text-tertiary)]"
+				>
+					{{ formatMessage(messages.noMatchingServers) }}
+				</div>
+				<div v-else class="min-h-0 flex-1 overflow-y-auto">
+					<Table
+						:columns="syncedServerColumns"
+						:data="filteredSyncedServerRows"
+						row-key="id"
+						table-min-width="44rem"
+						class="!rounded-none !border-0"
+					>
+						<template #cell-server="{ row }">
+							<div class="flex min-w-0 items-center gap-3">
+								<Avatar
+									:src="serverData[row.address]?.status?.favicon"
+									:alt="row.name"
+									:tint-by="row.address"
+									size="32px"
+									no-shadow
+									class="shrink-0 !rounded-lg"
+								/>
+								<div class="flex min-w-0 flex-col">
+									<span class="truncate font-semibold text-[var(--color-text-primary)]">{{
+										row.name
+									}}</span>
+									<span class="truncate text-sm text-[var(--color-text-tertiary)]">{{
+										row.address
+									}}</span>
+								</div>
+							</div>
+						</template>
+						<template #cell-status="{ row }">
+							<span class="inline-flex items-center gap-1.5 font-medium">
+								<RefreshCwIcon
+									v-if="serverData[row.address]?.refreshing"
+									class="size-4 shrink-0 animate-spin"
+									aria-hidden="true"
+								/>
+								<SignalIcon
+									v-else-if="serverData[row.address]?.status"
+									class="size-4 shrink-0 text-green"
+									aria-hidden="true"
+								/>
+								<NoSignalIcon v-else class="size-4 shrink-0" aria-hidden="true" />
+								<template v-if="serverData[row.address]?.refreshing">
+									{{ formatMessage(commonMessages.loadingLabel) }}
+								</template>
+								<template v-else-if="serverData[row.address]?.status">
+									{{
+										formatMessage(messages.playersOnline, {
+											count: serverData[row.address]?.status?.players?.online ?? 0,
+										})
+									}}
+								</template>
+								<template v-else>{{ formatMessage(messages.offlineFilter) }}</template>
+							</span>
+						</template>
+						<template #cell-version="{ row }">
+							<span class="block truncate">{{ row.version || '—' }}</span>
+						</template>
+						<template #cell-actions="{ row }">
+							<div class="flex justify-end">
+								<TeleportOverflowMenu
+									type="quiet"
+									:label="formatMessage(messages.moreServerOptions)"
+									:options="syncedServerMenuOptions(row)"
+								>
+									<MoreVerticalIcon aria-hidden="true" />
+								</TeleportOverflowMenu>
+							</div>
+						</template>
+					</Table>
+				</div>
+			</div>
+
+			<div
+				class="flex shrink-0 items-center border-0 border-t border-solid border-surface-4 px-6 py-4"
+			>
+				<span class="font-medium text-[var(--color-text-default)]">
+					{{ formatMessage(messages.serverCount, { count: syncedServers.length }) }}
+				</span>
+			</div>
+		</div>
+	</NewModal>
+
+	<NewModal
+		ref="editServerModal"
+		:header="formatMessage(messages.editServerTitle)"
+		:disable-close="saveMutation.isPending.value"
+		max-width="500px"
+		width="500px"
+	>
+		<div v-if="editedServer" class="flex flex-col gap-4">
+			<label class="flex flex-col gap-2 font-semibold text-[var(--color-text-primary)]">
+				{{ formatMessage(messages.serverName) }}
+				<StyledInput v-model="editedServer.name" autocomplete="off" wrapper-class="w-full" />
+			</label>
+			<label class="flex flex-col gap-2 font-semibold text-[var(--color-text-primary)]">
+				{{ formatMessage(messages.serverAddress) }}
+				<StyledInput v-model="editedServer.address" autocomplete="off" wrapper-class="w-full" />
+			</label>
+		</div>
+		<template #actions>
+			<div class="flex justify-end gap-2">
+				<Button type="outlined" @click="editServerModal?.hide()">
+					<XIcon aria-hidden="true" />
+					{{ formatMessage(commonMessages.cancelButton) }}
+				</Button>
+				<Button
+					type="colored"
+					color="brand"
+					:disabled="!editedServer?.address"
+					:loading="saveMutation.isPending.value"
+					@click="saveSyncedServer"
+				>
+					<SaveIcon aria-hidden="true" />
+					{{ formatMessage(commonMessages.saveChangesButton) }}
+				</Button>
+			</div>
+		</template>
+	</NewModal>
+</template>

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

@@ -3,6 +3,7 @@ import type { MessageDescriptor } from '@modrinth/ui'
 export type SettingsCategoryId =
 	| 'interface'
 	| 'home-navigation'
+	| 'shortcut-settings'
 	| 'language-translation'
 	| 'ai'
 	| 'java-performance'
@@ -13,6 +14,7 @@ export type SettingsCategoryId =
 	| 'updates'
 	| 'about'
 	| 'feature-flags'
+	| 'logs'
 
 export type SettingsGroupId = 'launcher' | 'game' | 'data-privacy' | 'support' | 'developer'
 
@@ -44,6 +46,15 @@ export const settingsCategoryDefinitions: SettingsCategoryDefinition[] = [
 		group: 'launcher',
 		onboardingId: 'settings-tab-home-navigation',
 	},
+	{
+		id: 'shortcut-settings',
+		name: {
+			id: 'app.settings.tabs.shortcut-settings',
+			defaultMessage: 'Keyboard shortcuts',
+		},
+		group: 'launcher',
+		onboardingId: 'settings-tab-shortcut-settings',
+	},
 	{
 		id: 'language-translation',
 		name: {
@@ -116,6 +127,11 @@ export const settingsCategoryDefinitions: SettingsCategoryDefinition[] = [
 		name: { id: 'app.settings.tabs.about', defaultMessage: 'About' },
 		group: 'support',
 	},
+	{
+		id: 'logs',
+		name: { id: 'app.settings.tabs.logs', defaultMessage: 'Logs' },
+		group: 'support',
+	},
 	{
 		id: 'feature-flags',
 		name: {

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

@@ -3,9 +3,11 @@ import {
 	BotIcon,
 	CoffeeIcon,
 	CpuIcon,
+	FileTextIcon,
 	GameIcon,
 	GaugeIcon,
 	InfoIcon,
+	KeyboardIcon,
 	LanguagesIcon,
 	LayoutTemplateIcon,
 	PaintbrushIcon,
@@ -48,6 +50,10 @@ const categoryContent: Record<SettingsCategoryId, Pick<SettingsCategory, 'icon'
 		icon: LayoutTemplateIcon,
 		content: defineAsyncComponent(() => import('./HomeNavigationSettings.vue')),
 	},
+	'shortcut-settings': {
+		icon: KeyboardIcon,
+		content: defineAsyncComponent(() => import('./KeybindSettings.vue')),
+	},
 	'language-translation': {
 		icon: LanguagesIcon,
 		content: defineAsyncComponent(() => import('./LanguageTranslationSettings.vue')),
@@ -78,6 +84,10 @@ const categoryContent: Record<SettingsCategoryId, Pick<SettingsCategory, 'icon'
 		content: defineAsyncComponent(() => import('./UpdateSettings.vue')),
 	},
 	about: { icon: InfoIcon, content: defineAsyncComponent(() => import('./AboutSettings.vue')) },
+	logs: {
+		icon: FileTextIcon,
+		content: defineAsyncComponent(() => import('./LogsSettings.vue')),
+	},
 	'feature-flags': {
 		icon: ToggleRightIcon,
 		content: defineAsyncComponent(() => import('./FeatureFlagSettings.vue')),

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

@@ -384,6 +384,16 @@ export const settingsSearchEntries: SettingsSearchEntry[] = [
 		categoryId: 'feature-flags',
 		label: message('settings.feature-flags.title', 'Feature flags'),
 	},
+	{
+		id: 'logs-export',
+		categoryId: 'logs',
+		targetId: 'settings-target-logs-export',
+		label: message('app.settings.logs.export.title', 'Export logs'),
+		description: message(
+			'app.settings.logs.export.description',
+			'Package launcher logs with an optional environment summary, instance log, and crash analysis.',
+		),
+	},
 ]
 
 export function validateSettingsSearchEntries(entries = settingsSearchEntries): string[] {

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

@@ -0,0 +1,123 @@
+<script setup lang="ts">
+import { CheckIcon, RotateCounterClockwiseIcon, XIcon } from '@modrinth/assets'
+import {
+	type ArmorPreviewConfig,
+	ArmorTrimPanel,
+	Button,
+	defineMessages,
+	useVIntl,
+} from '@modrinth/ui'
+import { computed, onMounted, onUnmounted } from 'vue'
+
+const messages = defineMessages({
+	title: { id: 'app.skins.armor.title', defaultMessage: 'Armour and trims' },
+	description: {
+		id: 'app.skins.armor.description',
+		defaultMessage: 'Try armour and trims on your skin. Nothing is stored until you save it.',
+	},
+	unsaved: { id: 'app.skins.armor.unsaved', defaultMessage: 'Unsaved changes' },
+	resetToSaved: { id: 'app.skins.armor.reset-to-saved', defaultMessage: 'Reset to saved' },
+	restoreDefaults: {
+		id: 'app.skins.armor.restore-defaults',
+		defaultMessage: 'Restore defaults',
+	},
+	save: { id: 'app.skins.armor.save', defaultMessage: 'Save' },
+	close: { id: 'app.skins.armor.close', defaultMessage: 'Close' },
+})
+
+const draft = defineModel<ArmorPreviewConfig>({ required: true })
+const props = defineProps<{
+	saved: ArmorPreviewConfig
+	/** Stable id shared with the toggle so it can point `aria-controls` here. */
+	panelId: string
+}>()
+const emit = defineEmits<{
+	save: []
+	reset: []
+	defaults: []
+	close: []
+}>()
+
+const { formatMessage } = useVIntl()
+
+/**
+ * The tab is mounted only while it is showing, so this listens exactly for that
+ * window. It listens in the capture phase because the app's own global
+ * shortcuts listen on `window` the same way, and a bubble-phase listener here
+ * would be skipped as soon as anything closer stopped the event. A modal on top
+ * of the page owns Escape while it is up, and focus sits inside it, so the key
+ * is left to it.
+ */
+function handleKeydown(event: KeyboardEvent) {
+	if (event.key !== 'Escape') return
+	if (
+		event.target instanceof Element &&
+		event.target.closest('[role="dialog"], [role="alertdialog"], [aria-modal="true"]')
+	) {
+		return
+	}
+
+	emit('close')
+}
+
+onMounted(() => window.addEventListener('keydown', handleKeydown, true))
+onUnmounted(() => window.removeEventListener('keydown', handleKeydown, true))
+
+const isDirty = computed(() =>
+	Object.entries(draft.value).some(([slot, piece]) => {
+		const applied = props.saved[slot as keyof ArmorPreviewConfig]
+		return (
+			!applied ||
+			applied.material !== piece.material ||
+			applied.trimPattern !== piece.trimPattern ||
+			applied.trimMaterial !== piece.trimMaterial
+		)
+	}),
+)
+</script>
+
+<template>
+	<div
+		:id="panelId"
+		role="region"
+		:aria-label="formatMessage(messages.title)"
+		class="flex min-h-[24rem] flex-col gap-4 rounded-2xl border border-solid border-surface-5 bg-surface-2 p-4"
+	>
+		<header class="flex flex-wrap items-start justify-between gap-3">
+			<div class="min-w-0">
+				<h2 class="m-0 text-lg font-bold text-[var(--color-text-primary)]">
+					{{ formatMessage(messages.title) }}
+				</h2>
+				<p class="m-0 mt-1 text-sm leading-6 text-[var(--color-text-tertiary)]">
+					{{ formatMessage(messages.description) }}
+				</p>
+			</div>
+			<div class="flex shrink-0 flex-wrap items-center gap-2">
+				<span v-if="isDirty" class="text-sm font-semibold text-[var(--color-text-tertiary)]">
+					{{ formatMessage(messages.unsaved) }}
+				</span>
+				<Button type="outlined" @click="emit('close')"
+					><XIcon />{{ formatMessage(messages.close) }}</Button
+				>
+			</div>
+		</header>
+
+		<ArmorTrimPanel v-model="draft" />
+
+		<footer
+			class="mt-auto flex flex-wrap items-center justify-between gap-2 border-0 border-t border-solid border-surface-5 pt-3"
+		>
+			<div class="flex flex-wrap items-center gap-2">
+				<Button type="outlined" :disabled="!isDirty" @click="emit('reset')"
+					><RotateCounterClockwiseIcon />{{ formatMessage(messages.resetToSaved) }}</Button
+				>
+				<Button type="outlined" @click="emit('defaults')">{{
+					formatMessage(messages.restoreDefaults)
+				}}</Button>
+			</div>
+			<Button type="colored" color="brand" :disabled="!isDirty" @click="emit('save')"
+				><CheckIcon />{{ formatMessage(messages.save) }}</Button
+			>
+		</footer>
+	</div>
+</template>

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

@@ -0,0 +1,28 @@
+<script setup lang="ts">
+const { sections = 2, cards = 12 } = defineProps<{
+	sections?: number
+	cards?: number
+}>()
+</script>
+
+<template>
+	<!--
+		Shaped after VirtualSkinSectionList: the same grid breakpoints and card
+		ratio, so the swap to real content does not move anything. Decorative, so
+		it stays out of the accessibility tree.
+	-->
+	<div class="flex flex-col gap-8" aria-hidden="true">
+		<div v-for="section in sections" :key="section" class="flex flex-col gap-4">
+			<div class="h-7 w-44 animate-pulse rounded-lg bg-surface-4" />
+			<div
+				class="grid w-full grid-cols-3 gap-3 min-[1300px]:grid-cols-4 min-[1750px]:grid-cols-5 min-[2050px]:grid-cols-6"
+			>
+				<div
+					v-for="card in cards"
+					:key="card"
+					class="aspect-[31/40] w-full animate-pulse rounded-[20px] bg-surface-4"
+				/>
+			</div>
+		</div>
+	</div>
+</template>

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

@@ -605,3 +605,110 @@ test('skin updates are restricted to known non-Mojang players and validated resu
 	setSkinSiteFrame(null)
 	resetSkinSiteSession()
 })
+
+test('hosted create auto-authenticates the first skin site player when no game account exists', async () => {
+	const previousWindow = Object.getOwnPropertyDescriptor(globalThis, 'window')
+	const calls: Array<{ command: string; args: Record<string, unknown> }> = []
+	let accounts: Array<{
+		account_type: string
+		yggdrasil?: { api_root: string }
+	}> = []
+	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: 'site.jwt.secret',
+						},
+					} as MessageEvent,
+					frame,
+				)
+				return
+			}
+			if (data.type === 'starlight-skin-players-request') {
+				receiveSkinSiteMessage(
+					{
+						origin: SKIN_SITE_ORIGIN,
+						source: frame,
+						data: {
+							type: 'starlight-skin-players-result',
+							requestId: data.requestId,
+							ok: true,
+							players: [
+								{
+									uuid: '11111111-1111-1111-1111-111111111111',
+									name: 'AutoPlayer',
+									isMojang: false,
+									skinState: 'empty',
+								},
+							],
+						},
+					} 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_has_game_account') {
+						return accounts.some(
+							(account) =>
+								account.account_type === 'microsoft' ||
+								(account.account_type === 'yggdrasil' &&
+									account.yggdrasil?.api_root.replace(/\/+$/, '') ===
+										'https://skin.starlight.cool/yggdrasil'),
+						)
+					}
+					if (command === 'plugin:auth|login_skin_site_player') {
+						accounts = [
+							{
+								account_type: 'yggdrasil',
+								yggdrasil: { api_root: 'https://skin.starlight.cool/yggdrasil' },
+							},
+						]
+						return null
+					}
+					if (command === 'plugin:instance|instance_get') return null
+					return command === 'plugin:install|hosted_create' ? 'auto-instance' : null
+				},
+			},
+		},
+	})
+	try {
+		resetSkinSiteSession()
+		setSkinSiteFrame(frame)
+		receiveSkinSiteMessage(
+			{
+				origin: SKIN_SITE_ORIGIN,
+				source: frame,
+				data: {
+					type: 'starlight-skin-session',
+					status: 'signed-in',
+					user: { uuid: 'site-user', username: 'Site' },
+				},
+			} as MessageEvent,
+			frame,
+		)
+		await requestSkinSitePlayers().catch(() => {})
+		assert.equal(await hostedCreate(), 'auto-instance')
+		assert.ok(
+			calls.some(({ command }) => command === 'plugin:auth|login_skin_site_player'),
+			'expected automatic player authentication',
+		)
+	} finally {
+		resetSkinSiteSession()
+		setSkinSiteFrame(null)
+		if (previousWindow) Object.defineProperty(globalThis, 'window', previousWindow)
+		else delete (globalThis as { window?: unknown }).window
+	}
+})

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

@@ -7,15 +7,22 @@ export const UNGROUPED_GROUP_KEY = '__ungrouped__'
 
 export type GridGroupingOption = 'Group' | 'Loader' | 'Game version' | 'None'
 export type GridSortOption =
-	| 'Name'
-	| 'Last played'
-	| 'Date created'
-	| 'Date modified'
-	| 'Game version'
+	'Name' | 'Last played' | 'Date created' | 'Date modified' | 'Game version'
+
+export type GridSortDirection = 'asc' | 'desc'
+
+export const defaultSortDirections: Record<GridSortOption, GridSortDirection> = {
+	Name: 'asc',
+	'Last played': 'desc',
+	'Date created': 'desc',
+	'Date modified': 'desc',
+	'Game version': 'asc',
+}
 
 export interface GridDisplayState {
 	group: GridGroupingOption
 	sortBy: GridSortOption
+	sortDirections: Partial<Record<GridSortOption, GridSortDirection>>
 	collapsedGroups: string[]
 }
 
@@ -38,6 +45,7 @@ export function useGridGrouping<T extends Record<string, unknown>>(
 		{
 			group: 'Group',
 			sortBy: 'Name',
+			sortDirections: {},
 			collapsedGroups: [],
 		},
 		localStorage,
@@ -66,7 +74,7 @@ export function useGridGrouping<T extends Record<string, unknown>>(
 		state.value.collapsedGroups = [...collapsedSections]
 	}
 
-	function sortInstances(instances: T[], sortBy: GridSortOption): T[] {
+	function sortInstances(instances: T[], sortBy: GridSortOption, ascending: boolean): T[] {
 		const sorted = [...instances]
 		const getGameVersion = options.getGameVersion ?? ((i: T) => i.game_version ?? '')
 		const getLastPlayed = options.getLastPlayed ?? ((i: T) => i.last_played ?? 0)
@@ -83,16 +91,19 @@ export function useGridGrouping<T extends Record<string, unknown>>(
 				)
 				break
 			case 'Last played':
-				sorted.sort((a, b) => dayjs(getLastPlayed(b)).diff(dayjs(getLastPlayed(a))))
+				sorted.sort((a, b) => dayjs(getLastPlayed(a)).diff(dayjs(getLastPlayed(b))))
 				break
 			case 'Date created':
-				sorted.sort((a, b) => dayjs(getDateCreated(b)).diff(dayjs(getDateCreated(a))))
+				sorted.sort((a, b) => dayjs(getDateCreated(a)).diff(dayjs(getDateCreated(b))))
 				break
 			case 'Date modified':
-				sorted.sort((a, b) => dayjs(getDateModified(b)).diff(dayjs(getDateModified(a))))
+				sorted.sort((a, b) => dayjs(getDateModified(a)).diff(dayjs(getDateModified(b))))
 				break
 		}
 
+		if (!ascending) {
+			sorted.reverse()
+		}
 		return sorted
 	}
 
@@ -148,11 +159,25 @@ export function useGridGrouping<T extends Record<string, unknown>>(
 	function sortSections(
 		instanceMap: Map<string, T[]>,
 		group: GridGroupingOption,
+		sortBy: GridSortOption,
 	): Map<string, T[]> {
 		if (group !== 'Group' && group !== 'Game version') {
 			return instanceMap
 		}
 
+		if (group === 'Group' && sortBy !== 'Name') {
+			if (instanceMap.has(UNGROUPED_GROUP_KEY) && instanceMap.size > 1) {
+				const ungroupedInstances = instanceMap.get(UNGROUPED_GROUP_KEY)!
+				instanceMap.delete(UNGROUPED_GROUP_KEY)
+				const newMap = new Map<string, T[]>([[UNGROUPED_GROUP_KEY, ungroupedInstances]])
+				for (const [key, instances] of instanceMap) {
+					newMap.set(key, instances)
+				}
+				return newMap
+			}
+			return instanceMap
+		}
+
 		const sortedEntries = [...instanceMap.entries()].sort((a, b) => {
 			if (group === 'Group') {
 				if (a[0] === UNGROUPED_GROUP_KEY && b[0] !== UNGROUPED_GROUP_KEY) return -1
@@ -166,12 +191,30 @@ export function useGridGrouping<T extends Record<string, unknown>>(
 		return instanceMap
 	}
 
+	const sortDirection = computed<GridSortDirection>(() => {
+		return (
+			state.value.sortDirections[state.value.sortBy] ?? defaultSortDirections[state.value.sortBy]
+		)
+	})
+
+	const isSortAscending = computed(() => sortDirection.value === 'asc')
+
+	const toggleSortDirection = () => {
+		const current = sortDirection.value
+		const next: GridSortDirection = current === 'asc' ? 'desc' : 'asc'
+		state.value.sortDirections = {
+			...state.value.sortDirections,
+			[state.value.sortBy]: next,
+		}
+	}
+
 	const filteredResults = computed(() => {
 		const { group = 'Group', sortBy = 'Name' } = state.value
+		const ascending = isSortAscending.value
 
-		const sorted = sortInstances(instances.value, sortBy)
+		const sorted = sortInstances(instances.value, sortBy, ascending)
 		const grouped = groupInstances(sorted, group)
-		return sortSections(grouped, group)
+		return sortSections(grouped, group, sortBy)
 	})
 
 	return {
@@ -180,6 +223,9 @@ export function useGridGrouping<T extends Record<string, unknown>>(
 		filteredResults,
 		isSectionCollapsed,
 		setSectionCollapsed,
+		sortDirection,
+		isSortAscending,
+		toggleSortDirection,
 		UNGROUPED_GROUP_KEY,
 	}
-}
+}

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

@@ -0,0 +1,182 @@
+import { computed, type Ref, ref, watch } from 'vue'
+
+import { instance_groups_listener } from '@/helpers/events'
+import {
+	create_group,
+	delete_group,
+	type InstanceGroupDefinition,
+	type InstanceGroupMembershipUpdate,
+	list_groups,
+	MAX_INSTANCE_GROUP_NAME_LENGTH,
+	rename_group,
+	set_group_memberships,
+	set_group_order,
+} from '@/helpers/instance-groups'
+
+export const FAVORITES_GROUP_ID = 'group:favorites'
+
+export const UNGROUPED_GROUP_ID = 'group:none'
+
+export { MAX_INSTANCE_GROUP_NAME_LENGTH }
+
+export { type InstanceGroupDefinition, type InstanceGroupMembershipUpdate }
+
+export interface InstanceGroupWithMembership {
+	key: string
+	name: string
+	instances: string[]
+}
+
+export function useInstanceGroups(instances: Ref<{ id: string; groups: string[] }[]>) {
+	const libraryGroups = ref<InstanceGroupDefinition[]>([])
+	const libraryGroupsLoaded = ref(false)
+
+	async function fetchGroups() {
+		libraryGroups.value = await list_groups()
+		libraryGroupsLoaded.value = true
+	}
+
+	fetchGroups()
+
+	instance_groups_listener(() => {
+		fetchGroups()
+	})
+
+	const orderedLibraryGroupIds = ref<string[]>([])
+
+	watch(
+		libraryGroups,
+		(groups) => {
+			orderedLibraryGroupIds.value = groups.map((g) => g.id)
+		},
+		{ immediate: true },
+	)
+
+	const instanceGroups = computed(() => {
+		if (!libraryGroupsLoaded.value) {
+			return []
+		}
+
+		const instanceGroupMap = new Map<string, string[]>()
+
+		for (const instance of instances.value) {
+			const groups = instance.groups ?? []
+			for (const groupId of groups) {
+				if (!instanceGroupMap.has(groupId)) {
+					instanceGroupMap.set(groupId, [])
+				}
+				instanceGroupMap.get(groupId)!.push(instance.id)
+			}
+		}
+
+		const allGroupIds = new Set<string>()
+		const groupMap = new Map<string, string[]>()
+
+		for (const groupId of orderedLibraryGroupIds.value) {
+			allGroupIds.add(groupId)
+			groupMap.set(groupId, instanceGroupMap.get(groupId) ?? [])
+		}
+
+		const ungroupedIds: string[] = []
+		for (const instance of instances.value) {
+			const instanceGroups = instance.groups ?? []
+			const isInAnyGroup = instanceGroups.some((g) => allGroupIds.has(g))
+			if (!isInAnyGroup) {
+				ungroupedIds.push(instance.id)
+			}
+		}
+
+		if (ungroupedIds.length > 0) {
+			groupMap.set(UNGROUPED_GROUP_ID, ungroupedIds)
+		}
+
+		return [...groupMap.entries()].map(([key, instances]) => ({
+			key,
+			name:
+				key === UNGROUPED_GROUP_ID
+					? 'Ungrouped'
+					: (libraryGroups.value.find((g) => g.id === key)?.name ?? key),
+			instances,
+		}))
+	})
+
+	const creatingGroup = ref(false)
+	const reorderingGroups = ref(false)
+
+	async function createNewGroup(name: string): Promise<string | null> {
+		creatingGroup.value = true
+		try {
+			const group = await create_group(name)
+			libraryGroups.value = [...libraryGroups.value, group]
+			orderedLibraryGroupIds.value = [...orderedLibraryGroupIds.value, group.id]
+			return group.id
+		} finally {
+			creatingGroup.value = false
+		}
+	}
+
+	async function renameGroupById(id: string, newName: string): Promise<boolean> {
+		if (id === FAVORITES_GROUP_ID) return false
+		const result = await rename_group(id, newName)
+		const idx = libraryGroups.value.findIndex((g) => g.id === id)
+		if (idx !== -1) {
+			libraryGroups.value = [
+				...libraryGroups.value.slice(0, idx),
+				result,
+				...libraryGroups.value.slice(idx + 1),
+			]
+		}
+		return true
+	}
+
+	async function deleteGroupById(id: string): Promise<boolean> {
+		if (id === FAVORITES_GROUP_ID) return false
+		await delete_group(id)
+		libraryGroups.value = libraryGroups.value.filter((g) => g.id !== id)
+		orderedLibraryGroupIds.value = orderedLibraryGroupIds.value.filter((gid) => gid !== id)
+		return true
+	}
+
+	async function reorderGroups(groupIds: string[]): Promise<boolean> {
+		reorderingGroups.value = true
+		try {
+			await set_group_order(groupIds)
+			// Favorites is rendered separately from draggable sections. Keep it in
+			// the local order after a drag even though the backend accepts only the
+			// reorderable group ids; otherwise it appears again as an ordinary
+			// section until the next full group refresh.
+			orderedLibraryGroupIds.value = [
+				FAVORITES_GROUP_ID,
+				...groupIds.filter((id) => id !== FAVORITES_GROUP_ID),
+			]
+			return true
+		} finally {
+			reorderingGroups.value = false
+		}
+	}
+
+	async function setMemberships(updates: InstanceGroupMembershipUpdate[]): Promise<boolean> {
+		await set_group_memberships(updates)
+		return true
+	}
+
+	function groupNameById(id: string): string | undefined {
+		if (id === UNGROUPED_GROUP_ID) return 'Ungrouped'
+		return libraryGroups.value.find((g) => g.id === id)?.name
+	}
+
+	return {
+		libraryGroups,
+		libraryGroupsLoaded,
+		orderedLibraryGroupIds,
+		instanceGroups,
+		creatingGroup,
+		reorderingGroups,
+		createGroup: createNewGroup,
+		renameGroupById,
+		deleteGroupById,
+		reorderGroups,
+		setMemberships,
+		groupNameById,
+	}
+}

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

@@ -0,0 +1,215 @@
+import {
+	type KeyBinding,
+	bindingMatchesKeyboardEvent,
+	bindingMatchesMouseEvent,
+	bindingMatchesWheelEvent,
+	useModalStack,
+} from '@modrinth/ui'
+import { computed, onUnmounted } from 'vue'
+import { useRoute, useRouter } from 'vue-router'
+
+import { useNetworkStatus } from '@/composables/useNetworkStatus'
+import {
+	SCROLL_ACTIONS,
+	SHORTCUT_ACTIONS,
+	type ShortcutAction,
+} from '@/helpers/shortcut-actions'
+import { resolveAllBindings } from '@/helpers/shortcut-bindings'
+import { getNavShortcutEnabled } from '@/helpers/nav-shortcut-state'
+import { getQuickScrollEnabled } from '@/helpers/scroll-top-state'
+import { useTheming } from '@/store/theme'
+
+/** Editing surfaces keep these keys for themselves. */
+function isEditableTarget(target: EventTarget | null) {
+	return (
+		target instanceof HTMLInputElement ||
+		target instanceof HTMLTextAreaElement ||
+		target instanceof HTMLSelectElement ||
+		(target instanceof HTMLElement && target.isContentEditable)
+	)
+}
+
+function scrollsAtOwnLevel(element: Element) {
+	const { overflowY } = getComputedStyle(element)
+	return /(auto|scroll|overlay)/.test(overflowY) && element.scrollHeight > element.clientHeight
+}
+
+/** A container that scrolls the page itself rather than a widget on it. */
+function isPageScroller(element: Element) {
+	return scrollsAtOwnLevel(element) && element.clientHeight >= window.innerHeight / 2
+}
+
+/** Nearest scrolling ancestor, whatever its size. */
+function nearestScrollContainer(target: EventTarget | null) {
+	let element = target instanceof Element ? target : null
+	while (element) {
+		if (scrollsAtOwnLevel(element)) return element
+		element = element.parentElement
+	}
+	return null
+}
+
+/**
+ * The page's own scroller. Most pages scroll inside `.app-viewport`, but some
+ * screens (settings, consoles, studios) turn that element's scrolling off and
+ * host a full-height container inside it, so fall back to whatever fills the
+ * middle of the viewport.
+ */
+function resolvePageScroller() {
+	const viewport = document.querySelector<HTMLElement>('.app-viewport')
+	if (!viewport) return null
+	if (isPageScroller(viewport)) return viewport
+
+	const bounds = viewport.getBoundingClientRect()
+	let element: Element | null = document.elementFromPoint(
+		bounds.left + bounds.width / 2,
+		bounds.top + bounds.height / 2,
+	)
+	while (element) {
+		if (isPageScroller(element)) return element
+		element = element.parentElement
+	}
+
+	return viewport
+}
+
+export function setupKeyboardShortcuts() {
+	const themeStore = useTheming()
+	const { hasModal } = useModalStack()
+	const route = useRoute()
+	const router = useRouter()
+	const { offline } = useNetworkStatus()
+
+	themeStore.quickScrollEnabled = getQuickScrollEnabled()
+	for (const shortcut of SHORTCUT_ACTIONS) {
+		if (shortcut.group === 'nav') themeStore[shortcut.enabledField] = getNavShortcutEnabled(shortcut.id)
+	}
+	themeStore.shortcutBindings = resolveAllBindings()
+
+	/** The combination an action answers to now: recorded if there is one, default otherwise. */
+	function bindingFor(action: ShortcutAction): KeyBinding {
+		return themeStore.shortcutBindings[action.id] ?? action.defaultBinding
+	}
+
+	/** Whether an action is switched on and reachable in the current state. */
+	function shortcutIsAvailable(action: ShortcutAction): boolean {
+		if (!themeStore[action.enabledField]) return false
+		return !action.unavailable?.({
+			worldsTabEnabled: themeStore.featureFlags.worlds_tab,
+			offline: offline.value,
+		})
+	}
+
+	function findShortcut<E extends Event>(
+		event: E,
+		matches: (binding: KeyBinding, event: E) => boolean,
+		{ includeDisabled = false }: { includeDisabled?: boolean } = {},
+	): ShortcutAction | null {
+		if (hasModal.value) return null
+		if (isEditableTarget(event.target)) return null
+
+		for (const action of SHORTCUT_ACTIONS) {
+			if (!includeDisabled && !shortcutIsAvailable(action)) continue
+			if (matches(bindingFor(action), event)) return action
+		}
+
+		return null
+	}
+
+	/** Does what an action is for. Scrolling actions move the page's own scroller. */
+	function runShortcut(action: ShortcutAction, event: Event) {
+		if (action.target) {
+			router.push(action.target(route))
+			return
+		}
+
+		const focusedContainer = nearestScrollContainer(event.target)
+		if (focusedContainer && !isPageScroller(focusedContainer)) return
+
+		const scroller = resolvePageScroller()
+		if (!scroller) return
+
+		action.applyScroll?.(scroller)
+	}
+
+	function handleScrollShortcutKey(event: KeyboardEvent) {
+		if (event.isComposing) return
+
+		const match = findShortcut(event, bindingMatchesKeyboardEvent, { includeDisabled: true })
+		if (match?.group !== 'scroll') return
+
+		const focusedContainer = nearestScrollContainer(event.target)
+		if (focusedContainer && !isPageScroller(focusedContainer)) return
+
+		const scroller = resolvePageScroller()
+		if (!scroller) return
+
+		event.preventDefault()
+		if (!shortcutIsAvailable(match)) return
+
+		match.applyScroll?.(scroller)
+	}
+
+	function handleNavShortcutKey(event: KeyboardEvent) {
+		if (event.isComposing) return
+
+		const match = findShortcut(event, bindingMatchesKeyboardEvent)
+		if (match?.group !== 'nav') return
+
+		event.preventDefault()
+		runShortcut(match, event)
+	}
+
+	const hasPointerBindings = computed(() =>
+		SHORTCUT_ACTIONS.some((action) => bindingFor(action).device === 'mouse'),
+	)
+
+	function handleShortcutMouse(event: MouseEvent) {
+		if (!hasPointerBindings.value) return
+
+		const match = findShortcut(event, bindingMatchesMouseEvent)
+		if (!match) return
+
+		event.preventDefault()
+		event.stopPropagation()
+		runShortcut(match, event)
+	}
+
+	function handleShortcutWheel(event: WheelEvent) {
+		if (!hasPointerBindings.value) return
+
+		const match = findShortcut(event, bindingMatchesWheelEvent)
+		if (!match) return
+
+		event.preventDefault()
+		event.stopPropagation()
+		runShortcut(match, event)
+	}
+
+	function handleGlobalKeydown(event: KeyboardEvent) {
+		const key = event.key.toLowerCase()
+		const isFindShortcut = key === 'f' && (event.ctrlKey || event.metaKey)
+		const isBlockedDevtoolsShortcut = event.key === 'F12' && !themeStore.devMode
+
+		if (isFindShortcut || isBlockedDevtoolsShortcut) {
+			event.preventDefault()
+			event.stopPropagation()
+		}
+
+		handleScrollShortcutKey(event)
+		handleNavShortcutKey(event)
+	}
+
+	window.addEventListener('keydown', handleGlobalKeydown, true)
+	window.addEventListener('mousedown', handleShortcutMouse, true)
+	// Not passive: a bound wheel direction has to keep the page from scrolling.
+	window.addEventListener('wheel', handleShortcutWheel, { capture: true, passive: false })
+
+	onUnmounted(() => {
+		window.removeEventListener('keydown', handleGlobalKeydown, true)
+		window.removeEventListener('mousedown', handleShortcutMouse, true)
+		window.removeEventListener('wheel', handleShortcutWheel, { capture: true, passive: false })
+	})
+
+	return { bindingFor, shortcutIsAvailable, SCROLL_ACTIONS }
+}

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

@@ -0,0 +1,75 @@
+interface InstanceProperties {
+	loader: string
+	game_version: string
+}
+
+interface ProjectProperties extends InstanceProperties {
+	id: string
+	project_type: string
+}
+
+type AnalyticsEventMap = {
+	Launched: { version: string; dev: boolean; onboarded: boolean }
+	PageView: { path: string; fromPath: string; failed: unknown }
+	InstanceCreate: { source: string }
+	InstanceCreateStart: { source: string }
+	InstanceStart: InstanceProperties & { source: string }
+	InstanceStop: Partial<InstanceProperties> & { source?: string }
+	InstanceDuplicate: InstanceProperties
+	InstanceRepair: InstanceProperties
+	InstanceSetIcon: Record<string, never>
+	InstanceRemoveIcon: Record<string, never>
+	InstanceUpdateAll: InstanceProperties & { count: number; selected: boolean }
+	InstanceProjectUpdate: InstanceProperties & { id: string; name: string; project_type: string }
+	InstanceProjectDisable: InstanceProperties & {
+		id: string
+		name: string
+		project_type: string
+		disabled: boolean
+	}
+	InstanceProjectRemove: InstanceProperties & { id: string; name: string; project_type: string }
+	ProjectInstall: ProjectProperties & { version_id: string; title: string; source: string }
+	ProjectInstallStart: { source: string }
+	PackInstall: { id: string; version_id: string; title: string; source: string }
+	PackInstallStart: Record<string, never>
+	AccountLogIn: { source?: string }
+	AccountLogOut: Record<string, never>
+	JavaTest: { path: string; success: boolean }
+	JavaManualSelect: { version: string }
+	JavaAutoDetect: { path: string; version: string }
+	GalleryImageNext: { project_id: string; url: string }
+	GalleryImagePrevious: { project_id: string; url: unknown }
+	GalleryImageExpand: { project_id: string; url: string }
+}
+
+export type AnalyticsEvent = keyof AnalyticsEventMap
+
+let optedIn = false
+let debugEnabled = false
+
+export const initAnalytics = () => {
+	optedIn = true
+}
+
+export const debugAnalytics = () => {
+	debugEnabled = true
+}
+
+export const optOutAnalytics = () => {
+	optedIn = false
+}
+
+export const optInAnalytics = () => {
+	optedIn = true
+}
+
+type OptionalArgs<T> = Record<string, never> extends T ? [properties?: T] : [properties: T]
+
+export const trackEvent = <E extends AnalyticsEvent>(
+	eventName: E,
+	...args: OptionalArgs<AnalyticsEventMap[E]>
+) => {
+	if (optedIn && debugEnabled) {
+		console.debug('[Starlight telemetry disabled]', eventName, args[0])
+	}
+}

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

@@ -0,0 +1,61 @@
+/**
+ * Starlight anniversary helpers.
+ *
+ * Starlight's first release was on 2014-10-04, so every October 4th the
+ * launcher shows a small celebration. The anniversary number is simply
+ * `currentYear - 2014`.
+ */
+
+/** Year of Starlight's first release. */
+export const STARLIGHT_FOUNDING_YEAR = 2014
+
+/** Month (1-12) of Starlight's anniversary. */
+export const STARLIGHT_ANNIVERSARY_MONTH = 10
+
+/** Day of month of Starlight's anniversary. */
+export const STARLIGHT_ANNIVERSARY_DAY = 4
+
+/**
+ * Whether the given date falls on Starlight's anniversary (October 4th).
+ * Uses the local timezone, which is what the launcher user experiences.
+ */
+export function isAnniversary(date: Date = new Date()): boolean {
+	return (
+		date.getMonth() + 1 === STARLIGHT_ANNIVERSARY_MONTH &&
+		date.getDate() === STARLIGHT_ANNIVERSARY_DAY
+	)
+}
+
+/**
+ * The anniversary number for the given date (e.g. 12 for 2026).
+ * Not clamped: callers decide whether to guard against pre-2014 dates.
+ */
+export function anniversaryYear(date: Date = new Date()): number {
+	return date.getFullYear() - STARLIGHT_FOUNDING_YEAR
+}
+
+/**
+ * Whether the celebration should currently be shown.
+ *
+ * Normally this is only true on October 4th, but the developer-page
+ * `force_anniversary_celebration` feature flag forces it on for previewing.
+ */
+export function shouldCelebrate(force = false, date: Date = new Date()): boolean {
+	return force || isAnniversary(date)
+}
+
+/** English ordinal suffix for a number (1 -> "1st", 12 -> "12th"). */
+export function ordinal(n: number): string {
+	const mod100 = n % 100
+	if (mod100 >= 11 && mod100 <= 13) return `${n}th`
+	switch (n % 10) {
+		case 1:
+			return `${n}st`
+		case 2:
+			return `${n}nd`
+		case 3:
+			return `${n}rd`
+		default:
+			return `${n}th`
+	}
+}

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

@@ -82,6 +82,16 @@ export async function instance_bulk_update_progress_listener(callback) {
 	return await listen('instance_bulk_update_progress', (event) => callback(event.payload))
 }
 
+/// Payload for the 'instance_groups_changed' event
+/*
+	InstanceGroupsChangedPayload {
+		instance_ids: string[]
+	}
+*/
+export async function instance_groups_listener(callback) {
+	return await listen('instance_groups_changed', (event) => callback(event.payload))
+}
+
 export async function install_job_listener(callback) {
 	return await listen('install_job', (event) => callback(event.payload))
 }
@@ -150,6 +160,10 @@ export async function notification_listener(callback) {
 	return await listen('notification', (event) => callback(event.payload))
 }
 
+export async function logshare_ai_listener(callback) {
+	return await listen('logshare_ai', (event) => callback(event.payload))
+}
+
 /// Payload for the 'log' event
 /*
     LogPayload {

apps/app-frontend/src/helpers/game-options.ts

@@ -0,0 +1,244 @@
+import { queryOptions } from '@tanstack/vue-query'
+import { invoke } from '@tauri-apps/api/core'
+
+export type GameOptionCanonicalValue =
+	| { type: 'bool'; value: boolean }
+	| { type: 'integer'; value: number }
+	| { type: 'decimal'; value: string }
+	| { type: 'enum'; value: string }
+	| { type: 'text'; value: string }
+	| { type: 'string_list'; value: string[] }
+	| { type: 'key_binding'; value: string }
+	| { type: 'external_raw'; value: string }
+
+export type GameOptionValueState = 'canonical' | 'uniform_local' | 'mixed' | 'unset' | 'invalid'
+
+export type GameOptionCompatibilityStatus =
+	| 'ready'
+	| 'deferred'
+	| 'waiting_for_file'
+	| 'waiting_for_base'
+	| 'not_available'
+	| 'unsupported_value'
+	| 'unmappable'
+	| 'catalog_uncovered'
+	| 'controlled'
+	| 'degraded'
+
+export type GameOptionMappingKind = 'direct' | 'legacy' | 'migrated' | 'lossless' | 'lossy'
+
+export type GameOptionCompatibilityReason =
+	| 'launcher_controlled'
+	| 'catalog_uncovered'
+	| 'inspection_failed'
+	| 'waiting_for_options_file'
+	| 'unsupported_value'
+	| 'migrates_on_write'
+	| 'waiting_for_compatible_base'
+	| 'missing_setting'
+
+export type GameOptionCompatibilityBucket = {
+	instance_count: number
+	write_keys: string[]
+	eventual_keys: string[]
+	game_versions: string[]
+	status: GameOptionCompatibilityStatus
+	mapping?: GameOptionMappingKind | null
+	reason?: GameOptionCompatibilityReason | null
+}
+
+export type GameOptionCompatibilitySummary = {
+	total_participating: number
+	will_receive: number
+	write_now: number
+	left_local: number
+	buckets: GameOptionCompatibilityBucket[]
+}
+
+export type GameOptionEditorChoice = {
+	value: string
+}
+
+export type GameOptionEditor = {
+	type:
+		| 'bool'
+		| 'integer'
+		| 'decimal'
+		| 'enum'
+		| 'text'
+		| 'string_list'
+		| 'key_binding'
+		| 'external_raw'
+	min?: number | null
+	max?: number | null
+	step?: number | null
+	unit?: string | null
+	choices?: GameOptionEditorChoice[]
+}
+
+export type GameSettingCategory = {
+	id: string
+	is_custom?: boolean
+}
+
+export type GameOptionValidationError =
+	'missing_value' | 'no_compatible_instances' | 'invalid_value' | 'changed_since_opened'
+
+export type EditableGameSetting = {
+	option_id: string
+	category_id: string
+	kind: 'vanilla' | 'external'
+	raw_key?: string | null
+	sync_enabled: boolean
+	canonical_value?: GameOptionCanonicalValue | null
+	value_state: GameOptionValueState
+	option_revision: number
+	editor: GameOptionEditor
+	compatibility: GameOptionCompatibilitySummary
+	validation_error?: GameOptionValidationError | null
+	controlled?: boolean
+}
+
+export type GameSettingsEditorState = {
+	summary_revision: string
+	canonical_revision: number
+	catalog_revision: number
+	total_participating: number
+	categories: GameSettingCategory[]
+	settings: EditableGameSetting[]
+}
+
+export type GameSettingChange = {
+	option_id: string
+	base_option_revision: number
+	sync_enabled?: boolean
+	canonical_value?: GameOptionCanonicalValue | null
+}
+
+export type UpdateGameSettingsRequest = {
+	expected_summary_revision: string
+	expected_canonical_revision: number
+	expected_catalog_revision: number
+	changes: GameSettingChange[]
+}
+
+export type GameOptionsSourceCandidate = {
+	source_id: string
+	instance_id: string
+	name: string
+	icon_path?: string | null
+	game_version?: string | null
+	eligible: boolean
+	disabled_reason?: GameOptionsSourceDisabledReason | null
+	recognized_setting_count: number
+	custom_setting_count: number
+}
+
+export type GameOptionsSourceDisabledReason =
+	| 'installing_or_updating'
+	| 'unsupported_version'
+	| 'missing_options_file'
+	| 'no_syncable_settings'
+	| 'unreadable_options_file'
+
+export type SaveGameSettingsResult = {
+	state?: GameSettingsEditorState
+	applied: number
+	migrated: number
+	deferred: number
+	unsupported: number
+	failed: number
+	conflicts?: string[]
+}
+
+export type GameSettingLocaleLabel = {
+	label: string
+	choices: Record<string, string>
+	source?: GameSettingSource | null
+}
+
+export type GameSettingSource = {
+	instance_id: string
+	file_name: string
+	file_path: string
+	project: {
+		id: string
+		title: string
+		icon_url: string | null
+	} | null
+}
+
+export async function get_game_setting_locale_labels(
+	instanceId: string | undefined,
+	locale: string,
+	optionIds: string[],
+	refreshSources = false,
+): Promise<{ settings: Record<string, GameSettingLocaleLabel> }> {
+	return await invoke('plugin:instance|instance_get_game_setting_locale_labels', {
+		instanceId,
+		locale,
+		optionIds,
+		refreshSources,
+	})
+}
+
+export async function list_game_options_sync_sources(): Promise<GameOptionsSourceCandidate[]> {
+	return await invoke('plugin:instance|instance_list_game_options_sync_sources')
+}
+
+export async function get_synced_game_options_config(): Promise<GameSettingsEditorState> {
+	return await invoke('plugin:instance|instance_get_synced_game_options_config')
+}
+
+export const gameSettingsKeys = {
+	synced: ['game-settings', 'synced'] as const,
+	local: (instanceId: string) => ['game-settings', 'local', instanceId] as const,
+}
+
+export function gameSettingsQueryOptions(instanceId?: string) {
+	return queryOptions({
+		queryKey: instanceId ? gameSettingsKeys.local(instanceId) : gameSettingsKeys.synced,
+		queryFn: () =>
+			instanceId ? get_local_game_options_config(instanceId) : get_synced_game_options_config(),
+		staleTime: 30_000,
+		retry: false,
+	})
+}
+
+export async function preview_synced_game_option_changes(
+	request: UpdateGameSettingsRequest,
+): Promise<GameSettingsEditorState> {
+	return await invoke('plugin:instance|instance_preview_synced_game_option_changes', { request })
+}
+
+export async function save_synced_game_option_changes(
+	request: UpdateGameSettingsRequest,
+): Promise<SaveGameSettingsResult> {
+	return await invoke('plugin:instance|instance_save_synced_game_option_changes', { request })
+}
+
+export async function get_local_game_options_config(
+	instanceId: string,
+): Promise<GameSettingsEditorState> {
+	return await invoke('plugin:instance|instance_get_local_game_options_config', { instanceId })
+}
+
+export async function preview_local_game_option_changes(
+	instanceId: string,
+	request: UpdateGameSettingsRequest,
+): Promise<GameSettingsEditorState> {
+	return await invoke('plugin:instance|instance_preview_local_game_option_changes', {
+		instanceId,
+		request,
+	})
+}
+
+export async function save_local_game_option_changes(
+	instanceId: string,
+	request: UpdateGameSettingsRequest,
+): Promise<SaveGameSettingsResult> {
+	return await invoke('plugin:instance|instance_save_local_game_option_changes', {
+		instanceId,
+		request,
+	})
+}

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

@@ -2,10 +2,13 @@ import { invoke } from '@tauri-apps/api/core'
 
 import {
 	requestSkinSiteDownloadToken,
+	requestSkinSitePlayers,
+	skinSitePlayers,
 	skinSiteStatus,
 	skinSiteUser,
 	waitForSkinSiteSession,
 } from '../composables/skin-site-session.ts'
+import { authenticateInstancePlayer } from './instance-player.ts'
 
 export const HOSTED_ACCOUNT_REQUIRED_MESSAGE = '您需要登录正版或皮肤站账号后才能操作'
 
@@ -24,10 +27,36 @@ function startHostedPackAttempt(instanceId: string) {
 }
 
 export async function requireHostedGameAccount(): Promise<void> {
-	const available = await invokeHosted<boolean>('plugin:install|hosted_has_game_account')
-	if (!available) {
-		throw new Error(HOSTED_ACCOUNT_REQUIRED_MESSAGE)
+	if (await invokeHosted<boolean>('plugin:install|hosted_has_game_account')) return
+
+	// No game credential yet, but a signed-in skin site already lists the
+	// user's players. Authenticate the first one automatically so the user
+	// does not have to pick a player manually before creating an instance.
+	await waitForSkinSiteSession()
+	if (skinSiteStatus.value === 'signed-in' && skinSiteUser.value) {
+		if (skinSitePlayers.value.length === 0) {
+			await requestSkinSitePlayers().catch(() => {})
+		}
+		const player =
+			skinSitePlayers.value.find((candidate) => !candidate.isMojang) ?? skinSitePlayers.value[0]
+		if (player) {
+			try {
+				await authenticateInstancePlayer({
+					id: player.uuid,
+					name: player.name,
+					account_type: 'yggdrasil',
+					skin_site_user: skinSiteUser.value.uuid,
+				})
+			} catch {
+				// Fall through to the login-required error below.
+			}
+			if (await invokeHosted<boolean>('plugin:install|hosted_has_game_account')) {
+				return
+			}
+		}
 	}
+
+	throw new Error(HOSTED_ACCOUNT_REQUIRED_MESSAGE)
 }
 
 export function clearHostedSession(): Promise<void> {

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

@@ -1 +1,46 @@
-export const MAX_INSTANCE_GROUP_NAME_LENGTH = 256
+import { invoke } from '@tauri-apps/api/core'
+
+export const MAX_INSTANCE_GROUP_NAME_LENGTH = 256
+
+export type InstanceGroupDefinition = {
+	id: string
+	name: string
+}
+
+export type InstanceGroupMembershipUpdate = {
+	instance_id: string
+	group_ids: string[]
+}
+
+export async function list_groups(): Promise<InstanceGroupDefinition[]> {
+	return await invoke('plugin:instance|instance_list_groups')
+}
+
+export async function create_group(name: string): Promise<InstanceGroupDefinition> {
+	return await invoke('plugin:instance|instance_create_group', { name })
+}
+
+export async function rename_group(id: string, newName: string): Promise<InstanceGroupDefinition> {
+	return await invoke('plugin:instance|instance_rename_group', {
+		id,
+		newName,
+	})
+}
+
+export async function delete_group(id: string): Promise<void> {
+	return await invoke('plugin:instance|instance_delete_group', { id })
+}
+
+export async function set_group_order(group_ids: string[]): Promise<void> {
+	return await invoke('plugin:instance|instance_set_group_order', {
+		groupIds: group_ids,
+	})
+}
+
+export async function set_group_memberships(
+	updates: InstanceGroupMembershipUpdate[],
+): Promise<void> {
+	return await invoke('plugin:instance|instance_set_group_memberships', {
+		updates,
+	})
+}

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

@@ -108,6 +108,104 @@ export async function get_many(instanceIds: string[]): Promise<GameInstance[]> {
 	return await invoke('plugin:instance|instance_get_many', { instanceIds })
 }
 
+export function adaptContentItems(items: ContentItem[]): ContentItem[] {
+	return items.map((item) => {
+		const embeddedMetadata = item.embedded_metadata
+		if (!embeddedMetadata?.icon_path) return item
+		return {
+			...item,
+			embedded_metadata: {
+				...embeddedMetadata,
+				icon_url: convertFileSrc(embeddedMetadata.icon_path),
+			},
+		}
+	})
+}
+
+export type SyncedOption =
+	| 'game_options'
+	| 'command_history'
+	| 'multiplayer_servers'
+	| 'creative_hotbars'
+	| 'screenshots'
+	| 'resource_packs'
+	| 'data_packs'
+export type GlobalSyncedOptions = Record<SyncedOption, boolean>
+export type SyncedOptionCapability = {
+	option: SyncedOption
+	supported: boolean
+	disabled_reason: string | null
+}
+export type SyncedOptionJoinPreview = { action: string }
+export type SyncedOptionsOverview = {
+	global_options: GlobalSyncedOptions
+	capabilities: SyncedOptionCapability[]
+}
+export async function get_global_synced_options(): Promise<GlobalSyncedOptions> {
+	return await invoke('plugin:instance|instance_get_synced_options')
+}
+export async function get_initialized_synced_options(): Promise<GlobalSyncedOptions> {
+	return await invoke('plugin:instance|instance_get_initialized_synced_options')
+}
+/**
+ * Every synced option is currently available on every instance. The parameter
+ * stays so callers keep passing the option they are asking about, which is what
+ * a real implementation will need.
+ */
+export function isSyncedOptionAvailable(_option: SyncedOption): boolean {
+	return true
+}
+export async function set_global_synced_option(
+	option: SyncedOption,
+	enabled: boolean,
+	baseInstanceId?: string | null,
+): Promise<GlobalSyncedOptions> {
+	return await invoke('plugin:instance|instance_set_synced_option', {
+		option,
+		enabled,
+		baseInstanceId,
+	})
+}
+export async function set_instance_synced_option(
+	instanceId: string,
+	option: SyncedOption,
+	enabled: boolean,
+	resolution?: string | null,
+): Promise<GameInstance> {
+	return await invoke('plugin:instance|instance_set_instance_synced_option', {
+		instanceId,
+		option,
+		enabled,
+		resolution,
+	})
+}
+export async function get_synced_options_overview(
+	instanceId: string,
+): Promise<SyncedOptionsOverview> {
+	return await invoke('plugin:instance|instance_get_synced_options_overview', { instanceId })
+}
+export async function get_command_history(): Promise<string> {
+	return await invoke('plugin:instance|instance_get_synced_command_history')
+}
+export async function set_command_history(contents: string): Promise<string> {
+	return await invoke('plugin:instance|instance_set_synced_command_history', { contents })
+}
+export type SyncedServer = {
+	id: string
+	name: string
+	address: string
+	accept_textures: boolean | null
+}
+export async function list_synced_servers(): Promise<SyncedServer[]> {
+	return await invoke('plugin:instance|instance_list_synced_servers')
+}
+export async function update_synced_server(server: SyncedServer): Promise<void> {
+	await invoke('plugin:instance|instance_update_synced_server', { server })
+}
+export async function remove_synced_server(id: string): Promise<void> {
+	await invoke('plugin:instance|instance_remove_synced_server', { id })
+}
+
 export async function get_projects(
 	instanceId: string,
 	cacheBehaviour?: CacheBehaviour,

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

@@ -95,6 +95,50 @@ export async function undo_added_mod(instanceId, filename, expectedHash) {
 	return await invoke('plugin:logs|logs_undo_added_mod', { instanceId, filename, expectedHash })
 }
 
+export async function get_log_share_settings() {
+	return await invoke('plugin:logs|logs_get_log_share_settings')
+}
+
+export async function update_log_share_settings(settings) {
+	return await invoke('plugin:logs|logs_update_log_share_settings', { settings })
+}
+
+export async function logshare_upload_crash(instanceId) {
+	return await invoke('plugin:logs|logs_logshare_upload_crash', { instanceId })
+}
+
+export async function logshare_get_insights(id) {
+	return await invoke('plugin:logs|logs_logshare_get_insights', { id })
+}
+
+export async function logshare_analyse_crash_direct(instanceId) {
+	return await invoke('plugin:logs|logs_logshare_analyse_crash_direct', { instanceId })
+}
+
+export async function logshare_ai_analyze_stored(instanceId, id) {
+	return await invoke('plugin:logs|logs_logshare_ai_analyze_stored', { instanceId, id })
+}
+
+export async function logshare_ai_analyze_direct(instanceId) {
+	return await invoke('plugin:logs|logs_logshare_ai_analyze_direct', { instanceId })
+}
+
+export async function logshare_delete(id, token) {
+	return await invoke('plugin:logs|logs_logshare_delete', { id, token })
+}
+
+export async function list_shared_logs() {
+	return await invoke('plugin:logs|logs_list_shared_logs')
+}
+
+export async function record_shared_log(log) {
+	return await invoke('plugin:logs|logs_record_shared_log', { log })
+}
+
+export async function delete_shared_log(id, token) {
+	return await invoke('plugin:logs|logs_delete_shared_log', { id, token })
+}
+
 /// Export the censored files and local analysis from an instance's latest run.
 export async function export_crash_context(instanceId, instanceName) {
 	const timestamp = new Date().toISOString().replace(/[:.]/g, '-')

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

@@ -0,0 +1,14 @@
+const NAV_SHORTCUT_STORAGE_PREFIX = 'starlight-shortcut-nav-'
+
+/**
+ * Whether a navigation shortcut is enabled. Shortcuts are off by default;
+ * each one is turned on individually from the Shortcut settings page.
+ */
+export function getNavShortcutEnabled(id: string): boolean {
+	const value = localStorage.getItem(NAV_SHORTCUT_STORAGE_PREFIX + id)
+	return value === 'true'
+}
+
+export function setNavShortcutEnabled(id: string, enabled: boolean) {
+	localStorage.setItem(NAV_SHORTCUT_STORAGE_PREFIX + id, String(enabled))
+}

apps/app-frontend/src/helpers/remote-announcements.test.ts

@@ -0,0 +1,78 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { mapBroadcastAnnouncements } from './remote-announcements.ts'
+
+test('maps a broadcast entry into a remote announcement', () => {
+	const result = mapBroadcastAnnouncements([
+		{
+			id: 1,
+			title: '维护通知',
+			subtitle: '今晚停机',
+			content: '服务器将于今晚维护。',
+			updateAt: 1791640873710,
+			star: true,
+			importantLevel: 9,
+			source: 'SKIN',
+		},
+	])
+	assert.equal(result?.length, 1)
+	const item = result?.[0]
+	assert.equal(item?.id, '1')
+	assert.equal(item?.title, '维护通知')
+	assert.equal(item?.summary, '今晚停机')
+	assert.equal(item?.priority, 'critical')
+	assert.equal(item?.pinned, true)
+	assert.equal(item?.type, 'modal')
+	assert.equal(item?.published_at, new Date(1791640873710).toISOString())
+	assert.equal(item?.ends_at, null)
+})
+
+test('empty or blank subtitle becomes null summary', () => {
+	const result = mapBroadcastAnnouncements([
+		{ id: 2, title: '公告', subtitle: '  ', content: '内容', updateAt: 1000 },
+	])
+	assert.equal(result?.[0]?.summary, null)
+})
+
+test('skips entries missing required fields', () => {
+	const result = mapBroadcastAnnouncements([
+		{ id: 3, title: '有效', content: '内容', updateAt: 1000 },
+		{ id: 4, title: '', content: '内容', updateAt: 1000 },
+		{ title: '无 id', content: '内容', updateAt: 1000 },
+		{ id: 5, title: '无时间', content: '内容' },
+		null,
+		'不是对象',
+	])
+	assert.equal(result?.length, 1)
+	assert.equal(result?.[0]?.id, '3')
+})
+
+test('clamps importantLevel and maps priority boundaries', () => {
+	const result = mapBroadcastAnnouncements([
+		{ id: 6, title: 'a', content: 'x', updateAt: 1000, importantLevel: 0 },
+		{ id: 7, title: 'b', content: 'x', updateAt: 1000, importantLevel: 3 },
+		{ id: 8, title: 'c', content: 'x', updateAt: 1000, importantLevel: 6 },
+		{ id: 9, title: 'd', content: 'x', updateAt: 1000, importantLevel: 999 },
+	])
+	const byId = new Map(result?.map((item) => [item.id, item.priority]))
+	assert.equal(byId.get('6'), 'low')
+	assert.equal(byId.get('7'), 'normal')
+	assert.equal(byId.get('8'), 'high')
+	assert.equal(byId.get('9'), 'critical')
+})
+
+test('returns null for non-array payloads', () => {
+	assert.equal(mapBroadcastAnnouncements(null), null)
+	assert.equal(mapBroadcastAnnouncements({ payload: [] }), null)
+	assert.equal(mapBroadcastAnnouncements('nope'), null)
+})
+
+test('pinned announcements sort first', () => {
+	const result = mapBroadcastAnnouncements([
+		{ id: 10, title: '普通', content: 'x', updateAt: 2000, importantLevel: 9 },
+		{ id: 11, title: '置顶', content: 'x', updateAt: 1000, star: true },
+	])
+	assert.equal(result?.[0]?.id, '11')
+	assert.equal(result?.[1]?.id, '10')
+})

apps/app-frontend/src/helpers/remote-announcements.ts

@@ -5,6 +5,7 @@ export type RemoteAnnouncement = {
 	content: string
 	type: 'modal' | 'notification'
 	priority: 'low' | 'normal' | 'high' | 'critical'
+	pinned?: boolean
 	starts_at: string
 	ends_at: string | null
 	published_at: string
@@ -32,18 +33,28 @@ export function parseAnnouncements(value: unknown): RemoteAnnouncement[] | null
 		if (!entry || typeof entry !== 'object') continue
 		const item = entry as Record<string, unknown>
 		if (
-			typeof item.id !== 'string' || item.id.length > 100 || ids.has(item.id) ||
-			typeof item.title !== 'string' || !item.title.trim() || item.title.length > 120 ||
-			typeof item.content !== 'string' || item.content.length > 20000 ||
+			typeof item.id !== 'string' ||
+			item.id.length > 100 ||
+			ids.has(item.id) ||
+			typeof item.title !== 'string' ||
+			!item.title.trim() ||
+			item.title.length > 120 ||
+			typeof item.content !== 'string' ||
+			item.content.length > 20000 ||
 			(item.summary != null && (typeof item.summary !== 'string' || item.summary.length > 300)) ||
 			!['modal', 'notification'].includes(String(item.type)) ||
 			!['low', 'normal', 'high', 'critical'].includes(String(item.priority)) ||
-			typeof item.starts_at !== 'string' || !Number.isFinite(Date.parse(item.starts_at)) ||
-			typeof item.published_at !== 'string' || !Number.isFinite(Date.parse(item.published_at)) ||
-			(item.ends_at != null && (typeof item.ends_at !== 'string' || !Number.isFinite(Date.parse(item.ends_at)))) ||
-			(item.action_label != null && (typeof item.action_label !== 'string' || item.action_label.length > 80)) ||
+			typeof item.starts_at !== 'string' ||
+			!Number.isFinite(Date.parse(item.starts_at)) ||
+			typeof item.published_at !== 'string' ||
+			!Number.isFinite(Date.parse(item.published_at)) ||
+			(item.ends_at != null &&
+				(typeof item.ends_at !== 'string' || !Number.isFinite(Date.parse(item.ends_at)))) ||
+			(item.action_label != null &&
+				(typeof item.action_label !== 'string' || item.action_label.length > 80)) ||
 			(item.action_url != null && !safeAnnouncementUrl(item.action_url))
-		) continue
+		)
+			continue
 		ids.add(item.id)
 		items.push({
 			...item,
@@ -54,7 +65,12 @@ export function parseAnnouncements(value: unknown): RemoteAnnouncement[] | null
 		} as RemoteAnnouncement)
 	}
 	const rank = { low: 0, normal: 1, high: 2, critical: 3 }
-	return items.sort((first, second) => rank[second.priority] - rank[first.priority] || Date.parse(second.published_at) - Date.parse(first.published_at))
+	return items.sort(
+		(first, second) =>
+			Number(second.pinned ?? false) - Number(first.pinned ?? false) ||
+			rank[second.priority] - rank[first.priority] ||
+			Date.parse(second.published_at) - Date.parse(first.published_at),
+	)
 }
 
 export function isAnnouncementActive(item: RemoteAnnouncement, now = Date.now()) {
@@ -64,3 +80,76 @@ export function isAnnouncementActive(item: RemoteAnnouncement, now = Date.now())
 export function announcementKey(item: RemoteAnnouncement) {
 	return item.id + ':' + item.published_at
 }
+
+export const REMOTE_ANNOUNCEMENTS_UPDATED_EVENT = 'starlight:remote-announcements-updated'
+export const OPEN_REMOTE_ANNOUNCEMENT_CENTER_EVENT = 'starlight:open-remote-announcement-center'
+type BroadcastAnnouncementEntry = {
+	title?: unknown
+	subtitle?: unknown
+	content?: unknown
+	updateAt?: unknown
+	star?: unknown
+	importantLevel?: unknown
+	id?: unknown
+}
+
+function broadcastPriority(level: number): RemoteAnnouncement['priority'] {
+	if (level >= 9) return 'critical'
+	if (level >= 6) return 'high'
+	if (level >= 3) return 'normal'
+	return 'low'
+}
+
+export function mapBroadcastAnnouncements(payload: unknown): RemoteAnnouncement[] | null {
+	if (!Array.isArray(payload) || payload.length > 200) return null
+	const items: RemoteAnnouncement[] = []
+	const seen = new Set<string>()
+	for (const entry of payload) {
+		if (!entry || typeof entry !== 'object') continue
+		const item = entry as BroadcastAnnouncementEntry
+		if (
+			typeof item.id !== 'number' ||
+			!Number.isFinite(item.id) ||
+			typeof item.title !== 'string' ||
+			!item.title.trim() ||
+			item.title.length > 120 ||
+			typeof item.content !== 'string' ||
+			item.content.length > 20000 ||
+			typeof item.updateAt !== 'number' ||
+			!Number.isFinite(item.updateAt) ||
+			(item.subtitle != null && typeof item.subtitle !== 'string')
+		)
+			continue
+		const id = String(item.id)
+		if (seen.has(id)) continue
+		seen.add(id)
+		const level =
+			typeof item.importantLevel === 'number' && Number.isFinite(item.importantLevel)
+				? Math.max(0, Math.min(10, Math.floor(item.importantLevel)))
+				: 0
+		const starred = item.star === true
+		const published = new Date(item.updateAt).toISOString()
+		const summary = typeof item.subtitle === 'string' && item.subtitle.trim() ? item.subtitle : null
+		items.push({
+			id,
+			title: item.title,
+			summary,
+			content: item.content,
+			type: starred || level >= 8 ? 'modal' : 'notification',
+			priority: broadcastPriority(level),
+			pinned: starred,
+			starts_at: published,
+			ends_at: null,
+			published_at: published,
+			action_url: null,
+			action_label: null,
+		})
+	}
+	const rank = { low: 0, normal: 1, high: 2, critical: 3 }
+	return items.sort(
+		(first, second) =>
+			Number(second.pinned ?? false) - Number(first.pinned ?? false) ||
+			rank[second.priority] - rank[first.priority] ||
+			Date.parse(second.published_at) - Date.parse(first.published_at),
+	)
+}

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

@@ -0,0 +1,20 @@
+const SHOW_SCROLL_TOP_STORAGE_KEY = 'starlight-show-scroll-top'
+const QUICK_SCROLL_ENABLED_STORAGE_KEY = 'starlight-quick-scroll-enabled'
+
+export function getShowScrollTop(): boolean {
+	const value = localStorage.getItem(SHOW_SCROLL_TOP_STORAGE_KEY)
+	return value !== 'false'
+}
+
+export function setShowScrollTop(show: boolean) {
+	localStorage.setItem(SHOW_SCROLL_TOP_STORAGE_KEY, String(show))
+}
+
+export function getQuickScrollEnabled(): boolean {
+	const value = localStorage.getItem(QUICK_SCROLL_ENABLED_STORAGE_KEY)
+	return value === 'true'
+}
+
+export function setQuickScrollEnabled(enabled: boolean) {
+	localStorage.setItem(QUICK_SCROLL_ENABLED_STORAGE_KEY, String(enabled))
+}

apps/app-frontend/src/helpers/shortcut-actions.ts

@@ -0,0 +1,309 @@
+import { defineMessages, type KeyBinding, type MessageDescriptor } from '@modrinth/ui'
+import type { RouteLocationNormalizedLoaded } from 'vue-router'
+
+import { getLastBrowseContentProjectType, isBrowseContentProjectType } from '@/helpers/settings'
+
+/** Which half of the settings page an action belongs to. */
+export type ShortcutGroupId = 'scroll' | 'nav'
+
+/** Theme store fields that switch an action on. */
+export type ShortcutEnabledField =
+	| 'quickScrollEnabled'
+	| 'shortcutNavHome'
+	| 'shortcutNavWorlds'
+	| 'shortcutNavDiscover'
+	| 'shortcutNavSkins'
+	| 'shortcutNavMultiplayer'
+	| 'shortcutNavLibrary'
+	| 'shortcutNavLab'
+	| 'shortcutNavDownloads'
+	| 'shortcutNavCreate'
+	| 'shortcutNavSettings'
+
+export interface ShortcutContext {
+	worldsTabEnabled: boolean
+	offline: boolean
+}
+
+export interface ShortcutAction {
+	/** Stable id, used for the binding, the enable flag and the settings row. */
+	id: string
+	group: ShortcutGroupId
+	enabledField: ShortcutEnabledField
+	defaultBinding: KeyBinding
+	label: MessageDescriptor
+	description: MessageDescriptor
+	/** Navigation actions know where they lead. */
+	target?: (route: RouteLocationNormalizedLoaded) => string
+	/** Navigation actions that are not reachable right now. */
+	unavailable?: (context: ShortcutContext) => boolean
+	/** Scrolling actions move the page's own scroller. */
+	applyScroll?: (scroller: HTMLElement) => void
+}
+
+/**
+ * Declared here rather than assembled from the action ids, so the extractor can
+ * see them; an id built at runtime is one a translation pass would drop.
+ */
+const messages = defineMessages({
+	scrollTop: {
+		id: 'app.shortcut-settings.home-action',
+		defaultMessage: 'Scroll to the top',
+	},
+	scrollTopDescription: {
+		id: 'app.shortcut-settings.home-action-description',
+		defaultMessage: 'Moves the page you are reading to the top.',
+	},
+	scrollBottom: {
+		id: 'app.shortcut-settings.end-action',
+		defaultMessage: 'Scroll to the bottom',
+	},
+	scrollBottomDescription: {
+		id: 'app.shortcut-settings.end-action-description',
+		defaultMessage: 'Moves the page you are reading to the bottom.',
+	},
+	scrollUp: {
+		id: 'app.shortcut-settings.page-up-action',
+		defaultMessage: 'Scroll up one screen',
+	},
+	scrollUpDescription: {
+		id: 'app.shortcut-settings.page-up-action-description',
+		defaultMessage: 'Moves the page you are reading up by one screen.',
+	},
+	scrollDown: {
+		id: 'app.shortcut-settings.page-down-action',
+		defaultMessage: 'Scroll down one screen',
+	},
+	scrollDownDescription: {
+		id: 'app.shortcut-settings.page-down-action-description',
+		defaultMessage: 'Moves the page you are reading down by one screen.',
+	},
+	navHome: { id: 'app.shortcut-settings.nav-home', defaultMessage: 'Home' },
+	navHomeDescription: {
+		id: 'app.shortcut-settings.nav-home-description',
+		defaultMessage: 'Jump to the Home page.',
+	},
+	navWorlds: { id: 'app.shortcut-settings.nav-worlds', defaultMessage: 'Worlds' },
+	navWorldsDescription: {
+		id: 'app.shortcut-settings.nav-worlds-description',
+		defaultMessage: 'Jump to your worlds.',
+	},
+	navDiscover: {
+		id: 'app.shortcut-settings.nav-discover',
+		defaultMessage: 'Discover content',
+	},
+	navDiscoverDescription: {
+		id: 'app.shortcut-settings.nav-discover-description',
+		defaultMessage: 'Jump to browsing content.',
+	},
+	navSkins: { id: 'app.shortcut-settings.nav-skins', defaultMessage: 'Skin selector' },
+	navSkinsDescription: {
+		id: 'app.shortcut-settings.nav-skins-description',
+		defaultMessage: 'Jump to the skin selector.',
+	},
+	navMultiplayer: { id: 'app.shortcut-settings.nav-multiplayer', defaultMessage: 'Multiplayer' },
+	navMultiplayerDescription: {
+		id: 'app.shortcut-settings.nav-multiplayer-description',
+		defaultMessage: 'Jump to multiplayer.',
+	},
+	navLibrary: { id: 'app.shortcut-settings.nav-library', defaultMessage: 'Library' },
+	navLibraryDescription: {
+		id: 'app.shortcut-settings.nav-library-description',
+		defaultMessage: 'Jump to your library.',
+	},
+	navLab: { id: 'app.shortcut-settings.nav-lab', defaultMessage: 'Lab' },
+	navLabDescription: {
+		id: 'app.shortcut-settings.nav-lab-description',
+		defaultMessage: 'Jump to the Lab.',
+	},
+	navDownloads: { id: 'app.shortcut-settings.nav-downloads', defaultMessage: 'Downloads' },
+	navDownloadsDescription: {
+		id: 'app.shortcut-settings.nav-downloads-description',
+		defaultMessage: 'Jump to downloads.',
+	},
+	navCreate: { id: 'app.shortcut-settings.nav-create', defaultMessage: 'Create new instance' },
+	navCreateDescription: {
+		id: 'app.shortcut-settings.nav-create-description',
+		defaultMessage: 'Jump to creating a new instance.',
+	},
+	navSettings: { id: 'app.shortcut-settings.nav-settings', defaultMessage: 'Settings' },
+	navSettingsDescription: {
+		id: 'app.shortcut-settings.nav-settings-description',
+		defaultMessage: 'Jump to the settings.',
+	},
+})
+
+function keyboard(code: string, mod = false, alt = false, shift = false): KeyBinding {
+	return { device: 'keyboard', code, mod, alt, shift }
+}
+
+/**
+ * Resolves the Discover content target from the current route, so the nav
+ * button and the keyboard shortcut share one source of truth.
+ */
+export function discoverContentTarget(route: RouteLocationNormalizedLoaded): string {
+	const projectType = route.params.projectType
+	if (
+		!route.query.i &&
+		!route.query.sid &&
+		!route.query.wid &&
+		typeof projectType === 'string' &&
+		isBrowseContentProjectType(projectType)
+	) {
+		return `/browse/${projectType}`
+	}
+
+	return `/browse/${getLastBrowseContentProjectType()}`
+}
+
+/**
+ * Every shortcut the launcher answers to. The binding here is the one a fresh
+ * install uses; a recorded binding is stored separately and wins over it.
+ */
+export const SHORTCUT_ACTIONS: ShortcutAction[] = [
+	{
+		id: 'shortcutScrollTop',
+		group: 'scroll',
+		enabledField: 'quickScrollEnabled',
+		defaultBinding: keyboard('Home'),
+		label: messages.scrollTop,
+		description: messages.scrollTopDescription,
+		applyScroll: (scroller) => scroller.scrollTo({ top: 0, behavior: 'smooth' }),
+	},
+	{
+		id: 'shortcutScrollBottom',
+		group: 'scroll',
+		enabledField: 'quickScrollEnabled',
+		defaultBinding: keyboard('End'),
+		label: messages.scrollBottom,
+		description: messages.scrollBottomDescription,
+		applyScroll: (scroller) =>
+			scroller.scrollTo({ top: scroller.scrollHeight, behavior: 'smooth' }),
+	},
+	{
+		id: 'shortcutScrollUp',
+		group: 'scroll',
+		enabledField: 'quickScrollEnabled',
+		defaultBinding: keyboard('PageUp'),
+		label: messages.scrollUp,
+		description: messages.scrollUpDescription,
+		applyScroll: (scroller) => {
+			// Immediate scrolling keeps rapid key repeats responsive.
+			scroller.scrollTop = Math.max(0, scroller.scrollTop - scroller.clientHeight * 0.9)
+		},
+	},
+	{
+		id: 'shortcutScrollDown',
+		group: 'scroll',
+		enabledField: 'quickScrollEnabled',
+		defaultBinding: keyboard('PageDown'),
+		label: messages.scrollDown,
+		description: messages.scrollDownDescription,
+		applyScroll: (scroller) => {
+			scroller.scrollTop = Math.min(
+				scroller.scrollHeight,
+				scroller.scrollTop + scroller.clientHeight * 0.9,
+			)
+		},
+	},
+	{
+		id: 'shortcutNavHome',
+		group: 'nav',
+		enabledField: 'shortcutNavHome',
+		defaultBinding: keyboard('Digit1', true),
+		label: messages.navHome,
+		description: messages.navHomeDescription,
+		target: () => '/',
+	},
+	{
+		id: 'shortcutNavWorlds',
+		group: 'nav',
+		enabledField: 'shortcutNavWorlds',
+		defaultBinding: keyboard('Digit2', true),
+		label: messages.navWorlds,
+		description: messages.navWorldsDescription,
+		target: () => '/worlds',
+		unavailable: (context) => !context.worldsTabEnabled,
+	},
+	{
+		id: 'shortcutNavDiscover',
+		group: 'nav',
+		enabledField: 'shortcutNavDiscover',
+		defaultBinding: keyboard('Digit3', true),
+		label: messages.navDiscover,
+		description: messages.navDiscoverDescription,
+		target: (route) => discoverContentTarget(route),
+		unavailable: (context) => context.offline,
+	},
+	{
+		id: 'shortcutNavSkins',
+		group: 'nav',
+		enabledField: 'shortcutNavSkins',
+		defaultBinding: keyboard('Digit4', true),
+		label: messages.navSkins,
+		description: messages.navSkinsDescription,
+		target: () => '/skins',
+	},
+	{
+		id: 'shortcutNavMultiplayer',
+		group: 'nav',
+		enabledField: 'shortcutNavMultiplayer',
+		defaultBinding: keyboard('Digit5', true),
+		label: messages.navMultiplayer,
+		description: messages.navMultiplayerDescription,
+		target: () => '/multiplayer',
+	},
+	{
+		id: 'shortcutNavLibrary',
+		group: 'nav',
+		enabledField: 'shortcutNavLibrary',
+		defaultBinding: keyboard('Digit6', true),
+		label: messages.navLibrary,
+		description: messages.navLibraryDescription,
+		target: () => '/library',
+	},
+	{
+		id: 'shortcutNavLab',
+		group: 'nav',
+		enabledField: 'shortcutNavLab',
+		defaultBinding: keyboard('Digit7', true),
+		label: messages.navLab,
+		description: messages.navLabDescription,
+		target: () => '/lab',
+	},
+	{
+		id: 'shortcutNavDownloads',
+		group: 'nav',
+		enabledField: 'shortcutNavDownloads',
+		defaultBinding: keyboard('Digit8', true),
+		label: messages.navDownloads,
+		description: messages.navDownloadsDescription,
+		target: () => '/downloads',
+	},
+	{
+		id: 'shortcutNavCreate',
+		group: 'nav',
+		enabledField: 'shortcutNavCreate',
+		defaultBinding: keyboard('Digit9', true),
+		label: messages.navCreate,
+		description: messages.navCreateDescription,
+		target: () => '/create',
+		unavailable: (context) => context.offline,
+	},
+	{
+		id: 'shortcutNavSettings',
+		group: 'nav',
+		enabledField: 'shortcutNavSettings',
+		defaultBinding: keyboard('Comma', true),
+		label: messages.navSettings,
+		description: messages.navSettingsDescription,
+		target: () => '/settings',
+	},
+]
+
+export const SCROLL_ACTIONS = SHORTCUT_ACTIONS.filter((action) => action.group === 'scroll')
+export const NAV_ACTIONS = SHORTCUT_ACTIONS.filter((action) => action.group === 'nav')
+
+export function shortcutAction(id: string): ShortcutAction | undefined {
+	return SHORTCUT_ACTIONS.find((action) => action.id === id)
+}

apps/app-frontend/src/helpers/shortcut-bindings.ts

@@ -0,0 +1,120 @@
+import type { BindingConflict, KeyBinding } from '@modrinth/ui'
+
+import { SHORTCUT_ACTIONS, shortcutAction } from '@/helpers/shortcut-actions'
+
+const BINDING_STORAGE_PREFIX = 'starlight-shortcut-binding-'
+
+/**
+ * Combinations the shell or the operating system answers to before the launcher
+ * sees them. Saved shortcuts may not take these over.
+ */
+export const RESERVED_BINDINGS: BindingConflict[] = [
+	{
+		id: 'system-find',
+		label: 'Find in page (Ctrl/Cmd + F)',
+		binding: keyboard('KeyF', true),
+		reserved: true,
+	},
+	{
+		id: 'system-devtools',
+		label: 'Developer tools (F12)',
+		binding: keyboard('F12'),
+		reserved: true,
+	},
+	{
+		id: 'system-close',
+		label: 'Close window (Ctrl/Cmd + W)',
+		binding: keyboard('KeyW', true),
+		reserved: true,
+	},
+	{
+		id: 'system-quit',
+		label: 'Quit (Ctrl/Cmd + Q)',
+		binding: keyboard('KeyQ', true),
+		reserved: true,
+	},
+	{
+		id: 'system-reload',
+		label: 'Reload (Ctrl/Cmd + R)',
+		binding: keyboard('KeyR', true),
+		reserved: true,
+	},
+	{ id: 'system-refresh', label: 'Refresh (F5)', binding: keyboard('F5'), reserved: true },
+	{
+		id: 'system-exit',
+		label: 'Close window (Alt + F4)',
+		binding: keyboard('F4', false, true),
+		reserved: true,
+	},
+]
+
+function keyboard(code: string, mod = false, alt = false, shift = false): KeyBinding {
+	return { device: 'keyboard', code, mod, alt, shift }
+}
+
+function isKeyBinding(value: unknown): value is KeyBinding {
+	if (!value || typeof value !== 'object') return false
+	const candidate = value as Partial<KeyBinding>
+	return (
+		(candidate.device === 'keyboard' || candidate.device === 'mouse') &&
+		typeof candidate.code === 'string' &&
+		candidate.code.length > 0 &&
+		typeof candidate.mod === 'boolean' &&
+		typeof candidate.shift === 'boolean' &&
+		typeof candidate.alt === 'boolean'
+	)
+}
+
+/** The combination recorded for an action, if it has one. */
+export function readStoredBinding(id: string): KeyBinding | null {
+	const raw = localStorage.getItem(BINDING_STORAGE_PREFIX + id)
+	if (!raw) return null
+
+	try {
+		const parsed = JSON.parse(raw)
+		return isKeyBinding(parsed) ? parsed : null
+	} catch {
+		// A value that cannot be read is treated as unset, so the action keeps
+		// working with its default rather than becoming unreachable.
+		return null
+	}
+}
+
+export function storeBinding(id: string, binding: KeyBinding) {
+	localStorage.setItem(BINDING_STORAGE_PREFIX + id, JSON.stringify(binding))
+}
+
+/** Drops the recorded combination, putting the action back on its default. */
+export function clearStoredBinding(id: string) {
+	if (readStoredBinding(id)) localStorage.removeItem(BINDING_STORAGE_PREFIX + id)
+}
+
+/** The combination an action answers to now: the recorded one, or its default. */
+export function resolveBinding(id: string): KeyBinding | null {
+	const action = shortcutAction(id)
+	if (!action) return null
+	return readStoredBinding(id) ?? action.defaultBinding
+}
+
+export function resolveAllBindings(): Record<string, KeyBinding> {
+	const bindings: Record<string, KeyBinding> = {}
+	for (const action of SHORTCUT_ACTIONS) {
+		bindings[action.id] = resolveBinding(action.id) ?? action.defaultBinding
+	}
+	return bindings
+}
+
+/**
+ * Everything a new combination would collide with: the other actions, plus the
+ * combinations the shell owns. `label` is what the dialog names in the error.
+ */
+export function buildConflicts(exceptId: string, label: (id: string) => string): BindingConflict[] {
+	const conflicts = SHORTCUT_ACTIONS.filter((action) => action.id !== exceptId).flatMap(
+		(action) => {
+			const binding = resolveBinding(action.id)
+			return binding ? [{ id: action.id, label: label(action.id), binding }] : []
+		},
+	)
+
+	return [...conflicts, ...RESERVED_BINDINGS]
+}

apps/app-frontend/src/helpers/skin-armor-preview.test.ts

@@ -0,0 +1,60 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { loadSkinArmorPreview, saveSkinArmorPreview } from './skin-armor-preview.ts'
+
+const originalStorage = Object.getOwnPropertyDescriptor(globalThis, 'localStorage')
+
+function withStorage(run: (values: Map<string, string>) => void): void {
+	const values = new Map<string, string>()
+	Object.defineProperty(globalThis, 'localStorage', {
+		configurable: true,
+		value: {
+			getItem: (key: string) => values.get(key) ?? null,
+			setItem: (key: string, value: string) => values.set(key, value),
+		},
+	})
+	try {
+		run(values)
+	} finally {
+		if (originalStorage) Object.defineProperty(globalThis, 'localStorage', originalStorage)
+		else delete (globalThis as { localStorage?: Storage }).localStorage
+	}
+}
+
+test('armor preview selections survive storage round trips', () => {
+	withStorage(() => {
+		const config = loadSkinArmorPreview()
+		config.helmet.material = 'diamond'
+		config.helmet.trimPattern = 'sentry'
+		config.helmet.trimMaterial = 'gold'
+		saveSkinArmorPreview(config)
+
+		assert.deepEqual(loadSkinArmorPreview(), config)
+	})
+})
+
+test('invalid stored armor values fall back per slot and field', () => {
+	withStorage((values) => {
+		values.set(
+			'axolotl:skin-armor-preview',
+			JSON.stringify({
+				helmet: { material: 'diamond', trimPattern: 'invalid', trimMaterial: 'gold' },
+				boots: { material: 'turtle', trimPattern: 'sentry', trimMaterial: 'invalid' },
+			}),
+		)
+
+		const config = loadSkinArmorPreview()
+		assert.deepEqual(config.helmet, {
+			material: 'diamond',
+			trimPattern: null,
+			trimMaterial: 'gold',
+		})
+		assert.deepEqual(config.boots, {
+			material: null,
+			trimPattern: 'sentry',
+			trimMaterial: 'iron',
+		})
+		assert.equal(config.chestplate.material, null)
+	})
+})

apps/app-frontend/src/helpers/skin-armor-preview.ts

@@ -0,0 +1,47 @@
+import {
+	ARMOR_SLOTS,
+	ARMOR_TRIM_MATERIALS,
+	ARMOR_TRIM_PATTERNS,
+	armorMaterialsForSlot,
+	type ArmorPreviewConfig,
+	createDefaultArmorPreviewConfig,
+} from '@modrinth/ui'
+
+const STORAGE_KEY = 'axolotl:skin-armor-preview'
+
+function includes<T extends string>(values: readonly T[], value: unknown): value is T {
+	return typeof value === 'string' && values.some((item) => item === value)
+}
+
+export function loadSkinArmorPreview(): ArmorPreviewConfig {
+	const config = createDefaultArmorPreviewConfig()
+	try {
+		const saved = JSON.parse(globalThis.localStorage?.getItem(STORAGE_KEY) ?? 'null')
+		if (!saved || typeof saved !== 'object' || Array.isArray(saved)) return config
+
+		for (const slot of ARMOR_SLOTS) {
+			const piece = saved[slot]
+			if (!piece || typeof piece !== 'object' || Array.isArray(piece)) continue
+			if (piece.material === null || includes(armorMaterialsForSlot(slot), piece.material)) {
+				config[slot].material = piece.material
+			}
+			if (piece.trimPattern === null || includes(ARMOR_TRIM_PATTERNS, piece.trimPattern)) {
+				config[slot].trimPattern = piece.trimPattern
+			}
+			if (includes(ARMOR_TRIM_MATERIALS, piece.trimMaterial)) {
+				config[slot].trimMaterial = piece.trimMaterial
+			}
+		}
+	} catch {
+		// Invalid or unavailable local storage falls back to a fresh preview.
+	}
+	return config
+}
+
+export function saveSkinArmorPreview(config: ArmorPreviewConfig): void {
+	try {
+		globalThis.localStorage?.setItem(STORAGE_KEY, JSON.stringify(config))
+	} catch {
+		// The preview remains usable when local storage is unavailable.
+	}
+}

apps/app-frontend/src/helpers/synced-options.ts

@@ -0,0 +1,61 @@
+import { queryOptions } from '@tanstack/vue-query'
+
+import { list_game_options_sync_sources } from './game-options'
+import {
+	get_command_history,
+	get_global_synced_options,
+	get_initialized_synced_options,
+	list_synced_servers,
+} from './instance'
+import type { GameInstance } from './types'
+
+export const syncedOptionsKeys = {
+	global: ['global-synced-options'] as const,
+	initialized: ['initialized-synced-options'] as const,
+	gameSources: ['game-options-sync-sources'] as const,
+	set: ['global-synced-options', 'set'] as const,
+	servers: ['synced-servers', 'list'] as const,
+	commandHistory: ['synced-options', 'command-history'] as const,
+}
+
+export function globalSyncedOptionsQueryOptions() {
+	return queryOptions({
+		queryKey: syncedOptionsKeys.global,
+		queryFn: get_global_synced_options,
+	})
+}
+
+export function initializedSyncedOptionsQueryOptions() {
+	return queryOptions({
+		queryKey: syncedOptionsKeys.initialized,
+		queryFn: get_initialized_synced_options,
+	})
+}
+
+export function gameOptionsSyncSourcesQueryOptions() {
+	return queryOptions({
+		queryKey: syncedOptionsKeys.gameSources,
+		queryFn: list_game_options_sync_sources,
+		staleTime: 0,
+	})
+}
+
+export function syncedServersQueryOptions() {
+	return queryOptions({
+		queryKey: syncedOptionsKeys.servers,
+		queryFn: list_synced_servers,
+	})
+}
+
+export function commandHistoryQueryOptions() {
+	return queryOptions({
+		queryKey: syncedOptionsKeys.commandHistory,
+		queryFn: get_command_history,
+	})
+}
+
+export function canSourceMultiplayerServers(instance: GameInstance): boolean {
+	return !['server_project', 'server_project_modpack', 'modrinth_hosting'].includes(
+		instance.link?.type ?? '',
+	)
+}

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

@@ -0,0 +1,83 @@
+import type { ContentItem } from '@modrinth/ui'
+import { queryOptions } from '@tanstack/vue-query'
+import { invoke } from '@tauri-apps/api/core'
+
+import { adaptContentItems, isSyncedOptionAvailable } from './instance'
+
+export type SyncedPackType = 'resourcepack' | 'datapack'
+export type SyncedPackAction = 'enable' | 'disable'
+
+export type DesyncServerMode = 'keep_in_other_instances' | 'remove_from_other_instances'
+
+export function isSyncedPackTypeAvailable(projectType: ContentItem['project_type']): boolean {
+	return (
+		['resourcepack', 'datapack'].includes(projectType) &&
+		isSyncedOptionAvailable(projectType === 'resourcepack' ? 'resource_packs' : 'data_packs')
+	)
+}
+
+export interface PackSyncPreview {
+	pack: ContentItem
+	instances: {
+		instance_id: string
+		name: string
+		game_version: string
+		compatible: boolean
+		participating: boolean
+	}[]
+}
+
+export const syncedPackKeys = {
+	all: ['synced-packs'] as const,
+	list: (type: SyncedPackType) => ['synced-packs', 'list', type] as const,
+}
+
+export function syncedPackQueryOptions(type: SyncedPackType) {
+	return queryOptions({
+		queryKey: syncedPackKeys.list(type),
+		queryFn: () => list_synced_packs(type),
+		enabled: isSyncedPackTypeAvailable(type),
+	})
+}
+
+export async function list_synced_packs(projectType: SyncedPackType): Promise<ContentItem[]> {
+	const items = await invoke<ContentItem[]>('plugin:instance|instance_list_synced_packs', {
+		projectType,
+	})
+	return adaptContentItems(items).map((item) => ({ ...item, external: !item.project }))
+}
+
+export function get_pack_sync_preview(
+	instanceId: string,
+	projectPath: string,
+): Promise<PackSyncPreview> {
+	return invoke('plugin:instance|instance_get_pack_sync_preview', { instanceId, projectPath })
+}
+
+export function sync_pack(instanceId: string, projectPath: string): Promise<void> {
+	return invoke('plugin:instance|instance_sync_pack', { instanceId, projectPath })
+}
+
+export function desync_pack(
+	instanceId: string,
+	packId: string,
+	mode: DesyncServerMode,
+): Promise<void> {
+	return invoke('plugin:instance|instance_desync_pack', { instanceId, packId, mode })
+}
+
+export function upload_synced_pack(
+	path: string,
+	projectType: SyncedPackType,
+	gameVersions: string[],
+): Promise<void> {
+	return invoke('plugin:instance|instance_upload_synced_pack', { path, projectType, gameVersions })
+}
+
+export function set_synced_pack_enabled(packId: string, enabled: boolean): Promise<void> {
+	return invoke('plugin:instance|instance_set_synced_pack_enabled', { packId, enabled })
+}
+
+export function remove_synced_pack(packId: string): Promise<void> {
+	return invoke('plugin:instance|instance_remove_synced_pack', { packId })
+}

apps/app-frontend/src/helpers/types.d.ts

@@ -23,6 +23,17 @@ export type GameInstance = {
 	loader_version?: string
 	loader_components: LoaderComponent[]
 
+	synced_options: Record<
+		| 'game_options'
+		| 'command_history'
+		| 'multiplayer_servers'
+		| 'creative_hotbars'
+		| 'screenshots'
+		| 'resource_packs'
+		| 'data_packs',
+		boolean
+	>
+
 	groups: string[]
 
 	link?: InstanceLink | null
@@ -44,6 +55,7 @@ export type GameInstance = {
 	force_fullscreen?: boolean
 	maximize_window?: boolean
 	game_resolution?: [number, number]
+	window_title?: string | null
 	launch_preparation_timeout?: number | null
 	hooks: Hooks
 }
@@ -228,6 +240,8 @@ type AppSettings = {
 	force_fullscreen: boolean
 	maximize_window: boolean
 	game_resolution: [number, number]
+	custom_window_title_enabled: boolean
+	default_window_title: string
 	hide_on_process_start: boolean
 	enter_lightweight_mode_on_game_launch: boolean
 	auto_set_java_high_performance_mode: boolean

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

@@ -81,6 +81,38 @@ export async function exportErrorLogs(
 	return await invoke('plugin:utils|export_error_logs', { outputPath, errorMessage })
 }
 
+export async function exportLauncherLogs({
+	range = 'last2Hours',
+	level = 'all',
+	includeSystemInfo = true,
+	includeInstanceLogs = false,
+	includeCrashAnalysis = false,
+	fileNamePrefix = 'Starlight Launcher logs',
+} = {}) {
+	const timestamp = new Date().toISOString().replace(/[:.]/g, '-')
+	const outputPath = await save({
+		defaultPath: `${fileNamePrefix} ${timestamp}.zip`,
+		filters: [
+			{
+				name: 'ZIP archive',
+				extensions: ['zip'],
+			},
+		],
+	})
+
+	if (!outputPath) return null
+
+	await invoke('plugin:utils|export_launcher_logs', {
+		outputPath,
+		range,
+		level,
+		includeSystemInfo,
+		includeInstanceLogs,
+		includeCrashAnalysis,
+	})
+	return outputPath
+}
+
 export async function createInstanceShortcut(instanceName, instanceId, options = {}) {
 	const outputPath = await save({
 		defaultPath: `Modrinth - ${instanceName}`,

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

@@ -10929,5 +10929,594 @@
   },
   "settings.backups.repository.usage-description": {
     "message": "实际存储 {stored}，对应 {logical} 的备份数据，共 {count, plural, other {# 个快照}}。"
-  }
+  },
+	"app.settings.synced-options.choose-sync-source.command-history-description": { "message": "选择要从哪个实例复制命令历史记录。这些记录仅用于初始同步，之后可从任意实例编辑。" },
+	"app.settings.synced-options.choose-sync-source.command-history-title": { "message": "选择命令历史记录来源" },
+	"app.settings.synced-options.choose-sync-source.creative-hotbars-description": { "message": "选择要从哪个实例复制保存的创造模式快捷栏。这些快捷栏仅用于初始同步，之后可从任意实例编辑。" },
+	"app.settings.synced-options.choose-sync-source.creative-hotbars-title": { "message": "选择创造模式快捷栏来源" },
+	"app.settings.synced-options.choose-sync-source.data-packs-title": { "message": "选择数据包来源" },
+	"app.settings.synced-options.choose-sync-source.game-settings-description": { "message": "选择要从哪个实例复制游戏设置。这些设置仅用于初始同步，之后可从任意实例编辑。" },
+	"app.settings.synced-options.choose-sync-source.game-settings-title": { "message": "选择游戏设置来源" },
+	"app.settings.synced-options.choose-sync-source.ineligible": { "message": "无法选择此实例作为同步来源" },
+	"app.settings.synced-options.choose-sync-source.load-error": { "message": "无法加载同步来源，请重试。" },
+	"app.settings.synced-options.choose-sync-source.multiplayer-servers-description": { "message": "选择要从哪个实例复制多人服务器列表。这些服务器仅用于初始同步，之后可从任意实例编辑。" },
+	"app.settings.synced-options.choose-sync-source.multiplayer-servers-title": { "message": "选择多人服务器来源" },
+	"app.settings.synced-options.choose-sync-source.no-instances-found": { "message": "没有找到实例" },
+	"app.settings.synced-options.choose-sync-source.resource-packs-title": { "message": "选择资源包来源" },
+	"app.settings.synced-options.choose-sync-source.retry": { "message": "重试" },
+	"app.settings.synced-options.choose-sync-source.search-placeholder": { "message": "搜索实例" },
+	"app.settings.synced-options.choose-sync-source.sync": { "message": "同步" },
+	"app.settings.synced-options.command-history": { "message": "同步命令记录" },
+	"app.settings.synced-options.command-history.description": { "message": "在不同的实例之间同步命令记录。" },
+	"app.settings.synced-options.command-history.editor-title": { "message": "编辑指令历史记录" },
+	"app.settings.synced-options.creative-hotbars": { "message": "同步保存的创造模式物品栏" },
+	"app.settings.synced-options.creative-hotbars.description": { "message": "在不同的实例之间同步创造模式物品栏。" },
+	"app.settings.synced-options.data-packs": { "message": "同步数据包" },
+	"app.settings.synced-options.data-packs.description": { "message": "在所有实例间使用相同的数据包" },
+	"app.settings.synced-options.data-packs.none-synced-yet": { "message": "尚未同步任何数据包" },
+	"app.settings.synced-options.edit.no-instances": { "message": "请先添加实例，再编辑同步数据。" },
+	"app.settings.synced-options.edit.no-synced-data": { "message": "请先选择同步来源，再编辑此设置。" },
+	"app.settings.synced-options.game-settings": { "message": "同步游戏设置" },
+	"app.settings.synced-options.game-settings.button": { "message": "编辑游戏设置" },
+	"app.settings.synced-options.game-settings.description": { "message": "在所有实例间使用相同的游戏设置。" },
+	"app.settings.synced-options.game-settings.disabled-tooltip": { "message": "请先启用游戏设置同步，再选择单个设置。" },
+	"app.settings.synced-options.game-settings.no-options-to-edit": { "message": "目前没有可编辑的设置" },
+	"app.settings.synced-options.multiplayer-servers": { "message": "同步多人模式服务器列表" },
+	"app.settings.synced-options.multiplayer-servers.address": { "message": "服务器地址" },
+	"app.settings.synced-options.multiplayer-servers.copy-address": { "message": "复制地址" },
+	"app.settings.synced-options.multiplayer-servers.count": { "message": "{count, number} 个服务器" },
+	"app.settings.synced-options.multiplayer-servers.description": { "message": "在不同的实例直接同步多人模式服务器列表。" },
+	"app.settings.synced-options.multiplayer-servers.editor-title": { "message": "编辑同步的服务器" },
+	"app.settings.synced-options.multiplayer-servers.empty": { "message": "当前未同步任何用户添加的服务器。" },
+	"app.settings.synced-options.multiplayer-servers.filter-offline": { "message": "离线" },
+	"app.settings.synced-options.multiplayer-servers.filter-online": { "message": "在线" },
+	"app.settings.synced-options.multiplayer-servers.more-options": { "message": "更多服务器选项" },
+	"app.settings.synced-options.multiplayer-servers.name": { "message": "服务器名称" },
+	"app.settings.synced-options.multiplayer-servers.no-results": { "message": "没有匹配搜索或筛选条件的已同步服务器。" },
+	"app.settings.synced-options.multiplayer-servers.none-synced-yet": { "message": "暂无已同步的服务器" },
+	"app.settings.synced-options.multiplayer-servers.players-online": { "message": "{count, number} 人在线" },
+	"app.settings.synced-options.multiplayer-servers.search": { "message": "搜索 {count, number} 个已同步服务器……" },
+	"app.settings.synced-options.multiplayer-servers.status": { "message": "状态" },
+	"app.settings.synced-options.packs.disabled": { "message": "请先启用同步，再编辑共享包。" },
+	"app.settings.synced-options.resource-packs": { "message": "同步资源包" },
+	"app.settings.synced-options.resource-packs.description": { "message": "在所有实例间使用相同的资源包" },
+	"app.settings.synced-options.resource-packs.none-synced-yet": { "message": "尚未同步任何资源包" },
+	"app.settings.synced-options.title": { "message": "跨所有实例同步的选项" },
+	"app.settings.synced-packs.data-packs": { "message": "数据包" },
+	"app.settings.synced-packs.disable": { "message": "禁用" },
+	"app.settings.synced-packs.empty": { "message": "没有已同步的包" },
+	"app.settings.synced-packs.enable": { "message": "启用" },
+	"app.settings.synced-packs.remove": { "message": "移除" },
+	"app.settings.synced-packs.resource-packs": { "message": "资源包" },
+	"app.sync-instances-update.choose-source.data-packs": { "message": "选择要从哪个实例复制数据包。这些包仅用于初始化同步，之后可从任意实例进行编辑。" },
+	"app.sync-instances-update.choose-source.resource-packs": { "message": "选择要从哪个实例复制资源包。这些包仅用于初始化同步，之后可从任意实例进行编辑。" },
+	"instance.settings.tabs.backups": { "message": "备份" },
+	"instance.settings.tabs.sync": { "message": "同步" },
+	"app.settings.game-options.category.accessibility.description": { "message": "无障碍设置" },
+	"app.settings.game-options.category.accessibility.label": { "message": "无障碍" },
+	"app.settings.game-options.category.chat.description": { "message": "聊天显示与外观" },
+	"app.settings.game-options.category.chat.label": { "message": "聊天" },
+	"app.settings.game-options.category.controls.description": { "message": "鼠标、移动与按键绑定" },
+	"app.settings.game-options.category.controls.label": { "message": "控制" },
+	"app.settings.game-options.category.custom.description": { "message": "由模组添加的设置" },
+	"app.settings.game-options.category.custom.label": { "message": "自定义设置" },
+	"app.settings.game-options.category.language.description": { "message": "游戏语言" },
+	"app.settings.game-options.category.language.label": { "message": "语言" },
+	"app.settings.game-options.category.music-and-sound.description": { "message": "音量与音频偏好" },
+	"app.settings.game-options.category.music-and-sound.label": { "message": "音乐和声音" },
+	"app.settings.game-options.category.online.description": { "message": "在线与 Realms 偏好" },
+	"app.settings.game-options.category.online.label": { "message": "在线" },
+	"app.settings.game-options.category.skin-customization.description": { "message": "皮肤层与主手" },
+	"app.settings.game-options.category.skin-customization.label": { "message": "皮肤自定义" },
+	"app.settings.game-options.category.video.description": { "message": "镜头与显示设置" },
+	"app.settings.game-options.category.video.label": { "message": "视频" },
+	"app.settings.game-options.choice.all": { "message": "全部" },
+	"app.settings.game-options.choice.balanced": { "message": "平衡" },
+	"app.settings.game-options.choice.by-player": { "message": "按玩家" },
+	"app.settings.game-options.choice.chat": { "message": "聊天" },
+	"app.settings.game-options.choice.commands-only": { "message": "仅命令" },
+	"app.settings.game-options.choice.constant": { "message": "持续" },
+	"app.settings.game-options.choice.crosshair": { "message": "准星" },
+	"app.settings.game-options.choice.custom": { "message": "自定义" },
+	"app.settings.game-options.choice.decreased": { "message": "降低" },
+	"app.settings.game-options.choice.default": { "message": "默认" },
+	"app.settings.game-options.choice.fabulous": { "message": "极佳" },
+	"app.settings.game-options.choice.fancy": { "message": "精美" },
+	"app.settings.game-options.choice.far": { "message": "远" },
+	"app.settings.game-options.choice.fast": { "message": "快速" },
+	"app.settings.game-options.choice.frequent": { "message": "频繁" },
+	"app.settings.game-options.choice.hidden": { "message": "隐藏" },
+	"app.settings.game-options.choice.hotbar": { "message": "快捷栏" },
+	"app.settings.game-options.choice.left": { "message": "左" },
+	"app.settings.game-options.choice.limited": { "message": "有限" },
+	"app.settings.game-options.choice.max-fps": { "message": "最高 FPS" },
+	"app.settings.game-options.choice.maximum": { "message": "最大" },
+	"app.settings.game-options.choice.minimal": { "message": "最少" },
+	"app.settings.game-options.choice.minimum": { "message": "最小" },
+	"app.settings.game-options.choice.nearby": { "message": "附近" },
+	"app.settings.game-options.choice.never": { "message": "从不" },
+	"app.settings.game-options.choice.none": { "message": "无" },
+	"app.settings.game-options.choice.normal": { "message": "正常" },
+	"app.settings.game-options.choice.off": { "message": "关闭" },
+	"app.settings.game-options.choice.on": { "message": "开启" },
+	"app.settings.game-options.choice.opengl": { "message": "OpenGL 渲染器" },
+	"app.settings.game-options.choice.pause": { "message": "暂停菜单" },
+	"app.settings.game-options.choice.pause-and-toast": { "message": "暂停菜单和提示" },
+	"app.settings.game-options.choice.power-saver": { "message": "省电" },
+	"app.settings.game-options.choice.right": { "message": "右" },
+	"app.settings.game-options.choice.short": { "message": "短" },
+	"app.settings.game-options.choice.shown": { "message": "显示" },
+	"app.settings.game-options.choice.system": { "message": "系统" },
+	"app.settings.game-options.choice.tiny": { "message": "极小" },
+	"app.settings.game-options.choice.vulkan": { "message": "Vulkan 渲染器" },
+	"app.settings.game-options.choice.when-minimized": { "message": "最小化时" },
+	"app.settings.game-options.choice.while-afk": { "message": "挂机时" },
+	"app.settings.game-options.compatibility.none": { "message": "部分实例无法使用此设置" },
+	"app.settings.game-options.compatibility.reason.launcher-controlled": { "message": "此设置由启动器设置管理" },
+	"app.settings.game-options.custom-value.placeholder": { "message": "输入值" },
+	"app.settings.game-options.keybind.assigned-status": { "message": "已将 {setting} 绑定为 {binding}。" },
+	"app.settings.game-options.keybind.cancelled-status": { "message": "已取消按键绑定更改。" },
+	"app.settings.game-options.keybind.change": { "message": "{setting}：{binding}。激活以更改绑定。" },
+	"app.settings.game-options.keybind.choose": { "message": "选择按键" },
+	"app.settings.game-options.keybind.conflict-description": { "message": "{settings} 已使用此按键。" },
+	"app.settings.game-options.keybind.key.arrow-down": { "message": "向下箭头" },
+	"app.settings.game-options.keybind.key.arrow-left": { "message": "向左箭头" },
+	"app.settings.game-options.keybind.key.arrow-right": { "message": "向右箭头" },
+	"app.settings.game-options.keybind.key.arrow-up": { "message": "向上箭头" },
+	"app.settings.game-options.keybind.key.backspace": { "message": "退格" },
+	"app.settings.game-options.keybind.key.caps-lock": { "message": "大写锁定" },
+	"app.settings.game-options.keybind.key.delete": { "message": "删除" },
+	"app.settings.game-options.keybind.key.end": { "message": "End 键" },
+	"app.settings.game-options.keybind.key.enter": { "message": "回车" },
+	"app.settings.game-options.keybind.key.escape": { "message": "Esc 键" },
+	"app.settings.game-options.keybind.key.home": { "message": "Home 键" },
+	"app.settings.game-options.keybind.key.insert": { "message": "Insert 键" },
+	"app.settings.game-options.keybind.key.keypad-key": { "message": "数字键盘 {key}" },
+	"app.settings.game-options.keybind.key.left-alt": { "message": "左 Alt" },
+	"app.settings.game-options.keybind.key.left-command": { "message": "左 Command" },
+	"app.settings.game-options.keybind.key.left-control": { "message": "左 Ctrl" },
+	"app.settings.game-options.keybind.key.left-shift": { "message": "左 Shift" },
+	"app.settings.game-options.keybind.key.left-super": { "message": "左 Super" },
+	"app.settings.game-options.keybind.key.menu": { "message": "菜单" },
+	"app.settings.game-options.keybind.key.num-lock": { "message": "数字锁定" },
+	"app.settings.game-options.keybind.key.page-down": { "message": "Page Down 键" },
+	"app.settings.game-options.keybind.key.page-up": { "message": "Page Up 键" },
+	"app.settings.game-options.keybind.key.pause": { "message": "暂停" },
+	"app.settings.game-options.keybind.key.print-screen": { "message": "截图" },
+	"app.settings.game-options.keybind.key.right-alt": { "message": "右 Alt" },
+	"app.settings.game-options.keybind.key.right-command": { "message": "右 Command" },
+	"app.settings.game-options.keybind.key.right-control": { "message": "右 Ctrl" },
+	"app.settings.game-options.keybind.key.right-shift": { "message": "右 Shift" },
+	"app.settings.game-options.keybind.key.right-super": { "message": "右 Super" },
+	"app.settings.game-options.keybind.key.scroll-lock": { "message": "滚动锁定" },
+	"app.settings.game-options.keybind.key.space": { "message": "空格" },
+	"app.settings.game-options.keybind.key.tab": { "message": "Tab 键" },
+	"app.settings.game-options.keybind.key.unbound": { "message": "未绑定" },
+	"app.settings.game-options.keybind.key.unknown": { "message": "未知按键" },
+	"app.settings.game-options.keybind.listen": { "message": "请按下一个按键……" },
+	"app.settings.game-options.keybind.listening-status": { "message": "正在监听按键或鼠标按钮。按 Esc 清除绑定。" },
+	"app.settings.game-options.keybind.mixed": { "message": "各实例不同" },
+	"app.settings.game-options.keybind.modifier.alt": { "message": "Alt 键" },
+	"app.settings.game-options.keybind.modifier.command": { "message": "Command 键" },
+	"app.settings.game-options.keybind.modifier.control": { "message": "Ctrl 键" },
+	"app.settings.game-options.keybind.modifier.shift": { "message": "Shift 键" },
+	"app.settings.game-options.keybind.modifier.super": { "message": "Super 键" },
+	"app.settings.game-options.keybind.mouse.button": { "message": "鼠标 {button}" },
+	"app.settings.game-options.keybind.mouse.left": { "message": "鼠标左键" },
+	"app.settings.game-options.keybind.mouse.middle": { "message": "鼠标中键" },
+	"app.settings.game-options.keybind.mouse.right": { "message": "鼠标右键" },
+	"app.settings.game-options.keybind.recording-label": { "message": "{setting}：正在监听按键或鼠标按钮。按 Esc 清除绑定。" },
+	"app.settings.game-options.keybind.scancode": { "message": "扫描码 {code}" },
+	"app.settings.game-options.keybind.unsupported-status": { "message": "Minecraft 无法使用此输入，请尝试其他按键。" },
+	"app.settings.game-options.setting.advanced-opengl.label": { "message": "高级 OpenGL" },
+	"app.settings.game-options.setting.allow-cursor-changes.label": { "message": "允许光标变化" },
+	"app.settings.game-options.setting.allow-server-listing.description": { "message": "允许玩家名称出现在服务器列表中。" },
+	"app.settings.game-options.setting.allow-server-listing.label": { "message": "服务器列表" },
+	"app.settings.game-options.setting.alternate-blocks.label": { "message": "备用方块" },
+	"app.settings.game-options.setting.ambient-occlusion.label": { "message": "平滑光照" },
+	"app.settings.game-options.setting.ambient-volume.label": { "message": "环境" },
+	"app.settings.game-options.setting.anaglyph-3d.label": { "message": "3D 红蓝立体" },
+	"app.settings.game-options.setting.anisotropic-filtering.label": { "message": "各向异性过滤" },
+	"app.settings.game-options.setting.anisotropy.label": { "message": "各向异性" },
+	"app.settings.game-options.setting.attack-indicator.label": { "message": "攻击指示器" },
+	"app.settings.game-options.setting.auto-jump.description": { "message": "自动跳过一格高的障碍物。" },
+	"app.settings.game-options.setting.auto-jump.label": { "message": "自动跳跃" },
+	"app.settings.game-options.setting.auto-suggestions.label": { "message": "命令建议" },
+	"app.settings.game-options.setting.autosave-indicator.label": { "message": "自动保存指示器" },
+	"app.settings.game-options.setting.biome-blend-radius.description": { "message": "生物群系颜色过渡的距离。" },
+	"app.settings.game-options.setting.biome-blend-radius.label": { "message": "生物群系混合" },
+	"app.settings.game-options.setting.blocks-volume.label": { "message": "方块" },
+	"app.settings.game-options.setting.brightness.label": { "message": "亮度" },
+	"app.settings.game-options.setting.cape.description": { "message": "显示玩家的披风，包括鞘翅纹理。" },
+	"app.settings.game-options.setting.cape.label": { "message": "披风" },
+	"app.settings.game-options.setting.chat-background-only.label": { "message": "仅聊天背景" },
+	"app.settings.game-options.setting.chat-colors.label": { "message": "聊天颜色" },
+	"app.settings.game-options.setting.chat-delay.label": { "message": "聊天延迟" },
+	"app.settings.game-options.setting.chat-line-spacing.label": { "message": "聊天行间距" },
+	"app.settings.game-options.setting.chat-links-prompt.description": { "message": "打开聊天链接前询问" },
+	"app.settings.game-options.setting.chat-links-prompt.label": { "message": "打开链接前询问" },
+	"app.settings.game-options.setting.chat-links.description": { "message": "允许打开聊天中的网页链接。" },
+	"app.settings.game-options.setting.chat-links.label": { "message": "网页链接" },
+	"app.settings.game-options.setting.chat-opacity.description": { "message": "聊天文字的不透明度。" },
+	"app.settings.game-options.setting.chat-opacity.label": { "message": "聊天不透明度" },
+	"app.settings.game-options.setting.chat-preview.label": { "message": "聊天预览" },
+	"app.settings.game-options.setting.chat-scale.label": { "message": "聊天缩放" },
+	"app.settings.game-options.setting.chat-visibility.label": { "message": "聊天可见性" },
+	"app.settings.game-options.setting.chat-width.label": { "message": "聊天宽度" },
+	"app.settings.game-options.setting.chunk-fade-time.label": { "message": "区块淡出时间" },
+	"app.settings.game-options.setting.cloud-range.label": { "message": "云层距离" },
+	"app.settings.game-options.setting.clouds.label": { "message": "云" },
+	"app.settings.game-options.setting.ctrl-click-right-click.label": { "message": "按住 Control 点击代替右键点击" },
+	"app.settings.game-options.setting.cutout-leaves.label": { "message": "半透明树叶" },
+	"app.settings.game-options.setting.damage-tilt.label": { "message": "受伤倾斜" },
+	"app.settings.game-options.setting.dark-splash.description": { "message": "将 Mojang Studios 加载界面从红色改为黑色。" },
+	"app.settings.game-options.setting.dark-splash.label": { "message": "单色徽标" },
+	"app.settings.game-options.setting.darkness-pulsing.label": { "message": "黑暗脉动" },
+	"app.settings.game-options.setting.debug-gui-scale.label": { "message": "调试界面缩放" },
+	"app.settings.game-options.setting.directional-audio.label": { "message": "方向性音频" },
+	"app.settings.game-options.setting.discrete-mouse-scroll.description": { "message": "将每次鼠标滚轮输入视为一个滚动步进。" },
+	"app.settings.game-options.setting.discrete-mouse-scroll.label": { "message": "离散滚动" },
+	"app.settings.game-options.setting.entity-distance.label": { "message": "实体距离" },
+	"app.settings.game-options.setting.entity-shadows.label": { "message": "实体阴影" },
+	"app.settings.game-options.setting.exclusive-fullscreen.label": { "message": "独占全屏" },
+	"app.settings.game-options.setting.extra-telemetry.label": { "message": "可选遥测" },
+	"app.settings.game-options.setting.focused-chat-height.label": { "message": "聚焦时聊天高度" },
+	"app.settings.game-options.setting.force-unicode-font.label": { "message": "强制 Unicode 字体" },
+	"app.settings.game-options.setting.fov-effects.label": { "message": "视野效果" },
+	"app.settings.game-options.setting.fov.label": { "message": "视野" },
+	"app.settings.game-options.setting.fullscreen.label": { "message": "全屏" },
+	"app.settings.game-options.setting.glint-speed.label": { "message": "附魔光效速度" },
+	"app.settings.game-options.setting.glint-strength.label": { "message": "附魔光效强度" },
+	"app.settings.game-options.setting.graphics-backend.label": { "message": "图形后端" },
+	"app.settings.game-options.setting.graphics.description": { "message": "控制画面质量和性能。" },
+	"app.settings.game-options.setting.graphics.label": { "message": "画面" },
+	"app.settings.game-options.setting.gui-scale.description": { "message": "游戏界面和 HUD 的大小。" },
+	"app.settings.game-options.setting.gui-scale.label": { "message": "界面缩放" },
+	"app.settings.game-options.setting.hat.description": { "message": "显示帽子皮肤层。" },
+	"app.settings.game-options.setting.hat.label": { "message": "帽子" },
+	"app.settings.game-options.setting.held-item-tooltips.label": { "message": "手持物品提示" },
+	"app.settings.game-options.setting.hide-lightning-flashes.label": { "message": "隐藏闪电闪光" },
+	"app.settings.game-options.setting.hide-matched-names.label": { "message": "隐藏匹配的名称" },
+	"app.settings.game-options.setting.hide-server-address.label": { "message": "隐藏服务器地址" },
+	"app.settings.game-options.setting.hide-splash-texts.label": { "message": "隐藏启动标语" },
+	"app.settings.game-options.setting.high-contrast-outline.label": { "message": "高对比度方块轮廓" },
+	"app.settings.game-options.setting.high-contrast.description": { "message": "增强界面元素的对比度。" },
+	"app.settings.game-options.setting.high-contrast.label": { "message": "高对比度" },
+	"app.settings.game-options.setting.hostile-volume.label": { "message": "敌对生物" },
+	"app.settings.game-options.setting.improved-transparency.label": { "message": "改进透明度" },
+	"app.settings.game-options.setting.in-game-notifications.label": { "message": "游戏内通知" },
+	"app.settings.game-options.setting.inactivity-framerate-limit.label": { "message": "降低帧率" },
+	"app.settings.game-options.setting.invert-horizontal-mouse.label": { "message": "反转水平鼠标" },
+	"app.settings.game-options.setting.invert-mouse.description": { "message": "反转垂直鼠标移动。" },
+	"app.settings.game-options.setting.invert-mouse.label": { "message": "反转鼠标" },
+	"app.settings.game-options.setting.jacket.description": { "message": "显示夹克皮肤层。" },
+	"app.settings.game-options.setting.jacket.label": { "message": "夹克" },
+	"app.settings.game-options.setting.japanese-glyph-variants.label": { "message": "日文字符变体" },
+	"app.settings.game-options.setting.key-advancements.label": { "message": "进度" },
+	"app.settings.game-options.setting.key-attack.label": { "message": "攻击" },
+	"app.settings.game-options.setting.key-back.label": { "message": "后退" },
+	"app.settings.game-options.setting.key-chat.label": { "message": "打开聊天" },
+	"app.settings.game-options.setting.key-command.label": { "message": "命令" },
+	"app.settings.game-options.setting.key-debug-advanced-tooltips.label": { "message": "显示高级提示" },
+	"app.settings.game-options.setting.key-debug-chunk-borders.label": { "message": "显示区块边界" },
+	"app.settings.game-options.setting.key-debug-clear-chat.label": { "message": "清空聊天" },
+	"app.settings.game-options.setting.key-debug-copy-location.label": { "message": "复制位置" },
+	"app.settings.game-options.setting.key-debug-copy-recreate-command.label": { "message": "复制重建命令" },
+	"app.settings.game-options.setting.key-debug-crash.label": { "message": "触发调试崩溃" },
+	"app.settings.game-options.setting.key-debug-dump-dynamic-textures.label": { "message": "转储动态纹理" },
+	"app.settings.game-options.setting.key-debug-dump-version.label": { "message": "转储版本" },
+	"app.settings.game-options.setting.key-debug-focus-pause.label": { "message": "失去焦点时暂停" },
+	"app.settings.game-options.setting.key-debug-fps-charts.label": { "message": "FPS 图表" },
+	"app.settings.game-options.setting.key-debug-hitboxes.label": { "message": "显示碰撞箱" },
+	"app.settings.game-options.setting.key-debug-improved-transparency.label": { "message": "改进透明度调试视图" },
+	"app.settings.game-options.setting.key-debug-lightmap-texture.label": { "message": "光照贴图纹理" },
+	"app.settings.game-options.setting.key-debug-modifier.label": { "message": "调试修饰键" },
+	"app.settings.game-options.setting.key-debug-network-charts.label": { "message": "网络图表" },
+	"app.settings.game-options.setting.key-debug-options.label": { "message": "调试选项" },
+	"app.settings.game-options.setting.key-debug-overlay.label": { "message": "调试覆盖层" },
+	"app.settings.game-options.setting.key-debug-profiling-chart.label": { "message": "性能分析图表" },
+	"app.settings.game-options.setting.key-debug-profiling.label": { "message": "开始性能分析" },
+	"app.settings.game-options.setting.key-debug-reload-chunks.label": { "message": "重新加载区块" },
+	"app.settings.game-options.setting.key-debug-reload-resource-packs.label": { "message": "重新加载资源包" },
+	"app.settings.game-options.setting.key-debug-spectate.label": { "message": "旁观实体" },
+	"app.settings.game-options.setting.key-debug-switch-game-mode.label": { "message": "切换游戏模式" },
+	"app.settings.game-options.setting.key-drop.label": { "message": "丢弃物品" },
+	"app.settings.game-options.setting.key-forward.label": { "message": "前进" },
+	"app.settings.game-options.setting.key-friends.label": { "message": "好友" },
+	"app.settings.game-options.setting.key-fullscreen.label": { "message": "切换全屏" },
+	"app.settings.game-options.setting.key-hotbar-1.label": { "message": "快捷栏 1" },
+	"app.settings.game-options.setting.key-hotbar-2.label": { "message": "快捷栏 2" },
+	"app.settings.game-options.setting.key-hotbar-3.label": { "message": "快捷栏 3" },
+	"app.settings.game-options.setting.key-hotbar-4.label": { "message": "快捷栏 4" },
+	"app.settings.game-options.setting.key-hotbar-5.label": { "message": "快捷栏 5" },
+	"app.settings.game-options.setting.key-hotbar-6.label": { "message": "快捷栏 6" },
+	"app.settings.game-options.setting.key-hotbar-7.label": { "message": "快捷栏 7" },
+	"app.settings.game-options.setting.key-hotbar-8.label": { "message": "快捷栏 8" },
+	"app.settings.game-options.setting.key-hotbar-9.label": { "message": "快捷栏 9" },
+	"app.settings.game-options.setting.key-inventory.label": { "message": "物品栏" },
+	"app.settings.game-options.setting.key-jump.label": { "message": "跳跃" },
+	"app.settings.game-options.setting.key-left.label": { "message": "向左平移" },
+	"app.settings.game-options.setting.key-load-toolbar.label": { "message": "加载工具栏" },
+	"app.settings.game-options.setting.key-perspective.label": { "message": "切换视角" },
+	"app.settings.game-options.setting.key-pick-item.label": { "message": "选取方块" },
+	"app.settings.game-options.setting.key-player-list.label": { "message": "玩家列表" },
+	"app.settings.game-options.setting.key-quick-actions.label": { "message": "快捷操作" },
+	"app.settings.game-options.setting.key-right.label": { "message": "向右平移" },
+	"app.settings.game-options.setting.key-save-toolbar.label": { "message": "保存工具栏" },
+	"app.settings.game-options.setting.key-screenshot.label": { "message": "截图" },
+	"app.settings.game-options.setting.key-smooth-camera.label": { "message": "切换电影视角" },
+	"app.settings.game-options.setting.key-sneak.label": { "message": "潜行" },
+	"app.settings.game-options.setting.key-social-interactions.label": { "message": "社交互动" },
+	"app.settings.game-options.setting.key-spectator-hotbar.label": { "message": "旁观者快捷栏" },
+	"app.settings.game-options.setting.key-spectator-outlines.label": { "message": "高亮旁观者" },
+	"app.settings.game-options.setting.key-sprint.label": { "message": "疾跑" },
+	"app.settings.game-options.setting.key-swap-offhand.label": { "message": "交换副手" },
+	"app.settings.game-options.setting.key-toggle-gui.label": { "message": "切换 HUD" },
+	"app.settings.game-options.setting.key-toggle-spectator-shader.label": { "message": "切换旁观者着色器" },
+	"app.settings.game-options.setting.key-use.label": { "message": "使用物品" },
+	"app.settings.game-options.setting.language.label": { "message": "语言" },
+	"app.settings.game-options.setting.left-pants-leg.label": { "message": "左裤腿" },
+	"app.settings.game-options.setting.left-sleeve.label": { "message": "左袖" },
+	"app.settings.game-options.setting.legacy-framerate-limit.label": { "message": "帧率上限" },
+	"app.settings.game-options.setting.legacy-view-distance.label": { "message": "视距" },
+	"app.settings.game-options.setting.mac-fullscreen-menu.label": { "message": "全屏时显示 macOS 菜单" },
+	"app.settings.game-options.setting.main-hand.description": { "message": "选择主手为左手还是右手。" },
+	"app.settings.game-options.setting.main-hand.label": { "message": "主手" },
+	"app.settings.game-options.setting.master-volume.label": { "message": "主音量" },
+	"app.settings.game-options.setting.max-framerate.label": { "message": "最大帧率" },
+	"app.settings.game-options.setting.menu-background-blur.label": { "message": "菜单背景模糊" },
+	"app.settings.game-options.setting.mipmap-levels.description": { "message": "平滑远处纹理。" },
+	"app.settings.game-options.setting.mipmap-levels.label": { "message": "Mipmap 级别" },
+	"app.settings.game-options.setting.mouse-wheel-sensitivity.label": { "message": "鼠标滚轮灵敏度" },
+	"app.settings.game-options.setting.music-frequency.label": { "message": "音乐频率" },
+	"app.settings.game-options.setting.music-toast.description": { "message": "选择是否在暂停菜单和提示中显示音乐标题。" },
+	"app.settings.game-options.setting.music-toast.label": { "message": "音乐通知" },
+	"app.settings.game-options.setting.music-volume.label": { "message": "音乐" },
+	"app.settings.game-options.setting.narrator-hotkey.label": { "message": "旁白快捷键" },
+	"app.settings.game-options.setting.narrator.description": { "message": "选择旁白朗读的内容。" },
+	"app.settings.game-options.setting.narrator.label": { "message": "旁白" },
+	"app.settings.game-options.setting.neutral-volume.label": { "message": "友好生物" },
+	"app.settings.game-options.setting.notification-time.description": { "message": "提示通知保持显示的时长。" },
+	"app.settings.game-options.setting.notification-time.label": { "message": "通知时长" },
+	"app.settings.game-options.setting.operator-items-tab.label": { "message": "管理员物品栏标签" },
+	"app.settings.game-options.setting.panorama-speed.label": { "message": "全景图速度" },
+	"app.settings.game-options.setting.particles.label": { "message": "粒子" },
+	"app.settings.game-options.setting.players-volume.label": { "message": "玩家" },
+	"app.settings.game-options.setting.prioritize-chunk-updates.label": { "message": "区块更新优先级" },
+	"app.settings.game-options.setting.quit-shortcuts.label": { "message": "退出快捷键" },
+	"app.settings.game-options.setting.raw-mouse-input.label": { "message": "原始鼠标输入" },
+	"app.settings.game-options.setting.realms-notifications.label": { "message": "Realms 通知" },
+	"app.settings.game-options.setting.record-volume.label": { "message": "唱片机/音符盒" },
+	"app.settings.game-options.setting.reduced-debug-info.label": { "message": "减少调试信息" },
+	"app.settings.game-options.setting.render-distance.label": { "message": "渲染距离" },
+	"app.settings.game-options.setting.right-pants-leg.label": { "message": "右裤腿" },
+	"app.settings.game-options.setting.right-sleeve.label": { "message": "右袖" },
+	"app.settings.game-options.setting.rotate-with-minecart.label": { "message": "随矿车旋转" },
+	"app.settings.game-options.setting.save-chat-drafts.label": { "message": "保存聊天草稿" },
+	"app.settings.game-options.setting.screen-effects.label": { "message": "屏幕效果" },
+	"app.settings.game-options.setting.secure-chat-only.label": { "message": "仅显示安全聊天" },
+	"app.settings.game-options.setting.sensitivity.label": { "message": "鼠标灵敏度" },
+	"app.settings.game-options.setting.server-textures.label": { "message": "服务器纹理" },
+	"app.settings.game-options.setting.share-presence.label": { "message": "共享在线状态" },
+	"app.settings.game-options.setting.simulation-distance.description": { "message": "实体更新以及方块和流体更新的距离。" },
+	"app.settings.game-options.setting.simulation-distance.label": { "message": "模拟距离" },
+	"app.settings.game-options.setting.snooper.label": { "message": "数据收集" },
+	"app.settings.game-options.setting.sprint-window.label": { "message": "疾跑窗口" },
+	"app.settings.game-options.setting.subtitles.description": { "message": "显示游戏声音的字幕。" },
+	"app.settings.game-options.setting.subtitles.label": { "message": "字幕" },
+	"app.settings.game-options.setting.text-background-opacity.label": { "message": "文字背景不透明度" },
+	"app.settings.game-options.setting.texture-filtering.label": { "message": "纹理过滤" },
+	"app.settings.game-options.setting.toggle-attack.label": { "message": "切换攻击" },
+	"app.settings.game-options.setting.toggle-crouch.description": { "message": "按一次即可保持潜行。" },
+	"app.settings.game-options.setting.toggle-crouch.label": { "message": "切换潜行" },
+	"app.settings.game-options.setting.toggle-sprint.description": { "message": "按一次即可保持疾跑。" },
+	"app.settings.game-options.setting.toggle-sprint.label": { "message": "切换疾跑" },
+	"app.settings.game-options.setting.toggle-use.label": { "message": "切换使用" },
+	"app.settings.game-options.setting.touchscreen.label": { "message": "触屏模式" },
+	"app.settings.game-options.setting.ui-volume.label": { "message": "界面" },
+	"app.settings.game-options.setting.unfocused-chat-height.label": { "message": "未聚焦时聊天高度" },
+	"app.settings.game-options.setting.use-vbo.label": { "message": "使用 VBO" },
+	"app.settings.game-options.setting.view-bobbing.description": { "message": "行走时为镜头添加摇摆效果。" },
+	"app.settings.game-options.setting.view-bobbing.label": { "message": "视角摇摆" },
+	"app.settings.game-options.setting.vignette.label": { "message": "晕影" },
+	"app.settings.game-options.setting.voice-volume.label": { "message": "语音和语音朗读" },
+	"app.settings.game-options.setting.vsync.description": { "message": "将帧率限制为显示器刷新率，以防止画面撕裂。" },
+	"app.settings.game-options.setting.vsync.label": { "message": "垂直同步" },
+	"app.settings.game-options.setting.weather-radius.label": { "message": "天气范围" },
+	"app.settings.game-options.setting.weather-volume.label": { "message": "天气" },
+	"app.settings.game-options.validation.changed-since-opened": { "message": "此设置已在其他位置更改，请检查后重试。" },
+	"app.settings.game-options.validation.invalid-value": { "message": "请选择有效值。" },
+	"app.settings.game-options.validation.missing-value": { "message": "请先选择一个值。" },
+	"app.settings.game-options.validation.no-compatible-instances": { "message": "部分实例无法使用此设置" },
+	"app.settings.synced-options.game-settings.conflict-text": { "message": "我们已加载最新设置。请检查更改后再次保存。" },
+	"app.settings.synced-options.game-settings.conflict-title": { "message": "这些设置已在其他地方更改" },
+	"app.settings.synced-options.game-settings.custom-empty": { "message": "Modrinth 在某个实例中找到模组添加的设置后，它们会显示在这里。" },
+	"app.settings.synced-options.game-settings.disable-all": { "message": "取消同步全部" },
+	"app.settings.synced-options.game-settings.empty": { "message": "没有匹配当前搜索或筛选条件的设置。" },
+	"app.settings.synced-options.game-settings.enable-all": { "message": "同步全部" },
+	"app.settings.synced-options.game-settings.load-failed": { "message": "无法加载游戏设置。" },
+	"app.settings.synced-options.game-settings.loading": { "message": "正在加载设置……" },
+	"app.settings.synced-options.game-settings.not-being-synced": { "message": "未同步" },
+	"app.settings.synced-options.game-settings.retry": { "message": "重试" },
+	"app.settings.synced-options.game-settings.save": { "message": "保存设置" },
+	"app.settings.synced-options.game-settings.search": { "message": "搜索设置……" },
+	"app.settings.synced-options.game-settings.sync-description": { "message": "同步的选项会应用到每个实例，并覆盖整合包中包含的值。" },
+	"app.settings.synced-options.game-settings.sync-setting": { "message": "在所有实例间同步{setting}" },
+	"app.settings.synced-options.game-settings.sync-title": { "message": "同步游戏设置" },
+	"app.settings.synced-options.game-settings.synced-across-instances": { "message": "已在所有实例间同步" },
+	"app.settings.synced-options.game-settings.title": { "message": "游戏设置" },
+	"app.settings.synced-options.game-settings.unsaved-changes": { "message": "你有未保存的更改。" },
+	"app.settings.synced-options.game-settings.unsync-setting": { "message": "停止在所有实例间同步{setting}" },
+	"app.settings.synced-options.game-settings.value-mixed": { "message": "各实例不同" },
+	"app.settings.synced-options.game-settings.value-off": { "message": "关闭" },
+	"app.settings.synced-options.game-settings.value-on": { "message": "开启" },
+	"app.settings.synced-options.game-settings.value-unset": { "message": "选择一个值" },
+	"app.anniversary.banner": { "message": "Starlight {ordinal} 周年快乐！" },
+	"instance.settings.tabs.window.window-title": { "message": "窗口标题" },
+	"instance.settings.tabs.window.window-title.description": { "message": "自定义 Minecraft 窗口标题。留空则使用默认标题。" },
+	"instance.settings.tabs.window.window-title.enter": { "message": "输入窗口标题..." },
+	"app.settings.defaults.window-title.enabled": { "message": "自定义 Minecraft 窗口标题" },
+	"app.settings.defaults.window-title.enabled-description": { "message": "允许实例自定义 Minecraft 窗口标题。" },
+	"app.settings.defaults.window-title.default": { "message": "默认窗口标题" },
+	"app.settings.defaults.window-title.default-description": { "message": "当实例未提供自己的标题时使用。" },
+	"app.settings.defaults.window-title.default-placeholder": { "message": "输入默认窗口标题..." },
+	"app.action-bar.announcements": { "message": "公告" },
+	"app.remote-announcements.center-title": { "message": "公告" },
+	"app.remote-announcements.empty": { "message": "暂无公告" },
+	"app.settings.tabs.logs": { "message": "日志与诊断" },
+	"app.settings.logs.export.title": { "message": "导出日志" },
+	"app.settings.logs.export.description": { "message": "将启动器日志打包，可附带环境摘要、最近的实例日志与崩溃分析。" },
+	"app.settings.logs.export.button": { "message": "导出日志…" },
+	"app.settings.logs.open-folder": { "message": "打开日志文件夹" },
+	"app.settings.logs.export.modal.title": { "message": "导出日志" },
+	"app.settings.logs.export.modal.description": { "message": "选择要包含的详细程度。导出的日志会把访问令牌、Minecraft 令牌与 IP 地址替换为占位符。" },
+	"app.settings.logs.export.modal.range": { "message": "时间范围" },
+	"app.settings.logs.export.modal.range.30-minutes": { "message": "最近 30 分钟" },
+	"app.settings.logs.export.modal.range.2-hours": { "message": "最近 2 小时" },
+	"app.settings.logs.export.modal.range.all": { "message": "全部会话" },
+	"app.settings.logs.export.modal.level": { "message": "日志等级" },
+	"app.settings.logs.export.modal.level.all": { "message": "全部等级" },
+	"app.settings.logs.export.modal.level.debug": { "message": "DEBUG 及以上" },
+	"app.settings.logs.export.modal.level.info": { "message": "INFO 及以上" },
+	"app.settings.logs.export.modal.extras": { "message": "附加信息" },
+	"app.settings.logs.export.modal.system-info": { "message": "系统与环境摘要" },
+	"app.settings.logs.export.modal.instance-logs": { "message": "最近的实例日志" },
+	"app.settings.logs.export.modal.crash-analysis": { "message": "崩溃分析（检测到崩溃时）" },
+	"app.settings.logs.export.modal.cancel": { "message": "取消" },
+	"app.settings.logs.export.modal.confirm": { "message": "导出" },
+	"app.settings.logs.export.notification-title": { "message": "日志已导出" },
+	"app.settings.logs.export.notification-text": { "message": "日志压缩包已保存到 {path}" },
+  "app.skins.armor.title": {"message": "盔甲与纹饰"},
+  "app.skins.armor.save": {"message": "保存"},
+  "app.skins.armor.close": {"message": "关闭"},
+  "app.skins.armor.description": {"message": "在皮肤上试穿盔甲与纹饰。未保存前不会写入任何内容。"},
+  "app.skins.armor.unsaved": {"message": "有未保存的更改"},
+  "app.skins.armor.reset-to-saved": {"message": "重置为已保存"},
+  "app.skins.armor.restore-defaults": {"message": "恢复默认"},
+  "app.instances.batch-edit-groups.add": {"message": "添加"},
+  "app.instances.batch-edit-groups.add-to-group-title": {"message": "添加实例到「{groupName}」"},
+  "app.instances.batch-edit-groups.added": {"message": "已添加"},
+  "app.instances.batch-edit-groups.cancel": {"message": "取消"},
+  "app.instances.batch-edit-groups.create": {"message": "创建分组"},
+  "app.instances.batch-edit-groups.group-name": {"message": "分组名称"},
+  "app.instances.batch-edit-groups.group-name-placeholder": {"message": "输入分组名称"},
+  "app.instances.batch-edit-groups.no-instances-found": {"message": "未找到实例"},
+  "app.instances.batch-edit-groups.save-changes": {"message": "保存"},
+  "app.instances.batch-edit-groups.search-instance": {"message": "搜索实例"},
+  "app.instances.group.add-to-group": {"message": "添加到分组"},
+  "app.instances.group.collapse": {"message": "折叠分组"},
+  "app.instances.group.delete-description": {"message": "此分组中的实例将被取消分组。"},
+  "app.instances.group.delete-group": {"message": "删除分组"},
+  "app.instances.group.edit-name": {"message": "编辑分组名称"},
+  "app.instances.group.empty": {"message": "拖放实例到此处添加。"},
+  "app.instances.group.expand": {"message": "展开分组"},
+  "app.instances.group.move-down": {"message": "下移分组"},
+  "app.instances.group.move-up": {"message": "上移分组"},
+  "app.instances.group.name-empty": {"message": "分组名称不能为空。"},
+  "app.instances.group.name-too-long": {"message": "分组名称不能超过 {maxLength} 个字符。"},
+  "app.instances.group.new-instance": {"message": "新建实例"},
+  "app.instances.group.pinned": {"message": "已置顶"},
+  "app.instances.group.rename-group": {"message": "重命名分组"},
+  "app.instances.sort-by": {"message": "排序方式"},
+  "app.instances.sort.direction.asc-alphabetical": {"message": "A–Z 正序"},
+  "app.instances.sort.direction.asc-date": {"message": "最早的在前"},
+  "app.instances.sort.direction.asc-recency": {"message": "最早游玩在前"},
+  "app.instances.sort.direction.asc-version": {"message": "旧版本在前"},
+  "app.instances.sort.direction.desc-alphabetical": {"message": "Z–A 倒序"},
+  "app.instances.sort.direction.desc-date": {"message": "最新的在前"},
+  "app.instances.sort.direction.desc-recency": {"message": "最近游玩在前"},
+  "app.instances.sort.direction.desc-version": {"message": "新版本在前"},
+  "app.library.context-menu.pin-instance": {"message": "置顶实例"},
+  "app.library.context-menu.remove-from-group": {"message": "移出分组"},
+  "app.library.context-menu.unpin-instance": {"message": "取消置顶"},
+  "app.library.group.new": {"message": "新建分组"},
+  "app.library.selection.new-group": {"message": "新建分组"},
+  "app.library.selection.remove-from-group": {"message": "移出分组"},
+  "app.log-share.settings.title": {"message": "日志分享与 AI 分析"},
+  "app.log-share.settings.description": {"message": "将崩溃诊断分享到 LogShare，获取结构化摘要与可选的 AI 分析。优先使用 LogShare，不可用时回退到 mclo.gs。"},
+  "app.log-share.settings.share-provider": {"message": "日志分享服务"},
+  "app.log-share.settings.share-provider-description": {"message": "分享诊断链接时上传到的目标服务。"},
+  "app.log-share.settings.ai-source": {"message": "AI 分析来源"},
+  "app.log-share.settings.ai-source-logshare": {"message": "LogShare AI"},
+  "app.log-share.settings.ai-source-custom": {"message": "自定义 AI 服务商"},
+  "app.log-share.settings.ai-source-description": {"message": "LogShare AI 在云端分析；自定义则使用下方配置的服务商。"},
+  "app.log-share.settings.auto-upload": {"message": "自动上传以获取结构化摘要"},
+  "app.log-share.settings.auto-upload-description": {"message": "仅在 LogShare 模式下生效。"},
+  "app.log-share.settings.multi-file": {"message": "多文件上传"},
+  "app.log-share.settings.multi-file-description": {"message": "同时上传 latest.log、崩溃报告、hs_err 以及启动器日志。"},
+  "app.log-share.settings.no-storage": {"message": "不落盘直接分析"},
+  "app.log-share.settings.no-storage-description": {"message": "直接提交内容进行分析并跳过存储上传。会关闭自动摘要。"},
+  "app.log-share.settings.show-progress": {"message": "显示 AI 分析进度"},
+  "app.log-share.settings.show-progress-description": {"message": "展示 LogAgent 运行期间的思考、工具及上限状态。"},
+  "app.log-share.shared-logs.title": {"message": "已分享日志"},
+  "app.log-share.shared-logs.description": {"message": "你分享过的所有诊断都记录在这里。删除条目会将其从记录中移除，并向分享服务请求删除。"},
+  "app.log-share.shared-logs.empty": {"message": "暂无已分享的日志。"},
+  "app.log-share.shared-logs.delete": {"message": "删除"},
+  "app.log-share.shared-logs.deleting": {"message": "删除中…"},
+  "app.log-share.shared-logs.deleted": {"message": "已删除共享日志。"},
+  "app.log-share.shared-logs.delete-failed": {"message": "删除已分享日志失败。"},
+  "app.log-share.shared-logs.truncated": {"message": "已截断"},
+  "app.minecraft-crash.share-fallback": {"message": "LogShare 不可用，已改用 mclo.gs 分享诊断信息。"},
+  "app.log-share.ai.action": {"message": "AI 深度分析"},
+  "app.log-share.summary.title": {"message": "LogShare 分析"},
+  "app.log-share.summary.loading": {"message": "正在加载结构化摘要…"},
+  "app.log-share.summary.empty": {"message": "LogShare 未返回这些日志的结构化摘要。"},
+  "app.log-share.summary.no-storage": {"message": "启用不落盘模式时无法获取结构化摘要。"},
+  "app.log-share.summary.failed": {"message": "无法加载 LogShare 摘要：{message}"},
+  "app.log-share.summary.problems": {"message": "问题"},
+  "app.log-share.summary.information": {"message": "信息"},
+  "app.minecraft-crash.logs.loading": {"message": "正在加载崩溃日志…"},
+  "app.minecraft-crash.logs.empty": {"message": "未找到本次启动产生的日志。"},
+  "app.minecraft-crash.logs.failed": {"message": "无法加载崩溃日志：{message}"},
+  "app.minecraft-crash.log-file.loading": {"message": "正在加载日志文件…"},
+  "app.minecraft-crash.log-file.failed": {"message": "无法加载此日志文件：{message}"},
+  "app.log-share.ai.tab": {"message": "LogAgent 深度分析"},
+  "app.log-share.ai.root-cause": {"message": "核心根因"},
+  "app.log-share.ai.confidence": {"message": "诊断置信度"},
+  "app.log-share.ai.steps": {"message": "推荐排障步骤"},
+  "app.log-share.ai.evidence": {"message": "支撑证据链"},
+  "app.log-share.ai.thinking": {"message": "思考中…"},
+  "app.log-share.ai.queued": {"message": "排队中，前方约 {position} 个任务"},
+  "app.log-share.ai.queued-front": {"message": "排队中，正在等待空闲槽位"},
+  "app.log-share.ai.tool": {"message": "正在使用工具：{name}"},
+  "app.log-share.ai.unknown-tool": {"message": "工具"},
+  "app.log-share.ai.tool-result": {"message": "已收到工具结果"},
+  "app.log-share.ai.limit": {"message": "已达到工具调用上限"},
+  "app.log-share.ai.working": {"message": "正在使用 LogAgent 分析…"},
+  "app.log-share.ai.failed": {"message": "LogAgent 分析失败：{message}"},
+  "app.shortcut-settings.change-shortcut": {"message": "更改「{action}」的快捷键"},
+  "app.shortcut-settings.enable": {"message": "启用快捷滚动"},
+  "app.shortcut-settings.end-action": {"message": "滚动到页面底部"},
+  "app.shortcut-settings.end-action-description": {"message": "将当前页面移动到底部。"},
+  "app.shortcut-settings.home-action": {"message": "滚动到页面顶部"},
+  "app.shortcut-settings.home-action-description": {"message": "将当前页面移动到顶部。"},
+  "app.shortcut-settings.nav-create": {"message": "新建实例"},
+  "app.shortcut-settings.nav-create-description": {"message": "前往新建实例。"},
+  "app.shortcut-settings.nav-description": {"message": "使用各自的快捷键跳转到对应菜单项。每个快捷键默认关闭，需逐个启用。"},
+  "app.shortcut-settings.nav-discover": {"message": "发现内容"},
+  "app.shortcut-settings.nav-discover-description": {"message": "前往浏览内容。"},
+  "app.shortcut-settings.nav-downloads": {"message": "下载"},
+  "app.shortcut-settings.nav-downloads-description": {"message": "前往下载。"},
+  "app.shortcut-settings.nav-home": {"message": "首页"},
+  "app.shortcut-settings.nav-home-description": {"message": "前往首页。"},
+  "app.shortcut-settings.nav-lab": {"message": "实验室"},
+  "app.shortcut-settings.nav-lab-description": {"message": "前往实验室。"},
+  "app.shortcut-settings.nav-library": {"message": "内容库"},
+  "app.shortcut-settings.nav-library-description": {"message": "前往内容库。"},
+  "app.shortcut-settings.nav-multiplayer": {"message": "多人游戏"},
+  "app.shortcut-settings.nav-multiplayer-description": {"message": "前往多人游戏。"},
+  "app.shortcut-settings.nav-settings": {"message": "设置"},
+  "app.shortcut-settings.nav-settings-description": {"message": "前往设置。"},
+  "app.shortcut-settings.nav-skins": {"message": "皮肤选择器"},
+  "app.shortcut-settings.nav-skins-description": {"message": "前往皮肤选择器。"},
+  "app.shortcut-settings.nav-title": {"message": "导航快捷键"},
+  "app.shortcut-settings.nav-worlds": {"message": "世界"},
+  "app.shortcut-settings.nav-worlds-description": {"message": "前往你的世界。"},
+  "app.shortcut-settings.page-down-action": {"message": "向下滚动一屏"},
+  "app.shortcut-settings.page-down-action-description": {"message": "将当前页面向下移动一屏。"},
+  "app.shortcut-settings.page-up-action": {"message": "向上滚动一屏"},
+  "app.shortcut-settings.page-up-action-description": {"message": "将当前页面向上移动一屏。"},
+  "app.shortcut-settings.scroll-description": {"message": "使用键盘在长页面中快速滚动。"},
+  "app.shortcut-settings.scroll-title": {"message": "快速滚动"},
+  "app.settings.tabs.shortcut-settings": {"message": "键盘快捷键"}
 }

apps/app-frontend/src/pages/Skins.vue

@@ -9,9 +9,13 @@ import {
 	SpinnerIcon,
 } from '@modrinth/assets'
 import {
+	type ArmorPreviewConfig,
+	ArmorPreviewControls,
 	ButtonStyled,
+	cloneArmorPreviewConfig,
 	commonMessages,
 	ConfirmModal,
+	createDefaultArmorPreviewConfig,
 	defineMessages,
 	injectNotificationManager,
 	NavTabs,
@@ -24,12 +28,14 @@ import { invoke } from '@tauri-apps/api/core'
 import type { DragDropEvent } from '@tauri-apps/api/webview'
 import { getCurrentWebview } from '@tauri-apps/api/webview'
 import { computedAsync } from '@vueuse/core'
-import type { Ref } from 'vue'
+import type { ComponentPublicInstance, Ref } from 'vue'
 import { computed, inject, onMounted, onUnmounted, ref, useTemplateRef, watch } from 'vue'
 import { onBeforeRouteLeave, useRouter } from 'vue-router'
 
 import type AccountsCard from '@/components/ui/AccountsCard.vue'
+import ArmorTrimTab from '@/components/ui/skin/ArmorTrimTab.vue'
 import EditSkinModal from '@/components/ui/skin/EditSkinModal.vue'
+import SkinListSkeleton from '@/components/ui/skin/SkinListSkeleton.vue'
 import VirtualSkinSectionList from '@/components/ui/skin/VirtualSkinSectionList.vue'
 import {
 	openSkinSiteLogin,
@@ -45,6 +51,7 @@ import { useNetworkStatus } from '@/composables/useNetworkStatus'
 import { check_reachable, get_default_user, users } from '@/helpers/auth'
 import type { RenderResult } from '@/helpers/rendering/batch-skin-renderer.ts'
 import { skinBlobUrlMap } from '@/helpers/rendering/batch-skin-renderer.ts'
+import { loadSkinArmorPreview, saveSkinArmorPreview } from '@/helpers/skin-armor-preview'
 import type { Cape, Skin, SkinTextureUrl } from '@/helpers/skins.ts'
 import {
 	determineModelType,
@@ -252,6 +259,8 @@ const editSkinModal = useTemplateRef('editSkinModal')
 const addSkinFileInput = useTemplateRef<HTMLInputElement>('addSkinFileInput')
 const skinSectionList = useTemplateRef<VirtualSkinSectionListExpose>('skinSectionList')
 const skinPreviewArea = useTemplateRef<HTMLElement>('skinPreviewArea')
+const armorTrimTab = useTemplateRef<ComponentPublicInstance>('armorTrimTab')
+const armorPreviewControls = useTemplateRef<ComponentPublicInstance>('armorPreviewControls')
 
 const { formatMessage } = useVIntl()
 const router = useRouter()
@@ -391,7 +400,8 @@ const isAddSkinButtonDragActive = ref(false)
 
 const deleteSkinModal = ref()
 const skinToDelete = ref<Skin | null>(null)
-const skinListTab = ref<'saved' | 'default'>('saved')
+const lastSkinListTab = ref<'saved' | 'default'>('saved')
+const skinListTab = ref<'saved' | 'default' | 'armor'>('saved')
 
 const skinListTabLinks = computed(() => [
 	{
@@ -403,6 +413,70 @@ const skinListTabLinks = computed(() => [
 		label: formatMessage(messages.defaultTab),
 	},
 ])
+const ARMOR_TRIM_PANEL_ID = 'skins-armor-trim-panel'
+const savedArmorPreview = ref<ArmorPreviewConfig>(loadSkinArmorPreview())
+const armorPreviewConfig = ref<ArmorPreviewConfig>(cloneArmorPreviewConfig(savedArmorPreview.value))
+
+function saveArmorPreview() {
+	savedArmorPreview.value = cloneArmorPreviewConfig(armorPreviewConfig.value)
+	saveSkinArmorPreview(savedArmorPreview.value)
+}
+
+function resetArmorPreviewToSaved() {
+	armorPreviewConfig.value = cloneArmorPreviewConfig(savedArmorPreview.value)
+}
+
+function restoreDefaultArmorPreview() {
+	armorPreviewConfig.value = createDefaultArmorPreviewConfig()
+}
+
+/** A third tab behind the two list tabs, opened from the preview's action row. */
+function openArmorTab() {
+	if (skinListTab.value !== 'armor') lastSkinListTab.value = skinListTab.value
+
+	skinListTab.value = 'armor'
+}
+
+/**
+ * Whether an element belongs to the armour surface: somewhere inside the open
+ * armour tab or the button that toggles it. Only those hold a focus ring that
+ * would be left behind when the tab closes.
+ */
+function isArmorPreviewElement(element: Element) {
+	const tabElement: unknown = armorTrimTab.value?.$el
+	const toggleElement: unknown = armorPreviewControls.value?.$el
+
+	return (
+		(tabElement instanceof Element && tabElement.contains(element)) ||
+		(toggleElement instanceof Element && toggleElement.contains(element))
+	)
+}
+
+function closeArmorTab() {
+	// Leaving the tab drops whatever was not saved on purpose.
+	resetArmorPreviewToSaved()
+	skinListTab.value = lastSkinListTab.value
+
+	// Escape and the toggle both leave the armour button holding focus, which
+	// keeps its focus ring drawn until something else is clicked. Only drop that
+	// ring when the focus sits on the armour surface, never on an unrelated
+	// control that happened to hold it when Escape was pressed.
+	const focused = document.activeElement
+	if (focused instanceof HTMLElement && isArmorPreviewElement(focused)) focused.blur()
+}
+
+/**
+ * The tab bar keeps the last list tab highlighted while the armour tab shows, so
+ * picking one of them leaves the armour tab. That transition has to drop the
+ * draft exactly like the toggle and Escape paths do, or it lingers on the model
+ * while the panel is gone.
+ */
+function selectSkinListTab(index: number) {
+	if (skinListTab.value === 'armor') resetArmorPreviewToSaved()
+
+	lastSkinListTab.value = index === 0 ? 'saved' : 'default'
+	skinListTab.value = lastSkinListTab.value
+}
 
 function confirmDeleteSkin(skin: Skin) {
 	if (isSkinManagementReadOnly.value) return
@@ -1211,6 +1285,9 @@ await loadSkins()
 				class="ml-5 mt-4 flex h-[calc(80vh-1rem)] items-center justify-center max-[700px]:h-[calc(50vh-1rem)]"
 			>
 				<SkinPreviewRenderer
+					v-model:armor-config="armorPreviewConfig"
+					armor-preview
+					:armor-controls="false"
 					:cape-src="capeTexture"
 					:texture-src="skinTexture || ''"
 					:variant="skinVariant"
@@ -1257,6 +1334,16 @@ await loadSkins()
 							<EditIcon />
 							{{ formatMessage(messages.editSkinButton) }}
 						</button>
+						<ArmorPreviewControls
+							v-if="!isSkinSiteProfile"
+							ref="armorPreviewControls"
+							v-model="armorPreviewConfig"
+							panel="external"
+							:panel-id="ARMOR_TRIM_PANEL_ID"
+							:open="skinListTab === 'armor'"
+							@open="openArmorTab"
+							@close="closeArmorTab"
+						/>
 					</template>
 				</SkinPreviewRenderer>
 			</div>
@@ -1265,14 +1352,10 @@ await loadSkins()
 		<div class="pt-2">
 			<div class="mb-4 flex flex-wrap items-center justify-between gap-3">
 				<NavTabs
-					:active-index="skinListTab === 'saved' ? 0 : 1"
+					:active-index="lastSkinListTab === 'saved' ? 0 : 1"
 					:links="skinListTabLinks"
 					mode="local"
-					@tab-click="
-						(index: number) => {
-							skinListTab = index === 0 ? 'saved' : 'default'
-						}
-					"
+					@tab-click="selectSkinListTab"
 				/>
 				<ButtonStyled v-if="!isSkinSiteProfile" color="brand">
 					<button @click="router.push('/lab/skin-editor')">
@@ -1281,27 +1364,45 @@ await loadSkins()
 					</button>
 				</ButtonStyled>
 			</div>
-			<VirtualSkinSectionList
-				ref="skinSectionList"
-				:active-tab="skinListTab"
-				:saved-skins="savedSkins"
-				:default-skin-sections="defaultSkinSections"
-				:get-baked-skin-textures="getBakedSkinTextures"
-				:is-skin-selected="isSkinSelected"
-				:is-skin-active="isSkinActive"
-				:is-add-skin-button-drag-active="isAddSkinButtonDragActive"
-				:read-only="isSkinManagementReadOnly"
-				:manage-saved-skins="!isSkinSiteProfile"
-				@select="changeSkin"
-				@edit="(skin, event) => !isSkinSiteProfile && editSkinModal?.show(event, skin)"
-				@delete="confirmDeleteSkin"
-				@reorder-saved-skins="reorderSavedSkins"
-				@add-skin="openAddSkinFileBrowser"
-				@add-skin-dragenter="onAddSkinDragOver"
-				@add-skin-dragover="onAddSkinDragOver"
-				@add-skin-dragleave="onAddSkinDragLeave"
-				@add-skin-drop="onAddSkinDrop"
-			/>
+			<Transition name="armor-tab" mode="out-in">
+				<div v-if="skinListTab !== 'armor'" key="list">
+					<SkinListSkeleton v-if="isSkinListBuffering" />
+					<VirtualSkinSectionList
+						v-show="!isSkinListBuffering"
+						ref="skinSectionList"
+						:active-tab="skinListTab"
+						:saved-skins="savedSkins"
+						:default-skin-sections="defaultSkinSections"
+						:get-baked-skin-textures="getBakedSkinTextures"
+						:is-skin-selected="isSkinSelected"
+						:is-skin-active="isSkinActive"
+						:is-add-skin-button-drag-active="isAddSkinButtonDragActive"
+						:read-only="isSkinManagementReadOnly"
+						:manage-saved-skins="!isSkinSiteProfile"
+						@select="changeSkin"
+						@edit="(skin, event) => !isSkinSiteProfile && editSkinModal?.show(event, skin)"
+						@delete="confirmDeleteSkin"
+						@reorder-saved-skins="reorderSavedSkins"
+						@add-skin="openAddSkinFileBrowser"
+						@add-skin-dragenter="onAddSkinDragOver"
+						@add-skin-dragover="onAddSkinDragOver"
+						@add-skin-dragleave="onAddSkinDragLeave"
+						@add-skin-drop="onAddSkinDrop"
+					/>
+				</div>
+				<ArmorTrimTab
+					v-else
+					ref="armorTrimTab"
+					key="armor"
+					v-model="armorPreviewConfig"
+					:panel-id="ARMOR_TRIM_PANEL_ID"
+					:saved="savedArmorPreview"
+					@save="saveArmorPreview"
+					@reset="resetArmorPreviewToSaved"
+					@defaults="restoreDefaultArmorPreview"
+					@close="closeArmorTab"
+				/>
+			</Transition>
 		</div>
 	</div>
 
@@ -1382,4 +1483,17 @@ await loadSkins()
 		grid-template-columns: 1fr;
 	}
 }
+// The armour tab crossfades with the skin list it replaces.
+.armor-tab-enter-active,
+.armor-tab-leave-active {
+	transition:
+		opacity 180ms ease,
+		transform 180ms ease;
+}
+
+.armor-tab-enter-from,
+.armor-tab-leave-to {
+	opacity: 0;
+	transform: translateY(0.5rem);
+}
 </style>

apps/app-frontend/src/pages/instance/components/settings-modal/instance-settings-context.ts

@@ -0,0 +1,2 @@
+export type { InstanceSettingsContext } from '@/providers/instance-settings'
+export { injectInstanceSettings, provideInstanceSettings } from '@/providers/instance-settings'

apps/app-frontend/src/providers/app-settings-modal.ts

@@ -0,0 +1,18 @@
+import type { InjectionKey } from 'vue'
+
+export type UnsavedChangesController = {
+	hasChanges: () => boolean
+	getOriginal: () => Record<string, unknown>
+	getModified: () => Record<string, unknown>
+	isSaving: () => boolean
+	reset: () => void
+	save: () => void | Promise<void>
+}
+
+export type AppSettingsModalContext = {
+	close: () => boolean
+	registerUnsavedChangesController: (controller: UnsavedChangesController | null) => void
+}
+
+export const appSettingsModalContextKey: InjectionKey<AppSettingsModalContext> =
+	Symbol('appSettingsModalContext')

apps/app-frontend/src/providers/instance-settings.ts

@@ -8,7 +8,7 @@ export interface InstanceSettingsContext {
 	offline?: boolean
 	isMinecraftServer: Ref<boolean>
 	onUnlinked: () => void
-	closeModal?: () => void
+	closeModal?: (onAfterClose?: () => void) => void
 }
 
 export const [injectInstanceSettings, provideInstanceSettings] =

apps/app-frontend/src/store/theme.ts

@@ -6,6 +6,18 @@ import {
 	resolveFontFamily,
 } from '@/helpers/font-family.ts'
 
+/**
+ * Mirrors `KeyBinding` from `@modrinth/ui`. Declared here so this module stays
+ * loadable without the UI package.
+ */
+export interface ShortcutBinding {
+	device: 'keyboard' | 'mouse'
+	code: string
+	mod: boolean
+	shift: boolean
+	alt: boolean
+}
+
 let systemThemeMq: MediaQueryList | null = null
 
 export const DEFAULT_FEATURE_FLAGS = {
@@ -25,6 +37,7 @@ export const DEFAULT_FEATURE_FLAGS = {
 	page_transitions: true,
 	advanced_filters_collapsed: true,
 	auto_install_dependencies: true,
+	force_anniversary_celebration: false,
 }
 
 export const THEME_OPTIONS = ['dark', 'light', 'oled', 'system'] as const
@@ -134,8 +147,30 @@ export type ThemeStore = {
 	minimalHomeInstanceId: string | null
 	closeBehavior: CloseBehavior
 
+	/** Whether the floating "back to top" button is shown on scrollable pages. */
+	showScrollTop: boolean
+	/** Whether quick scrolling shortcuts (Home/End/PageUp/PageDown) are active. */
+	quickScrollEnabled: boolean
+	/** Per-nav-item quick jump shortcuts (Ctrl/Cmd + number), off by default. */
+	shortcutNavHome: boolean
+	shortcutNavWorlds: boolean
+	shortcutNavDiscover: boolean
+	shortcutNavSkins: boolean
+	shortcutNavMultiplayer: boolean
+	shortcutNavLibrary: boolean
+	shortcutNavLab: boolean
+	shortcutNavDownloads: boolean
+	shortcutNavCreate: boolean
+	shortcutNavSettings: boolean
+
+	/**
+	 * The combination every shortcut answers to, keyed by action id. Kept here so
+	 * pages re-render when one is recorded; the value itself lives in local
+	 * storage, next to the enable flags.
+	 */
+	shortcutBindings: Record<string, ShortcutBinding>
+
 	devMode: boolean
-	featureFlags: FeatureFlags
 
 	uiFont: string | null
 	monoFont: string | null
@@ -161,6 +196,22 @@ export const DEFAULT_THEME_STORE: ThemeStore = {
 	minimalHomeInstanceId: null,
 	closeBehavior: 'ask',
 
+	showScrollTop: true,
+	quickScrollEnabled: false,
+
+	shortcutNavHome: false,
+	shortcutNavWorlds: false,
+	shortcutNavDiscover: false,
+	shortcutNavSkins: false,
+	shortcutNavMultiplayer: false,
+	shortcutNavLibrary: false,
+	shortcutNavLab: false,
+	shortcutNavDownloads: false,
+	shortcutNavCreate: false,
+	shortcutNavSettings: false,
+
+	shortcutBindings: {},
+
 	devMode: false,
 	featureFlags: DEFAULT_FEATURE_FLAGS,
 

apps/app/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "theseus_gui"
 # The actual version is set by the theseus-build workflow on tagging
-version = "1.0.0-beta15"
+version = "1.0.2-beta7"
 edition.workspace = true
 description = "Axolotl Launcher is a cross-platform Minecraft launcher"
 homepage = "https://www.ghs.red"

apps/app/build.rs

@@ -300,6 +300,17 @@ fn main() {
                         "logs_explain_crash_with_ai",
                         "logs_undo_added_mod",
                         "logs_export_crash_context",
+                        "logs_get_log_share_settings",
+                        "logs_update_log_share_settings",
+                        "logs_logshare_upload_crash",
+                        "logs_logshare_get_insights",
+                        "logs_logshare_analyse_crash_direct",
+                        "logs_logshare_ai_analyze_stored",
+                        "logs_logshare_ai_analyze_direct",
+                        "logs_logshare_delete",
+                        "logs_list_shared_logs",
+                        "logs_record_shared_log",
+                        "logs_delete_shared_log",
                     ])
                     .default_permission(
                         DefaultPermissionRule::AllowAllCommands,
@@ -534,10 +545,43 @@ fn main() {
                         "instance_delete_screenshot_group",
                         "instance_set_screenshot_group_memberships",
                         "instance_import_screenshot_groups",
+                        "instance_list_groups",
+                        "instance_create_group",
+                        "instance_rename_group",
+                        "instance_delete_group",
+                        "instance_set_group_order",
+                        "instance_set_group_memberships",
                         "instance_delete_screenshots",
                         "instance_export_screenshots",
                         "instance_move_screenshots",
                         "instance_open_screenshot",
+                        "instance_get_synced_options",
+                        "instance_get_initialized_synced_options",
+                        "instance_get_synced_options_overview",
+                        "instance_get_synced_option_capabilities",
+                        "instance_get_synced_option_join_preview",
+                        "instance_set_synced_option",
+                        "instance_set_instance_synced_option",
+                        "instance_get_synced_command_history",
+                        "instance_set_synced_command_history",
+                        "instance_list_synced_servers",
+                        "instance_update_synced_server",
+                        "instance_remove_synced_server",
+                        "instance_get_synced_game_options_config",
+                        "instance_preview_synced_game_option_changes",
+                        "instance_save_synced_game_option_changes",
+                        "instance_list_game_options_sync_sources",
+                        "instance_get_game_setting_locale_labels",
+                        "instance_get_local_game_options_config",
+                        "instance_preview_local_game_option_changes",
+                        "instance_save_local_game_option_changes",
+                        "instance_get_pack_sync_preview",
+                        "instance_sync_pack",
+                        "instance_desync_pack",
+                        "instance_list_synced_packs",
+                        "instance_upload_synced_pack",
+                        "instance_set_synced_pack_enabled",
+                        "instance_remove_synced_pack",
                     ])
                     .default_permission(
                         DefaultPermissionRule::AllowAllCommands,
@@ -667,6 +711,7 @@ fn main() {
                         "open_path",
                         "show_launcher_logs_folder",
                         "export_error_logs",
+                        "export_launcher_logs",
                         "show_app_db_backups_folder",
                         "progress_bars_list",
                         "get_opening_command",

apps/app/src/api/instance/mod.rs

@@ -131,10 +131,43 @@ pub fn init<R: tauri::Runtime>() -> tauri::plugin::TauriPlugin<R> {
             instance_delete_screenshot_group,
             instance_set_screenshot_group_memberships,
             instance_import_screenshot_groups,
+            instance_list_groups,
+            instance_create_group,
+            instance_rename_group,
+            instance_delete_group,
+            instance_set_group_order,
+            instance_set_group_memberships,
             instance_delete_screenshots,
             instance_export_screenshots,
             instance_move_screenshots,
             instance_open_screenshot,
+            instance_get_synced_options,
+            instance_get_initialized_synced_options,
+            instance_get_synced_options_overview,
+            instance_get_synced_option_capabilities,
+            instance_get_synced_option_join_preview,
+            instance_set_synced_option,
+            instance_set_instance_synced_option,
+            instance_get_synced_command_history,
+            instance_set_synced_command_history,
+            instance_list_synced_servers,
+            instance_update_synced_server,
+            instance_remove_synced_server,
+            instance_get_synced_game_options_config,
+            instance_preview_synced_game_option_changes,
+            instance_save_synced_game_option_changes,
+            instance_list_game_options_sync_sources,
+            instance_get_game_setting_locale_labels,
+            instance_get_local_game_options_config,
+            instance_preview_local_game_option_changes,
+            instance_save_local_game_option_changes,
+            instance_get_pack_sync_preview,
+            instance_sync_pack,
+            instance_desync_pack,
+            instance_list_synced_packs,
+            instance_upload_synced_pack,
+            instance_set_synced_pack_enabled,
+            instance_remove_synced_pack,
         ])
         .build()
 }
@@ -178,6 +211,7 @@ pub struct Instance {
     pub linked_version_id: Option<String>,
     pub linked_version_json_path: Option<String>,
     pub linked_game_dir_mode: Option<String>,
+    pub synced_options: theseus::instance::InstanceSyncedOptions,
 }
 
 #[derive(Deserialize, Debug, Clone)]
@@ -305,6 +339,12 @@ pub struct EditInstance {
     )]
     pub launch_preparation_timeout: Option<Option<u64>>,
     pub hooks: Option<Hooks>,
+    #[serde(
+        default,
+        skip_serializing_if = "Option::is_none",
+        with = "serde_with::rust::double_option"
+    )]
+    pub window_title: Option<Option<String>>,
 
     #[serde(
         default,
@@ -362,6 +402,7 @@ impl From<InstanceMetadata> for Instance {
                 .instance
                 .linked_version_json_path,
             linked_game_dir_mode: metadata.instance.linked_game_dir_mode,
+            synced_options: metadata.synced_options,
         }
     }
 }
@@ -502,7 +543,8 @@ fn edit_to_core(edit_instance: EditInstance) -> Result<CoreEditInstance> {
                 || edit_instance.maximize_window.is_some()
                 || edit_instance.game_resolution.is_some()
                 || edit_instance.launch_preparation_timeout.is_some()
-                || edit_instance.hooks.is_some();
+                || edit_instance.hooks.is_some()
+                || edit_instance.window_title.is_some();
             if has_launch_change {
                 Some(InstanceLaunchOverridesPatch {
                     player: None,
@@ -517,6 +559,7 @@ fn edit_to_core(edit_instance: EditInstance) -> Result<CoreEditInstance> {
                     launch_preparation_timeout: edit_instance
                         .launch_preparation_timeout,
                     hooks: edit_instance.hooks,
+                    window_title: edit_instance.window_title,
                 })
             } else {
                 None
@@ -1680,6 +1723,44 @@ pub async fn instance_import_screenshot_groups(
     Ok(theseus::instance::import_screenshot_groups(groups).await?)
 }
 
+#[tauri::command]
+pub async fn instance_list_groups()
+-> Result<Vec<theseus::instance::InstanceGroup>> {
+    Ok(theseus::instance::list_groups().await?)
+}
+
+#[tauri::command]
+pub async fn instance_create_group(
+    name: String,
+) -> Result<theseus::instance::InstanceGroup> {
+    Ok(theseus::instance::create_group(name).await?)
+}
+
+#[tauri::command]
+pub async fn instance_rename_group(
+    id: String,
+    new_name: String,
+) -> Result<theseus::instance::InstanceGroup> {
+    Ok(theseus::instance::rename_group(id, new_name).await?)
+}
+
+#[tauri::command]
+pub async fn instance_delete_group(id: String) -> Result<()> {
+    Ok(theseus::instance::delete_group(id).await?)
+}
+
+#[tauri::command]
+pub async fn instance_set_group_order(group_ids: Vec<String>) -> Result<()> {
+    Ok(theseus::instance::set_group_order(group_ids).await?)
+}
+
+#[tauri::command]
+pub async fn instance_set_group_memberships(
+    updates: Vec<theseus::instance::InstanceGroupMembershipUpdate>,
+) -> Result<()> {
+    Ok(theseus::instance::set_group_memberships(updates).await?)
+}
+
 #[tauri::command]
 pub async fn instance_delete_screenshots(
     keys: Vec<theseus::instance::ScreenshotKey>,
@@ -1833,3 +1914,242 @@ pub async fn instance_get_backup_delete_summary(
 ) -> Result<theseus::instance::BackupDeleteSummary> {
     Ok(theseus::instance::get_backup_delete_summary(instance_id).await?)
 }
+
+#[tauri::command]
+pub async fn instance_get_synced_options()
+-> Result<theseus::instance::GlobalSyncedOptions> {
+    Ok(theseus::instance::get_global_synced_options().await?)
+}
+
+#[tauri::command]
+pub async fn instance_get_initialized_synced_options()
+-> Result<theseus::instance::GlobalSyncedOptions> {
+    Ok(theseus::instance::get_initialized_synced_options().await?)
+}
+
+#[tauri::command]
+pub async fn instance_get_synced_game_options_config()
+-> Result<theseus::instance::GameSettingsEditorState> {
+    Ok(theseus::instance::get_synced_game_options_config().await?)
+}
+
+#[tauri::command]
+pub async fn instance_preview_synced_game_option_changes(
+    request: theseus::instance::UpdateGameSettingsRequest,
+) -> Result<theseus::instance::GameSettingsEditorState> {
+    Ok(theseus::instance::preview_synced_game_option_changes(request).await?)
+}
+
+#[tauri::command]
+pub async fn instance_save_synced_game_option_changes(
+    request: theseus::instance::UpdateGameSettingsRequest,
+) -> Result<theseus::instance::SaveGameSettingsResult> {
+    Ok(theseus::instance::save_synced_game_option_changes(request).await?)
+}
+
+#[tauri::command]
+pub async fn instance_list_game_options_sync_sources()
+-> Result<Vec<theseus::instance::GameOptionsSourceCandidate>> {
+    Ok(theseus::instance::list_game_options_sync_sources().await?)
+}
+
+#[tauri::command]
+pub async fn instance_get_game_setting_locale_labels(
+    instance_id: Option<String>,
+    locale: String,
+    option_ids: Vec<String>,
+    refresh_sources: bool,
+) -> Result<theseus::instance::GameSettingLocaleLabels> {
+    Ok(theseus::instance::get_game_setting_locale_labels(
+        instance_id.as_deref(),
+        &locale,
+        option_ids,
+        refresh_sources,
+    )
+    .await?)
+}
+
+#[tauri::command]
+pub async fn instance_get_local_game_options_config(
+    instance_id: String,
+) -> Result<theseus::instance::GameSettingsEditorState> {
+    Ok(theseus::instance::get_local_game_options_config(&instance_id).await?)
+}
+
+#[tauri::command]
+pub async fn instance_preview_local_game_option_changes(
+    instance_id: String,
+    request: theseus::instance::UpdateGameSettingsRequest,
+) -> Result<theseus::instance::GameSettingsEditorState> {
+    Ok(theseus::instance::preview_local_game_option_changes(
+        &instance_id,
+        request,
+    )
+    .await?)
+}
+
+#[tauri::command]
+pub async fn instance_save_local_game_option_changes(
+    instance_id: String,
+    request: theseus::instance::UpdateGameSettingsRequest,
+) -> Result<theseus::instance::SaveGameSettingsResult> {
+    Ok(
+        theseus::instance::save_local_game_option_changes(
+            &instance_id,
+            request,
+        )
+        .await?,
+    )
+}
+
+#[tauri::command]
+pub async fn instance_get_pack_sync_preview(
+    instance_id: String,
+    project_path: String,
+) -> Result<theseus::instance::PackSyncPreview> {
+    Ok(
+        theseus::instance::get_pack_sync_preview(&instance_id, &project_path)
+            .await?,
+    )
+}
+
+#[tauri::command]
+pub async fn instance_sync_pack(
+    instance_id: String,
+    project_path: String,
+) -> Result<()> {
+    Ok(theseus::instance::sync_pack(&instance_id, &project_path).await?)
+}
+
+#[tauri::command]
+pub async fn instance_desync_pack(
+    instance_id: String,
+    pack_id: String,
+    mode: theseus::instance::DesyncServerMode,
+) -> Result<()> {
+    Ok(theseus::instance::desync_pack(&instance_id, &pack_id, mode).await?)
+}
+
+#[tauri::command]
+pub async fn instance_list_synced_packs(
+    project_type: theseus::data::ProjectType,
+) -> Result<Vec<theseus::data::ContentItem>> {
+    Ok(theseus::instance::list_synced_packs(project_type).await?)
+}
+
+#[tauri::command]
+pub async fn instance_upload_synced_pack(
+    path: PathBuf,
+    project_type: theseus::data::ProjectType,
+    game_versions: Vec<String>,
+) -> Result<()> {
+    Ok(
+        theseus::instance::upload_synced_pack(
+            path,
+            project_type,
+            game_versions,
+        )
+        .await?,
+    )
+}
+
+#[tauri::command]
+pub async fn instance_set_synced_pack_enabled(
+    pack_id: String,
+    enabled: bool,
+) -> Result<()> {
+    Ok(theseus::instance::set_synced_pack_enabled(&pack_id, enabled).await?)
+}
+
+#[tauri::command]
+pub async fn instance_remove_synced_pack(pack_id: String) -> Result<()> {
+    Ok(theseus::instance::remove_synced_pack(&pack_id).await?)
+}
+
+#[tauri::command]
+pub async fn instance_get_synced_options_overview(
+    instance_id: String,
+) -> Result<theseus::instance::SyncedOptionsOverview> {
+    Ok(theseus::instance::get_synced_options_overview(&instance_id).await?)
+}
+
+#[tauri::command]
+pub async fn instance_get_synced_option_capabilities(
+    instance_id: String,
+) -> Result<Vec<theseus::instance::SyncedOptionCapability>> {
+    Ok(theseus::instance::get_synced_option_capabilities(&instance_id).await?)
+}
+
+#[tauri::command]
+pub async fn instance_get_synced_option_join_preview(
+    instance_id: String,
+    option: theseus::instance::SyncedOption,
+) -> Result<theseus::instance::SyncedOptionJoinPreview> {
+    Ok(
+        theseus::instance::get_synced_option_join_preview(&instance_id, option)
+            .await?,
+    )
+}
+
+#[tauri::command]
+pub async fn instance_set_synced_option(
+    option: theseus::instance::SyncedOption,
+    enabled: bool,
+    base_instance_id: Option<String>,
+) -> Result<theseus::instance::GlobalSyncedOptions> {
+    Ok(theseus::instance::set_global_synced_option(
+        option,
+        enabled,
+        base_instance_id.as_deref(),
+    )
+    .await?)
+}
+
+#[tauri::command]
+pub async fn instance_set_instance_synced_option(
+    instance_id: String,
+    option: theseus::instance::SyncedOption,
+    enabled: bool,
+    resolution: Option<theseus::instance::SyncedOptionJoinResolution>,
+) -> Result<Instance> {
+    let metadata = theseus::instance::set_instance_synced_option(
+        &instance_id,
+        option,
+        enabled,
+        resolution,
+    )
+    .await?;
+    instance_from_metadata(metadata).await
+}
+
+#[tauri::command]
+pub async fn instance_get_synced_command_history() -> Result<String> {
+    Ok(theseus::instance::get_synced_command_history().await?)
+}
+
+#[tauri::command]
+pub async fn instance_set_synced_command_history(
+    contents: String,
+) -> Result<String> {
+    Ok(theseus::instance::set_synced_command_history(&contents).await?)
+}
+
+#[tauri::command]
+pub async fn instance_list_synced_servers()
+-> Result<Vec<theseus::instance::SyncedServer>> {
+    Ok(theseus::instance::list_synced_servers().await?)
+}
+
+#[tauri::command]
+pub async fn instance_update_synced_server(
+    server: theseus::instance::SyncedServer,
+) -> Result<()> {
+    theseus::instance::update_synced_server(server).await?;
+    Ok(())
+}
+
+#[tauri::command]
+pub async fn instance_remove_synced_server(id: String) -> Result<()> {
+    theseus::instance::remove_synced_server(&id).await?;
+    Ok(())
+}

apps/app/src/api/logs.rs

@@ -4,7 +4,8 @@ use std::path::PathBuf;
 use theseus::logs::LogType;
 use theseus::logs::{
     self, CensoredString, CrashAnalysis, CrashAnalysisAiExplanation,
-    CrashAnalysisAiSettings, LatestLogCursor, LiveLogSnapshot, Logs,
+    CrashAnalysisAiSettings, LatestLogCursor, LiveLogSnapshot,
+    LogShareSettings, LogShareUploadResponse, Logs, SharedLog,
 };
 
 /*
@@ -34,6 +35,17 @@ pub fn init<R: tauri::Runtime>() -> tauri::plugin::TauriPlugin<R> {
             logs_explain_crash_with_ai,
             logs_undo_added_mod,
             logs_export_crash_context,
+            logs_get_log_share_settings,
+            logs_update_log_share_settings,
+            logs_logshare_upload_crash,
+            logs_logshare_get_insights,
+            logs_logshare_analyse_crash_direct,
+            logs_logshare_ai_analyze_stored,
+            logs_logshare_ai_analyze_direct,
+            logs_logshare_delete,
+            logs_list_shared_logs,
+            logs_record_shared_log,
+            logs_delete_shared_log,
         ])
         .build()
 }
@@ -172,3 +184,81 @@ pub async fn logs_export_crash_context(
     writer.close().await.map_err(crate::api::utils::zip_error)?;
     Ok(())
 }
+
+/// Get the log share settings.
+#[tauri::command]
+pub async fn logs_get_log_share_settings() -> Result<LogShareSettings> {
+    Ok(logs::get_log_share_settings().await?)
+}
+
+/// Update the log share settings.
+#[tauri::command]
+pub async fn logs_update_log_share_settings(
+    settings: LogShareSettings,
+) -> Result<()> {
+    Ok(logs::update_log_share_settings(settings).await?)
+}
+
+/// Upload the latest run's crash logs to LogShare.
+#[tauri::command]
+pub async fn logs_logshare_upload_crash(
+    instance_id: &str,
+) -> Result<LogShareUploadResponse> {
+    Ok(logs::upload_crash(instance_id).await?)
+}
+
+/// Fetch structured insights for a shared log.
+#[tauri::command]
+pub async fn logs_logshare_get_insights(id: &str) -> Result<serde_json::Value> {
+    Ok(logs::get_insights(id).await?)
+}
+
+/// Analyse the latest run's crash logs directly.
+#[tauri::command]
+pub async fn logs_logshare_analyse_crash_direct(
+    instance_id: &str,
+) -> Result<serde_json::Value> {
+    Ok(logs::analyse_crash_direct(instance_id).await?)
+}
+
+/// Stream an AI analysis for a stored shared log.
+#[tauri::command]
+pub async fn logs_logshare_ai_analyze_stored(
+    instance_id: &str,
+    id: &str,
+) -> Result<String> {
+    Ok(logs::ai_analyze_stored(instance_id, id).await?)
+}
+
+/// Stream an AI analysis for the latest run's crash logs.
+#[tauri::command]
+pub async fn logs_logshare_ai_analyze_direct(
+    instance_id: &str,
+) -> Result<String> {
+    Ok(logs::ai_analyze_direct(instance_id).await?)
+}
+
+/// Delete a shared log remotely and locally.
+#[tauri::command]
+pub async fn logs_logshare_delete(id: &str, token: &str) -> Result<()> {
+    logs::delete_log(id, token).await?;
+    Ok(())
+}
+
+/// List locally recorded shared logs.
+#[tauri::command]
+pub async fn logs_list_shared_logs() -> Result<Vec<SharedLog>> {
+    Ok(logs::list_shared_logs().await?)
+}
+
+/// Record a shared log locally.
+#[tauri::command]
+pub async fn logs_record_shared_log(log: SharedLog) -> Result<()> {
+    Ok(logs::record_shared_log(log).await?)
+}
+
+/// Remove a shared log record locally and remotely.
+#[tauri::command]
+pub async fn logs_delete_shared_log(id: String, token: String) -> Result<()> {
+    Ok(logs::delete_shared_log(id, token).await?)
+}

apps/app/src/api/utils.rs

@@ -25,6 +25,7 @@ pub fn init<R: Runtime>() -> tauri::plugin::TauriPlugin<R> {
             open_path,
             show_launcher_logs_folder,
             export_error_logs,
+            export_launcher_logs,
             show_app_db_backups_folder,
             progress_bars_list,
             get_opening_command,
@@ -164,6 +165,312 @@ pub async fn export_error_logs(
     Ok(())
 }
 
+/// Time window included in a launcher log export.
+#[derive(Debug, Clone, Copy, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub enum LogExportRange {
+    Last30Minutes,
+    Last2Hours,
+    All,
+}
+
+impl LogExportRange {
+    fn max_age(self) -> Option<std::time::Duration> {
+        match self {
+            Self::Last30Minutes => {
+                Some(std::time::Duration::from_secs(30 * 60))
+            }
+            Self::Last2Hours => {
+                Some(std::time::Duration::from_secs(2 * 60 * 60))
+            }
+            Self::All => None,
+        }
+    }
+
+    fn label(self) -> &'static str {
+        match self {
+            Self::Last30Minutes => "last 30 minutes",
+            Self::Last2Hours => "last 2 hours",
+            Self::All => "all sessions",
+        }
+    }
+}
+
+/// Lowest level included in a launcher log export.
+#[derive(Debug, Clone, Copy, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub enum LogExportLevel {
+    All,
+    Debug,
+    Info,
+}
+
+impl LogExportLevel {
+    fn minimum(self) -> Option<&'static str> {
+        match self {
+            Self::All => None,
+            Self::Debug => Some("debug"),
+            Self::Info => Some("info"),
+        }
+    }
+
+    fn label(self) -> &'static str {
+        match self {
+            Self::All => "all levels",
+            Self::Debug => "debug and above",
+            Self::Info => "info and above",
+        }
+    }
+}
+
+/// Instance log tail included in an export, in bytes.
+const LOG_EXPORT_INSTANCE_LOG_TAIL_BYTES: u64 = 512 * 1024;
+
+/// Export launcher logs (filtered by time range and level) plus optional
+/// system information, the most recent instance log, and a crash analysis
+/// summary into a ZIP archive.
+#[tauri::command]
+pub async fn export_launcher_logs(
+    output_path: PathBuf,
+    range: LogExportRange,
+    level: LogExportLevel,
+    include_system_info: bool,
+    include_instance_logs: bool,
+    include_crash_analysis: bool,
+) -> Result<()> {
+    // Censoring needs the app state (credentials, IPs). Without it an export
+    // would silently ship secrets, so fail rather than degrade.
+    let state = theseus::State::get().await?;
+    let archive = tokio::fs::File::create(&output_path).await?;
+    let mut writer = ZipFileWriter::with_tokio(archive);
+
+    let (exported_logs, skipped_logs) =
+        write_exported_logs(&mut writer, range, level, &state).await?;
+
+    let mut manifest = format!(
+        "Starlight Launcher log export\n\
+         Exported at: {}\n\
+         App version: {}\n\
+         Time range: {}\n\
+         Level filter: {}\n\
+         System information: {}\n\
+         Recent instance log: {}\n\
+         Crash analysis: {}\n\
+         Log files: {exported_logs}\n\n\
+         Access tokens, Minecraft tokens, and IP addresses are replaced with placeholders.\n",
+        chrono::Local::now().to_rfc3339(),
+        env!("CARGO_PKG_VERSION"),
+        range.label(),
+        level.label(),
+        if include_system_info {
+            "included"
+        } else {
+            "omitted"
+        },
+        if include_instance_logs {
+            "included"
+        } else {
+            "omitted"
+        },
+        if include_crash_analysis {
+            "included"
+        } else {
+            "omitted"
+        },
+    );
+    if !skipped_logs.is_empty() {
+        manifest.push_str("\nSkipped unreadable log files:\n");
+        for name in &skipped_logs {
+            manifest.push_str(&format!("- {name}\n"));
+        }
+    }
+    write_zip_entry(&mut writer, "manifest.txt", manifest.as_bytes()).await?;
+
+    if include_system_info {
+        let environment = build_environment_report();
+        let environment = censor_export_text(environment, &state).await?;
+        write_zip_entry(
+            &mut writer,
+            "system-information.txt",
+            environment.as_bytes(),
+        )
+        .await?;
+    }
+
+    let recent_instance = if include_instance_logs || include_crash_analysis {
+        newest_instance_log(&state).await
+    } else {
+        None
+    };
+
+    if include_instance_logs
+        && let Some((instance_id, path)) = recent_instance.as_ref()
+    {
+        let tail = read_file_tail(path, LOG_EXPORT_INSTANCE_LOG_TAIL_BYTES)?;
+        let tail = censor_export_text(tail, &state).await?;
+        write_zip_entry(
+            &mut writer,
+            &format!("minecraft/{instance_id}/latest.log"),
+            tail.as_bytes(),
+        )
+        .await?;
+    }
+
+    if include_crash_analysis
+        && let Some((instance_id, _)) = recent_instance.as_ref()
+        && let Ok(analysis) = theseus::logs::analyze_crash(instance_id).await
+        && (analysis.crashed || !analysis.findings.is_empty())
+        && let Ok(report) = serde_json::to_vec_pretty(&analysis)
+    {
+        // The analysis carries raw log text and Windows event messages, so it
+        // goes through the same censoring as the exported logs.
+        let report = censor_export_text(
+            String::from_utf8_lossy(&report).into_owned(),
+            &state,
+        )
+        .await?;
+        write_zip_entry(
+            &mut writer,
+            &format!("minecraft/{instance_id}/crash-analysis.json"),
+            report.as_bytes(),
+        )
+        .await?;
+    }
+
+    writer.close().await.map_err(zip_error)?;
+    Ok(())
+}
+
+/// Writes the matching launcher logs and reports how many were written plus
+/// the names of any files that could not be read.
+async fn write_exported_logs(
+    writer: &mut ZipFileWriter<tokio::fs::File>,
+    range: LogExportRange,
+    level: LogExportLevel,
+    state: &theseus::State,
+) -> Result<(usize, Vec<String>)> {
+    let Some(directories) = DirectoryInfo::global_handle_if_ready() else {
+        return Ok((0, Vec::new()));
+    };
+    let Some(logs_dir) = directories.launcher_logs_dir() else {
+        return Ok((0, Vec::new()));
+    };
+    if !tokio::fs::try_exists(&logs_dir).await? {
+        return Ok((0, Vec::new()));
+    }
+
+    let mut entries = tokio::fs::read_dir(&logs_dir).await?;
+    let mut paths = Vec::new();
+    while let Some(entry) = entries.next_entry().await? {
+        let path = entry.path();
+        let is_session_log =
+            path.file_name().and_then(|name| name.to_str()).is_some_and(
+                |name| name.starts_with("session_") && name.ends_with(".log"),
+            );
+        if is_session_log && entry.file_type().await?.is_file() {
+            paths.push(path);
+        }
+    }
+    paths.sort();
+
+    let mut exported = 0;
+    let mut skipped = Vec::new();
+    for path in paths {
+        let file_name = path
+            .file_name()
+            .map(|name| name.to_string_lossy().into_owned())
+            .unwrap_or_else(|| "session.log".to_string());
+
+        // A single unreadable file must not lose the whole report.
+        let Ok(contents) = tokio::fs::read(&path).await else {
+            skipped.push(file_name);
+            continue;
+        };
+        let filtered = theseus::filter_log_contents(
+            &contents,
+            range.max_age(),
+            level.minimum(),
+        );
+        let text = String::from_utf8_lossy(&filtered).into_owned();
+        let censored = censor_export_text(text, state).await?;
+        write_zip_entry(
+            writer,
+            &format!("launcher_logs/{file_name}"),
+            censored.as_bytes(),
+        )
+        .await?;
+        exported += 1;
+    }
+
+    Ok((exported, skipped))
+}
+
+/// Replaces credentials and IP addresses with placeholders. Censoring failures
+/// propagate so an export never ships unredacted content.
+async fn censor_export_text(
+    text: String,
+    state: &theseus::State,
+) -> Result<String> {
+    Ok(theseus::install::censor_shared_text(text, state).await?)
+}
+
+fn build_environment_report() -> String {
+    format!(
+        "Starlight Launcher environment\n\
+         App version: {}\n\
+         Operating system: {}\n\
+         Architecture: {}\n",
+        env!("CARGO_PKG_VERSION"),
+        std::env::consts::OS,
+        std::env::consts::ARCH,
+    )
+}
+
+/// The instance whose log was written most recently, if any.
+async fn newest_instance_log(
+    state: &theseus::State,
+) -> Option<(String, PathBuf)> {
+    let instances_dir = state.directories.instances_dir();
+    let mut entries = tokio::fs::read_dir(&instances_dir).await.ok()?;
+    let mut newest: Option<(std::time::SystemTime, String, PathBuf)> = None;
+
+    while let Some(entry) = entries.next_entry().await.ok()? {
+        if !entry.file_type().await.ok()?.is_dir() {
+            continue;
+        }
+        let log_path = entry.path().join("logs").join("latest.log");
+        let Ok(metadata) = tokio::fs::metadata(&log_path).await else {
+            continue;
+        };
+        let Ok(modified) = metadata.modified() else {
+            continue;
+        };
+        let is_newer = newest
+            .as_ref()
+            .is_none_or(|(newest_modified, ..)| modified > *newest_modified);
+        if is_newer {
+            let id = entry.file_name().to_string_lossy().into_owned();
+            newest = Some((modified, id, log_path));
+        }
+    }
+
+    newest.map(|(_, id, path)| (id, path))
+}
+
+fn read_file_tail(path: &Path, max_bytes: u64) -> Result<String> {
+    use std::io::{Read, Seek, SeekFrom};
+
+    let mut file = std::fs::File::open(path)?;
+    let length = file.metadata()?.len();
+    if length > max_bytes {
+        file.seek(SeekFrom::Start(length - max_bytes))?;
+    }
+
+    let mut contents = Vec::new();
+    file.read_to_end(&mut contents)?;
+    Ok(String::from_utf8_lossy(&contents).into_owned())
+}
+
 async fn write_zip_file(
     writer: &mut ZipFileWriter<tokio::fs::File>,
     filename: &str,

apps/app/src/lightweight_mode.rs

@@ -253,6 +253,14 @@ impl LightweightMode {
                     if payload.maximize_window {
                         maximize_minecraft_window(payload.pid).await;
                     }
+                    if let Some(title) = payload
+                        .window_title
+                        .as_ref()
+                        .map(|value| value.trim())
+                        .filter(|value| !value.is_empty())
+                    {
+                        rename_minecraft_window(payload.pid, title).await;
+                    }
                     let settings = match theseus::settings::get().await {
                         Ok(settings) => settings,
                         Err(error) => {
@@ -332,6 +340,8 @@ struct ProcessEventPayload {
     pid: u32,
     #[serde(default)]
     maximize_window: bool,
+    #[serde(default)]
+    window_title: Option<String>,
     event: String,
     crashed: Option<bool>,
     #[serde(default)]
@@ -339,7 +349,7 @@ struct ProcessEventPayload {
 }
 
 #[cfg(target_os = "windows")]
-use std::sync::atomic::{AtomicBool, AtomicU32, Ordering};
+use std::sync::atomic::{AtomicBool, AtomicIsize, AtomicU32, Ordering};
 
 #[cfg(target_os = "windows")]
 static MAXIMIZE_PROCESS_ID: AtomicU32 = AtomicU32::new(0);
@@ -400,6 +410,74 @@ async fn maximize_minecraft_window(pid: u32) {
 
 #[cfg(not(target_os = "windows"))]
 async fn maximize_minecraft_window(_pid: u32) {}
+#[cfg(target_os = "windows")]
+static RENAME_WINDOW_HANDLE: AtomicIsize = AtomicIsize::new(0);
+
+#[cfg(target_os = "windows")]
+unsafe extern "system" fn rename_if_owned_by_process(
+    hwnd: windows::Win32::Foundation::HWND,
+    _: windows::Win32::Foundation::LPARAM,
+) -> windows::core::BOOL {
+    use windows::Win32::UI::WindowsAndMessaging::{
+        GetWindowThreadProcessId, IsWindowVisible,
+    };
+    use windows::core::BOOL;
+
+    let mut window_pid = 0;
+    unsafe { GetWindowThreadProcessId(hwnd, Some(&mut window_pid)) };
+    if window_pid == MAXIMIZE_PROCESS_ID.load(Ordering::Relaxed)
+        && unsafe { IsWindowVisible(hwnd).as_bool() }
+    {
+        RENAME_WINDOW_HANDLE.store(hwnd.0 as isize, Ordering::Relaxed);
+        return BOOL(0);
+    }
+    BOOL(1)
+}
+
+#[cfg(target_os = "windows")]
+async fn rename_minecraft_window(pid: u32, title: &str) {
+    if pid == 0 || title.is_empty() {
+        return;
+    }
+
+    // PCL keeps re-applying the title: FML/Quilt and some mods reset it
+    // while the game boots, so a one-shot rename is not enough.
+    let deadline =
+        tokio::time::Instant::now() + std::time::Duration::from_secs(45);
+    let mut applied = false;
+    loop {
+        let found = {
+            let _guard = MAXIMIZE_WINDOW_ENUMERATION.lock();
+            MAXIMIZE_PROCESS_ID.store(pid, Ordering::Relaxed);
+            RENAME_WINDOW_HANDLE.store(0, Ordering::Relaxed);
+            unsafe {
+                use windows::Win32::Foundation::LPARAM;
+                use windows::Win32::UI::WindowsAndMessaging::EnumWindows;
+                let _ =
+                    EnumWindows(Some(rename_if_owned_by_process), LPARAM(0));
+            }
+            RENAME_WINDOW_HANDLE.load(Ordering::Relaxed)
+        };
+        if found != 0 {
+            let hwnd = windows::Win32::Foundation::HWND(found as *mut _);
+            let wide: Vec<u16> = title.encode_utf16().chain(Some(0)).collect();
+            unsafe {
+                use windows::Win32::UI::WindowsAndMessaging::SetWindowTextW;
+                let _ =
+                    SetWindowTextW(hwnd, windows::core::PCWSTR(wide.as_ptr()));
+            }
+            applied = true;
+        }
+        if tokio::time::Instant::now() >= deadline {
+            return;
+        }
+        let _ = applied;
+        tokio::time::sleep(std::time::Duration::from_millis(400)).await;
+    }
+}
+
+#[cfg(not(target_os = "windows"))]
+async fn rename_minecraft_window(_pid: u32, _title: &str) {}
 
 #[tauri::command]
 pub fn lightweight_mode_frontend_ready(

apps/app/src/main.rs

@@ -324,12 +324,9 @@ async fn initialize_state(app: tauri::AppHandle) -> api::Result<()> {
 /// external game-directory root for the one-click StarLight install flow.
 #[tauri::command]
 fn get_launcher_root_dir() -> api::Result<String> {
-    let exe = std::env::current_exe().map_err(|error| {
-        theseus::Error::from(theseus::ErrorKind::FSError(error.to_string()))
-    })?;
-    let dir = exe.parent().ok_or_else(|| {
+    let dir = theseus::default_game_dir_root().ok_or_else(|| {
         theseus::Error::from(theseus::ErrorKind::FSError(
-            "Launcher executable has no parent directory".to_string(),
+            "Could not determine a default game directory root".to_string(),
         ))
     })?;
     Ok(dir.to_string_lossy().into_owned())
@@ -339,7 +336,7 @@ fn get_launcher_root_dir() -> api::Result<String> {
 fn get_update_channel(app: tauri::AppHandle) -> api::Result<String> {
     let channel = read_update_channel_state(&app)?
         .active_channel
-        .unwrap_or_else(|| "release".to_string());
+        .unwrap_or_else(|| theseus::default_update_channel().to_string());
 
     match channel.as_str() {
         "release" | "beta" => Ok(channel),

apps/website/releases/catalog.json

@@ -1,6 +1,163 @@
 {
-  "updated_at": "2026-10-01T05:02:05.765Z",
+  "updated_at": "2026-10-03T07:08:29.010Z",
   "announcements": [
+    {
+      "id": "launcher-1.0.1",
+      "version": "1.0.1",
+      "publishedAt": "2026-10-03",
+      "title": {
+        "en-US": "Starlight Launcher 1.0.1",
+        "zh-CN": "Starlight Launcher 1.0.1"
+      },
+      "changes": {
+        "added": [
+          {
+            "en-US": "Instance backups: create deduplicated snapshots of an instance while it is closed, preview and restore them, exclude specific files or folders, and move the backup repository.",
+            "zh-CN": "实例备份：在实例关闭时创建去重快照，可预览与恢复，支持排除指定文件或文件夹，并可迁移备份仓库。"
+          },
+          {
+            "en-US": "Customize the launcher's UI font and monospace font in appearance settings.",
+            "zh-CN": "在外观设置中自定义启动器界面字体与等宽字体。"
+          }
+        ],
+        "fixed": [
+          {
+            "en-US": "Fixed beta builds not auto-updating from beta9 to beta10 (prerelease versions were compared as text instead of by number).",
+            "zh-CN": "修复 beta 版本无法从 beta9 自动更新到 beta10 的问题（预发布版本此前按文本而非数字比较）。"
+          },
+          {
+            "en-US": "Fixed a cross-crate visibility issue that prevented the launcher from compiling with the ignore-SSL-errors option.",
+            "zh-CN": "修复因跨 crate 可见性导致的编译失败，此前启用“忽略 SSL 证书错误”选项时无法编译。"
+          }
+        ]
+      }
+    },
+    {
+      "id": "launcher-1.0.1-beta10",
+      "version": "1.0.1-beta10",
+      "publishedAt": "2026-10-02",
+      "title": {
+        "en-US": "Starlight Launcher 1.0.1-beta10",
+        "zh-CN": "Starlight Launcher 1.0.1-beta10"
+      },
+      "changes": {
+        "added": [
+          {
+            "en-US": "Reworked the instance-page tour into four steps covering content, files, worlds, and logs.",
+            "zh-CN": "重做实例页导览，分为内容、文件、世界、日志四步。"
+          },
+          {
+            "en-US": "When the install location is a drive root, the installer now creates a Starlight subfolder automatically.",
+            "zh-CN": "安装位置选到盘符根目录时，安装器会自动创建 Starlight 子文件夹。"
+          }
+        ],
+        "fixed": [
+          {
+            "en-US": "Fixed the launcher UI scale reverting after a restart.",
+            "zh-CN": "修复启动器界面缩放重启后恢复原状的问题。"
+          },
+          {
+            "en-US": "Fixed developer feature flags not saving.",
+            "zh-CN": "修复开发者功能开关无法保存的问题。"
+          },
+          {
+            "en-US": "Fixed instance group edits not saving for instances without an applied content set.",
+            "zh-CN": "修复没有应用内容集的实例无法保存分组修改的问题。"
+          },
+          {
+            "en-US": "Fixed the launcher crashing on startup when feature flags were out of sync between the frontend and backend.",
+            "zh-CN": "修复前后端功能开关不同步导致启动器启动崩溃的问题。"
+          },
+          {
+            "en-US": "Fixed being unable to copy text inside the embedded skin site.",
+            "zh-CN": "修复内嵌皮肤站中无法复制文本的问题。"
+          },
+          {
+            "en-US": "Fixed the onboarding prompt not dismissing when clicking anywhere.",
+            "zh-CN": "修复导览提示点击任意位置无法关闭的问题。"
+          }
+        ]
+      }
+    },
+    {
+      "id": "launcher-1.0.1-beta9",
+      "version": "1.0.1-beta9",
+      "publishedAt": "2026-10-02",
+      "title": {
+        "en-US": "Starlight Launcher 1.0.1-beta9",
+        "zh-CN": "Starlight Launcher 1.0.1-beta9"
+      },
+      "changes": {
+        "fixed": [
+          {
+            "en-US": "Fixed a crash on the minimal home layout caused by an unrecognized multiplayer feature flag (missing backend enum variant).",
+            "zh-CN": "修复多人联机功能开关缺少后端枚举变体、导致精简主页报错的问题。"
+          }
+        ]
+      }
+    },
+    {
+      "id": "launcher-1.0.1-beta8",
+      "version": "1.0.1-beta8",
+      "publishedAt": "2026-10-02",
+      "title": {
+        "en-US": "Starlight Launcher 1.0.1-beta8",
+        "zh-CN": "Starlight Launcher 1.0.1-beta8"
+      },
+      "changes": {
+        "fixed": [
+          {
+            "en-US": "Fixed the sidebar navigation entries breaking after the screenshot center was added.",
+            "zh-CN": "修复添加截图中心后侧边栏导航项损坏的问题。"
+          },
+          {
+            "en-US": "Fixed being unable to install the StarLight hosted pack even after signing in (missing command permission).",
+            "zh-CN": "修复登录后仍无法安装 StarLight 实例的问题（命令权限缺失）。"
+          },
+          {
+            "en-US": "Fixed the launcher UI scaling not applying when changed (missing command permission).",
+            "zh-CN": "修复修改启动器界面缩放后不生效的问题（命令权限缺失）。"
+          },
+          {
+            "en-US": "Fixed several screenshot center actions failing due to missing command permissions.",
+            "zh-CN": "修复截图中心部分操作因命令权限缺失而失败的问题。"
+          }
+        ]
+      }
+    },
+    {
+      "id": "launcher-1.0.1-beta7",
+      "version": "1.0.1-beta7",
+      "publishedAt": "2026-10-02",
+      "title": {
+        "en-US": "Starlight Launcher 1.0.1-beta7",
+        "zh-CN": "Starlight Launcher 1.0.1-beta7"
+      },
+      "changes": {
+        "added": [
+          {
+            "en-US": "Added a screenshot center: browse screenshots across every instance, group them (custom groups, by instance, or by date), preview, edit (crop, rotate, annotate, censor), and export as ZIP.",
+            "zh-CN": "新增截图中心：跨实例浏览截图，支持自定义/按实例/按日期分组，可预览、编辑（裁剪、标注、打码等）并导出为 ZIP。"
+          },
+          {
+            "en-US": "Added the multiplayer (Terracotta) entry to the sidebar, behind a feature flag.",
+            "zh-CN": "侧边栏新增多人联机（陶瓦）入口，由功能开关控制。"
+          }
+        ],
+        "changed": [
+          {
+            "en-US": "Launcher UI scaling is now persisted in the backend and applied via native webview zoom, so it scales embedded pages correctly and keeps onboarding anchors aligned.",
+            "zh-CN": "启动器界面缩放改为后端持久化，并通过原生 webview 缩放应用，可正确缩放内嵌页面且导览锚点不再偏移。"
+          }
+        ],
+        "fixed": [
+          {
+            "en-US": "Fixed the onboarding tour skipping its first step when the target anchor was missing.",
+            "zh-CN": "修复导览首步在目标锚点缺失时被自动跳过的问题。"
+          }
+        ]
+      }
+    },
     {
       "id": "launcher-1.0.1-beta6",
       "version": "1.0.1-beta6",

apps/website/releases/latest.json

@@ -1,32 +1,32 @@
 {
-  "tag_name": "v1.0.0",
+  "tag_name": "v1.0.1",
   "assets": [
-    "Axolotl_Launcher_1.0.0_x64_modern-setup.exe",
-    "Axolotl_Launcher_1.0.0_x64_modern-setup.exe.sig",
-    "Axolotl_Launcher_1.0.0_x64_nsis-setup.exe",
-    "Axolotl_Launcher_1.0.0_x64_nsis-setup.exe.sig",
-    "Axolotl_Launcher_1.0.0_x64_portable.zip",
-    "Starlight.Launcher-1.0.0-1.aarch64.rpm",
-    "Starlight.Launcher-1.0.0-1.aarch64.rpm.sig",
-    "Starlight.Launcher-1.0.0-1.x86_64.rpm",
-    "Starlight.Launcher-1.0.0-1.x86_64.rpm.sig",
-    "Starlight.Launcher_1.0.0_aarch64.AppImage",
-    "Starlight.Launcher_1.0.0_aarch64.AppImage.sig",
-    "Starlight.Launcher_1.0.0_aarch64.AppImage.tar.gz",
-    "Starlight.Launcher_1.0.0_aarch64.AppImage.tar.gz.sig",
-    "Starlight.Launcher_1.0.0_amd64.AppImage",
-    "Starlight.Launcher_1.0.0_amd64.AppImage.sig",
-    "Starlight.Launcher_1.0.0_amd64.AppImage.tar.gz",
-    "Starlight.Launcher_1.0.0_amd64.AppImage.tar.gz.sig",
-    "Starlight.Launcher_1.0.0_amd64.deb",
-    "Starlight.Launcher_1.0.0_amd64.deb.sig",
-    "Starlight.Launcher_1.0.0_arm64.deb",
-    "Starlight.Launcher_1.0.0_arm64.deb.sig",
-    "Starlight.Launcher_1.0.0_universal.dmg",
-    "Starlight.Launcher_1.0.0_x64-setup.exe",
-    "Starlight.Launcher_1.0.0_x64-setup.exe.sig",
-    "Starlight.Launcher_1.0.0_x64-setup.nsis.zip",
-    "Starlight.Launcher_1.0.0_x64-setup.nsis.zip.sig",
+    "Axolotl_Launcher_1.0.1_x64_modern-setup.exe",
+    "Axolotl_Launcher_1.0.1_x64_modern-setup.exe.sig",
+    "Axolotl_Launcher_1.0.1_x64_nsis-setup.exe",
+    "Axolotl_Launcher_1.0.1_x64_nsis-setup.exe.sig",
+    "Axolotl_Launcher_1.0.1_x64_portable.zip",
+    "Starlight.Launcher-1.0.1-1.aarch64.rpm",
+    "Starlight.Launcher-1.0.1-1.aarch64.rpm.sig",
+    "Starlight.Launcher-1.0.1-1.x86_64.rpm",
+    "Starlight.Launcher-1.0.1-1.x86_64.rpm.sig",
+    "Starlight.Launcher_1.0.1_aarch64.AppImage",
+    "Starlight.Launcher_1.0.1_aarch64.AppImage.sig",
+    "Starlight.Launcher_1.0.1_aarch64.AppImage.tar.gz",
+    "Starlight.Launcher_1.0.1_aarch64.AppImage.tar.gz.sig",
+    "Starlight.Launcher_1.0.1_amd64.AppImage",
+    "Starlight.Launcher_1.0.1_amd64.AppImage.sig",
+    "Starlight.Launcher_1.0.1_amd64.AppImage.tar.gz",
+    "Starlight.Launcher_1.0.1_amd64.AppImage.tar.gz.sig",
+    "Starlight.Launcher_1.0.1_amd64.deb",
+    "Starlight.Launcher_1.0.1_amd64.deb.sig",
+    "Starlight.Launcher_1.0.1_arm64.deb",
+    "Starlight.Launcher_1.0.1_arm64.deb.sig",
+    "Starlight.Launcher_1.0.1_universal.dmg",
+    "Starlight.Launcher_1.0.1_x64-setup.exe",
+    "Starlight.Launcher_1.0.1_x64-setup.exe.sig",
+    "Starlight.Launcher_1.0.1_x64-setup.nsis.zip",
+    "Starlight.Launcher_1.0.1_x64-setup.nsis.zip.sig",
     "Starlight.Launcher_universal.app.tar.gz",
     "Starlight.Launcher_universal.app.tar.gz.sig"
   ]

packages/app-lib/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "theseus"
 # The actual version is set by the theseus-build workflow on tagging
-version = "1.0.0-beta15"
+version = "1.0.2-beta7"
 edition.workspace = true
 
 [dependencies]

packages/app-lib/migrations/20261003000000_instance-sync-feature-tables.sql

@@ -0,0 +1,217 @@
+-- Instance settings synchronization: shared feature tables.
+--
+-- Split out of Axolotl's combined "instance-sync-and-screenshot-center"
+-- migration so that the screenshot-center tables (already present in this
+-- fork under its own migration) are not created twice.
+
+CREATE TABLE sync_feature_settings (
+	feature TEXT PRIMARY KEY NOT NULL,
+	globally_enabled INTEGER NOT NULL CHECK (globally_enabled IN (0, 1)),
+	new_instance_default INTEGER NOT NULL CHECK (new_instance_default IN (0, 1))
+);
+
+INSERT INTO sync_feature_settings (feature, globally_enabled, new_instance_default)
+VALUES
+	('command_history', 0, 0),
+	('multiplayer_servers', 0, 0),
+	('creative_hotbars', 0, 0),
+	('screenshots', 0, 0),
+	('game_options', 0, 0),
+	('resource_packs', 0, 0),
+	('data_packs', 0, 0);
+
+CREATE TABLE instance_sync_preferences (
+	instance_id TEXT NOT NULL,
+	feature TEXT NOT NULL,
+	enabled INTEGER NOT NULL CHECK (enabled IN (0, 1)),
+	PRIMARY KEY (instance_id, feature),
+	FOREIGN KEY (instance_id) REFERENCES instances (id) ON DELETE CASCADE,
+	FOREIGN KEY (feature) REFERENCES sync_feature_settings (feature) ON DELETE CASCADE
+);
+
+CREATE INDEX instance_sync_preferences_feature_enabled
+	ON instance_sync_preferences (feature, enabled);
+
+INSERT INTO instance_sync_preferences (instance_id, feature, enabled)
+SELECT instances.id, features.feature, features.enabled
+FROM instances
+CROSS JOIN (
+	SELECT 'command_history' AS feature, 0 AS enabled
+	UNION ALL SELECT 'multiplayer_servers', 0
+	UNION ALL SELECT 'creative_hotbars', 0
+	UNION ALL SELECT 'screenshots', 0
+) AS features;
+
+INSERT INTO instance_sync_preferences (instance_id, feature, enabled)
+SELECT id, 'game_options', 0 FROM instances;
+
+INSERT INTO instance_sync_preferences (instance_id, feature, enabled)
+SELECT instances.id, features.feature, 0
+FROM instances
+CROSS JOIN (
+	SELECT 'resource_packs' AS feature
+	UNION ALL SELECT 'data_packs'
+) AS features;
+
+CREATE TABLE synced_game_option_state (
+	singleton INTEGER PRIMARY KEY NOT NULL CHECK (singleton = 1),
+	revision INTEGER NOT NULL CHECK (revision >= 0),
+	catalog_revision INTEGER NOT NULL CHECK (catalog_revision >= 1)
+);
+
+CREATE TABLE synced_game_option_values (
+	option_id TEXT PRIMARY KEY NOT NULL,
+	kind TEXT NOT NULL CHECK (kind IN ('vanilla', 'external')),
+	raw_key TEXT,
+	canonical_type TEXT NOT NULL,
+	canonical_value_json TEXT,
+	value_codec TEXT NOT NULL,
+	seeded INTEGER NOT NULL CHECK (seeded IN (0, 1)),
+	revision INTEGER NOT NULL CHECK (revision >= 0),
+	origin TEXT NOT NULL CHECK (origin IN ('app_editor', 'instance', 'source_seed')),
+	source_game_version TEXT,
+	source_instance_id TEXT,
+	updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE synced_game_option_preferences (
+	option_id TEXT PRIMARY KEY NOT NULL,
+	enabled INTEGER NOT NULL CHECK (enabled IN (0, 1)),
+	source TEXT NOT NULL CHECK (source IN ('catalog_default', 'discovery_default', 'user')),
+	revision INTEGER NOT NULL CHECK (revision >= 0)
+);
+
+CREATE TABLE instance_game_option_pack_bases (
+	instance_id TEXT PRIMARY KEY NOT NULL,
+	pack_version_id TEXT,
+	source TEXT NOT NULL CHECK (source IN ('client_overrides', 'overrides', 'none')),
+	sha1 TEXT,
+	encoding TEXT,
+	document BLOB,
+	FOREIGN KEY (instance_id) REFERENCES instances (id) ON DELETE CASCADE
+);
+
+CREATE TABLE instance_game_option_update_state (
+	instance_id TEXT PRIMARY KEY NOT NULL,
+	had_file INTEGER NOT NULL CHECK (had_file IN (0, 1)),
+	sha1 TEXT,
+	document BLOB,
+	FOREIGN KEY (instance_id) REFERENCES instances (id) ON DELETE CASCADE
+);
+
+CREATE TABLE game_option_locale_origins (
+	scope TEXT NOT NULL,
+	option_id TEXT NOT NULL,
+	source_instance_id TEXT,
+	source_game_version TEXT,
+	backfilled INTEGER NOT NULL DEFAULT 0,
+	observation_json TEXT,
+	origin_json TEXT,
+	PRIMARY KEY (scope, option_id)
+);
+
+INSERT INTO game_option_locale_origins
+	(scope, option_id, source_instance_id, source_game_version, backfilled)
+SELECT '', option_id, source_instance_id, source_game_version, 1
+FROM synced_game_option_values;
+
+CREATE TRIGGER record_game_option_locale_origin
+AFTER INSERT ON synced_game_option_values
+BEGIN
+	INSERT INTO game_option_locale_origins
+		(scope, option_id, source_instance_id, source_game_version)
+	VALUES ('', NEW.option_id, NEW.source_instance_id, NEW.source_game_version)
+	ON CONFLICT(scope, option_id) DO NOTHING;
+END;
+
+CREATE TABLE instance_sync_checkpoints (
+	instance_id TEXT NOT NULL,
+	feature TEXT NOT NULL,
+	variant TEXT NOT NULL CHECK (variant IN ('default', 'legacy', 'components')),
+	expected_sha1 TEXT NOT NULL,
+	merge_base BLOB,
+	source_revision INTEGER NOT NULL CHECK (source_revision >= 0),
+	status TEXT NOT NULL CHECK (status IN ('pending', 'ready')),
+	link_mode TEXT CHECK (link_mode IS NULL OR link_mode IN ('copy', 'hard', 'symbolic')),
+	PRIMARY KEY (instance_id, feature, variant),
+	FOREIGN KEY (instance_id, feature)
+		REFERENCES instance_sync_preferences (instance_id, feature) ON DELETE CASCADE
+);
+
+CREATE TABLE synced_hotbar_state (
+	singleton INTEGER PRIMARY KEY NOT NULL CHECK (singleton = 1),
+	schema_version INTEGER NOT NULL CHECK (schema_version >= 1),
+	revision INTEGER NOT NULL CHECK (revision >= 0),
+	nbt BLOB NOT NULL
+);
+
+CREATE TABLE synced_server_state (
+	singleton INTEGER PRIMARY KEY NOT NULL CHECK (singleton = 1),
+	revision INTEGER NOT NULL CHECK (revision >= 0)
+);
+
+CREATE TABLE synced_servers (
+	id TEXT PRIMARY KEY NOT NULL,
+	position INTEGER NOT NULL UNIQUE CHECK (position >= 0),
+	nbt BLOB NOT NULL
+);
+
+CREATE TABLE instance_servers (
+	instance_id TEXT NOT NULL,
+	id TEXT NOT NULL,
+	source TEXT NOT NULL CHECK (source IN ('modpack', 'local_desynced')),
+	excluded_synced_server_id TEXT,
+	nbt BLOB NOT NULL,
+	position INTEGER NOT NULL CHECK (position >= 0),
+	PRIMARY KEY (instance_id, id),
+	UNIQUE (instance_id, position),
+	FOREIGN KEY (instance_id) REFERENCES instances (id) ON DELETE CASCADE,
+	FOREIGN KEY (excluded_synced_server_id) REFERENCES synced_servers (id) ON DELETE SET NULL
+);
+
+CREATE TABLE instance_server_projection_entries (
+	instance_id TEXT NOT NULL,
+	owner TEXT NOT NULL CHECK (owner IN ('synced', 'instance')),
+	server_id TEXT NOT NULL,
+	nbt BLOB NOT NULL,
+	position INTEGER NOT NULL CHECK (position >= 0),
+	PRIMARY KEY (instance_id, owner, server_id),
+	UNIQUE (instance_id, position),
+	FOREIGN KEY (instance_id) REFERENCES instances (id) ON DELETE CASCADE
+);
+
+CREATE TABLE instance_server_pack_state (
+	instance_id TEXT PRIMARY KEY NOT NULL,
+	version_id TEXT,
+	FOREIGN KEY (instance_id) REFERENCES instances (id) ON DELETE CASCADE
+);
+
+-- Synced pack catalog tables (ported alongside the sync feature tables).
+CREATE TABLE synced_pack_catalog (
+	id TEXT PRIMARY KEY NOT NULL,
+	project_type TEXT NOT NULL CHECK (project_type IN ('resourcepack', 'datapack')),
+	file_name TEXT NOT NULL,
+	sha1 TEXT NOT NULL UNIQUE,
+	size INTEGER NOT NULL CHECK (size >= 0),
+	game_versions_json TEXT NOT NULL DEFAULT '[]',
+	enabled INTEGER NOT NULL DEFAULT 1 CHECK (enabled IN (0, 1)),
+	created_at INTEGER NOT NULL,
+	modified_at INTEGER NOT NULL
+);
+
+CREATE INDEX synced_pack_catalog_type ON synced_pack_catalog(project_type, modified_at);
+
+CREATE TABLE synced_pack_instances (
+	pack_id TEXT NOT NULL,
+	instance_id TEXT NOT NULL,
+	excluded INTEGER NOT NULL DEFAULT 0 CHECK (excluded IN (0, 1)),
+	materialized_path TEXT,
+	modified_at INTEGER NOT NULL,
+	PRIMARY KEY (pack_id, instance_id),
+	FOREIGN KEY (pack_id) REFERENCES synced_pack_catalog(id) ON DELETE CASCADE,
+	FOREIGN KEY (instance_id) REFERENCES instances(id) ON DELETE CASCADE
+);
+
+CREATE INDEX synced_pack_instances_instance ON synced_pack_instances(instance_id, excluded);
+
+ALTER TABLE settings ADD COLUMN sync_features_across_devices INTEGER NOT NULL DEFAULT FALSE;

packages/app-lib/migrations/20261003000100_linked-server-project-sync-source.sql

@@ -0,0 +1,27 @@
+-- Axolotl stores managed server-project entries alongside the local additions
+-- that are composed with the launcher-wide multiplayer server list. Extend
+-- the original sync table constraint without changing the already-applied
+-- instance-sync migration.
+CREATE TABLE instance_servers_new (
+	instance_id TEXT NOT NULL,
+	id TEXT NOT NULL,
+	source TEXT NOT NULL CHECK (
+		source IN ('modpack', 'linked_server_project', 'local_desynced')
+	),
+	excluded_synced_server_id TEXT,
+	nbt BLOB NOT NULL,
+	position INTEGER NOT NULL CHECK (position >= 0),
+	PRIMARY KEY (instance_id, id),
+	UNIQUE (instance_id, position),
+	FOREIGN KEY (instance_id) REFERENCES instances (id) ON DELETE CASCADE,
+	FOREIGN KEY (excluded_synced_server_id)
+		REFERENCES synced_servers (id) ON DELETE SET NULL
+);
+
+INSERT INTO instance_servers_new
+	(instance_id, id, source, excluded_synced_server_id, nbt, position)
+SELECT instance_id, id, source, excluded_synced_server_id, nbt, position
+FROM instance_servers;
+
+DROP TABLE instance_servers;
+ALTER TABLE instance_servers_new RENAME TO instance_servers;

packages/app-lib/migrations/20261003000200_synced-pack-selection.sql

@@ -0,0 +1,2 @@
+ALTER TABLE synced_pack_catalog ADD COLUMN selected INTEGER NOT NULL DEFAULT 1 CHECK (selected IN (0, 1));
+ALTER TABLE synced_pack_catalog ADD COLUMN selection_order INTEGER;

packages/app-lib/migrations/20261003000300_disable-discovered-game-options.sql

@@ -0,0 +1,5 @@
+-- Discovered options are catalogued for review, but must not be synced until
+-- the user explicitly enables them.
+UPDATE synced_game_option_preferences
+SET enabled = 0
+WHERE source = 'discovery_default' AND enabled = 1;

packages/app-lib/migrations/20261004000000_custom-window-title.sql

@@ -0,0 +1,2 @@
+ALTER TABLE settings ADD COLUMN custom_window_title_enabled INTEGER NOT NULL DEFAULT FALSE;
+ALTER TABLE settings ADD COLUMN default_window_title TEXT NOT NULL DEFAULT 'Minecraft';

packages/app-lib/migrations/20261005000000_log-share.sql

@@ -0,0 +1,26 @@
+CREATE TABLE log_share_settings (
+	id INTEGER NOT NULL CHECK (id = 0),
+	share_provider TEXT NOT NULL DEFAULT 'logshare',
+	ai_source TEXT NOT NULL DEFAULT 'logshare',
+	auto_upload INTEGER NOT NULL DEFAULT TRUE,
+	multi_file INTEGER NOT NULL DEFAULT TRUE,
+	no_storage INTEGER NOT NULL DEFAULT FALSE,
+	show_progress INTEGER NOT NULL DEFAULT TRUE,
+	PRIMARY KEY (id)
+);
+
+INSERT INTO log_share_settings (id) VALUES (0);
+
+CREATE TABLE shared_logs (
+	id TEXT NOT NULL PRIMARY KEY,
+	url TEXT NOT NULL,
+	raw TEXT NOT NULL,
+	token TEXT NOT NULL,
+	provider TEXT NOT NULL DEFAULT 'logshare',
+	instance_id TEXT NULL,
+	instance_name TEXT NULL,
+	truncated INTEGER NOT NULL DEFAULT FALSE,
+	created_at INTEGER NOT NULL
+);
+
+CREATE INDEX shared_logs_created_at_idx ON shared_logs (created_at DESC);

packages/app-lib/src/api/ai.rs

@@ -19,7 +19,7 @@ use uuid::Uuid;
 
 use crate::{ErrorKind, State};
 
-const CATALOG_SOURCE: &str = "LobeHub 906b10e03029648655e0257bda4f785a9e0973f0";
+const CATALOG_SOURCE: &str = "LobeHub 6c7a6fb033e443bc27bf34cbd5509ab3db7f22f3";
 const KEYRING_PREFIX: &str = "ai-provider";
 const OAUTH_CREDENTIAL: &str = "oauth";
 const API_KEY_CREDENTIAL: &str = "api-key";

packages/app-lib/src/api/instance/groups.rs

@@ -0,0 +1,261 @@
+use crate::event::emit::emit_instance_groups_changed;
+use crate::state::instance_groups;
+use serde::{Deserialize, Serialize};
+use std::collections::HashSet;
+use uuid::Uuid;
+
+const MAX_GROUP_NAME_LENGTH: usize = 256;
+pub const FAVORITES_GROUP_ID: &str = instance_groups::FAVORITES_GROUP_ID;
+
+#[derive(Debug, Clone, Deserialize, Serialize)]
+pub struct InstanceGroup {
+    pub id: String,
+    pub name: String,
+}
+
+#[derive(Debug, Clone, Deserialize, Serialize)]
+pub struct InstanceGroupMembershipUpdate {
+    pub instance_id: String,
+    pub group_ids: Vec<String>,
+}
+
+fn validate_group_name(name: &str) -> crate::Result<&str> {
+    let name = name.trim();
+
+    if name.is_empty() {
+        return Err(crate::ErrorKind::InputError(
+            "Group name cannot be empty".to_string(),
+        )
+        .into());
+    }
+
+    if name.chars().count() > MAX_GROUP_NAME_LENGTH {
+        return Err(crate::ErrorKind::InputError(format!(
+            "Group name cannot exceed {MAX_GROUP_NAME_LENGTH} characters"
+        ))
+        .into());
+    }
+
+    if name.eq_ignore_ascii_case("none") {
+        return Err(crate::ErrorKind::InputError(
+            "Group name cannot be None".to_string(),
+        )
+        .into());
+    }
+
+    Ok(name)
+}
+
+fn normalize_membership_updates(
+    mut updates: Vec<InstanceGroupMembershipUpdate>,
+) -> crate::Result<Vec<InstanceGroupMembershipUpdate>> {
+    let mut instance_ids = HashSet::new();
+    for update in &mut updates {
+        if !instance_ids.insert(update.instance_id.clone()) {
+            return Err(crate::ErrorKind::InputError(format!(
+                "Duplicate instance {} in group membership update",
+                update.instance_id
+            ))
+            .into());
+        }
+
+        let mut group_ids = HashSet::new();
+        update
+            .group_ids
+            .retain(|group_id| group_ids.insert(group_id.clone()));
+    }
+
+    Ok(updates)
+}
+
+pub async fn list_groups() -> crate::Result<Vec<InstanceGroup>> {
+    Ok(instance_groups::list()
+        .into_iter()
+        .map(|group| InstanceGroup {
+            id: group.id,
+            name: group.name,
+        })
+        .collect())
+}
+
+pub async fn create_group(name: String) -> crate::Result<InstanceGroup> {
+    let name = validate_group_name(&name)?;
+    let id = Uuid::new_v4().to_string();
+    instance_groups::create(&id, name);
+
+    Ok(InstanceGroup {
+        id,
+        name: name.to_string(),
+    })
+}
+
+pub async fn set_group_order(group_ids: Vec<String>) -> crate::Result<()> {
+    instance_groups::set_order(&group_ids);
+    Ok(())
+}
+
+pub async fn set_group_memberships(
+    updates: Vec<InstanceGroupMembershipUpdate>,
+) -> crate::Result<()> {
+    if updates.is_empty() {
+        return Ok(());
+    }
+
+    let updates = normalize_membership_updates(updates)?;
+
+    // Note: the instances themselves are deliberately not validated here.
+    // JSON-backed instances (`local:` ids) have no row in the `instances` table,
+    // and requiring one is what used to make grouping them fail outright.
+    let unique_group_ids = updates
+        .iter()
+        .flat_map(|update| update.group_ids.iter())
+        .collect::<HashSet<_>>();
+    for group_id in unique_group_ids {
+        if !instance_groups::group_exists(group_id) {
+            return Err(crate::ErrorKind::InputError(format!(
+                "Unknown instance group {group_id}"
+            ))
+            .into());
+        }
+    }
+
+    instance_groups::set_memberships(
+        &updates
+            .iter()
+            .map(|update| {
+                (update.instance_id.clone(), update.group_ids.clone())
+            })
+            .collect::<Vec<_>>(),
+    );
+
+    let instance_ids = updates
+        .into_iter()
+        .map(|update| update.instance_id)
+        .collect::<Vec<_>>();
+    emit_instance_groups_changed(&instance_ids).await?;
+
+    Ok(())
+}
+
+pub async fn rename_group(
+    id: String,
+    new_name: String,
+) -> crate::Result<InstanceGroup> {
+    if id == FAVORITES_GROUP_ID {
+        return Err(crate::ErrorKind::InputError(
+            "Favorites cannot be renamed".to_string(),
+        )
+        .into());
+    }
+
+    let new_name = validate_group_name(&new_name)?;
+
+    let Some(instance_ids) = instance_groups::rename(&id, new_name) else {
+        return Err(crate::ErrorKind::InputError(format!(
+            "Unknown instance group {id}"
+        ))
+        .into());
+    };
+
+    emit_instance_groups_changed(&instance_ids).await?;
+
+    Ok(InstanceGroup {
+        id,
+        name: new_name.to_string(),
+    })
+}
+
+pub async fn delete_group(id: String) -> crate::Result<()> {
+    if id == FAVORITES_GROUP_ID {
+        return Err(crate::ErrorKind::InputError(
+            "Favorites cannot be deleted".to_string(),
+        )
+        .into());
+    }
+
+    let Some(instance_ids) = instance_groups::delete(&id) else {
+        return Err(crate::ErrorKind::InputError(format!(
+            "Unknown instance group {id}"
+        ))
+        .into());
+    };
+
+    emit_instance_groups_changed(&instance_ids).await?;
+
+    Ok(())
+}
+
+#[cfg(test)]
+mod tests {
+    use super::{
+        FAVORITES_GROUP_ID, InstanceGroupMembershipUpdate,
+        MAX_GROUP_NAME_LENGTH, normalize_membership_updates,
+        validate_group_name,
+    };
+
+    #[test]
+    fn group_name_validation_trims_valid_names() {
+        assert_eq!(validate_group_name("  My group  ").unwrap(), "My group");
+    }
+
+    #[test]
+    fn group_name_validation_rejects_empty_names() {
+        assert!(validate_group_name("   ").is_err());
+    }
+
+    #[test]
+    fn group_name_validation_rejects_reserved_name() {
+        assert!(validate_group_name("NoNe").is_err());
+    }
+
+    #[test]
+    fn group_name_validation_allows_favorites() {
+        assert_eq!(validate_group_name("Favorites").unwrap(), "Favorites");
+    }
+
+    #[test]
+    fn group_name_validation_rejects_long_names() {
+        assert!(
+            validate_group_name(&"a".repeat(MAX_GROUP_NAME_LENGTH + 1))
+                .is_err()
+        );
+    }
+
+    #[test]
+    fn favorites_group_id_is_stable() {
+        assert_eq!(FAVORITES_GROUP_ID, "group:favorites");
+    }
+
+    #[test]
+    fn membership_updates_reject_duplicate_instances() {
+        let updates = vec![
+            InstanceGroupMembershipUpdate {
+                instance_id: "instance".to_string(),
+                group_ids: vec!["first".to_string()],
+            },
+            InstanceGroupMembershipUpdate {
+                instance_id: "instance".to_string(),
+                group_ids: vec!["second".to_string()],
+            },
+        ];
+
+        assert!(normalize_membership_updates(updates).is_err());
+    }
+
+    #[test]
+    fn membership_updates_deduplicate_groups() {
+        let updates =
+            normalize_membership_updates(vec![InstanceGroupMembershipUpdate {
+                instance_id: "instance".to_string(),
+                group_ids: vec![
+                    "a".to_string(),
+                    "b".to_string(),
+                    "a".to_string(),
+                    "b".to_string(),
+                ],
+            }])
+            .unwrap();
+
+        assert_eq!(updates[0].group_ids, &["a", "b"]);
+    }
+}

packages/app-lib/src/api/instance/mod.rs

@@ -5,6 +5,7 @@ mod content;
 mod core_components;
 mod export_mrpack;
 mod get;
+mod groups;
 mod home;
 mod install;
 mod lifecycle;
@@ -15,7 +16,16 @@ mod projects;
 mod run;
 mod screenshot_groups;
 mod screenshots;
+pub(crate) mod synced_options;
 mod upgrade;
+pub(crate) mod synced_packs {
+    pub(crate) use super::synced_packs_axolotl::{
+        capture_resource_pack_selection_change, detach,
+        prepare_instance_update, reconcile, seed_from_instance,
+    };
+}
+mod synced_packs_axolotl;
+pub(crate) mod synced_servers;
 
 pub use self::backup::{
     BackupDeleteSummary, BackupExclusion, BackupExclusionKind, BackupOperation,
@@ -63,6 +73,11 @@ pub use self::export_mrpack::{
     create_mrpack_json, export_mrpack, get_pack_export_candidates,
 };
 pub use self::get::{get, get_many, list};
+pub use self::groups::{
+    FAVORITES_GROUP_ID, InstanceGroup, InstanceGroupMembershipUpdate,
+    create_group, delete_group, list_groups, rename_group,
+    set_group_memberships, set_group_order,
+};
 pub use self::home::{
     get_daily_playtime, get_daily_playtime_details, set_pinned,
 };
@@ -114,6 +129,48 @@ pub use self::screenshots::{
     list_all_screenshots, list_screenshots, list_synced_screenshots,
     move_screenshots, save_edited_screenshot,
 };
+pub use self::synced_options::game_options::{
+    GameOptionsSourceCandidate, GameSettingLocaleLabels,
+    GameSettingsEditorState, SaveGameSettingsResult, UpdateGameSettingsRequest,
+    get_config as get_synced_game_options_config,
+    get_game_setting_locale_labels,
+    get_local_config as get_local_game_options_config,
+    list_sync_sources as list_game_options_sync_sources,
+    preview_changes as preview_synced_game_option_changes,
+    preview_local_changes as preview_local_game_option_changes,
+    save_changes as save_synced_game_option_changes,
+    save_local_changes as save_local_game_option_changes,
+};
+pub(crate) use self::synced_options::game_options::{
+    apply_launcher_overrides as apply_game_options_launcher_overrides,
+    sync_before_launch as sync_game_options_before_launch,
+};
+pub use self::synced_options::{
+    GlobalSyncedOptions, SyncedOptionCapability, SyncedOptionJoinAction,
+    SyncedOptionJoinPreview, SyncedOptionJoinResolution, SyncedOptionsOverview,
+    get_capabilities as get_synced_option_capabilities,
+    get_command_history as get_synced_command_history,
+    get_global_options as get_global_synced_options,
+    get_initialized_options as get_initialized_synced_options,
+    get_instance_option_join_preview as get_synced_option_join_preview,
+    get_overview as get_synced_options_overview,
+    set_command_history as set_synced_command_history,
+    set_global_option as set_global_synced_option,
+    set_instance_option as set_instance_synced_option,
+};
+pub(crate) use self::synced_options::{
+    reconcile_changed_file as reconcile_synced_option_file,
+    remove_generated_instance_files,
+};
+pub use self::synced_packs_axolotl::{
+    PackSyncPreview, PackSyncTarget, desync_pack, get_pack_sync_preview,
+    list_synced_packs, remove_synced_pack, set_synced_pack_enabled, sync_pack,
+    upload_synced_pack,
+};
+pub use self::synced_servers::{
+    DesyncServerMode, ServerSource, SyncedServer, desync_server,
+    list_synced_servers, remove_synced_server, update_synced_server,
+};
 pub use self::upgrade::{
     dismiss_instance_post_upgrade_notice, execute_instance_upgrade,
     get_instance_post_upgrade_notice, get_instance_upgrade_plan,
@@ -122,3 +179,4 @@ pub use self::upgrade::{
     update_instance_upgrade_resolution, update_instance_upgrade_resolutions,
 };
 pub use crate::state::{DailyPlaytime, DailyPlaytimeEntry};
+pub use crate::state::{InstanceSyncedOptions, SyncedOption};

packages/app-lib/src/api/instance/run.rs

@@ -250,6 +250,17 @@ async fn run_credentials(
         .launch_overrides
         .maximize_window
         .unwrap_or(settings.maximize_window);
+    let window_title = settings
+        .custom_window_title_enabled
+        .then(|| {
+            context
+                .launch_overrides
+                .window_title
+                .clone()
+                .filter(|value| !value.trim().is_empty())
+                .unwrap_or_else(|| settings.default_window_title.clone())
+        })
+        .filter(|value| !value.trim().is_empty());
     let env_args = context
         .launch_overrides
         .custom_env_vars
@@ -319,6 +330,7 @@ async fn run_credentials(
         &memory,
         &resolution,
         maximize_window,
+        window_title,
         credentials,
         post_exit_hook,
         &context,

packages/app-lib/src/api/instance/synced_options/command_history.rs

@@ -0,0 +1,186 @@
+use super::COMMAND_HISTORY_FILE;
+use super::files::{
+    CheckpointStatus, begin_checkpoint, checkpoint, ensure_link,
+    finish_checkpoint, instance_game_dir, sha1_bytes, sha1_file,
+    synced_options_path,
+};
+use super::orchestration::{create_synced_directories, option_effective};
+use crate::State;
+use crate::state::{InstanceMetadata, SyncedOption};
+use crate::util::io;
+use std::path::PathBuf;
+
+const COMMAND_HISTORY_LIMIT: usize = 50;
+
+pub async fn get_command_history() -> crate::Result<String> {
+    let state = State::get().await?;
+    let _guard = state.lock_synced_options().await;
+    let path = command_history_path(&state);
+    if !path.exists() {
+        return Ok(String::new());
+    }
+    Ok(String::from_utf8_lossy(&io::read(path).await?).into_owned())
+}
+
+pub async fn set_command_history(contents: &str) -> crate::Result<String> {
+    let state = State::get().await?;
+    let _guard = state.lock_synced_options().await;
+    create_synced_directories(&state).await?;
+    let normalized = normalize_command_history(contents);
+    io::write(command_history_path(&state), normalized.as_bytes()).await?;
+    refresh_command_history_links(&state).await?;
+    Ok(normalized)
+}
+
+pub(super) async fn ensure_command_history(
+    metadata: &InstanceMetadata,
+    state: &State,
+) -> crate::Result<()> {
+    create_synced_directories(state).await?;
+    let canonical = command_history_path(state);
+    if !canonical.exists() {
+        let local =
+            instance_game_dir(metadata, state)?.join(COMMAND_HISTORY_FILE);
+        let contents = if local.exists() {
+            String::from_utf8_lossy(&io::read(&local).await?).into_owned()
+        } else {
+            String::new()
+        };
+        io::write(&canonical, normalize_command_history(&contents)).await?;
+    }
+    let target = instance_game_dir(metadata, state)?.join(COMMAND_HISTORY_FILE);
+    let canonical_bytes = io::read(&canonical).await?;
+    let expected = sha1_bytes(&canonical_bytes);
+    begin_checkpoint(
+        &metadata.instance.id,
+        SyncedOption::CommandHistory,
+        "default",
+        &expected,
+        None,
+        0,
+        state,
+    )
+    .await?;
+    let mode = ensure_link(&canonical, &target).await?;
+    finish_checkpoint(
+        &metadata.instance.id,
+        SyncedOption::CommandHistory,
+        "default",
+        mode,
+        state,
+    )
+    .await
+}
+
+pub(super) async fn reconcile_command_history(
+    metadata: &InstanceMetadata,
+    state: &State,
+) -> crate::Result<()> {
+    if !option_effective(metadata, SyncedOption::CommandHistory, state).await? {
+        return Ok(());
+    }
+    let local = instance_game_dir(metadata, state)?.join(COMMAND_HISTORY_FILE);
+    if !local.exists() {
+        return ensure_command_history(metadata, state).await;
+    }
+    let symlink = tokio::fs::symlink_metadata(&local)
+        .await
+        .map(|metadata| metadata.file_type().is_symlink())
+        .unwrap_or(false);
+    let current_checkpoint = checkpoint(
+        &metadata.instance.id,
+        SyncedOption::CommandHistory,
+        "default",
+        state,
+    )
+    .await?;
+    if current_checkpoint
+        .as_ref()
+        .is_some_and(|value| value.status == CheckpointStatus::Pending)
+    {
+        return ensure_command_history(metadata, state).await;
+    }
+    let actual = sha1_file(&local).await?;
+    let expected = current_checkpoint.map(|value| value.expected_sha1);
+    if !symlink && expected.as_deref() != Some(actual.as_str()) {
+        let contents =
+            String::from_utf8_lossy(&io::read(&local).await?).into_owned();
+        io::write(
+            command_history_path(state),
+            normalize_command_history(&contents),
+        )
+        .await?;
+        refresh_command_history_links(state).await?;
+    } else {
+        ensure_command_history(metadata, state).await?;
+    }
+    Ok(())
+}
+
+async fn refresh_command_history_links(state: &State) -> crate::Result<()> {
+    let instances = crate::state::list_instances(&state.pool).await?;
+    for metadata in instances {
+        if option_effective(&metadata, SyncedOption::CommandHistory, state)
+            .await?
+        {
+            ensure_command_history(&metadata, state).await?;
+        }
+    }
+    Ok(())
+}
+
+pub(super) fn normalize_command_history(contents: &str) -> String {
+    let lines = contents.lines().collect::<Vec<_>>();
+    let start = lines.len().saturating_sub(COMMAND_HISTORY_LIMIT);
+    let mut normalized = lines[start..].join("\n");
+    if !normalized.is_empty() {
+        normalized.push('\n');
+    }
+    normalized
+}
+
+pub(super) async fn merge_command_history_from_instance(
+    metadata: &InstanceMetadata,
+    state: &State,
+) -> crate::Result<()> {
+    let canonical_path = command_history_path(state);
+    let canonical = if canonical_path.exists() {
+        String::from_utf8_lossy(&io::read(&canonical_path).await?).into_owned()
+    } else {
+        String::new()
+    };
+    let local_path =
+        instance_game_dir(metadata, state)?.join(COMMAND_HISTORY_FILE);
+    let local = if local_path.exists() {
+        String::from_utf8_lossy(&io::read(&local_path).await?).into_owned()
+    } else {
+        String::new()
+    };
+    let canonical_lines = canonical.lines().collect::<Vec<_>>();
+    let available = COMMAND_HISTORY_LIMIT.saturating_sub(canonical_lines.len());
+    let mut seen = canonical_lines
+        .iter()
+        .copied()
+        .collect::<std::collections::HashSet<_>>();
+    let mut imported = Vec::new();
+    for line in local.lines().rev() {
+        if imported.len() == available {
+            break;
+        }
+        if seen.insert(line) {
+            imported.push(line);
+        }
+    }
+    imported.reverse();
+    imported.extend(canonical_lines);
+    let merged = normalize_command_history(&imported.join("\n"));
+    if merged != normalize_command_history(&canonical) {
+        io::write(&canonical_path, merged).await?;
+        refresh_command_history_links(state).await?;
+    }
+    Ok(())
+}
+
+pub(super) fn command_history_path(state: &State) -> PathBuf {
+    synced_options_path(state).join(COMMAND_HISTORY_FILE)
+}

packages/app-lib/src/api/instance/synced_options/files.rs

@@ -0,0 +1,338 @@
+use crate::state::{InstanceInstallStage, InstanceMetadata, SyncedOption};
+use crate::util::io;
+use crate::{ErrorKind, State};
+use quartz_nbt::NbtCompound;
+use sha1_smol::Sha1;
+use std::io::Cursor;
+use std::path::{Path, PathBuf};
+
+pub(in crate::api::instance) struct SyncCheckpoint {
+    pub expected_sha1: String,
+    pub merge_base: Option<Vec<u8>>,
+    pub source_revision: i64,
+    pub status: CheckpointStatus,
+}
+
+#[derive(Clone, Copy, Debug, Eq, PartialEq)]
+pub(in crate::api::instance) enum CheckpointStatus {
+    Pending,
+    Ready,
+}
+
+impl CheckpointStatus {
+    fn from_str(value: &str) -> Option<Self> {
+        match value {
+            "pending" => Some(Self::Pending),
+            "ready" => Some(Self::Ready),
+            _ => None,
+        }
+    }
+}
+
+#[derive(Clone, Copy, Debug)]
+pub(in crate::api::instance) enum LinkMode {
+    Symbolic,
+    #[cfg(windows)]
+    Hard,
+    #[cfg(windows)]
+    Copy,
+}
+
+impl LinkMode {
+    fn as_str(self) -> &'static str {
+        match self {
+            Self::Symbolic => "symbolic",
+            #[cfg(windows)]
+            Self::Hard => "hard",
+            #[cfg(windows)]
+            Self::Copy => "copy",
+        }
+    }
+}
+
+pub(in crate::api::instance) fn safe_instance_id(instance_id: &str) -> String {
+    instance_id.replace([':', '/', '\\'], "_")
+}
+
+pub(crate) fn instance_game_dir(
+    metadata: &InstanceMetadata,
+    state: &State,
+) -> crate::Result<PathBuf> {
+    crate::state::instances::commands::instance_content_root(
+        &state.directories,
+        &metadata.instance,
+    )
+}
+
+pub(crate) fn synced_options_path(state: &State) -> PathBuf {
+    state.directories.synced_options_dir()
+}
+
+pub(in crate::api::instance) fn sync_files_are_protected(
+    metadata: &InstanceMetadata,
+) -> bool {
+    matches!(
+        metadata.instance.install_stage,
+        InstanceInstallStage::MinecraftInstalling
+            | InstanceInstallStage::PackInstalling
+    )
+}
+
+pub(in crate::api::instance) async fn instance_is_running(
+    metadata: &InstanceMetadata,
+    state: &State,
+) -> crate::Result<bool> {
+    crate::state::instance_has_running_process(&metadata.instance.id, state)
+        .await
+}
+
+pub(in crate::api::instance) fn option_can_apply_while_running(
+    option: SyncedOption,
+) -> bool {
+    matches!(
+        option,
+        SyncedOption::GameOptions
+            | SyncedOption::Screenshots
+            | SyncedOption::ResourcePacks
+    )
+}
+
+pub(in crate::api::instance) fn instance_option_enabled(
+    metadata: &InstanceMetadata,
+    option: SyncedOption,
+) -> bool {
+    match option {
+        SyncedOption::GameOptions => metadata.synced_options.game_options,
+        SyncedOption::CommandHistory => metadata.synced_options.command_history,
+        SyncedOption::MultiplayerServers => {
+            metadata.synced_options.multiplayer_servers
+        }
+        SyncedOption::CreativeHotbars => {
+            metadata.synced_options.creative_hotbars
+        }
+        SyncedOption::Screenshots => metadata.synced_options.screenshots,
+        SyncedOption::ResourcePacks => metadata.synced_options.resource_packs,
+        SyncedOption::DataPacks => metadata.synced_options.data_packs,
+    }
+}
+
+pub(in crate::api::instance) async fn ensure_link(
+    source: &Path,
+    target: &Path,
+) -> crate::Result<LinkMode> {
+    if let Some(parent) = target.parent() {
+        io::create_dir_all(parent).await?;
+    }
+    if tokio::fs::symlink_metadata(target)
+        .await
+        .is_ok_and(|metadata| metadata.file_type().is_symlink())
+        && tokio::fs::read_link(target)
+            .await
+            .is_ok_and(|current| current == source)
+    {
+        return Ok(LinkMode::Symbolic);
+    }
+    if tokio::fs::symlink_metadata(target).await.is_ok() {
+        io::remove_file(target).await?;
+    }
+
+    #[cfg(unix)]
+    {
+        tokio::fs::symlink(source, target).await?;
+        Ok(LinkMode::Symbolic)
+    }
+    #[cfg(windows)]
+    {
+        if tokio::fs::symlink_file(source, target).await.is_ok() {
+            return Ok(LinkMode::Symbolic);
+        }
+        if tokio::fs::hard_link(source, target).await.is_ok() {
+            return Ok(LinkMode::Hard);
+        }
+        io::copy(source, target).await?;
+        Ok(LinkMode::Copy)
+    }
+}
+
+pub(in crate::api::instance) async fn detach_link(
+    source: &Path,
+    target: &Path,
+) -> crate::Result<()> {
+    let target_metadata = tokio::fs::symlink_metadata(target).await.ok();
+    let contents = if target_metadata.is_some() && target.exists() {
+        Some(io::read(target).await?)
+    } else if source.exists() {
+        Some(io::read(source).await?)
+    } else {
+        None
+    };
+    if target_metadata.is_some() {
+        io::remove_file(target).await?;
+    }
+    if let Some(contents) = contents {
+        io::write(target, contents).await?;
+    }
+    Ok(())
+}
+
+pub(in crate::api::instance) async fn begin_checkpoint(
+    instance_id: &str,
+    option: SyncedOption,
+    variant: &str,
+    expected_sha1: &str,
+    merge_base: Option<&[u8]>,
+    source_revision: i64,
+    state: &State,
+) -> crate::Result<()> {
+    let option_name = option.as_str();
+    sqlx::query(
+        "
+		INSERT INTO instance_sync_checkpoints
+			(instance_id, feature, variant, expected_sha1, merge_base,
+			 source_revision, status, link_mode)
+		VALUES (?, ?, ?, ?, ?, ?, 'pending', NULL)
+		ON CONFLICT(instance_id, feature, variant) DO UPDATE SET
+			expected_sha1 = excluded.expected_sha1,
+			merge_base = excluded.merge_base,
+			source_revision = excluded.source_revision,
+			status = 'pending',
+			link_mode = NULL
+		",
+    )
+    .bind(instance_id)
+    .bind(option_name)
+    .bind(variant)
+    .bind(expected_sha1)
+    .bind(merge_base)
+    .bind(source_revision)
+    .execute(&state.pool)
+    .await?;
+    Ok(())
+}
+
+pub(in crate::api::instance) async fn finish_checkpoint(
+    instance_id: &str,
+    option: SyncedOption,
+    variant: &str,
+    mode: LinkMode,
+    state: &State,
+) -> crate::Result<()> {
+    let option_name = option.as_str();
+    let link_mode = mode.as_str();
+    sqlx::query(
+        "
+		UPDATE instance_sync_checkpoints
+		SET status = 'ready', link_mode = ?
+		WHERE instance_id = ? AND feature = ? AND variant = ?
+		",
+    )
+    .bind(link_mode)
+    .bind(instance_id)
+    .bind(option_name)
+    .bind(variant)
+    .execute(&state.pool)
+    .await?;
+    Ok(())
+}
+
+pub(in crate::api::instance) async fn finish_plain_checkpoint(
+    instance_id: &str,
+    option: SyncedOption,
+    variant: &str,
+    state: &State,
+) -> crate::Result<()> {
+    let option_name = option.as_str();
+    sqlx::query(
+        "
+		UPDATE instance_sync_checkpoints
+		SET status = 'ready', link_mode = NULL
+		WHERE instance_id = ? AND feature = ? AND variant = ?
+		",
+    )
+    .bind(instance_id)
+    .bind(option_name)
+    .bind(variant)
+    .execute(&state.pool)
+    .await?;
+    Ok(())
+}
+
+pub(in crate::api::instance) async fn checkpoint(
+    instance_id: &str,
+    option: SyncedOption,
+    variant: &str,
+    state: &State,
+) -> crate::Result<Option<SyncCheckpoint>> {
+    let option_name = option.as_str();
+    let row = sqlx::query(
+        r#"
+		SELECT expected_sha1, merge_base, source_revision, status
+		FROM instance_sync_checkpoints
+		WHERE instance_id = ? AND feature = ? AND variant = ?
+		"#,
+    )
+    .bind(instance_id)
+    .bind(option_name)
+    .bind(variant)
+    .fetch_optional(&state.pool)
+    .await?;
+    use sqlx::Row;
+    row.map(|row| {
+        let status: String = row.get("status");
+        Ok(SyncCheckpoint {
+            expected_sha1: row.get("expected_sha1"),
+            merge_base: row.get("merge_base"),
+            source_revision: row.get("source_revision"),
+            status: CheckpointStatus::from_str(&status).ok_or_else(|| {
+                ErrorKind::InputError(format!(
+                    "Unknown sync checkpoint status {status}"
+                ))
+            })?,
+        })
+    })
+    .transpose()
+}
+
+pub(in crate::api::instance) async fn sha1_file(
+    path: &Path,
+) -> crate::Result<String> {
+    Ok(Sha1::from(io::read(path).await?).digest().to_string())
+}
+
+pub(in crate::api::instance) fn sha1_bytes(bytes: &[u8]) -> String {
+    Sha1::from(bytes).digest().to_string()
+}
+
+pub(in crate::api::instance) async fn read_nbt_file(
+    path: &Path,
+) -> crate::Result<NbtCompound> {
+    let bytes = io::read(path).await?;
+    let (root, _) = quartz_nbt::io::read_nbt(
+        &mut Cursor::new(bytes),
+        quartz_nbt::io::Flavor::Uncompressed,
+    )?;
+    Ok(root)
+}
+
+pub(in crate::api::instance) fn nbt_to_bytes(
+    root: &NbtCompound,
+) -> crate::Result<Vec<u8>> {
+    let mut bytes = Vec::new();
+    quartz_nbt::io::write_nbt(
+        &mut bytes,
+        None,
+        root,
+        quartz_nbt::io::Flavor::Uncompressed,
+    )?;
+    Ok(bytes)
+}
+
+pub(in crate::api::instance) fn nbt_from_bytes(
+    bytes: Vec<u8>,
+) -> crate::Result<NbtCompound> {
+    let (root, _) = quartz_nbt::io::read_nbt(
+        &mut Cursor::new(bytes),
+        quartz_nbt::io::Flavor::Uncompressed,
+    )?;
+    Ok(root)
+}

packages/app-lib/src/api/instance/synced_options/game_options/api_types.rs

@@ -0,0 +1,203 @@
+use crate::state::{CanonicalValue, GameOptionKind};
+use serde::{Deserialize, Serialize};
+
+#[derive(Clone, Copy, Debug, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum GameOptionsSourceIssue {
+    InstallingOrUpdating,
+    UnsupportedVersion,
+    MissingOptionsFile,
+    NoSyncableSettings,
+    UnreadableOptionsFile,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct GameOptionsSourceCandidate {
+    pub source_id: String,
+    pub instance_id: String,
+    pub name: String,
+    pub icon_path: Option<String>,
+    pub game_version: Option<String>,
+    pub eligible: bool,
+    pub disabled_reason: Option<GameOptionsSourceIssue>,
+    pub recognized_setting_count: u32,
+    pub custom_setting_count: u32,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct GameSettingCategory {
+    pub id: String,
+    pub is_custom: bool,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct GameOptionEditorDefinition {
+    #[serde(rename = "type")]
+    pub type_: String,
+    pub min: Option<f64>,
+    pub max: Option<f64>,
+    pub step: Option<f64>,
+    pub unit: Option<String>,
+    pub choices: Vec<GameOptionEditorChoice>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct GameOptionEditorChoice {
+    pub value: String,
+}
+
+#[derive(Clone, Copy, Debug, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum GameOptionCompatibilityStatus {
+    Ready,
+    Deferred,
+    WaitingForFile,
+    WaitingForBase,
+    NotAvailable,
+    UnsupportedValue,
+    Unmappable,
+    CatalogUncovered,
+    Controlled,
+    Degraded,
+}
+
+#[derive(Clone, Copy, Debug, Eq, PartialEq, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum GameOptionMappingKind {
+    Direct,
+    Legacy,
+    Migrated,
+    Lossless,
+    Lossy,
+}
+
+#[derive(Clone, Copy, Debug, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum GameOptionCompatibilityReason {
+    LauncherControlled,
+    CatalogUncovered,
+    InspectionFailed,
+    WaitingForOptionsFile,
+    UnsupportedValue,
+    MigratesOnWrite,
+    WaitingForCompatibleBase,
+    MissingSetting,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct GameOptionCompatibilityBucket {
+    pub instance_count: u32,
+    pub write_keys: Vec<String>,
+    pub eventual_keys: Vec<String>,
+    pub game_versions: Vec<String>,
+    pub status: GameOptionCompatibilityStatus,
+    pub mapping: Option<GameOptionMappingKind>,
+    pub reason: Option<GameOptionCompatibilityReason>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct GameOptionCompatibility {
+    pub total_participating: u32,
+    pub will_receive: u32,
+    pub write_now: u32,
+    pub left_local: u32,
+    pub buckets: Vec<GameOptionCompatibilityBucket>,
+}
+
+#[derive(Clone, Copy, Debug, Eq, PartialEq, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum GameOptionValueState {
+    Canonical,
+    UniformLocal,
+    Mixed,
+    Unset,
+    Invalid,
+}
+
+#[derive(Clone, Copy, Debug, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum GameOptionValidationIssue {
+    MissingValue,
+    NoCompatibleInstances,
+    InvalidValue,
+    ChangedSinceOpened,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct EditableGameSetting {
+    pub option_id: String,
+    pub category_id: String,
+    pub kind: GameOptionKind,
+    pub raw_key: Option<String>,
+    pub sync_enabled: bool,
+    pub canonical_value: Option<CanonicalValue>,
+    pub value_state: GameOptionValueState,
+    pub option_revision: u64,
+    pub editor: GameOptionEditorDefinition,
+    pub compatibility: GameOptionCompatibility,
+    pub validation_error: Option<GameOptionValidationIssue>,
+    pub controlled: bool,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct GameSettingsEditorState {
+    pub summary_revision: String,
+    pub canonical_revision: u64,
+    pub catalog_revision: u32,
+    pub total_participating: u32,
+    pub categories: Vec<GameSettingCategory>,
+    pub settings: Vec<EditableGameSetting>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct UpdateGameSettingsRequest {
+    pub expected_summary_revision: String,
+    pub expected_canonical_revision: u64,
+    pub expected_catalog_revision: u32,
+    pub changes: Vec<GameSettingChange>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct GameSettingChange {
+    pub option_id: String,
+    pub base_option_revision: u64,
+    pub sync_enabled: Option<bool>,
+    #[serde(
+        default,
+        with = "serde_with::rust::double_option",
+        skip_serializing_if = "Option::is_none"
+    )]
+    pub canonical_value: Option<Option<CanonicalValue>>,
+}
+
+#[derive(Clone, Debug, Default, Serialize, Deserialize)]
+pub struct SaveGameSettingsResult {
+    pub state: Option<GameSettingsEditorState>,
+    pub applied: u32,
+    pub migrated: u32,
+    pub deferred: u32,
+    pub unsupported: u32,
+    pub failed: u32,
+    pub conflicts: Vec<String>,
+}
+
+#[derive(Clone, Copy, Debug, Eq, PartialEq)]
+pub(super) enum SyncOutcome {
+    Applied,
+    Migrated,
+    Unchanged,
+    Deferred,
+    WaitingForFile,
+}
+
+pub(super) fn canonical_values_equal(
+    left: &CanonicalValue,
+    right: &CanonicalValue,
+) -> bool {
+    match (left, right) {
+        (CanonicalValue::Decimal(left), CanonicalValue::Decimal(right)) => {
+            left.parse::<f64>().ok() == right.parse::<f64>().ok()
+        }
+        _ => left == right,
+    }
+}

packages/app-lib/src/api/instance/synced_options/game_options/catalog/accessibility.rs

@@ -0,0 +1,207 @@
+use super::{
+    BOOL, SettingEditor, SupportedSetting, UNIT_INTERVAL, ValueEncoding,
+    ranged_setting, version_changes, versioned_setting,
+};
+
+const NARRATOR: &[&str] = &["0", "1", "2", "3"];
+
+pub(super) const SETTINGS: &[SupportedSetting] = &[
+    ranged_setting(
+        "narrator",
+        &["narrator"],
+        "1.12",
+        "26.3",
+        "accessibility",
+        true,
+        SettingEditor::Enum(NARRATOR),
+        ValueEncoding::Enum(NARRATOR),
+    ),
+    ranged_setting(
+        "subtitles",
+        &["showSubtitles"],
+        "1.9",
+        "26.3",
+        "accessibility",
+        true,
+        BOOL,
+        ValueEncoding::Bool,
+    ),
+    ranged_setting(
+        "high_contrast",
+        &["highContrast"],
+        "1.19.4",
+        "26.3",
+        "accessibility",
+        true,
+        BOOL,
+        ValueEncoding::Bool,
+    ),
+    ranged_setting(
+        "dark_splash",
+        &["darkMojangStudiosBackground"],
+        "1.17",
+        "26.3",
+        "accessibility",
+        true,
+        BOOL,
+        ValueEncoding::Bool,
+    ),
+    ranged_setting(
+        "notification_time",
+        &["notificationDisplayTime"],
+        "1.19.4",
+        "26.3",
+        "accessibility",
+        true,
+        SettingEditor::Decimal {
+            min: 0.5,
+            max: 10.0,
+            step: 0.5,
+            unit: Some("multiplier"),
+        },
+        ValueEncoding::Decimal,
+    ),
+    ranged_setting(
+        "fov_effects",
+        &["fovEffectScale"],
+        "1.16.2",
+        "26.3",
+        "accessibility",
+        true,
+        UNIT_INTERVAL,
+        ValueEncoding::Decimal,
+    ),
+    ranged_setting(
+        "screen_effects",
+        &["screenEffectScale"],
+        "1.16.2",
+        "26.3",
+        "accessibility",
+        true,
+        UNIT_INTERVAL,
+        ValueEncoding::Decimal,
+    ),
+    ranged_setting(
+        "darkness_pulsing",
+        &["darknessEffectScale"],
+        "1.19",
+        "26.3",
+        "accessibility",
+        true,
+        UNIT_INTERVAL,
+        ValueEncoding::Decimal,
+    ),
+    ranged_setting(
+        "damage_tilt",
+        &["damageTiltStrength"],
+        "1.19.4",
+        "26.3",
+        "accessibility",
+        true,
+        UNIT_INTERVAL,
+        ValueEncoding::Decimal,
+    ),
+    ranged_setting(
+        "glint_speed",
+        &["glintSpeed"],
+        "1.19.4",
+        "26.3",
+        "accessibility",
+        true,
+        UNIT_INTERVAL,
+        ValueEncoding::Decimal,
+    ),
+    ranged_setting(
+        "glint_strength",
+        &["glintStrength"],
+        "1.19.4",
+        "26.3",
+        "accessibility",
+        true,
+        UNIT_INTERVAL,
+        ValueEncoding::Decimal,
+    ),
+    ranged_setting(
+        "hide_lightning_flashes",
+        &["hideLightningFlashes"],
+        "1.18",
+        "26.3",
+        "accessibility",
+        true,
+        BOOL,
+        ValueEncoding::Bool,
+    ),
+    ranged_setting(
+        "hide_splash_texts",
+        &["hideSplashTexts"],
+        "1.20.3",
+        "26.3",
+        "accessibility",
+        true,
+        BOOL,
+        ValueEncoding::Bool,
+    ),
+    ranged_setting(
+        "high_contrast_outline",
+        &["highContrastBlockOutline"],
+        "1.21.2",
+        "26.3",
+        "accessibility",
+        true,
+        BOOL,
+        ValueEncoding::Bool,
+    ),
+    ranged_setting(
+        "narrator_hotkey",
+        &["narratorHotkey"],
+        "1.20.2",
+        "26.3",
+        "accessibility",
+        true,
+        BOOL,
+        ValueEncoding::Bool,
+    ),
+    ranged_setting(
+        "autosave_indicator",
+        &["showAutosaveIndicator"],
+        "1.18",
+        "26.3",
+        "accessibility",
+        true,
+        BOOL,
+        ValueEncoding::Bool,
+    ),
+    ranged_setting(
+        "panorama_speed",
+        &["panoramaScrollSpeed"],
+        "1.19.3",
+        "26.3",
+        "accessibility",
+        true,
+        UNIT_INTERVAL,
+        ValueEncoding::Decimal,
+    ),
+    versioned_setting(
+        "menu_background_blur",
+        &["menuBackgroundBlurriness"],
+        version_changes::MENU_BACKGROUND_BLUR_KEYS,
+        "accessibility",
+        true,
+        SettingEditor::Integer {
+            min: 0,
+            max: 10,
+            step: 1,
+        },
+        ValueEncoding::MenuBackgroundBlur,
+    ),
+    ranged_setting(
+        "rotate_with_minecart",
+        &["rotateWithMinecart"],
+        "1.21.2",
+        "26.3",
+        "accessibility",
+        true,
+        BOOL,
+        ValueEncoding::Bool,
+    ),
+];