Arknights Client v0.4.1

What’s new for players

• Restored installs and updates: Fixed an issue with official manifest formatting that prevented installs, updates, and game repairs from completing across all regions.
• Smarter music HUD text: Long song titles now only scroll when they exceed the HUD pill width, and gracefully fall back to clean truncation when Reduce Motion is turned on.
• Safer in-game settings: Launch-critical options (such as display mode, Metal HUD, Game Mode, and Wine sync) are now locked while a game is starting or running to avoid conflicting runtime states.
• Reliable download progress: Installation and repair progress remains strictly accurate even if a corrupted chunk fails verification and triggers an automatic retry.

This patch release resolves critical installation and repair regressions while refining music HUD behavior and runtime settings stability.

---

Changed

• Scrolled the current song title only when it is too wide for the music HUD, while preserving a static truncated title when Reduce Motion is enabled.
• Locked launch-only display, Metal HUD, Game Mode, and Wine synchronization settings while a game session is starting or running, and recorded the selected launch configuration in diagnostics.
• Added the Yostar API operation, region, endpoint, HTTP status, and decoding phase to launcher logs without exposing request authorization or response bodies.

Fixed

• Accepted the official leading-slash convention in game manifests while preserving installer path-containment protections, restoring installs, updates, and repairs for every region (Thanks to @NemesisHoshiko, #36).
• Rejected manifest collisions with installer-owned files and stopped oversized download responses before they can grow temporary files beyond their declared size (Thanks to @NemesisHoshiko, #36).
• Kept installation progress accurate when a checksum failure removes a partial download before retrying.

Arknights Client v0.4.0

What’s new for players

• Transition to Beta: Version 0.4.0 marks the launcher's transition from Alpha to its first Beta, featuring a stabilized Wine and DXMT runtime, refined lifecycle management, and production-ready multi-region support.
• Broader macOS compatibility: The launcher now officially supports macOS 15 Sequoia alongside macOS 26, bringing adaptive Liquid Glass to newer systems and clean native material fallbacks to macOS 15.
• Guided setup assistant: A new onboarding flow walks first-time installs and 0.3.x upgrades through free-space preflights, automated Rosetta 2 checks, and background downloads.
• In-app asset galleries: Browse and apply curated official Arknights wallpapers directly from Yostar and operator avatars composited into native macOS squircle app icons.
• Dynamic theming & background music: Stream and shuffle official YouTube music playlists with volume fading, clickable now-playing HUD pills, and dynamic UI accent colors that harmonize with your active artwork.
• Performance & diagnostics: An optional Metal Performance HUD provides native FPS and GPU telemetry, alongside experimental Apple Game Mode integration.

The transition to Beta, expanded macOS 15 compatibility, performance/bug fixes and integrated asset galleries make this a major milestone for players on Mac.

---

Added

• A resumable setup assistant for first installs and 0.3.x upgrades, with update preflight, background installation, and guided settings.
• Dedicated support actions for GitHub launcher reports and Yostar account, payment, or game-service issues.
• Free-space validation before game installation or updates.
• Functional Rosetta 2 preflight and guided installation during setup and launch, including macOS 27 upgrade and Legacy Game Test Mode diagnostics (Thanks to @Sorula2079, #33).
• An optional Metal Performance HUD for native FPS and GPU diagnostics.
• An experimental Game Mode integration that requires the full Xcode app.
• An experimental Danger Zone control for switching new game launches between MSYNC and ESYNC.
• A Settings Danger Zone for resets, Wine-prefix maintenance, migration, and game removal.
• Custom launcher icons with normalized Dock sizing (Thanks to @RadioNoiseE, #24).
• Drag-and-drop selection for launcher artwork and icons.
• Optional game-version, server-time, and daily-reset indicators above the Play controls.
• Cache cleanup for DXMT shaders, the embedded browser, and downloaded gallery assets.
• Optional YouTube background music with shuffled playlists, synchronized track titles, volume controls, and now-playing links (Thanks to @darkwebdev, #27).
• Expandable now-playing controls with deterministic playlist navigation and compact mute or volume adjustment (#27).
• Expandable game-version details with a manual update check.
• Dynamic Theme colors for controls, HUD elements, and compatible launcher icons.
• Floating HUD pills for region, game version, reset time, and background music.
• Native macOS 15–25 fallbacks while preserving Liquid Glass on macOS 26 (Thanks to @Mickhasinsomnia, #29).
• Dedicated galleries for official wallpapers and paired Launcher/Game operators, with bounded downloads and caching (Thanks to @darkwebdev, #30; @RadioNoiseE, #24).
• Linked operator presets with a framed Launcher treatment and a simple character Game icon.
• Custom game icons and a normalized "Use Default" option that preserves the original Arknights icon.
• Version-range and display-window options for announcement management.
• Recipe-download tracking in release statistics.

Changed

• Updated the bundled WineCX 11.15 and DXMT 0.80 runtime to the maintained dappermint build 4.5.118.
• Matched the launcher's resolution choices to the options offered by the official PC client.
• Made segmented controls consistently honor dynamic and Danger Zone tint colors across supported macOS versions.
• Reduced DXMT logging to error-only output outside diagnostics.
• Reorganized Settings and moved music controls into a dedicated Audio section.
• Polished Settings with right-aligned actions, clearer descriptions, and better-positioned scrollbars.
• Attached destructive confirmations directly to their initiating Settings controls.
• Unified popups and bundled-document sheets with the Settings visual language.
• Made prominent button text adapt to the sampled accent's luminance.
• Enlarged the main Settings control.
• Hardened installer paths, temporary-file handling, and manifest conflict detection.
• Replaced silent filesystem and process failures with contextual logging or visible errors.
• Split large UI and service types, centralized limits, and expanded runtime documentation.
• Consolidated development commands, preview scenarios, formatting, and script output.
• Reworked launcher and music lifecycle handling around explicit hierarchical state machines.
• Kept potentially private log excerpts out of pre-filled GitHub issue URLs.

Fixed

• Kept the Notices window above fullscreen gameplay and synchronized while dragging (Thanks to u/Fukksaks5th, #19).
• Prevented the first Notices click from briefly flashing the game during focus handoff (#26).
• Loaded cached artwork immediately, kept it visible while switching regions, and avoided transitions when the server artwork is unchanged.
• Reapplied normalized Wine scrolling on every launch to prevent excessive trackpad speed (Thanks to @darkwebdev, #28).
• Matched launcher and game icon Dock footprints to native macOS apps (#24).
• Corrected the launcher update status shown in Settings.
• Applied custom launcher icons consistently in the Dock, Finder, Spotlight, and macOS Now Playing surfaces.
• Prevented repair, relocation, cache maintenance, and uninstall operations from modifying game files while Arknights is active.
• Kept running games stoppable when a background refresh or unrelated Settings action reports an error.
• Made concurrent downloads, Wine helper cancellation, and music player replacement resilient to stale asynchronous work.
• Prevented a launch-time crash when macOS requests Now Playing artwork from its MediaPlayer queue.
• Left-aligned the expanded version text consistently with the music HUD.

Arknights Client v0.3.0

What’s new for players

• Multi-region support: You can now install, update, and switch between the Global, Japan, and Korea PC clients right from the main window.
• In-game payments & stable browser: Credit card and PayPal checkouts are now working, and the embedded browser no longer crashes in a loop after a few minutes.
• Natural Mac controls: Touchpad scrolling has been tuned to feel natural instead of overly sensitive, and standard Command-C / Command-V copy-paste shortcuts now work inside web views.
• Better Notices window: The in-game Notices companion window stays out of your Dock, remains interactive, and cleanly follows the game across Spaces and window moves.
• Redesigned Settings & instant reporting: A cleaner Liquid Glass settings menu with a one-click "Report a Problem" button that pre-fills bug reports with system diagnostics.

Multi-region support and reliable payment/login web views make this a major upgrade for players across all servers.

---

Added

• Support for the Japan and Korea Arknights PC clients alongside Global, each installed, updated, and launched independently. Switch regions from Settings → Installation, or from the region switcher in the main window once more than one region is installed.
• A "Report a Problem" button in Settings and on launch failures that opens a pre-filled GitHub bug report with your launcher version, macOS and chip details, and a recent log excerpt.
• New troubleshooting instructions for development to locate logs faster.
• Separate unity.log and chromium.log files for the game and its embedded browser, kept apart from wine.log and reachable from the same Logs button in Settings.

Changed

• Expanded launcher and Wine diagnostic logging with clearer detail for troubleshooting, including why a Wine prefix migration ran or was skipped.
• Redesigned Settings with clearer grouping, consistent glass and cyan-accented controls, and working hover feedback throughout.
• Restored PayPal browser-challenge compatibility by disabling WebGL, GPU rasterization, and accelerated 2D canvas in the embedded browser, while keeping GPU compositing enabled for rendering speed; credit card and PayPal payments have now both been observed to work (Thanks to @darkwebdev).
• Centralized scattered timeouts, buffer sizes, and retry counts into a single constants file.
• Consolidated the Vuplex and PlatformProcess compatibility shims onto one shared file-swap engine, without changing their install or restore behavior.

Fixed

• Slowed touchpad scrolling in-game to match Windows mouse-wheel speed (Thanks to u/herr-tibalt).
• Integrated the separate Notices helper with macOS windowing so it remains interactive, stays out of the Dock, and follows the game across window moves and Spaces (Thanks to u/No_Entrepreneur_6542).
• Mapped Command to Control in Wine so standard macOS copy and paste shortcuts work in the in-game browser, and fixed a separate copy-paste sync timeout under Wine.
• Fixed a Chromium sandbox crash in the embedded browser by stubbing the full set of Windows AppContainer APIs it requires, instead of only the one used for OAuth popups (Thanks to @darkwebdev).

Arknights Client v0.2.0

What’s new for players

• Sharper graphics: The game and login browser now render at high resolution on Retina and HiDPI displays.
• Faster launches: Repeated game starts perform less Wine setup work and reuse cached shaders.
• Better downloads: Paused and interrupted downloads resume correctly with accurate progress.
• Clearer updates: New launcher versions now include release notes directly inside the app.

The high-resolution rendering is the main reason to upgrade—it makes the game noticeably sharper on modern Mac displays.

---

Added

• Native release-note popups
• Repository hosted one-time announcements
• Isolated (development) UI-state simulator
• High-resolution rendering for sharper game and login-browser output on HiDPI displays.

Changed

• Replaced the mixed shell and Python build scripts with uv-managed Python tooling and clearer command output.
• Made Wine prefix updates and game compatibility components resumable, idempotent, and removable across launcher versions.
• Kept DXMT shader data in the isolated persistent cache and added detailed runtime-stage timings to diagnostics.
• Enabled Chromium GPU compositing while retaining Vuplex's stable CPU texture transfer.
• Filled draft GitHub Release notes from the matching changelog section.
• Required releases to be built from merged main with matching changelog and app-bundle versions.
• Replaced per-byte game downloads with buffered streaming and loaded independent launcher metadata in parallel.
• Restored paused downloads as a Resume state and counted existing partial files in progress.
• Used Arknights cyan consistently for active Settings switches and text links.

Removed

• Repeated Wine registry processes and no-op prefix writes from normal game launches.

Arknights Client v0.1.0

Arknights Client 0.1.0 is the first alpha release.

Included

• Native Apple Silicon launcher for the official Global PC client.
• Resumable installation, updates, repair, removal, and independent update checks.
• Bundled and verified Wine 11.15 and DXMT 0.80 runtime.
• Windowed, borderless, and fullscreen launch modes.
• Working in-game web login through the Vuplex compatibility layer.
• Isolated Wine data, native game controls, Command-Q support, and diagnostic logs.
• Native Liquid Glass interface with official launcher branding and notices.

Requirements

• Apple Silicon
• macOS 26 or newer
• Rosetta 2

The app is ad-hoc signed and not notarized. On first launch, open it through Finder using Open.