Difference between revisions of "Proton"

From FEX-Emu Wiki
Jump to navigation Jump to search
 
(6 intermediate revisions by the same user not shown)
Line 3: Line 3:
  
 
== Prerequisites ==
 
== Prerequisites ==
=== Updating pressure-vessel ===
 
Pressure-vessel is the container software that Proton uses to containerize itself. Steam doesn't ship a version of pressure-vessel that supports FEX-Emu, so this needs to be built and overwrite the version that Steam ships.
 
* On an x86-64 device
 
* Clone this git repo https://gitlab.steamos.cloud/steamrt/steam-runtime-tools
 
* Follow build instructions here: https://gitlab.steamos.cloud/steamrt/steam-runtime-tools/-/blob/master/build-aux/many-builds.md
 
* If all dependencies are already installed then this can be as simple as following
 
** ./build-aux/many-builds.py setup
 
** ./build-aux/many-builds.py build
 
** ./build-aux/many-builds.py install
 
* After which it gives you an rsync command to follow to get the build in to the correct folder on an AArch64 device.
 
 
 
=== Gotchas ===
 
=== Gotchas ===
* When Steam updates its runtimes, it may overwrite the one you've installed. rsync again to overwrite again
 
 
* If pressure-vessel complains about missing lib64 files or unable to execute some adverb then two things could have happened
 
* If pressure-vessel complains about missing lib64 files or unable to execute some adverb then two things could have happened
** Your pressure-vessel changes got overwritten, rsync again
 
 
** Your version of FEX is too old, needs at least FEX-2207
 
** Your version of FEX is too old, needs at least FEX-2207
  
Line 27: Line 14:
  
 
== Running outside of pressure-vessel ==
 
== Running outside of pressure-vessel ==
 +
'''WIP'''
 
=== Environment variables ===
 
=== Environment variables ===
 
* STEAM_COMPAT_DATA_PATH
 
* STEAM_COMPAT_DATA_PATH
Line 34: Line 22:
 
* STEAM_COMPAT_INSTALL_PATH
 
* STEAM_COMPAT_INSTALL_PATH
 
** Needs to point to the game install path
 
** Needs to point to the game install path
** export STEAM_COMPAT_INSTALL_PATH=<STEAM_LIBRARY>/steamapps/common/Spelunky/
+
** export STEAM_COMPAT_INSTALL_PATH=$STEAM_LIBRARY/steamapps/common/Sonic\ Mania/
 
* STEAM_COMPAT_CLIENT_INSTALL_PATH
 
* STEAM_COMPAT_CLIENT_INSTALL_PATH
 
** Needs to point to steam
 
** Needs to point to steam
Line 40: Line 28:
  
 
=== Running ===
 
=== Running ===
* ./proton waitforexitandrun <STEAM_LIBRARY>/steamapps/common/Spelunky/Spelunky.exe
+
* ./proton waitforexitandrun $STEAM_LIBRARY/steamapps/common/Sonic\ Mania/SonicMania.exe
 +
 
 +
 
 +
=== Pressure-vessel errors ===
 +
  bwrap: Can't get type of source /usr/lib64: No such file or directory
 +
* Might need /usr/lib64 in your AArch64 root?
 +
* Might be because your rootfs is currently "unbroken", thus having a `/tmp` folder inside of it. execute `break_chroot.sh` and ensure `/tmp` is not in the rootfs.
 +
* Not 100% triaged.
 +
 
 +
== Development ==
 +
=== Updating pressure-vessel ===
 +
* On an x86-64 device
 +
* Clone this git repo https://gitlab.steamos.cloud/steamrt/steam-runtime-tools
 +
* Follow build instructions here: https://gitlab.steamos.cloud/steamrt/steam-runtime-tools/-/blob/master/build-aux/many-builds.md
 +
* If all dependencies are already installed then this can be as simple as following
 +
** ./build-aux/many-builds.py setup
 +
** ./build-aux/many-builds.py build
 +
** ./build-aux/many-builds.py install
 +
* After which it gives you an rsync command to follow to get the build in to the correct folder on an AArch64 device.
 +
 
 +
=== Shell for debugging ===
 +
Set environment variable:
 +
  PRESSURE_VESSEL_SHELL=instead
 +
 
 +
eg: Launching a proton game from Steam
 +
  PRESSURE_VESSEL_SHELL=instead %command%
 +
 
 +
This will open an xterm window that some work can be done before running the application.
 +
 
 +
To run the command from the xterm instance again
 +
  "$@"
 +
The quotes are important

Latest revision as of 17:47, 29 February 2024

Proton is the Windows on Linux compatibility layer that Steam uses to run Windows titles. Read more about it here


Prerequisites

Gotchas

  • If pressure-vessel complains about missing lib64 files or unable to execute some adverb then two things could have happened
    • Your version of FEX is too old, needs at least FEX-2207

Running

Selecting a Proton game inside of the Steam install and running it should be all that is necessary. Be patient as due to how pressure-vessel and FEX interacts with each other, building the chroot environment can take a few minutes. Watch the processes in htop if you want to make sure.

DXVK

Lots of games require Vulkan in order to run since they will be executed using DXVK. Make sure your AArch64 device has a new enough Vulkan driver to handle DXVK.

Running outside of pressure-vessel

WIP

Environment variables

  • STEAM_COMPAT_DATA_PATH
    • This needs to point to a path where proton will set up a wine prefix
    • export STEAM_COMPAT_DATA_PATH=$HOME/test_proton
    • mkdir $STEAM_COMPAT_DATA_PATH
  • STEAM_COMPAT_INSTALL_PATH
    • Needs to point to the game install path
    • export STEAM_COMPAT_INSTALL_PATH=$STEAM_LIBRARY/steamapps/common/Sonic\ Mania/
  • STEAM_COMPAT_CLIENT_INSTALL_PATH
    • Needs to point to steam
    • export STEAM_COMPAT_CLIENT_INSTALL_PATH=$HOME/.steam

Running

  • ./proton waitforexitandrun $STEAM_LIBRARY/steamapps/common/Sonic\ Mania/SonicMania.exe


Pressure-vessel errors

 bwrap: Can't get type of source /usr/lib64: No such file or directory
  • Might need /usr/lib64 in your AArch64 root?
  • Might be because your rootfs is currently "unbroken", thus having a `/tmp` folder inside of it. execute `break_chroot.sh` and ensure `/tmp` is not in the rootfs.
  • Not 100% triaged.

Development

Updating pressure-vessel

Shell for debugging

Set environment variable:

 PRESSURE_VESSEL_SHELL=instead

eg: Launching a proton game from Steam

 PRESSURE_VESSEL_SHELL=instead %command%

This will open an xterm window that some work can be done before running the application.

To run the command from the xterm instance again

 "$@"

The quotes are important