Add Library View to the launcher by NinjaPedroX · Pull Request #2710 · SubnauticaNitrox/Nitrox

NinjaPedroX · 2026-04-15T04:00:54Z

This PR adds a new tab to the launcher, named: Library

In this tab, you can:

View all instances of the game installed on your computer, all of which are saved into the Nitrox long-term cache.
Manually add/remove game installations to/from the launcher.
Easily manage which instance of Subnautica you would like to use Nitrox with.
View the status of any server you joined/added in the main menu (data such as online status and player counts/names).

Also, Options view was changed to support multiple game installations instead of only one, featuring the same game installation management features as Library View.

TODO:

Add communication between the launcher and remote servers to allow for the retrieval of its online status, host server name, online player count, max player count, online player names, and server image (not anymore).

Images:

(no installations)

Will be working on the design next

Laid some of the groundwork for LibraryView and completed most of its design. Also added the BZ game card in case its use is required in the future 👀

Game installations, after being automatically detected, will be saved into the Nitrox long-term cache, along with any manually added game installations not detected by the automatic game detection code. Any game installations that the user wants removed will not show up in the launcher any more unless the user manually adds that installation again.

This make it more clear that the Nitrox launcher isn't deleting the game itself from the computer :)

This makes it easier for users to see each server's IP and Port

Also added backup card/text for when no installations are being shown and transferred some path icons into Svgs.

Now, any game installation that does not exist on the PC anymore will be removed automatically. Also fixed another small issue.

Now, the game installation lists will keep the same order even after selecting a different installation in LibraryView and OptionsView

github-actions · 2026-04-15T04:02:42Z

Test Results

255 tests ±0 252 ✅ ±0 9s ⏱️ ±0s
1 suites ±0 3 💤 ±0
1 files ±0 0 ❌ ±0

Results for commit 12f2d61. ± Comparison against base commit 22cf75e.

♻️ This comment has been updated with latest results.

Measurity · 2026-04-16T14:01:43Z

+
+    public string ServerName { get; set; } = string.Empty;
+    public string ServerIP { get; set; } = string.Empty;
+    public int ServerPort { get; set; } = 11000;


Use constant value from SubnauticaServerConstants in Nitrox.Model

Measurity · 2026-04-16T14:03:54Z

+    public partial int PlayerCount { get; set; } = 0;
+
+    [ObservableProperty]
+    public partial int MaxPlayers { get; set; } = 100;


Time to add this as a constant to SubnauticaServerConstants. And then use this constant in SubnauticaServerOptions too.

Measurity · 2026-04-16T14:07:11Z

+
+    public AvaloniaList<KnownGame> InstalledGames { get; } = [];
+
+    public List<KnownGame> RefreshInstalledGames(GameInfo gameInfo)


All code that's accessing files should be async so that they don't cause UI hangs / stutter.

Measurity · 2026-04-16T14:20:24Z

+
+    public AvaloniaList<KnownGame> InstalledGames { get; } = [];
+
+    public List<KnownGame> RefreshInstalledGames(GameInfo gameInfo)


This method is getting chunky. Move logic into private methods that do one "thing". For example, logging should be moved into a method call. And savedGames code can be a separate method as well which also allowed use of IEnumerable and yield return to simplify processing.

- Moved MaxPlayers default value into SubnauticaServerConstants - Used those constants as required - Refactored any code that accessed files to be async - Refactored GameInstallationService

LibraryView will now display the host server name, online player count, online player names, max player count, and online status count of the remote servers listed in that view. Then, it'll refresh them periodically following this logic: 1. When first loading the view, it'll refresh all RecentServerEntries 2. After that, it'll start a 15 second refresh loop where it only refreshes online servers 3. Every 4th refresh, it'll refresh all listings 4. When navigating away from the view and back, it'll only refresh the online servers and then continue the refresh cycle I was not able to figure out how to transfer server image data without the icon looking very low quality (or failing to send), so I left it as a TODO for the future.

Seems a bit of a hacky way to do this, but I can't figure out a better way to make the RadioButton icon be equally spaced on both sides (or have a controllable width between the icon and the button content)

Found out a better way to do it :)

From SubnauticaNitrox#2721 Co-Authored-By: Meas <1107063+Measurity@users.noreply.github.com> Co-Authored-By: Jannify <23176718+Jannify@users.noreply.github.com>

NinjaPedroX · 2026-05-08T02:43:00Z

This PR is now ready for testing/reviews.

dartasen · 2026-05-09T18:42:43Z

Yay 🎶

When I saw the library design on Figma, I was thinking of doing a curse forge like experience. Where you can start the game with your profile (which would be game installation for our need)
i.e:

And I feel like it's missing UX from this feature. Currently the feature is +- the same as option page. I think we should be able to start the game from this view, but also be able to switch profile from the LaunchGame view as well, maybe something like that :

The question that remains for me is why we would keep the UI of the options page if the new “Library” section handles that aspect.
Maybe we should ask the team to test the feature and give some feedback, and that would be cool to double check with Rux as well

NinjaPedroX · 2026-05-09T19:23:16Z

Yay 🎶

When I saw the library design on Figma, I was thinking of doing a curse forge like experience. Where you can start the game with your profile (which would be game installation for our need)
i.e:

And I feel like it's missing UX from this feature. Currently the feature is +- the same as option page. I think we should be able to start the game from this view, but also be able to switch profile from the LaunchGame view as well, maybe something like that :

