nexus-launcher README

项目的 README,来自 github.com/domsvoboda/nexus-launcher。合并为一个 markdown 文件:README.md。

Nexus Launcher

Nexus Launcher

Your Microsoft Store PC games, on Linux.

CI License: MIT

🌐 Help translate Nexus Launcher on Tolgee

[!CAUTION] Nexus Launcher is an independent, unofficial project built on Xodus. It is not an official project or release from the upstream Xodus developers.

Please report all issues encountered with Nexus Launcher only in the Nexus Launcher repository, not in the upstream Xodus issue tracker or support channels.

Nexus Launcher includes its own changes, so a problem in Nexus Launcher does not necessarily indicate a problem in upstream Xodus.

An Xbox-inspired launcher built on Xodus, using our patched Nexus backend and Nexus Runtime. Browse the Store, install games you own or can access through a subscription, and play with a managed runtime family. Xbox sign-in and cloud saves are available for supported games.

Nexus Launcher demo

Preview with sample account data.

Community translations

Help make Nexus Launcher available in your language. Open our public Tolgee project, sign in and suggest translations for the launcher interface. No coding or GitHub access is needed. Maintainers review suggestions before including them in a release. Missing a language? Request it in a GitHub issue.

Start translating → · Translation guide

Install

Download the latest Linux AppImage from Releases, make it executable and open it. Release assets are named Nexus-Launcher-<version>-<arch>.AppImage with a matching .sha512sum sidecar. Existing Xodus-Nexus-... release assets remain available for existing installations. Launcher versions before 0.5 only recognize the older asset names for in-app updates; use the installer or download the latest AppImage once, then later versions update in place. Stable releases currently ship for x86_64. Experimental ARM64 support requires matching native launcher, backend and runtime builds, compatible graphics drivers and FEX for x86 Windows games.

The current x86_64 runtime requires glibc 2.38 or newer (for example Ubuntu 24.04 or a current SteamOS, Fedora or Arch installation). Ubuntu 22.04 does not meet this requirement.

For an application-menu installation on supported distributions:

curl -fsSL https://raw.githubusercontent.com/domsvoboda/nexus-launcher/main/scripts/install.sh | bash

On first startup, the launcher installs and verifies the Nexus backend in the background so you can sign in during setup. Install the Nexus Runtime from Settings before launching games. A valid purchase or subscription is required.

If passkey sign-in gets stuck, choose Continue in browser in the sign-in window. This option requires Google Chrome, either a native installation or the Flatpak version available through Discover. Other browsers are not supported.

Setup guide and SteamOS requirements

Uninstall

Close Nexus Launcher and its games, then remove the application-menu installation without sudo:

curl -fsSL https://raw.githubusercontent.com/domsvoboda/nexus-launcher/main/scripts/uninstall.sh | bash

Games, saves, settings, downloaded runtimes, wallet credentials and system packages are kept. Installations made with older Xodus-Nexus-... asset names are removed by the same script. For a custom installation, use the same XODUS_NEXUS_PREFIX and XDG_DATA_HOME as during installation. To preview the files, download the script and run bash uninstall.sh --dry-run. If you only downloaded an AppImage manually, delete that AppImage instead.

Use

In-game overlay

Enable Settings → Nexus Overlay to open friends, chats and party controls while playing. Record a shortcut, choose the screen edge and save the settings. The overlay requires Python 3, PyGObject, GTK 3 and WebKitGTK 4.1. Your desktop may ask you to approve the shortcut on Wayland; fullscreen and monitor detection depend on the desktop. The overlay is optional and disabled by default.

Offline play

Use Settings → Offline permissions while online to designate this PC for offline play. Microsoft allows only one offline PC per account; changing it removes the designation from the previous device and is subject to the limit shown before confirmation. Launch each game online once afterwards. Supported games can then start without a connection while their Microsoft-issued lease remains valid. A compatible backend and runtime are required; online-only games still need their servers. See Xbox offline-play guidance.

Wallet setup and unlocking

Microsoft Store device limit

Microsoft Store supports up to 10 linked devices. If downloading or launching a game fails with Microsoft Store device limit reached (licensing code 501), open Microsoft Store device management and sign in with the same Microsoft account. Unlink only an old device you no longer use, then retry in Nexus Launcher. You do not need to sign out or reset the wallet. Other license errors can have different causes.

Documentation · Report an issue

How it works

Component Role
Nexus Launcher The desktop interface for the Store, library, downloads, settings and launching games.
Nexus backend Our patched build of Xodus, handling Microsoft account sign-in, genuine license checks, package downloads and launch preparation.
Nexus Runtime Our fork of Valve's Proton Experimental, assembling Wine, XGameRuntime, graphics translation and supporting libraries into one complete runtime.
Nexus Wine The matching Wine fork, providing Windows API compatibility and Nexus game fixes.
Nexus XGameRuntime Our fork of the upstream C++ XGameRuntime, providing game-facing account, cloud-save, package and Store/DLC interfaces. API coverage varies by game.

