This repository is a native Linux port effort based on Freelancer Decomp: a reverse-engineered, behavior-matching reimplementation of the Freelancer (2003) client and engine DLLs.
Goal: run Freelancer natively on Linux (Wayland-first, targeting EndeavourOS/Hyprland + AMD RDNA3/RADV-class GPUs) without Wine or Proton, while preserving original game behavior and compatibility with legally obtained game data.
Status: M0–M9 implemented (bring-up). The 32-bit
freelancer_linux_clientruns (DACOM init, config/DATA load, window, render loop with skybox/nebula/HUD). Full upstream engine wiring (M8.7/M11) still pending. The original Windows build remains the upstream reference.
- Native Linux only: ELF executables/modules, Linux-native platform backends (filesystem, windowing/input, audio, threads/timing/module loading), no Windows compatibility layer.
- Preserve behavior first: keep gameplay/data behavior aligned with the original game wherever possible.
- 32-bit initially: retain x86 (32-bit) architecture during bring-up to avoid compounding ABI/asm/layout/serialization risks; 64-bit is deferred.
- Preserve architecture/interfaces: keep DACOM and existing engine interfaces/contracts where possible; replace implementations behind a Linux platform layer.
- Graphics strategy (phased):
- Level 1 (first major objective): native Linux app with compatible D3D8 rendering behavior if feasible (must be validated in a native Linux x86 architecture; not assumed to be a Wine drop-in).
- Level 2 (later): fully native renderer behind existing interfaces (e.g. Vulkan) only if/when needed.
See assessment.md for the detailed technical assessment, subsystem inventory, risks, and refactored plan.
- Repo cloned and organized for Linux work (
DATA/canonicalized withdata -> DATAcompatibility symlink). - #3 Path normalization: deterministic, ASCII case-insensitive path resolution + separator normalization for Linux (
linux/include/linux_port/path_util.*,fl_path_resolve). - #2 Config/boot probe:
dacom_ini_probeparsesbin/DACOM.INI/bin/freelancer.ini, emits boot/load-order and component/provider hints, resolves config/data paths, and extracts.vcxprojdependency hints. - #1 Platform shims + #1.2 DACOM/ReadFile integration: Win32/platform shims, Linux-backed file I/O, 32-bit build/runtime validation, guarded upstream
dacom.cpp/ReadFile.cppwrapper TUs, and integration harnesses with real config/file-backed reads and explicit registration hooks. - #4 Graphics de-risk spike:
gfx_env_probeand SDL3+Vulkangfx_wayland_poc(swapchain + present validation) plusIRenderPipeline/RP8scope findings. Seelinux/docs/gfx-de-risk-spike.md,linux/docs/irenderpipeline-rp8-scope.md,linux/docs/build-and-env-status.md.
- CMake/Ninja presets and dedicated i686/x86_64 toolchains (
CMakePresets.json,linux/CMakePresets.json,linux/cmake/toolchain-*.cmake). - Vcxproj dependency graph tooling/artifacts (
linux/tools/generate_vcxproj_dep_graph.py,linux/docs/vcxproj-dependency-graph.{json,md}). - Minimal boot subset and foundation docs (
linux/docs/m0-project-foundation.md,linux/docs/minimal-boot-subset.md).
- Engine-facing path normalization/resolution integration (
GetFullPathNameA,_fullpath,SearchPathA, cwd helpers,_access/_mkdir) and case-insensitive/normalized Linux behavior. - Win32 shim fidelity improvements (timing/sync/atomics, pointer-sized types, file/time helpers) and preserved logging/diagnostics/error mapping.
- Targeted validation expanded with
m1_platform_tests(path edge cases, file I/O/find, config variants/failure modes, timing/sync/interlocked, module resolution, ABI/layout checks); upstream DACOM/ReadFile harnesses remain runnable.
- DllMain-free explicit DACOM/init lifecycle hooks (FDUMP bridge, built-in registration, explicit ReadFile registration).
- Config/INI loading through Linux-compatible paths (
bin/DACOM.INI,bin/freelancer.ini, resolveddata path) with source-only explicit-registration-aware handling for unavailable external runtime modules. - Minimal core component init/load in dependency order proven by 32-bit
m2_engine_init_harness(component system init, config load, registration/composition, and successful core component instantiation includingFileSystem/DOS). Seeroadmap.mdandlinux/docs/m2-dacom-engine-init.md.
- Portable/isolated Linux
x86math(3DMathEngine) implementation with explicit DACOM registration and numeric/behavior validation (linux/src/x86math_portable.cpp,linux/tests/upstream_x86math_tu.cpp,m3_math_data_tests). - Path resolution integrated into config/data loading flows on case-sensitive layout (resolved
binconfigs andDATA/assets,FileSystem/DOSinstantiated against resolved data root). - Core Freelancer configuration and game data loaded from
DATA/with consistency/spot checks (including BINI data files) viam3_math_data_tests. Seeroadmap.mdandlinux/docs/m3-math-game-data.md.
- SDL3-based Wayland-first window/event abstraction (
linux/include/linux_port/window_input.h,linux/src/window_input.cpp) with stable opaque adapter handle (avoids fake-HWNDassumptions) and lifecycle/size/title APIs. - Keyboard/mouse/controller mapping to expected input semantics (Win32-like VK key mapping helper, mouse button/motion/wheel, SDL gamepad buttons/axes with normalized values and hotplug handling).
- Focus/lifecycle, resize, cursor visibility, mouse grab, and relative mouse mode handling.
- Event loop integration with engine/frame/update flow (
pump_events,run_looptick integration) proven bym4_window_input_harness(native window + functioning input/event loop). Seeroadmap.mdandlinux/docs/m4-windowing-input.md.
- Scoped native Vulkan backend behind render-pipeline abstraction (
linux/include/linux_port/render_pipeline.h,linux/src/render_pipeline.cpp) with lifecycle, device/surface/swapchain, clear+present, viewport/window/transforms, basic render states, draw submission. - Integrated with M4 window (SDL Vulkan surface) and engine-like frame loop (
init_for_window,render_frame,run_loop). -
m5_graphics_harnessrenders and presents 120/120 frames on 64-bit and 32-bit presets. Seeroadmap.mdandlinux/docs/m5-graphics-bringup.md.
- Null audio backend (
linux/include/linux_port/audio_backend.h,linux/src/audio_backend.cpp) unblocks boot/menu audio calls. - XDG-backed config/registry/save shim (
linux/include/linux_port/xdg_config.h,linux/src/xdg_config.cpp) for Linux persistence. - [~] Boot harness (
m6_boot_harness) ties audio, XDG, window (M4), and graphics (M5) into a boot sequence reaching main menu and entering a game world loop (harness-prototyped; full engine client wiring is follow-on). Seeroadmap.mdandlinux/docs/m6-gameplay-bringup.md.
- Fullscreen/windowed toggle, controller detection, frame pacing metrics in window/render backends.
- Packaging/install/run documentation (
linux/docs/packaging-install-run.md). - Final validation harness (
m7_release_harness) passes all subsystem checks on 64-bit and 32-bit presets. Seeroadmap.md.
-
freelancer_linux_clientnative ELF links and runs (DACOM init, config/DATA load, window, render loop). - [~] Upstream client/library init (M8.7) pending on unported dependencies.
- Vertex/index buffers, textures (stb), graphics pipeline, fonts (FreeType), draw submission, skybox, nebula, HUD text (
m9_render_harness).
| Milestone | Focus | Acceptance target | Status |
|---|---|---|---|
| M0 | Project foundation | CMake+Ninja Linux build scaffolding, 32-bit toolchain validation, source/build organization, dependency graph from .vcxproj |
Completed |
| M1 | Core platform compatibility | Filesystem/path compat, Win32 shims, logging/diagnostics, timing, threading/sync, module loading; DACOM/ReadFile compile or run in harnesses with targeted tests |
Completed (pending review) |
| M2 | DACOM & engine initialization | Linux DACOM/module init model, config/INI loading, preserved registration/composition semantics; component system initializes and loads core components | Completed (pending review) |
| M3 | Math & game data | Portable/isolated x86math (3DMathEngine) registration + numeric validation, path-integrated data/resource loading, core config/game data loaded from DATA/; assets/configs resolve correctly on case-sensitive FS |
Completed (pending review) |
| M4 | Windowing & input | SDL3-based Wayland-first window/event abstraction, keyboard/mouse/controller, engine adapters; native Linux window + input/event loop | Completed (pending review) |
| M5 | Graphics bring-up | Scoped native Vulkan backend behind render-pipeline abstraction, integrated with M4 window; minimal in-engine frame renders and presents | Completed (pending review) |
| M6 | Gameplay bring-up | Null-audio backend, XDG config/registry shim, boot sequence reaching main menu + game world loop; reach main menu and enter game world | Completed (pending review) |
| M7 | Native Linux release candidate (bring-up) | Fullscreen/windowed, controller detection, frame pacing, packaging/install docs; release candidate harness validates all subsystems | Completed (pending review) |
| M8 | Game client compilation | Compile/link freelancer client as native ELF against Linux shims; runnable native client binary | Planned |
| M8.8 | Win32/COM/Resource shim expansion | Win32 window/message pump, resource string tables, COM IRenderPipeline adapter; upstream client TUs compile/link | Planned |
| M9 | Full render pipeline | Textures, meshes, fonts, draw submission, skybox/nebula/HUD text; demo scene renders | In progress |
| M10 | Real audio backend | PulseAudio backend (64-bit), null backend (32-bit); SoundManager wiring pending | In progress |
| M11 | Game flow | Controlled main-menu state (bring-up); full upstream wiring blocked on M8.7 | In progress |
| M12 | Polish & release | Movies, IME, multiplayer, performance, packaging; playable native Linux experience | Planned |
Experimental scaffolding lives in linux/:
linux/CMakeLists.txt— CMake entry for helper prototypes/tools/harnesses- Path/config probes:
fl_path_resolve,dacom_ini_probe - Shim/integration harnesses:
core_shim_harness,abi_module_harness,dacom_boot_harness,m1_platform_tests,dacom_upstream_compile_probe(64/32-bit as applicable), plus 32-bit upstream wrapper/integration targets (fl_upstream_dacom_tu,fl_upstream_readfile_tu,fl_upstream_x86math_tu,upstream_dacom_readfile_harness,upstream_dacom_integration_harness,upstream_dacom_readfile_integration_harness,m2_engine_init_harness,m3_math_data_tests) - Windowing/input (M4):
fl_linux_port_window,m4_window_input_harness(SDL3, Wayland-first; built when usable target SDL3 libs are available) - Graphics bring-up (M5):
fl_linux_port_render,m5_graphics_harness(scoped Vulkan backend; built when usable target SDL3+Vulkan libs are available) - Gameplay bring-up (M6):
fl_linux_port_gameplay,m6_boot_harness(null audio + XDG config/registry + boot sequence; built when usable target SDL3+Vulkan libs are available) - Release candidate (M7):
m7_release_harness(final validation of all subsystems; built when usable target SDL3+Vulkan libs are available) - Graphics de-risk (#4):
gfx_env_probe,gfx_wayland_poc(SDL3+Vulkan; built when usable target SDL3/Vulkan libs are available) - Docs:
linux/docs/phase0-status.md,linux/docs/build-and-env-status.md,linux/docs/path-normalization.md,linux/docs/dacom-config-probe.md,linux/docs/win32-shim-notes.md,linux/docs/dacom-readfile-harness-spike.md,linux/docs/gfx-de-risk-spike.md,linux/docs/irenderpipeline-rp8-scope.md,linux/docs/m3-math-game-data.md,linux/docs/m4-windowing-input.md,linux/docs/m5-graphics-bringup.md,linux/docs/m6-gameplay-bringup.md,linux/docs/packaging-install-run.md
Run commands from the repository root. These are Phase 0/M1–M4 analysis, harness, and PoC targets; the full game is not yet buildable or launchable on Linux.
Requires CMake (3.20+), Ninja, and a C/C++ toolchain (Clang/GCC). The 32-bit bring-up build (linux-x86) also requires a working multilib toolchain and 32-bit runtime/dev dependencies (including 32-bit SDL3/Vulkan/Wayland stacks for graphics targets where applicable; see linux/docs/build-and-env-status.md).
cmake --preset linux-x64 -S linux
cmake --build --preset linux-x64 -j
# Path/config probes
./linux/linux-x64/fl_path_resolve bin '..\DATA\solar\solararch.ini'
./linux/linux-x64/dacom_ini_probe bin/DACOM.INI
# Platform/shim probes and M1 tests
./linux/linux-x64/core_shim_harness
./linux/linux-x64/m1_platform_tests
./linux/linux-x64/dacom_upstream_compile_probe
./linux/linux-x64/gfx_env_probe
# M4 windowing/input (native window + functioning input/event loop)
./linux/linux-x64/m4_window_input_harness
# M5 graphics bring-up (native window + scoped Vulkan backend, 120 presented frames)
./linux/linux-x64/m5_graphics_harness
# M6 gameplay bring-up (boot sequence reaching main menu + game world)
./linux/linux-x64/m6_boot_harness
# M7 release candidate (final validation of all subsystems)
./linux/linux-x64/m7_release_harness
# SDL3+Vulkan presentation PoC (Wayland session; creates a window and presents 120 clear frames)
./linux/linux-x64/gfx_wayland_pocBuild output directory: linux/linux-x64/.
cmake --preset linux-x86 -S linux
cmake --build --preset linux-x86 -j
# Core/path/config/shim checks
./linux/linux-x86/fl_path_resolve bin '..\DATA\solar\solararch.ini'
./linux/linux-x86/dacom_ini_probe bin/DACOM.INI
./linux/linux-x86/core_shim_harness
./linux/linux-x86/m1_platform_tests
./linux/linux-x86/dacom_boot_harness
# Upstream DACOM/ReadFile wrapper integration (real config/file-backed reads, explicit registration hooks)
./linux/linux-x86/upstream_dacom_readfile_integration_harness
# M2 engine init: DACOM component system init, config load, explicit core component load
./linux/linux-x86/m2_engine_init_harness
# M3 math + game data: x86math registration/numerics, path-integrated config/DATA load
./linux/linux-x86/m3_math_data_tests
# M4 windowing/input (native window + functioning input/event loop)
./linux/linux-x86/m4_window_input_harness
# 32-bit graphics capability + presentation PoC
./linux/linux-x86/gfx_env_probe
./linux/linux-x86/gfx_wayland_poc
# If native Wayland backend is unavailable in 32-bit SDL3 on your setup, try:
# SDL_VIDEODRIVER=x11 ./linux/linux-x86/gfx_wayland_poc
# SDL_VIDEODRIVER=x11 ./linux/linux-x86/m4_window_input_harness./linux/linux-x86/freelancer_linux_client
./linux/linux-x86/m9_render_harness
Build output directory: linux/linux-x86/. The linux-x86 configure preset sets PKG_CONFIG_LIBDIR=/usr/lib32/pkgconfig:/usr/share/pkgconfig for 32-bit SDL3/Vulkan discovery; you can also prefix the configure command with that environment variable if needed.
What to look for: fl_path_resolve prints resolved Linux paths for Windows-style inputs; dacom_ini_probe prints boot/config analysis; integration/harness targets end with success/PASS/overall: ok (accurate library-load/config warnings may appear in this source-only checkout without upstream runtime DLLs); gfx_wayland_poc reports device/swapchain and presented frames: 120/120 (ok). See linux/docs/phase0-status.md and linux/docs/build-and-env-status.md for details.
Note: If a build directory was deleted or you need to reconfigure (e.g. switching ABI or after cached pkg-config/toolchain changes), rerun the
cmake --preset ... -S linuxconfigure step. To force a clean reconfigure, remove the preset build directory (e.g.linux/linux-x86orlinux/linux-x64) or delete itsCMakeCache.txt/CMakeFilesfirst. Manual-Bbuild directories and alternative layouts are documented inlinux/docs/m0-project-foundation.md.
src/— upstream decomp source and Visual Studio solution (Freelancer.sln,.vcxprojmodules)bin/— runtime config/templates (DACOM.INI,freelancer.ini,flconfigdatabase.txt, etc.)DATA/— Freelancer game data (user-provided; required at runtime)DATA_EXTRA/— port-specific data (e.g. RP9 shaders/volumetric assets)docs/— reverse-engineering and format/config documentationlinux/— native Linux port scaffolding, prototypes, and bring-up docsassessment.md— Linux port assessment and roadmap
The upstream Freelancer Decomp project builds on Windows (Visual Studio 2022, v143, Win32/x86) using src/Freelancer.sln, DirectX SDK dependencies, and outputs to bin/. Refer to upstream docs for original build instructions and module details:
- docs/README.md, docs/MISSION.md
- Russian README: README.ru.md
- Keep changes behavior-preserving and, where possible, additive/guarded to avoid breaking the Windows reference build.
- Maintain a clear separation between original game logic and Linux platform/backend implementations.
- Prefer tests/harnesses and Windows-vs-Linux behavior comparisons for boot-critical systems (config parsing, path resolution, math, data loading).
- Project source (Freelancer Decomp) is released under The Unlicense.
- Vendored libraries under
src/(e.g.src/zlib/vendor,src/qhull/vendor) retain their own licenses. - Retail/third-party game binaries and assets are not covered by this license and remain property of their respective owners (including game data and any retail DLLs present such as
EBUEula.dll,EULA.RTF,EXE/gundll.dll).
Original project contacts (see upstream README for donation/support details): Discord @Giperion, gipdereline@gmail.com.