Matoking / protontricks

A wrapper that does winetricks things for Proton enabled games, requires Winetricks.
GNU General Public License v3.0
1.56k stars 35 forks source link

Better docs please / FUBARed Arkham Asylum #263

Open appsforartists opened 7 months ago

appsforartists commented 7 months ago

I tried installing https://github.com/neatodev/BmLauncherAsylumNET6, which also required that I use protontricks. I couldn't figure out how to list the possible commands in the command line, so copy/pasting from their README felt like poking in the dark. Furthermore, I couldn't figure out how to undo what protontricks did. I had to clobber my whole game and reinstall everything to make it playable.

Thanks for making such a popular community contribution! It would be great if it was easier to see what commands are available, and more importantly, possible to undo a failed trick.


To Reproduce Steps to reproduce the behavior:

  1. Install Batman: Arkham Asylum through Steam
  2. Install ProtonGE
  3. Play game
  4. Download the community launcher. (I tried both the 160MB one and the 5MB one.)
    • Backup the original and move the replacement in its place
    • Doesn't run
  5. protontricks 35140 -q calibri
  6. protontricks 35140 -q d3dx9 d3dcompiler_43
  7. Try running community launcher
    • still doesn't run
  8. Replace original BmLauncher
    • Now that won't run either

System:

Additional context

If the error happens when trying to run a Protontricks command, run the command again using the -v flag and copy the output!

I'm afraid to try that. I just spent an hour deleting and reinstalling the game. I don't want to break it again

Matoking commented 7 months ago

Protontricks is simply a wrapper for Winetricks. Winetricks does most of the heavy lifting here if you're just running Winetricks verbs. calibri, d3dx9 and d3dcompiler_43 in your reply are Winetricks verbs.

Winetricks does not generally allow you to uninstall anything; the recommended method is to delete the prefix entirely.

If you're using an installation method other than the Flatpak one (where running commands other than protontricks is a bit more involved), you can use winetricks --help to see what Winetricks commands are available. For any Winetricks command, instead of running winetricks FOO BAR, you run protontricks <APPID> FOO BAR.

Aside from that, the GitHub project page doesn't link directly to other documentation but there's the GitHub wiki and the article on WineHQ wiki.

Making the Winetricks commands discoverable outside the GUI could be improved, though I'm not sure what would be the best way to achieve this.