~_dev_fra/hwrc-proton-launcher

A launcher for Homeworld Remastered Collection with Proton
Update script and documentation for Proton 6.3, add deprecation note.
Update script and documentation for Proton 5.0, add license file.
Update the script for Proton 4.11 and add option for loading mods.

refs

master
browse  log 

clone

read-only
https://git.sr.ht/~_dev_fra/hwrc-proton-launcher
read/write
git@git.sr.ht:~_dev_fra/hwrc-proton-launcher

You can also use your local clone with git send-email.

#DEPRECATION NOTE

Starting with Proton 6.3, from Steam Play, there should be no need to use this script anymore. No additional updates are foreseen for this project.

#HWRC Proton Launcher

An alternative launcher script for the Steam version of Homeworld Remastered Collection (HWRC) to be played on GNU/Linux systems with Proton from Steam Play.

Reference links:

Feedback and contributions:

#Why this script

HWRC can be played on GNU/Linux systems by using Proton (Steam Play) from Steam. HWRC implements a launcher, to select the games from, that requires the installation of the .Net Framework 4 in the HWRC Proton prefix (more info at HWRC on WineHQ). To do so, protontricks can be used but as of Proton 6.3 there should be no need for it anymore.

However the launcher can be bypassed, so to avoid the need for the .Net Framework 4, and the games can be ran directly. This is the reason behind this script that can be used as an alternative launcher.

#How does it work

This script makes use of the instructions to run the games, as provided on the HWRC WineHQ page, integrated with those ones required to use Steam Play (Steam environment variables and Proton commands). The latter were retrieved by inspecting the run script that can be dumped from Steam, as discussed here, a process that basically requires to:

  1. Set the game launch options in the Steam client to PROTON_DUMP_DEBUG_COMMANDS=1 %command%;
  2. Launch the game (even if it may fail);
  3. Check the script /tmp/proton_<username>/run.

#How to use it

The first section of the script contains user defined variables that have to be set so to reflect the setup of the user (detailed information are provided already in the comments in the script). Then the script can be launched as usual, check the help with:

./hwrc-proton-launcher --help

Please note that the script checks if Steam is running, so make sure to launch Steam before this script.

#Known issues

  • The mod loading option has not been tested extensively; loading more than one mod at a time may not work.

#License

Copyright 2021 /dev/fra

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.