The question that remains for me is why we would keep the UI of the options page if the new “Library” section handles that aspect.
Maybe we should ask the team to test the feature and give some feedback, and that would be cool to double check with Rux as well

Sounds good, I'm down to implement whatever the team/Rux recommends. I agree that having the game selection feature in two different views is a bit redundant.

If we decide to do it where we can start the game in Library View, would we need the start game buttons in Launch Game View anymore? I'm not sure how that would work.

Thanks to mrbub for finding the bug.

Measurity · 2026-05-21T17:05:09Z

This PR and master should be connection tested as we had trouble connecting over WAN.

As for the design, game installations are now configurable in both "Library View" and "Options View". I think it would be best to merge these two into the "Play game" view as a combobox instead of the simple "Play Multiplayer" button there's now.

As for "recent servers", I think we should add this to "Servers" view with a new tab "Recently Visited" and a "Self host" tab. Then we can remove the "Library" view and simplify launcher navigation in my opinion.

Thoughts?

NinjaPedroX and others added 10 commits April 6, 2026 21:24

Added LibraryView base

1a6129b

Will be working on the design next

Started work on LibraryView design

db833f7

Laid some of the groundwork for LibraryView and completed most of its design. Also added the BZ game card in case its use is required in the future 👀

More work on LibraryView and OptionsView

d2f3ee3

Changed installation removal message wording

0dc7076

This make it more clear that the Nitrox launcher isn't deleting the game itself from the computer :)

Added tooltip icon to "Recent Servers" cards

58b6c42

This makes it easier for users to see each server's IP and Port

Added installation refresh button and finished libraryView

4c85f00

Also added backup card/text for when no installations are being shown and transferred some path icons into Svgs.

Added check for known game installations

1153726

Now, any game installation that does not exist on the PC anymore will be removed automatically. Also fixed another small issue.

Fixed game installation list reordering itself

01bc461

Now, the game installation lists will keep the same order even after selecting a different installation in LibraryView and OptionsView

Merge branch 'SubnauticaNitrox:master' into library-view

403a382

Measurity reviewed Apr 16, 2026

View reviewed changes

This comment was marked as spam.

Sign in to view

Handled review comments

42d6ccb

- Moved MaxPlayers default value into SubnauticaServerConstants - Used those constants as required - Refactored any code that accessed files to be async - Refactored GameInstallationService

NinjaPedroX requested a review from Measurity May 7, 2026 14:18

NinjaPedroX and others added 6 commits May 7, 2026 17:07

Fixed LaunchGameView not showing GamePlatform at startup

ac49ed7

Fixed broken RadioButton spacing for default style

5bcd487

Seems a bit of a hacky way to do this, but I can't figure out a better way to make the RadioButton icon be equally spaced on both sides (or have a controllable width between the icon and the button content)

Merge remote-tracking branch 'upstream/master' into library-view

dd25922

Better fix for RadioButton spacing

dab99f4

Found out a better way to do it :)

Implemented change suggested by Jannify

d89af66

From SubnauticaNitrox#2721 Co-Authored-By: Meas <1107063+Measurity@users.noreply.github.com> Co-Authored-By: Jannify <23176718+Jannify@users.noreply.github.com>

NinjaPedroX marked this pull request as ready for review May 8, 2026 02:42

misterbubb added the Area: user interface (launcher) Related to UI/UX in the launcher label May 8, 2026

NinjaPedroX and others added 3 commits May 10, 2026 21:05

Merge remote-tracking branch 'upstream/master' into library-view

86d149e

Merge remote-tracking branch 'upstream/master' into library-view

e5e510d

Fixed duplicated "Player" permission option in manage server view

12f2d61

Thanks to mrbub for finding the bug.

Measurity added the Status: Needs testing Pull Request is waiting for testing label May 19, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add Library View to the launcher#2710

Add Library View to the launcher#2710
NinjaPedroX wants to merge 20 commits into
SubnauticaNitrox:masterfrom
NinjaPedroX:library-view

NinjaPedroX commented Apr 15, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Apr 15, 2026 •

edited

Loading

Uh oh!

Measurity Apr 16, 2026

Uh oh!

Measurity Apr 16, 2026

Uh oh!

Measurity Apr 16, 2026

Uh oh!

Measurity Apr 16, 2026

Uh oh!

This comment was marked as spam.

NinjaPedroX commented May 8, 2026

Uh oh!

dartasen commented May 9, 2026

Uh oh!

NinjaPedroX commented May 9, 2026 •

edited

Loading

Uh oh!

Measurity commented May 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants


		public AvaloniaList<KnownGame> InstalledGames { get; } = [];

		public List<KnownGame> RefreshInstalledGames(GameInfo gameInfo)

Conversation

NinjaPedroX commented Apr 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Apr 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Test Results

Uh oh!

Measurity Apr 16, 2026

Choose a reason for hiding this comment

Uh oh!

Measurity Apr 16, 2026

Choose a reason for hiding this comment

Uh oh!

Measurity Apr 16, 2026

Choose a reason for hiding this comment

Uh oh!

Measurity Apr 16, 2026

Choose a reason for hiding this comment

Uh oh!

This comment was marked as spam.

NinjaPedroX commented May 8, 2026

Uh oh!

dartasen commented May 9, 2026

Uh oh!

NinjaPedroX commented May 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Measurity commented May 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

NinjaPedroX commented Apr 15, 2026 •

edited

Loading

github-actions Bot commented Apr 15, 2026 •

edited

Loading

NinjaPedroX commented May 9, 2026 •

edited

Loading