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/3] 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/3] 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/3] 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 |