hit-and-run-linux
hit-and-run-linux is a native 64-bit Linux and macOS port of The Simpsons: Hit & Run with Vulkan and OpenGL support, offering higher resolutions and dynamic shadows.
- Type: PC port
- Game: The Simpsons: Hit & Run
- Runs on Linux and macOS
- By zeropaulsy
- Latest release v0.3.0, 2026-11-15
- Source: https://github.com/zeropaulsy/hit-and-run-linux
README
The Simpsons Hit & Run: Linux/macOS port
A native 64-bit Linux and macOS build of The Simpsons Hit & Run (2003): SDL2 and Vulkan 1.3, with OpenGL as a fallback. X11 and Wayland, any resolution and aspect ratio, anti-aliasing, controllers, dynamic sun shadows and optional post-processing shaders.
Bring your own game. No game data is included. You need your own copy of the PC game, the folder holding art/,
scripts/ and the .rcf files.
AI disclaimer. Aspects of this port are written with the help of an AI coding assistant (Claude). Builds are always manually playtested for bugs and crashes.
| Original (2003) | This project |
|---|---|
| Direct3D 8, fixed-function | Vulkan 1.3 (default) or OpenGL 3.3 core, shaders matching Direct3D 8's output |
| Blob shadows | Dynamic sun shadows (Vulkan): ray traced on RTX-class GPUs, shadow map on any other |
| DirectInput | SDL2: keyboard, mouse, any modern gamepad, rumble |
| DirectSound + EAX hardware reverb | Software 3D mixer with EAX-style reverb |
| Bink video | FFmpeg |
| 640x480 to 1600x1200, 4:3 | Any resolution, any aspect ratio, resizable window |
Running
Download the latest release: a Linux tarball and AppImage, and a macOS app (prerelease). The release notes explain how to start it; older builds are on the Releases page.
- Linux: x86-64, Ubuntu 24.04 / Linux Mint 22 or newer (glibc 2.38+), a Vulkan 1.3 driver (NVIDIA, or Mesa for
AMD / Intel) or OpenGL 3.3. High shadows need ray tracing (
VK_KHR_ray_query). - macOS: Apple silicon on macOS 26 Tahoe or newer; Vulkan through MoltenVK, or OpenGL 4.1.
To build it yourself, install the dependencies, then let play.sh build and start the game:
# Debian / Ubuntu
sudo apt install cmake ninja-build python3 build-essential \
libsdl2-dev libgl-dev libvulkan-dev libopenal-dev \
libavformat-dev libavcodec-dev libswscale-dev libswresample-dev libavutil-dev
# macOS (Xcode Command Line Tools and Homebrew)
brew install cmake ninja pkgconf sdl2 ffmpeg openal-soft molten-vk vulkan-loader vulkan-headers vulkan-tools
port/play.sh --data "/path/to/The Simpsons - Hit & Run"
The first run builds the game, creates run/ with links to your game data and its own simpsons.ini and saves,
then starts it. Your original install is never written to. Add --no-build to skip the build, --mod X to load a
mod, or game options such as skipfe (straight into Level 1), bonus (Bonus Game unlocked) or console
(developer console on the key; typehelp`).
Other distributions, Intel Macs, build options and debug switches: see the README on the
dev branch, where development happens.
Settings
Options > Graphics (front end or pause menu) holds the port's own settings, saved in simpsons.ini:
| Setting | Values | ini key |
|---|---|---|
| Renderer | Vulkan (default), OpenGL; applies at the next start | renderer=vulkan|opengl |
| Anti-aliasing | Off, 2x, 4x (default), 8x | antialiasing= |
| Shaders | Off, or a pack from shaders/: vanilla-pack, soft-pack, toon-pack or your own | shaders= |
| Shadows | Off, Low (default), High; Vulkan only. F9 cycles them in game | shadows=off|low|high |
| Wide HUD | Off (default), On: HUD at the window edges on wide and tall windows | widehud=yes |
Sun shadows follow the sun or moon painted in each level's sky. Low bakes the world's shadow into a map on any Vulkan GPU, and cars and characters keep blob shadows. High ray traces cars and characters too, and takes the sun off covered places such as tunnels. OpenGL draws the original blob shadows. On macOS, High runs as Low.
Language: language=english (default), french, german or spanish in simpsons.ini sets the text, loading
screens, speech and localized movies. Speech needs that language's voice file in your game folder (dialogf.rcf,
dialogg.rcf or dialogs.rcf); without it you get English voices with translated text.
Mods (work in progress)
Mods for Lucas' Simpsons Hit & Run Mod Launcher load without the launcher, as a .lmlm package or an extracted mod
folder (the one holding Meta.ini). Back up your saves first.
port/play.sh --data DIR --mod ~/mods/SomeMod.lmlm --mod ~/mods/AnotherModFolder
On macOS, drag mods onto the app's icon. Repeat --mod to load several; if two replace the same file, the first
wins. Mods load only for that run. Nearly every launcher hack works, including Lua scripting; the log
(run/logs/last-session.log) lists each mod loaded and any hack it uses that isn't supported yet. When reporting a
mod problem, include the mod's name and version and that log.
Platforms
| Platform | Status |
|---|---|
| Linux x86-64 | Fully playtested: game completed to 100% |
| Linux x86 (32-bit, legacy) | Playable, tested through Levels 1-7 |
| macOS Apple silicon / Intel | Prerelease. Runs end to end on an Apple M2 (MoltenVK) and Intel Big Sur (OpenGL); no long play session yet |
| Windows x64 | Planned |
Vulkan is tested on NVIDIA, AMD (Mesa RADV) and Mesa's lavapipe; Intel hardware not yet.
Credits
- Donut Team, for Lucas' Simpsons Hit & Run Mod Launcher and their years of work on modding tools, documentation and research into the game. The mod support in this port follows the format and hacks their launcher defined. Support them on Ko-fi.
- The Mod Bakery, and the modders who publish there, for hosting and keeping the game's mods available over the years.
License
The port's own work is licensed under the Mozilla Public License 2.0: everything under port/
(except port/third_party/), shaders/ and mod/, and the files the port adds elsewhere.
The MPL does not cover the original game. Its source in code/, libs/ and build/ is © Radical Entertainment
(see the notices in those files), and the port's changes to those files do not change their copyright. No game
data is included. Third-party code in port/third_party/ (Lua, glslang, stb, DejaVu) keeps its own license, found
next to it.