From ee8c0b9d61cfee08f9e76925bbcb1644f3a6dd41 Mon Sep 17 00:00:00 2001 From: Arenovas <54878864+Arenovas@users.noreply.github.com> Date: Mon, 13 Apr 2026 19:44:09 -0700 Subject: [PATCH 1/3] Add a new section --- docs/modding/linux/tools_on_linux.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/modding/linux/tools_on_linux.md b/docs/modding/linux/tools_on_linux.md index 7b856f1c..16acff2a 100644 --- a/docs/modding/linux/tools_on_linux.md +++ b/docs/modding/linux/tools_on_linux.md @@ -101,3 +101,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` or enabling `-nowinecompat` depending on the version of Hammer being used 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. From 0ec63c47afbadb7cd44bf6b7aad608e07b974b0b Mon Sep 17 00:00:00 2001 From: Arenovas <54878864+Arenovas@users.noreply.github.com> Date: Fri, 17 Apr 2026 20:15:56 -0700 Subject: [PATCH 2/3] Update Tools on Linux section Remove the mention of winecompat from the launch command, fix and clarify the winecompat flags to possibly use on Wine 11, and add another method to improve Hammer performance. --- docs/modding/linux/tools_on_linux.md | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/docs/modding/linux/tools_on_linux.md b/docs/modding/linux/tools_on_linux.md index 16acff2a..4c604aed 100644 --- a/docs/modding/linux/tools_on_linux.md +++ b/docs/modding/linux/tools_on_linux.md @@ -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 @@ -106,7 +102,7 @@ Run `winecfg` in a terminal, navigate to "Graphics" and adjust the DPI as desire 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` or enabling `-nowinecompat` depending on the version of Hammer being used which will resolve performance issues. However, this will introduce a single frame delay in your interactions in the viewports. +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. +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. From ce9be5609f5e54a2485612b89993e8555b4d411e Mon Sep 17 00:00:00 2001 From: Arenovas <54878864+Arenovas@users.noreply.github.com> Date: Fri, 17 Apr 2026 20:17:01 -0700 Subject: [PATCH 3/3] Update launch options Add a bit more detail to winecompat and mark as deprecated, alongside adding in the nowinerenderfix option --- docs/modding/overview/launchoptions.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/modding/overview/launchoptions.md b/docs/modding/overview/launchoptions.md index 77eb9370..bc08bf8b 100644 --- a/docs/modding/overview/launchoptions.md +++ b/docs/modding/overview/launchoptions.md @@ -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) |