Skip to content

Add linux compatibility articles #129

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

Draft
Equalizer5118 wants to merge 1 commit into
base: main
Choose a base branch
from
+20 −0
Draft

Add linux compatibility articles #129

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
3 changes: 3 additions & 0 deletions docs/modding/linux/meta.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
"title": "Modding on Linux"
}
17 changes: 17 additions & 0 deletions docs/modding/linux/overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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 `<game name>/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` |
Copy link
Member

@JJL772 JJL772 Jan 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

-winecompat is only a thing in Hammer.

In Hammer, the only thing -winecompat does is enable the Qt file dialog instead of the native wine file browser. Other wine-specific fixups are applied automatically when the symbol wine_get_version is found in ntdll

I would just add a note to Hammer saying -winecompat enables the Qt file dialog instead of the native wine dialog or something

| 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.