The launcher asks the backend to prepare a licensed game, then starts it with the selected Nexus Runtime family. Wine provides Windows compatibility; XGameRuntime connects supported Xbox and Microsoft Store game APIs to the Nexus backend. DXVK and VKD3D-Proton translate supported Direct3D graphics to Vulkan.

Install and update the Standard and optional CachyOS runtime families independently in Settings. Each family bundles Wine and XGameRuntime at matching revisions, so there is no need to install the individual forks separately. Games choose an installed family in their own settings; an unconfigured game uses Standard. Installed families follow their latest verified build and reuse the existing prefix and saves. Compatibility and online services still depend on the game.

Compatible games

These results come from manual testing and user reports. Other games may work, but have not been verified and may encounter compatibility issues.

Game Playable Status
Persona 3 Reload Yes Gameplay, network features and cloud saves work; expansion pass not recognized. (user report)
Forza Motorsport Partial Unreleased runtime: intro completed. Online play unverified.
Age of Empires II: Definitive Edition Yes Unreleased runtime: single-player works; CachyOS startup verified. Dynasties of India: Bengalis selectable. Online play unverified.
Age of Empires III: Definitive Edition Yes Unreleased runtime: works. Online play unverified.
Age of Empires: Definitive Edition Partial Unreleased runtime: menu and sign-in work; Multiplayer and LAN menus enabled. Gameplay unverified.
Age of Empires IV Startup verified Unreleased runtime: starts successfully; online play unverified.
Batman: Arkham Knight Yes Works with Standard and CachyOS runtimes.
Gears of War: E-Day Yes Playable online; Xbox playing status works.
Deep Rock Galactic Yes Playable online.
Minecraft Dungeons Yes Playable online with launcher 0.3.5; ownership failures also reported on other setups.
Minecraft Dungeons II Yes Playable online.
Minecraft for Windows Yes Playable online. For licensing code 501, check the Store device limit.
Minecraft Launcher Yes Sign-in and Java download/startup work with launcher 0.3.5; Java online unverified. Login failure also reported on another setup.
No Man's Sky Yes Playable online.
Valor Mortis Yes Fully playable.
Forza Horizon 6 Yes Playable online; some setups need VC++ prerequisites. Loading failures also reported.
Palworld Yes Playable online.
DOOM Eternal Yes Playable.
Microsoft Flight Simulator 2024 Partial Unreleased runtime: sign-in and main menu verified. Multiplayer unverified.
Microsoft Flight Simulator (2020) Startup verified Unreleased runtime: reaches Installation Manager. Content download and flights unverified.
SnowRunner Yes Unreleased runtime: works. Multiplayer and DLC unverified.
Ori and the Will of the Wisps Partial Unreleased Experimental runtime: sign-in and main menu work; gameplay unverified.
Like a Dragon: Infinite Wealth Partial Unreleased Experimental runtime: main menu works; gameplay unverified.
DOOM: The Dark Ages Yes Playable (user report).
Fallout 76 Yes Playable online; one reported setup requires gamescope to display correctly.
The Outer Worlds 2 Yes Playable.
Wolfenstein: The Old Blood Yes Playable.
Wasteland Remastered Yes Playable.
Danganronpa 2 Yes Playable.
Neon Abyss 2 Yes Playable.
Hollow Knight: Voidheart Edition Yes Playable.
Avowed Yes Playable.
Mortal Shell: Enhanced Edition Yes Playable (user report).
Sea of Thieves Yes Playable online.
Tony Hawk's Pro Skater 3 + 4 Partial Solo playable; Private Match loads a map. Joining other players and public matchmaking remain unconfirmed. (#88)
ARC Raiders No Launches but cannot connect to online services. (user report)
Hogwarts Legacy Yes Playable. (user report)
Halo Infinite Partial Unreleased Experimental runtime: main menu and campaign start; multiplayer unavailable (offline).
Halo: Campaign Evolved Yes Playable; may remain running after quitting. (user report)
Resonance: A Plague Tale Legacy Yes Desktop gameplay and Xbox cloud saves work. Steam Deck exit black screen also reported. (desktop report, Steam Deck report)
Resident Evil 2 Yes Playable; may remain running after quitting. (user report)
Wreckfest Yes Playable. (user report)
TUNIC Yes Playable. (user report)
Hades Yes Playable. (user report)
Hell Let Loose: Vietnam No Crashes after Easy Anti-Cheat initialization on Arch Linux with an Arc A770. (user report)
Human: Fall Flat Partial Public online game search fails. (user report)
Wolfenstein II: The New Colossus Yes Playable. (user report)
The Dungeon of Naheulbeuk: The Amulet of Chaos Yes Playable. (user report)
Soul Hackers 2 Yes Playable with launcher 0.3.8 (user report, #166).
Monster Boy and the Cursed Kingdom Yes Playable. (user report)
Hollow Knight: Silksong Yes Playable. (user report)
Teenage Mutant Ninja Turtles: Shredder's Revenge Yes Playable. (user report)
DRAGON QUEST XI S: Echoes of an Elusive Age - Definitive Edition No Crashes after the first loading screen. (user report)
ACA NEOGEO METAL SLUG No Crashes at launch. (user report)
SIGNALIS Yes Playable. (user report)
DREDGE Yes Playable. (user report)
Warhammer 40,000: Space Marine 2 Yes Playable; online unverified. (user report)
Indiana Jones and the Great Circle Yes First mission playable. (#78)
Microsoft Jewel No Crashes at launch. (user report)
Microsoft Bubble No Crashes at launch. (user report)
AI: THE SOMNIUM FILES - nirvanA Initiative Yes Playable; Store ID detection issue reported. (user report)
Minecraft Legends Yes Playable; an online session starts, but play with friends is unverified. (user report)
The Elder Scrolls: Arena No Crashes at launch. (user report)
The Elder Scrolls II: Daggerfall No Crashes at launch. (user report)
Wolfenstein: Enemy Territory Partial Playable, but cannot join PunkBuster-enabled servers. (user report)
Hell Let Loose No Crashes at startup. (user report)
Kingdom Come: Deliverance II Yes Playable. (#112)
PAC-MAN MUSEUM+ No Stops after the opening logos. (user report)
Farming Simulator 25 No Startup failure reported; updated runtime retest pending. (user report)
PowerWash Simulator 2 Yes Playable. (#69)
Young Souls Unverified Launches in Steam Deck Desktop Mode; gameplay unverified. (user report)
Remnant II Unverified Starts and exits cleanly; gameplay and online were not detailed. (user report)
The Witcher 3 No Currently crashes on launch.
LIMBO Yes Playable.
World War Z Partial Connects to online services and starts Quick Match search; joining a match is unverified.
Balatro Yes Playable.

Full compatibility list

User reports describe individual setups, not universal compatibility. The wiki links to report sources and the community spreadsheet. Launch-only reports do not confirm gameplay or online support.

Screenshots

Library · Store · Social · Chat · Install queue · Settings

Independent project, not affiliated with Microsoft or Xbox. A valid game license is required. Launcher: MIT license. The separate Nexus backend retains its upstream GPLv3 license and ships with corresponding source. The Nexus Runtime includes FFmpeg shared libraries under LGPL 2.1 or later; its corresponding pinned source and build recipe accompany each runtime release. Contributing

nexus-launcher (domsvoboda/nexus-launcher)

正在搜索数据库…

这是什么?Xodus Nexus 是一款非官方的、受 Xbox 启发的 Linux 桌面启动器,可让你浏览 Microsoft Store,安装你拥有或可通过订阅访问的 Xbox PC 游戏,并通过共享的、已打补丁的运行时来游玩。
这是官方的 Xbox 应用,还是社区项目?这是一个独立的非官方项目,基于 Xodus 构建;它不由上游 Xodus 开发者、Microsoft 或 Xbox 发布或提供支持。
我该如何安装和设置?从 Releases 页面下载最新的 x86_64 Linux AppImage,赋予其可执行权限并运行,然后在设置中安装 Nexus 后端和运行时,并使用你的 Microsoft 账号登录。
要真正玩游戏,我还需要什么?需要一个 Microsoft 账号,并且拥有有效的游戏购买记录或处于有效的订阅状态;如果通行密钥登录卡住,则需要安装原生版或 Flatpak 版的 Google Chrome 以进行浏览器登录。
Microsoft Store 里的每款游戏都能正常运行吗?不能,兼容性因游戏而异:有些游戏可以完整地在线游玩,有些只能部分运行(缺少匹配或在线搜索功能),还有些在启动时就会崩溃;这些结果来自手动测试和用户反馈,并不作保证。
它能在所有 Linux 发行版上运行吗,包括 Steam Deck?它以 Linux AppImage 形式发布,并可在受支持的发行版上可选择安装到应用菜单中;多份兼容性报告明确提到了 Steam Deck。
诊断日志会泄露我的账号凭据吗?不会,本地后端诊断日志只包含安全的错误代码和操作结果,不包含凭据,不过仍建议你在分享前先检查一遍。
我能把 Xodus Nexus 游戏添加到 Steam 吗?可以,使用游戏菜单中的“添加到 Steam”或设置中的“将 Nexus 添加到 Steam”,即可创建一个带封面图的非 Steam 快捷方式;这需要安装原生 Linux 版 Steam,因为暂不支持 Flatpak 版 Steam。
支持手柄操作吗?支持,目前有实验性的手柄导航功能,适用于标准映射的手柄(方向键或摇杆移动,A 键确认,B 键返回等),同时也保留了正常的鼠标、触屏和键盘操作。
卸载游戏时,存档数据会怎样?你可以选择保留或永久删除安装文件夹(不经过回收站);删除该文件夹也会一并删除存放在其中的存档,而存放在其他位置的存档不会受影响。
Xbox 成就和云存档可以使用吗?对于受支持的游戏,可以使用 Xbox 登录和云存档;每个游戏页面都会显示其简介、分类、截图、成就和游戏时长,具体取决于账号和游戏的支持情况。
大小
53.2 MB
星标
1.3K
时长
1个月
提交 · 90 天