Skip to content

feat: Write tutorial how to install GameStudio on Linux (wine) - #555

Open
Jklawreszuk wants to merge 2 commits into
stride3d:masterfrom
Jklawreszuk:wine-gamestudio
Open

feat: Write tutorial how to install GameStudio on Linux (wine)#555
Jklawreszuk wants to merge 2 commits into
stride3d:masterfrom
Jklawreszuk:wine-gamestudio

Conversation

@Jklawreszuk

Copy link
Copy Markdown
Contributor

I wrote a short article based on trial and error about how to set up your Linux machine to run the Stride GameStudio editor.
This tutorial includes a workaround that may be resolved in the future. Please let me know if anything is missing that prevents you from following the steps, or if you’d simply write it differently.

@ferafiks

Copy link
Copy Markdown
Contributor

I've tried running your guide, but I ran into multiple hurdles along the way. The installer would immediately crash unless I enabled virtual desktop in winecfg, then it would partially install the launcher and crash. Later launches would show the options to modify, fix or remove the installation, but running any of them would freeze the progress bar. Opening the partially broken launcher also didn't work. Trying to open Game Studio in this state resulted in an error message saying that I need to install the runtime (which I already installed). I'll probably figure this out eventually, but so far, it seems like we're missing some steps.

Also, copying your entire .nuget cache is probably not ideal, since it could weight a lot depending on how much you develop with .net (for me it's 18gb). Maybe we could use a nuget config file to make the build download the required packages into a different cache?

This guide will be something that will have to be rechecked and updated with every release of the engine. I can already guess that the new launcher is going to break some things here. Still, I think this is a very useful resources that deserves a spot in the docs, so maybe a compromise would be to add warnings that this is a hack and mention the exact version with which this guide was tested.

@ferafiks ferafiks left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I left a few review comments. I'll probably go over your guide after it's merged anyway to adjust formatting and make it more beginner friendly for less savvy users.

Comment thread en/manual/install-and-update/install-stride-wine.md Outdated
Comment thread en/manual/install-and-update/install-stride-wine.md Outdated
Comment thread en/manual/install-and-update/install-stride-wine.md Outdated
Comment thread en/manual/platforms/linux/install-stride-wine.md
2. Paste this folder into the corresponding .nuget location within your Wine prefix (`~/.wine/drive_c/users/<your_user>/.nuget/packages`)


After the manual injection is complete, attempt to open the Stride.Launcher.exe via Wine. The launcher should now be able to resolve dependencies locally within the prefix and the Stride components should appear and be runnable.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

From what it seems, is sounds like you are copying all stride packages into the wine nuget folder, so that future engine updates won't actually show up. This is probably okay - you can use older versions of Game Studio with newer projects and as long as there weren't any major changes to how it handles project files or any new features, it should work just fine. However, it would be a good idea to mention that fact somewhere and add a section related to updating Stride (which as far as I can tell would just involve copying the nuget cache again).

Comment thread en/manual/install-and-update/install-stride-wine.md Outdated
Comment thread en/manual/toc.yml Outdated
Comment on lines +17 to +18
- name: Install Stride (wine)
href: install-and-update/install-stride-wine.md

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As much as I hate separating Linux from typical Windows documentation, I think it would be better to have this in Platforms/Linux next to Setup and requirements. To make it easier to find, we could add a mention at the top of install-stride redirecting Linux users to that page.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants