Skip to content

Update some Linux documentation #181

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Arenovas wants to merge 3 commits into
base: main
Choose a base branch
from
+14 −8
Open

Update some Linux documentation #181

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ee8c0b9
Add a new section
Arenovas Apr 14, 2026
0ec63c4
Update Tools on Linux section
Arenovas Apr 18, 2026
ce9be56
Update launch options
Arenovas Apr 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 10 additions & 5 deletions docs/modding/linux/tools_on_linux.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,13 +50,9 @@ Tools such as Hammer, HLMV and Faceposer can be run trivially using wine. Typica

For Hammer:
```sh
wine bin/win64/hammer.exe -winecompat
wine bin/win64/hammer.exe
```

>[!NOTE]
> `-winecompat` is completely optional for Hammer. It simply enables the Qt file browser dialog instead of using the native one provided by wine.
> This flag does nothing in HLMV and Faceposer, as those tools have no Qt integration.

Faceposer and HLMV both require the `-game` parameter to tell it which game to use. If running from the root of the game directory:
```sh
wine bin/win64/hlmv.exe -game p2ce
Expand Down Expand Up @@ -101,3 +97,12 @@ If you're still having issues, verify that `~/.steam/steam/steamapps/libraryfold
You can adjust the default DPI of the applications using `winecfg`.

Run `winecfg` in a terminal, navigate to "Graphics" and adjust the DPI as desired under the "Screen resolution" section.

### Hammer performs terribly!

This is a side effect of how the 2D viewports are rendered, when larger portions of the map are visible in the 2D viewports, Hammer will degrade in performance.

If you're using Wine 11 you can disable winecompat by either removing `-winecompat` for Portal: Revolution or enabling `-nowinerenderfix` for P2:CE and Momentum Mod, which will resolve performance issues. However, this will introduce a single frame delay in your interactions in the viewports.
Forcing Wine to use Wayland as opposed to X11 can fix that issue, however the model browser won't work.

If any of those are undesirable, one can simply resort to minimizing the amount drawn in the viewports by either zooming in or shifting the views away from the map. Disabling model rendering in the 2D viewports can also help improve performance a little as well.
7 changes: 4 additions & 3 deletions docs/modding/overview/launchoptions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@ The following options are only available on Linux currently.

# Hammer Options

| Option | Description |
| ----------- | ----------------------------------------------------------- |
| -winecompat | Enables the Qt file dialog in Hammer (on Linux) |
| Option | Description |
| ---------------- | ------------------------------------------------------------------------------------------------------------------- |
| -winecompat | Enables the Qt file dialog in Hammer and fixes 2D viewports in Wine 10 and below (on Linux) (Deprecated) |
| -nowinerenderfix | Disables the 2D viewport fixes (on Linux) |