Revision Difference
proton#563591
<cat>Play.Intro</cat>
<title>Proton</title>
# Proton
All information regarding running and developing s&box on Linux will described here.
# Running
S&box needs some tinkering to work on Linux:
S&box might need some tinkering to work on Linux:
⤶
<note>It seems like this isn't required anymore, but i'll leave it here if it still happens.</note>⤶
1. Change your Proton Version to "Proton Experimental"
2. In the terminal type:
```
sudo sysctl -w vm.max_map_count=16777216
```
This should be enough to get s&box to run for most people.
⤶
<note>The main menu can be unstable and may crash if open too long, but games should be stable.</note>⤶
# Developing
At the time of writing *(November 2024)* you can launch s&box development tools via the steam launch options and everything works aside from the game window. If using x11, you can download a library from the library manager to fix this, but there's currently nothing you can do on Wayland.
At the time of writing *(February 2025)* you can launch s&box development tools fine, but it is quite unstable and prone to crashing and screen flickering.
# Troubleshooting
## How to use the proton logs
Proton logs sometimes could help solve issues with games not launching or working properly under proton. Proton logging can be enabled inside the launch options of s&box:
```
PROTON_LOG=1 %command%
```
If you want smaller log files but still keep useful information use this launch option:
```
WINEDEBUG=+error+threadname+debugstr+loaddll+mscoree PROTON_LOG=1 %command%
```
By default it should generate a file inside your home directory `$HOME/steam-590830.log` but it can be modified as well:
```
PROTON_LOG=1 PROTON_LOG_DIR='/path/to/log' %command%
```
## Input (e.g. movement) does not work
This is probably caused by having multiple keyboard layouts, adding `-input_button_code_is_scan_code` to your launch options fixes the problem
# Useful Resources:
1. [S&box proton github issues](https://github.com/ValveSoftware/Proton/issues/4940)
2. [Proton parameters guide](https://github.com/ValveSoftware/Proton#runtime-config-options)