From e61d3fb198a2c97cd62c0b280d9f0905fc8ef19c Mon Sep 17 00:00:00 2001 From: Equalizer <113145248+Equalizer5118@users.noreply.github.com> Date: Mon, 12 Jan 2026 22:33:20 -0800 Subject: [PATCH 1/9] Initial Commit Added section and overview page --- docs/modding/linux/meta.json | 3 +++ docs/modding/linux/overview.md | 17 +++++++++++++++++ 2 files changed, 20 insertions(+) create mode 100644 docs/modding/linux/meta.json create mode 100644 docs/modding/linux/overview.md diff --git a/docs/modding/linux/meta.json b/docs/modding/linux/meta.json new file mode 100644 index 00000000..1c29c473 --- /dev/null +++ b/docs/modding/linux/meta.json @@ -0,0 +1,3 @@ +{ + "title": "Modding on Linux" +} diff --git a/docs/modding/linux/overview.md b/docs/modding/linux/overview.md new file mode 100644 index 00000000..69681879 --- /dev/null +++ b/docs/modding/linux/overview.md @@ -0,0 +1,17 @@ +--- +title: "General Information" +--- +# General Information +Full native Linux support, for both games and modding tools, is a major goal of the Strata engine, but in the current state of the project, only the games and any tools entirely developed by the Strata team are fully Linux compatible, with many tools being Windows-only due to outdated GUI elements or otherwise old code. However, thanks to tools like Wine, it is possible to run some of these incompatible tools on Linux devices, with little to no tweaks. This category will go over the basics of what tools are and are not compatible with Linux via Wine, and if any tweaks are necessary to make them function properly. Most native applications can be found in `/bin/linux64` + +| Tool | Compatibility | Notes | +| ------------ | ------------------------ | ------------------------------------------------------------------------------------------- | +| Hammer | *Combatible thru Wine* | Needs to be run with `-winecompat` | +| HLMV | *Combatible thru Wine* | Needs to be run with `-winecompat` | +| vbsp/vvis/vrad | Native | None | +| vtex(2) | Native | None | +| Faceposer | **Incompatible** | Frequent crashes or instabilities. | +| SDK launcher | Native | Must use version in `Portal 2 Community Edition/bin/linux64`, launching from Steam does not work | + + +TODO: Page for getting hammer/hlmv to work thru Wine. Add more tools to this table. From 1481b7130b822aec2b47afc14724c3332ac48281 Mon Sep 17 00:00:00 2001 From: Equalizer Date: Wed, 21 Jan 2026 22:18:59 -0800 Subject: [PATCH 2/9] Added basic Hammer running page + some troubleshooting stuffs --- docs/modding/linux/hammer_linux.md | 47 ++++++++++++++++++++++++++++++ docs/modding/linux/overview.md | 4 +-- 2 files changed, 49 insertions(+), 2 deletions(-) create mode 100644 docs/modding/linux/hammer_linux.md diff --git a/docs/modding/linux/hammer_linux.md b/docs/modding/linux/hammer_linux.md new file mode 100644 index 00000000..45cab7d5 --- /dev/null +++ b/docs/modding/linux/hammer_linux.md @@ -0,0 +1,47 @@ +--- +title: "Running Hammer on Linux" +--- +# Running Hammer on Linux +This article will cover the process of running Hammer on Linux-based operating systems and address many common questions or issues that may arise. + +## Prerequisites +This process uses a program named [Wine](https://www.winehq.org/), which is a translation layer that converts calls meant for Windows into native Linux calls, without the need for emulation. Wine can be installed using your distro's appropriate package manager or from the [WineHQ](https://www.winehq.org/) website. + +## Running Hammer +First, run a Terminal window and navigate to `/bin/win64` using `cd`. Now, copy this command into the terminal: +``` +wine hammer.exe -winecompat -game "./../../YOUR_MOD_HERE" +``` +Once you run this option, Hammer should launch and provide you with the normal configuration prompt. + +If you are running Hammer after previously using the program on Windows, you will have to edit your configurations to the correct filepaths. Make sure to point to the Windows executables, even for tools that have Linux-native versions, as Wine is not able to run Linux applications. + +### Creating a Shell script +For ease of use, you may find it useful to create a Shell (`.sh`) script that automatically runs Hammer under wine. Here is an example of a script for Portal 2: Community Edition named `hammer.sh` located in `/bin/linux64/`.: +``` +echo "Launching Hammer under Wine" +cd "./../win64" +wine "./hammer.exe" -winecompat -game "./../../p2ce" +``` +If placing this script somewhere other than `/bin/linux64`, then make sure to change `cd "..."` and `-game` to the appropriate path. When in doubt, use an absolute path. + +When you create the file for the first time, you may need to give it permission to execute. This can be done by running this command: +``` +sudo chmod +x "./hammer.sh" +``` + +## Common Issues / Fixes +This section should cover most of the issues most users have when setting up Hammer. If this guide does not solve your issue, as for help in your game's Discord server. Make sure to list what steps you have taken to attempt to solve the issue, and follow [Dont Ask to Ask](https://dontasktoask.com/)! + +### "Setup file 'gameinfo.txt' doesn't exist in subdirectory" when launching +Typically, this occurs when a path in your configuration file is incorrect, especially if Hammer had previously been run on Windows. Make sure to edit your configuration file to update the paths. + +If you do not see the Configurations window on startup because you only use one config, navigate to `/hammer/cfg` and either delete or rename `gameconfig.txt`. This will recreate your game configuration file, that way Hammer will fully launch. Alternatively, you can manually edit the file to alter the paths to their correct location. +>![NOTE] +>Wine prefixes all paths with a fake drive letter, `Z:` by default, to maintiain compatibility with Windows filesystems. Make sure to add this to the beginning of all your paths for them to work correctly. + +### My game looks washed out when ran from Hammer! +In some distros or Desktop Environments, when launching the game through the compilation can appear washed out or overbrightened when ran through Wine. This appears to be an issue with how some Desktop Environments, like Hyprland, interact with Wine applications, so the best way to remedy this issue is by running the game through Steam and manually running the map through the console. + +### "Portal 2 is not installed" (Portal 2: Community Edition) +This error can occur for a variety of reasons, but usually it is because Portal 2 cannot be found by Steam. Make sure that Portal 2 is in fact installed and visible in your Steam library, then try Verifying the game files of both Portal 2 and Portal 2: CE. Next, try restarting Steam to reload your library. If this does not fix your issue, try moving your Portal 2 install to the same drive as your Portal 2: Community Edition install. If all else fails, contact a programmer with your issue. \ No newline at end of file diff --git a/docs/modding/linux/overview.md b/docs/modding/linux/overview.md index 69681879..c322f772 100644 --- a/docs/modding/linux/overview.md +++ b/docs/modding/linux/overview.md @@ -2,12 +2,12 @@ title: "General Information" --- # General Information -Full native Linux support, for both games and modding tools, is a major goal of the Strata engine, but in the current state of the project, only the games and any tools entirely developed by the Strata team are fully Linux compatible, with many tools being Windows-only due to outdated GUI elements or otherwise old code. However, thanks to tools like Wine, it is possible to run some of these incompatible tools on Linux devices, with little to no tweaks. This category will go over the basics of what tools are and are not compatible with Linux via Wine, and if any tweaks are necessary to make them function properly. Most native applications can be found in `/bin/linux64` +Full native Linux support, for both games and modding tools, is a major goal of the Strata engine, but in the current state of the project, only the games and any tools entirely developed by the Strata team are fully Linux compatible, with many tools being Windows-only due to outdated GUI elements or otherwise old code. However, thanks to tools like Wine, it is possible to run some of these incompatible tools on Linux devices, with little to no tweaks. This category will go over the basics of what tools are and are not compatible with Linux via Wine, and if any tweaks are necessary to make them function properly. Most native applications can be found in `/bin/linux64`, with any Windows-only applications being located in `/bin/win64`. | Tool | Compatibility | Notes | | ------------ | ------------------------ | ------------------------------------------------------------------------------------------- | | Hammer | *Combatible thru Wine* | Needs to be run with `-winecompat` | -| HLMV | *Combatible thru Wine* | Needs to be run with `-winecompat` | +| HLMV | *Combatible thru Wine* | None | | vbsp/vvis/vrad | Native | None | | vtex(2) | Native | None | | Faceposer | **Incompatible** | Frequent crashes or instabilities. | From cf30546675166380034063ee2b24581ecfc8fcae Mon Sep 17 00:00:00 2001 From: Equalizer Date: Wed, 21 Jan 2026 22:23:47 -0800 Subject: [PATCH 3/9] Small Edits --- docs/modding/linux/hammer_linux.md | 2 ++ docs/modding/linux/overview.md | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/modding/linux/hammer_linux.md b/docs/modding/linux/hammer_linux.md index 45cab7d5..1c37ad79 100644 --- a/docs/modding/linux/hammer_linux.md +++ b/docs/modding/linux/hammer_linux.md @@ -7,6 +7,8 @@ This article will cover the process of running Hammer on Linux-based operating s ## Prerequisites This process uses a program named [Wine](https://www.winehq.org/), which is a translation layer that converts calls meant for Windows into native Linux calls, without the need for emulation. Wine can be installed using your distro's appropriate package manager or from the [WineHQ](https://www.winehq.org/) website. +If using a Virtual Machine or emulator such as WinBoat, Hammer should work as-is, minus any configuration file changes. + ## Running Hammer First, run a Terminal window and navigate to `/bin/win64` using `cd`. Now, copy this command into the terminal: ``` diff --git a/docs/modding/linux/overview.md b/docs/modding/linux/overview.md index c322f772..3a415d00 100644 --- a/docs/modding/linux/overview.md +++ b/docs/modding/linux/overview.md @@ -6,7 +6,7 @@ Full native Linux support, for both games and modding tools, is a major goal of | Tool | Compatibility | Notes | | ------------ | ------------------------ | ------------------------------------------------------------------------------------------- | -| Hammer | *Combatible thru Wine* | Needs to be run with `-winecompat` | +| Hammer | *Combatible thru Wine* | Needs to be run with `-winecompat`, see [Running Hammer on Linux](hammer_linux.md) | | HLMV | *Combatible thru Wine* | None | | vbsp/vvis/vrad | Native | None | | vtex(2) | Native | None | From 33f3b30fb4ea96aba488bd02338387f5140ace35 Mon Sep 17 00:00:00 2001 From: Equalizer Date: Fri, 23 Jan 2026 17:18:51 -0800 Subject: [PATCH 4/9] (hopeful) fix for broken compiling --- docs/modding/linux/hammer_linux.md | 2 +- docs/modding/linux/overview.md | 14 +++++++------- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/modding/linux/hammer_linux.md b/docs/modding/linux/hammer_linux.md index 1c37ad79..241c2cae 100644 --- a/docs/modding/linux/hammer_linux.md +++ b/docs/modding/linux/hammer_linux.md @@ -32,7 +32,7 @@ When you create the file for the first time, you may need to give it permission sudo chmod +x "./hammer.sh" ``` -## Common Issues / Fixes +## Common Issues and Fixes This section should cover most of the issues most users have when setting up Hammer. If this guide does not solve your issue, as for help in your game's Discord server. Make sure to list what steps you have taken to attempt to solve the issue, and follow [Dont Ask to Ask](https://dontasktoask.com/)! ### "Setup file 'gameinfo.txt' doesn't exist in subdirectory" when launching diff --git a/docs/modding/linux/overview.md b/docs/modding/linux/overview.md index 3a415d00..badbbb2f 100644 --- a/docs/modding/linux/overview.md +++ b/docs/modding/linux/overview.md @@ -4,13 +4,13 @@ title: "General Information" # General Information Full native Linux support, for both games and modding tools, is a major goal of the Strata engine, but in the current state of the project, only the games and any tools entirely developed by the Strata team are fully Linux compatible, with many tools being Windows-only due to outdated GUI elements or otherwise old code. However, thanks to tools like Wine, it is possible to run some of these incompatible tools on Linux devices, with little to no tweaks. This category will go over the basics of what tools are and are not compatible with Linux via Wine, and if any tweaks are necessary to make them function properly. Most native applications can be found in `/bin/linux64`, with any Windows-only applications being located in `/bin/win64`. -| Tool | Compatibility | Notes | -| ------------ | ------------------------ | ------------------------------------------------------------------------------------------- | -| Hammer | *Combatible thru Wine* | Needs to be run with `-winecompat`, see [Running Hammer on Linux](hammer_linux.md) | -| HLMV | *Combatible thru Wine* | None | -| vbsp/vvis/vrad | Native | None | -| vtex(2) | Native | None | -| Faceposer | **Incompatible** | Frequent crashes or instabilities. | +| Tool | Compatibility | Notes | +| ------------ | ------------------------ | ----- | +| Hammer | *Combatible thru Wine* | Needs to be run with `-winecompat`, see [Running Hammer on Linux](hammer_linux.md)| +| HLMV | *Combatible thru Wine* | None | +| vbsp/vvis/vrad | Native | None | +| vtex(2) | Native | None | +| Faceposer | **Incompatible** | Frequent crashes or instabilities. | | SDK launcher | Native | Must use version in `Portal 2 Community Edition/bin/linux64`, launching from Steam does not work | From 4986b9ff37269d762583db45b62dc6e11325b79a Mon Sep 17 00:00:00 2001 From: Equalizer Date: Fri, 23 Jan 2026 18:51:51 -0800 Subject: [PATCH 5/9] Expand + rename Included more info on running under wine, and also expanded page to include HLMV and Faceposer --- docs/modding/linux/overview.md | 11 +++---- .../{hammer_linux.md => tools_on_linux.md} | 31 +++++++++++++------ 2 files changed, 25 insertions(+), 17 deletions(-) rename docs/modding/linux/{hammer_linux.md => tools_on_linux.md} (56%) diff --git a/docs/modding/linux/overview.md b/docs/modding/linux/overview.md index badbbb2f..98eb2ce2 100644 --- a/docs/modding/linux/overview.md +++ b/docs/modding/linux/overview.md @@ -6,12 +6,9 @@ Full native Linux support, for both games and modding tools, is a major goal of | Tool | Compatibility | Notes | | ------------ | ------------------------ | ----- | -| Hammer | *Combatible thru Wine* | Needs to be run with `-winecompat`, see [Running Hammer on Linux](hammer_linux.md)| -| HLMV | *Combatible thru Wine* | None | -| vbsp/vvis/vrad | Native | None | +| Hammer | *Combatible thru Wine* | Needs to be run with `-winecompat`, see [Running Windows Tools on Linux](./tools_on_linux) | +| HLMV | *Combatible thru Wine* | Same with Hammer | +| Faceposer | *Compatible thru Wine* | Requires minimum Wine 11. Same process as Hammar. | +| vbsp/vvis/vrad | Native | When running Hammer under Wine, make sure to point to the Win64 versions for Compatibility | | vtex(2) | Native | None | -| Faceposer | **Incompatible** | Frequent crashes or instabilities. | | SDK launcher | Native | Must use version in `Portal 2 Community Edition/bin/linux64`, launching from Steam does not work | - - -TODO: Page for getting hammer/hlmv to work thru Wine. Add more tools to this table. diff --git a/docs/modding/linux/hammer_linux.md b/docs/modding/linux/tools_on_linux.md similarity index 56% rename from docs/modding/linux/hammer_linux.md rename to docs/modding/linux/tools_on_linux.md index 241c2cae..da1fc9e5 100644 --- a/docs/modding/linux/hammer_linux.md +++ b/docs/modding/linux/tools_on_linux.md @@ -1,20 +1,29 @@ --- -title: "Running Hammer on Linux" +title: "Running Windows Tools on Linux" --- -# Running Hammer on Linux +# Running Windows Tools on Linux This article will cover the process of running Hammer on Linux-based operating systems and address many common questions or issues that may arise. ## Prerequisites -This process uses a program named [Wine](https://www.winehq.org/), which is a translation layer that converts calls meant for Windows into native Linux calls, without the need for emulation. Wine can be installed using your distro's appropriate package manager or from the [WineHQ](https://www.winehq.org/) website. +This process uses a program named [Wine](https://www.winehq.org/), which is a translation layer that converts calls for Windows into native Linux calls, without the need for emulation. Wine can be installed using your distro's appropriate package manager, typically under the package name `wine`, or from Wine's website. -If using a Virtual Machine or emulator such as WinBoat, Hammer should work as-is, minus any configuration file changes. +>[!CAUTION] +>Since Wine 11, both the 32 and 64 bit packages of wine have been combined into one, so you only need to install the `wine` package for the tools to run properly. Installing the seperate outdated 32 and 64 bit packages is not recommended and will likely cause issues. + +If using a Virtual Machine or emulator such as WinBoat, the tools should work as-is, apart from any configuration file changes. + +## Running Windows Tools +This section uses Hammer as an example, but applies also to HLMV and Faceposer. Just replace all instaces of `hammer.exe` with the appropriate executable. -## Running Hammer First, run a Terminal window and navigate to `/bin/win64` using `cd`. Now, copy this command into the terminal: ``` wine hammer.exe -winecompat -game "./../../YOUR_MOD_HERE" ``` +>[!TIP] +>If you are starting Hammer for the first time on your system, `-game` should not be necessary, as the default config file will usually generate a correct path. Once you run this option, Hammer should launch and provide you with the normal configuration prompt. +> +>For HLMV/Faceposer, `-game` is *required* and the program will fail to launch or throw frequent errors if it is missing. If you are running Hammer after previously using the program on Windows, you will have to edit your configurations to the correct filepaths. Make sure to point to the Windows executables, even for tools that have Linux-native versions, as Wine is not able to run Linux applications. @@ -23,7 +32,7 @@ For ease of use, you may find it useful to create a Shell (`.sh`) script that au ``` echo "Launching Hammer under Wine" cd "./../win64" -wine "./hammer.exe" -winecompat -game "./../../p2ce" +wine "./hammer.exe" -winecompat -game "./../../YOUR_MOD_HERE" ``` If placing this script somewhere other than `/bin/linux64`, then make sure to change `cd "..."` and `-game` to the appropriate path. When in doubt, use an absolute path. @@ -33,13 +42,15 @@ sudo chmod +x "./hammer.sh" ``` ## Common Issues and Fixes -This section should cover most of the issues most users have when setting up Hammer. If this guide does not solve your issue, as for help in your game's Discord server. Make sure to list what steps you have taken to attempt to solve the issue, and follow [Dont Ask to Ask](https://dontasktoask.com/)! +This section should cover most of the issues most users have when setting up Windows tools. If this guide does not solve your issue, as for help in your game's Discord server. Make sure to list what steps you have taken to attempt to solve the issue, and follow [Dont Ask to Ask](https://dontasktoask.com/)! ### "Setup file 'gameinfo.txt' doesn't exist in subdirectory" when launching -Typically, this occurs when a path in your configuration file is incorrect, especially if Hammer had previously been run on Windows. Make sure to edit your configuration file to update the paths. +Typically, this occurs when a path in your configuration file is incorrect, especially for Hammer if it has previously been run on Windows. + +For Hammer, if you see the Select Config dialog when you start the program, edit the config to use the correct path. -If you do not see the Configurations window on startup because you only use one config, navigate to `/hammer/cfg` and either delete or rename `gameconfig.txt`. This will recreate your game configuration file, that way Hammer will fully launch. Alternatively, you can manually edit the file to alter the paths to their correct location. ->![NOTE] +For HLMV or if you only have one config for Hammer, first try making sure that the path specified in your `-game` option exists and that a `gameinfo.txt` file exsits. This should fix most cases of broken paths. If this does not fix your issue, navigate to `/hammer/cfg` and either delete or rename `gameconfig.txt`. This will recreate your game configuration file next time you start Hammer, and will likely fix all issues with broken paths. Alternatively, you can manually edit the file to alter the paths to their correct location. +>[!NOTE] >Wine prefixes all paths with a fake drive letter, `Z:` by default, to maintiain compatibility with Windows filesystems. Make sure to add this to the beginning of all your paths for them to work correctly. ### My game looks washed out when ran from Hammer! From dda36c8fa4964c57da92ba300b454e312799cb85 Mon Sep 17 00:00:00 2001 From: Equalizer Date: Fri, 23 Jan 2026 19:08:00 -0800 Subject: [PATCH 6/9] Grammar and Small Additions --- docs/modding/linux/overview.md | 8 +++++--- docs/modding/linux/tools_on_linux.md | 2 +- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/modding/linux/overview.md b/docs/modding/linux/overview.md index 98eb2ce2..2a95769a 100644 --- a/docs/modding/linux/overview.md +++ b/docs/modding/linux/overview.md @@ -2,13 +2,15 @@ title: "General Information" --- # General Information -Full native Linux support, for both games and modding tools, is a major goal of the Strata engine, but in the current state of the project, only the games and any tools entirely developed by the Strata team are fully Linux compatible, with many tools being Windows-only due to outdated GUI elements or otherwise old code. However, thanks to tools like Wine, it is possible to run some of these incompatible tools on Linux devices, with little to no tweaks. This category will go over the basics of what tools are and are not compatible with Linux via Wine, and if any tweaks are necessary to make them function properly. Most native applications can be found in `/bin/linux64`, with any Windows-only applications being located in `/bin/win64`. +Full native Linux support, for both games and modding tools, is a major goal of the Strata project, but in its current state, only the games and any tools entirely developed by the Strata team are fully Linux compatible, with many tools being Windows-only due to outdated GUI elements or otherwise old code. However, thanks to tools like Wine, it is possible to run some of these incompatible tools on Linux devices, with little to no tweaks. This category will go over the basics of what tools are and are not compatible with Linux via Wine, and if any tweaks are necessary to make them function properly. Most native applications can be found in `/bin/linux64`, with any Windows-only applications being located in `/bin/win64`. +>[!NOTE] +>This table only contains tools included with most builds of Strata, and does not cover any Third-Party tools like VTFEdit or GCFScape. Any official tool not listed here likely has a Linux native version, or is compatible thru Wine without any tweaks necessary. | Tool | Compatibility | Notes | | ------------ | ------------------------ | ----- | | Hammer | *Combatible thru Wine* | Needs to be run with `-winecompat`, see [Running Windows Tools on Linux](./tools_on_linux) | | HLMV | *Combatible thru Wine* | Same with Hammer | | Faceposer | *Compatible thru Wine* | Requires minimum Wine 11. Same process as Hammar. | -| vbsp/vvis/vrad | Native | When running Hammer under Wine, make sure to point to the Win64 versions for Compatibility | -| vtex(2) | Native | None | +| Postcompiler (TeamSpens HA) | *Compatible thru Wine* | While no Linux-native version is released, the program can be compiled for Linux by following instructions on the [Github Page](https://github.com/TeamSpen210/HammerAddons?tab=readme-ov-file#building-from-source) | +| vbsp/vvis/vrad | Native | Only for use in shell scripts/wrappers. When running Hammer under Wine, make sure to point to the Win64 versions for compatibility | | SDK launcher | Native | Must use version in `Portal 2 Community Edition/bin/linux64`, launching from Steam does not work | diff --git a/docs/modding/linux/tools_on_linux.md b/docs/modding/linux/tools_on_linux.md index da1fc9e5..b49ce00f 100644 --- a/docs/modding/linux/tools_on_linux.md +++ b/docs/modding/linux/tools_on_linux.md @@ -5,7 +5,7 @@ title: "Running Windows Tools on Linux" This article will cover the process of running Hammer on Linux-based operating systems and address many common questions or issues that may arise. ## Prerequisites -This process uses a program named [Wine](https://www.winehq.org/), which is a translation layer that converts calls for Windows into native Linux calls, without the need for emulation. Wine can be installed using your distro's appropriate package manager, typically under the package name `wine`, or from Wine's website. +This process uses [Wine](https://www.winehq.org/), a program which acts as a translation layer that converts Windows calls into Linux calls, without the need for emulation. Wine can be installed using your distro's appropriate package manager, typically under the package name `wine`, or from Wine's website. >[!CAUTION] >Since Wine 11, both the 32 and 64 bit packages of wine have been combined into one, so you only need to install the `wine` package for the tools to run properly. Installing the seperate outdated 32 and 64 bit packages is not recommended and will likely cause issues. From 5dc0eb0125417ae96503f29f1e20e120a000e459 Mon Sep 17 00:00:00 2001 From: Equalizer Date: Fri, 23 Jan 2026 19:11:02 -0800 Subject: [PATCH 7/9] Speling --- docs/modding/linux/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/modding/linux/overview.md b/docs/modding/linux/overview.md index 2a95769a..e4a851d4 100644 --- a/docs/modding/linux/overview.md +++ b/docs/modding/linux/overview.md @@ -10,7 +10,7 @@ Full native Linux support, for both games and modding tools, is a major goal of | ------------ | ------------------------ | ----- | | Hammer | *Combatible thru Wine* | Needs to be run with `-winecompat`, see [Running Windows Tools on Linux](./tools_on_linux) | | HLMV | *Combatible thru Wine* | Same with Hammer | -| Faceposer | *Compatible thru Wine* | Requires minimum Wine 11. Same process as Hammar. | +| Faceposer | *Compatible thru Wine* | Requires minimum Wine 11. Same process as Hammer. | | Postcompiler (TeamSpens HA) | *Compatible thru Wine* | While no Linux-native version is released, the program can be compiled for Linux by following instructions on the [Github Page](https://github.com/TeamSpen210/HammerAddons?tab=readme-ov-file#building-from-source) | | vbsp/vvis/vrad | Native | Only for use in shell scripts/wrappers. When running Hammer under Wine, make sure to point to the Win64 versions for compatibility | | SDK launcher | Native | Must use version in `Portal 2 Community Edition/bin/linux64`, launching from Steam does not work | From e7c4c2c01a2960e31b115377b97e3b1ee14e7335 Mon Sep 17 00:00:00 2001 From: Equalizer Date: Fri, 23 Jan 2026 19:44:41 -0800 Subject: [PATCH 8/9] Update tools_on_linux.md fix to JJ's review --- docs/modding/linux/tools_on_linux.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/modding/linux/tools_on_linux.md b/docs/modding/linux/tools_on_linux.md index b49ce00f..4b57c9e0 100644 --- a/docs/modding/linux/tools_on_linux.md +++ b/docs/modding/linux/tools_on_linux.md @@ -19,10 +19,10 @@ First, run a Terminal window and navigate to `/bin/win64` using `cd`. Now, ``` wine hammer.exe -winecompat -game "./../../YOUR_MOD_HERE" ``` ->[!TIP] +>[!NOTE] +>`-winecompat` is only necessary for Hammer, as it enables the Qt file dialog instead of the native wine dialog, which is not present in either HLMV or Faceposer. >If you are starting Hammer for the first time on your system, `-game` should not be necessary, as the default config file will usually generate a correct path. Once you run this option, Hammer should launch and provide you with the normal configuration prompt. -> >For HLMV/Faceposer, `-game` is *required* and the program will fail to launch or throw frequent errors if it is missing. If you are running Hammer after previously using the program on Windows, you will have to edit your configurations to the correct filepaths. Make sure to point to the Windows executables, even for tools that have Linux-native versions, as Wine is not able to run Linux applications. From 73118ed61f809641c4fb29445d0c7a7460a77a4d Mon Sep 17 00:00:00 2001 From: Equalizer Date: Fri, 23 Jan 2026 19:47:31 -0800 Subject: [PATCH 9/9] Update overview.md --- docs/modding/linux/overview.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/modding/linux/overview.md b/docs/modding/linux/overview.md index e4a851d4..80a8a7d8 100644 --- a/docs/modding/linux/overview.md +++ b/docs/modding/linux/overview.md @@ -13,4 +13,5 @@ Full native Linux support, for both games and modding tools, is a major goal of | Faceposer | *Compatible thru Wine* | Requires minimum Wine 11. Same process as Hammer. | | Postcompiler (TeamSpens HA) | *Compatible thru Wine* | While no Linux-native version is released, the program can be compiled for Linux by following instructions on the [Github Page](https://github.com/TeamSpen210/HammerAddons?tab=readme-ov-file#building-from-source) | | vbsp/vvis/vrad | Native | Only for use in shell scripts/wrappers. When running Hammer under Wine, make sure to point to the Win64 versions for compatibility | +| All engine tools (particle editor, material editor, etc)| Native | None | | SDK launcher | Native | Must use version in `Portal 2 Community Edition/bin/linux64`, launching from Steam does not work |