tpw-port

tpw-port is an unofficial PC port of Sim Theme Park for Windows, macOS, and Linux that allows playing with PS1 exclusive rides and SimCoaster worlds.

README

tpw-port

Join the Discord

Join the Discord: discord.gg/QSvugmgCwW

An unofficial port of Sim Theme Park (AKA Theme Park World, 1999) for Macs (Apple Silicon and Intel), 64-bit Windows and Linux. You need your own copy of the game.

Sim Theme Park running in the port, in widescreen

Quick start

To install, run the command below. To update, rerun the same command or themepark update.

Windows

Run in PowerShell:

irm https://github.com/ThemeParkWorldDecomp/tpw-port/releases/latest/download/install.ps1 | iex
macOS / Linux

Run in Terminal:

curl -fsSL https://github.com/ThemeParkWorldDecomp/tpw-port/releases/latest/download/install.sh | sh
Play after install

The launcher opens when the installer finishes. After that, type themepark in a new PowerShell or Terminal window, or open the launcher from its install location below.

Launcher locations:

  • Windows: %LOCALAPPDATA%\STP-TPW-Launcher\build\tpw_launcher.exe, also in the Start menu and Search
  • macOS: ~/Applications/STP-TPW-Launcher/build/tpw_launcher, also in Applications as STP/TPW Launcher
  • Linux: ~/.local/share/STP-TPW-Launcher/build/tpw_launcher, also in the applications menu

Mods

Optional extras that add bonus content. Click Mods in the Launcher, next to Settings. All are off by default, and all off is the original game. A park saved with a mod needs it on to load.

PS1 Exclusives

PlayStation rides in a park

More PlayStation rides

A PlayStation ride up close

The seven rides only the PlayStation had, plus its Tower as Halloween scenery. Converted from your own USA, European or Japanese PlayStation disc. Turn on PlayStation rides and drop the disc on the launcher.

SimCoaster AKA Theme Park Inc Worlds

Arabian Nights

Polar Zone

Land of Invention

Three worlds from SimCoaster (AKA Theme Park Inc, 2001): Arabian Nights, Polar Zone and Land of Invention, with their own rides, shops and scenery. A second ring of islands (Tab or right click) at 5, 3 and 1 golden keys. Converted from your own disc or install of that game. Turn on SimCoaster/TPI - New Worlds, Rides and Sprites and drop it on the launcher. Not publishable online.

More mods

ModWhat it does
Enable strikesStaff can strike, as Bullfrog first wrote it.
Patrolling staff can cross bridgesPatrols cross footbridges.

Every mod works on US, European and Gold.

Playing

  1. Run themepark (built by hand: build/tpw_launcher).
  2. Drop your disc on the window: Mac CD, PC CD, or a zip, 7-Zip, RAR or disc image of either. Split archive: drop all parts, or the first.
  3. Wait for the check. Press Play.

The buttons are at the top: Mods, Settings, and About / Game Data, which shows what your discs unlocked and holds Show logs, Export logs and Licenses.

Changed files are rechecked at each start. Edited .sam files are kept.

Settings:

SettingDefaultOn means
Skip the intro filmsOffStraight to the lobby.
Back to the launcher after playingOffThe launcher reopens when the game quits.
Full screenOnOff plays in a window. Cmd+Ctrl+F (Mac) or Alt+Enter switches.
Renderer (Linux)OpenGLVulkan: the port's own renderer.
Smooth wheel zoomOffThe wheel eases toward the pointer.
Zoom out furtherOffThe camera goes further out.
Free cameraOffTilt, zoom and fly anywhere: Q E turn, Z X tilt, Page Up/Down zoom, Tab flies, Home resets. On a trackpad a two-finger swipe zooms as in the original and turns sideways, and a pinch zooms. Its own settings show under it (Two-finger swipe: Zooms and rotates, the default, or Moves the camera).
Gamepad (under Free camera)OnA gamepad moves the free camera: left stick moves (flying: flies), right stick turns and tilts (looks), right and left triggers zoom in and out (rise and sink), LB and RB turn, Y (triangle) flies, View (Share, Select) resets.
Several keys at onceOffWalk and turn at once, as on the PC.
W A S D move the cameraOffW A S D scroll and walk (Z Q S D on AZERTY). A and S no longer open All items and All staff.
Varied soundsOnSounds vary, as on the PC. Off is the Mac's way.
Stereo panningOffSounds pan with the camera.
Show Ride BadgesOnGOLD and PS1 badges on build-menu icons.
Interface size100%85% or 70% shows more park.
LanguageThe edition's ownText and advisor voice, from your discs' languages.
Game optionsThe game's ownThe game's Options panel (Config.tcf, gms.dat). Greyed while playing.
GraphicsDefaultEight low/med/high.sam settings. Default follows Graphics quality.
Draw distance (under Graphics)FartherHow far rides and camcorder walks draw. Original is the original game's distance, Farther half as far again, Whole world the whole park and land with fog only at the edge.
Frame rate limitMonitor30 up to your refresh rate.
Check for updatesOnSee Updates.
Online serverEmptyAutomatic, or type an address.

Check again rehashes every file.

Online account: Create account on the login panel (the lobby's globe). Password 6 to 16 characters. The e-mail is only for resets. The 1999 game sends passwords unencrypted: use a new one. Forgot password? e-mails a code, valid 30 minutes.

Keys
ActionMacWindows and Linux
Help bar on/offCmd/Ctrl+HCtrl+H
Menu / cancelEscEsc
Hide control panelF3F3
Open parkCmd/Ctrl+OCtrl+O
Close parkCmd/Ctrl+CCtrl+C
Buy attractionsBB
Hire staffHH
Park informationII
All attractionsAA
All staffSS
All visitorsVV
FinancesFF
LoansLL
Training budgetsTT
Entry priceGG
ResearchRR
MapSpaceSpace
Staff locatorCmd/Ctrl+SCtrl+S
Visitor locatorCmd/Ctrl+VCtrl+V
PostcardCmd/Ctrl+PCtrl+P
CamcorderCC
Rotate cameraLeft / RightLeft / Right
Scroll left / rightNumpad 4 / 6Numpad 4 / 6
Scroll up / downNumpad 8 / 2Numpad 8 / 2
Zoom in / outUp / DownUp / Down
Back to the gatesHome or Numpad 5Home or Numpad 5
Turn object clockwise, (comma), (comma)
Turn object anticlockwise. (period). (period)
Build severalHold Cmd/CtrlHold Ctrl
Copy an objectCmd+clickCtrl+click
Delete track sectionBackspaceBackspace
Clear landF7 or Delete (fn+Delete on a laptop)Delete
Delete path tileBackspaceBackspace
Speed up timeNumpad +Numpad +
Slow down timeNumpad -Numpad -
Normal speedNumpad *Numpad *
PausePP
AdvisorF1F1
Chat hide / showF4F4
Chat focusTab, Enter or /Tab, Enter or /
Send chatReturn or EnterEnter
Full screenOption+ReturnAlt+Enter
QuitCmd+Q (port)Alt+F4 (Linux also Super+Q, port)
Cheats
How to enable cheat mode
  1. In a park, press G and click the park's name.
  2. Rename it Kevin the (first line) Cosmic Cow (second line).
  3. Press Return.

Or press Control+Shift+Option+C (Mac), Ctrl+Shift+Alt+C (Windows, Linux).

Cheat list

Mac keys. Windows and Linux: Option is Alt, Control is Ctrl. Tried: checked in play.

CheatKeysTried
+$10,000Option+1Mac
Complete all researchOption+R
Undo thatOption+Shift+R
One guestShift+1Mac
Five guestsControl+Shift+1
Fill every path with guestsControl+Shift+Option+1
Security guardShift+5Mac
ResearcherShift+6Mac
MechanicShift+7Mac
HandymanShift+8
EntertainerShift+9
One of each staffShift+0Mac
LitterShift+LMac
VomitShift+V
Clean all litterShift+Y
Break the ride under the pointerShift+B
Nothing (empty in the original)Option+Shift+B
Strikes (park 2+ years old) and a month's costsControl+Option+SMac
Winning sequence (again to stop)Option+Shift+1Mac
Bankruptcy sequenceOption+Shift+0
Bank loan 1 to 4Control+keypad 1 to 4
Golden ticketOption+GMac
Other golden ticketsOption+keypad 1 to 9
Weather up one step (of 100)Option+F12
Weather down one stepOption+F11
Weather up tenShift+F12
Weather down tenShift+F11
Weather offControl+Shift+F12
Weather back to normalControl+F12
Real-time lighting on/offControl+Shift+Option+F12
Frame rate on/offControl+Shift+Option+F11
Good to know
  • Clear both lines first. Capitals as shown.
  • Saved with the park. The key way adds $1.
  • Mac: Control or Command both work.
  • Keypad cheats need a numeric keypad.
  • Mac F11/F12: hold fn. Linux may grab Ctrl+Alt+F keys.
  • People and mess appear at the pointer. Guest keys open a closed park.
  • Golden ticket keys work without cheat mode.
  • A second strikes press may not stop them.
Updates
  • Checks GitHub at start, for releases only. Sends nothing about you.
  • Banner: "Version X.Y.Z is out". Update installs it (script installs) or opens the release page (built by hand). Flatpak: run themepark update.
  • Off: Settings, Check for updates. Once: tpw_launcher --check-updates.
  • The game never needs the internet.

What you need

  • macOS 11+ with xcode-select --install, Windows 10/11 64-bit (Arm: 11), or Linux x86-64 with OpenGL or Vulkan.
  • 2.5 GB free.
  • Your own disc:
DiscGives
US Mac CDSim Theme Park
+ European PC CD (2000 or later pressing)Theme Park World
US Windows CD 2.0Sim Theme Park
European Windows CDTheme Park World
US Windows CD 1.0Patch to 2.0 on Windows, then drop the installed folder with the CD
+ PC Gold bonus CD18 Gold rides, 17 updated ones

No other patches. A Gold park needs the Gold Edition switch on.

Data folder (files, saves, logs):

  • Mac: ~/Library/Application Support/STP-TPW Launcher
  • Windows: %APPDATA%\STP-TPW Launcher
  • Linux: ~/.local/share/STP-TPW Launcher
  • Flatpak: ~/.var/app/io.github.ThemeParkWorldDecomp.Launcher/data/STP-TPW Launcher

make clean and build.cmd clean never touch it. Log: logs/launcher.log. About / Game Data: Show logs, Export logs. Windows has no console: use build\tpw_launcher.exe 2> log.txt.

Edited settings files
  • .sam files live in assets/us/Theme Park Data and assets/eur/Theme Park Data. Edit freely: they are kept.
  • A Customized settings badge lists them. Restore original puts the disc's copy back.
  • A line the game can't read can crash it. The list warns you.

Asset packs

  • A zip of replacement files at their game paths, e.g. data/init/640/Splash_American.tga.
  • Put it in packs in the data folder, or pass --packs DIR. Later names win.
  • Allowed: .tga, .wct, .ani, .cur, .sf2, .sdt with .map, .ttf, .bf4, .mov. No .sam.
  • Ignored: zips starting with a dot, packs over 8 GB. The log says why.
  • Use the game's formats (uncompressed TGA). Replace all three logo folders (640, 800, 1024). A new welcome.tga must be at least as wide as legal.tga.
  • A broken file can crash the game.

Where it stands

  • Every function is translated. Both editions play.
  • 158 stand-ins remain, none reached in play.
  • Online play works on a revived server. Mail and postcards don't yet.

For developers

The code
  • tpw-decomp submodule: the translated game, bugs included.
  • launcher/: the launcher. launcher/net/ is the only internet code.
  • platform/: Mac and Windows shims on SDL3 and OpenGL. platform/vulkan/: the Linux Vulkan renderer.
  • overrides/: 664 fixes, listed in FIXES.md.
  • mods/: the tpw-mods submodule, via TPW_MOD_HOOK. -DTPW_MODS_DIR=<folder> points elsewhere.
The Windows build
  • .\build.cmd fetches pinned tools, or uses yours: clang 23.1.3+ (llvm-mingw), CMake 3.20+, Ninja 1.10+, Python 3.10+.
  • .\build.cmd TOOLS=fetch always fetches. .\build.cmd test runs the tests. BUILD=<folder> picks the folder.
  • Logs: build\logs.
  • Platform tests need -DTPW_LIBCLANG=<path>.
The Linux build
  • Tested on Ubuntu 24.04 (GCC 13.3, clang 18.1) and Arch (KDE, Wayland, NVIDIA).
  • --renderer vulkan falls back to OpenGL without a Vulkan device. No Vulkan package needed to build.
  • After a shader change, run devtools/vulkan_shaders.sh.
  • Platform tests need libclang (libclang-18-dev, or -DTPW_LIBCLANG=<path>).
  • install.sh --flatpak installs the Flatpak instead.
Building by hand

Needs CMake 3.20+, a C++17 compiler, Python 3.

git clone --recurse-submodules https://github.com/ThemeParkWorldDecomp/tpw-port.git
cd tpw-port
cmake -S . -B build
cmake --build build -j8 --target tpw_launcher
  • make takes BUILD=, CMAKE=, JOBS=. make clean deletes build/.
  • -DTPW_MOVIES=OFF: no films.
  • Local-folder clone: git -c protocol.file.allow=always submodule update --init.

Windows, with llvm-mingw in C:\llvm-mingw (PowerShell):

git -c core.autocrlf=false clone --recurse-submodules https://github.com/ThemeParkWorldDecomp/tpw-port.git
cd tpw-port
$env:PATH = "C:\llvm-mingw\bin;$env:PATH"
cmake -S . -B build -G Ninja -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
cmake --build build --target tpw_launcher
build\tpw_launcher.exe
Building on Linux

The installer does this. By hand: GCC 13 or clang 18+, CMake 3.20+, Ninja, Python 3, SDL's dev packages.

Debian and Ubuntu:

sudo apt install build-essential cmake ninja-build python3 git \
    libx11-dev libxext-dev libxrandr-dev libxcursor-dev libxi-dev libxfixes-dev libxss-dev libxkbcommon-dev \
    libwayland-dev wayland-protocols libdecor-0-dev libegl1-mesa-dev libgl1-mesa-dev libdrm-dev libgbm-dev \
    libasound2-dev libpulse-dev libpipewire-0.3-dev libdbus-1-dev libudev-dev libibus-1.0-dev

Fedora:

sudo dnf install gcc gcc-c++ libstdc++-static make cmake ninja-build python3 git \
    libX11-devel libXext-devel libXrandr-devel libXcursor-devel libXi-devel libXfixes-devel libXScrnSaver-devel \
    libxkbcommon-devel wayland-devel wayland-protocols-devel libdecor-devel mesa-libEGL-devel mesa-libGL-devel \
    libdrm-devel mesa-libgbm-devel alsa-lib-devel pulseaudio-libs-devel pipewire-devel dbus-devel systemd-devel \
    ibus-devel

Arch (run sudo pacman -Syu first):

sudo pacman -S --needed gcc make cmake ninja python git pkgconf libx11 libxext libxrandr libxcursor libxi \
    libxfixes libxss libxkbcommon wayland wayland-protocols libdecor libglvnd mesa libdrm alsa-lib libpulse \
    libpipewire dbus systemd-libs libibus

Then:

git clone --branch stable --recurse-submodules https://github.com/ThemeParkWorldDecomp/tpw-port.git
cd tpw-port
cmake -S . -B build -G Ninja
cmake --build build --target tpw_launcher
build/tpw_launcher
  • Update: git pull, git submodule update --init --recursive, then the two cmake lines.
  • -DTPW_STATIC_RUNTIME=OFF uses the system C++ runtime.
  • make, make run, make test, make clean work too.
  • Flatpak bundle: sh devtools/flatpak.sh.
  • Headless tests: SDL_AUDIO_DRIVER=dummy, xvfb-run.
Game data from the command line
python3 tpw-port/devtools/import_originals.py --from ORIGINALS --to extracted
tpw-port/build/tpw_launcher --game "extracted/disc-hfs/Theme Park Data"
  • Takes the US Mac CD image, optionally the European PC ISO and the Bonus Stuff zip. Ends with "CHECK OK".
  • --find lists finds. --check extracted rechecks. --whole-disc adds the CD's extras.
  • tpw_launcher --play us (eur, us-pc, eur-pc) skips the window. --no-preload stops read-ahead. --help lists all.
Running from the command line
tpw-port/devtools/run_launcher.sh tpw-port/build NAME SECONDS [options]
  • Own user folder (build/user-NAME) and log (build/launch-NAME.log). Quits after SECONDS.
  • Options: --mute, --no-movies, --windowed, --display builtin, --background, --launcher-window, --play us|eur, --data DIR.
  • Input: --click X,Y@PASS, --type TEXT@PASS, --drag X0,Y0-X1,Y1@PASS, --frames N, --window-click X,Y@FRAME, --window-size WxH, --fullscreen.
  • Defaults to --aspect 4:3 --resolution 2048x1536. --paced unsets TPW_VSYNC_EVERY_REFRESH.
Widescreen and resolution
  • Fills the screen at its shape (4:3, 16:10, 16:9). No bars.
  • --windowed: a window. --background: behind other windows.
  • Animations keep pace at any frame rate.
  • Options panel, Screen resolution: change size and shape while playing.
  • --resolution 2048x1536: the original's largest 4:3 size. --aspect 4:3: the original layout.

Reporting a problem

Open an issue or post on Discord with:

  1. The launcher version (tpw_launcher --version). For -dev, the log's build: ... line.
  2. Your system and edition.
  3. The log: About / Game Data, Export logs. It holds no user names.
  4. What you did.

Update to the newest release first.

Contributing

The project is three repositories, and every change belongs in exactly one of them:

RepositoryWhat it holdsPull requests
tpw-decompThe translation: the Mac program's own functions in C++, each behaving exactly as the Mac build does, bugs included, with the differential tests that check it.None. A function that behaves differently from the Mac is reported as an issue on tpw-port.
tpw-portThe original game on today's Macs, Windows PCs and Linux machines: the launcher, the platform layer, the builds, and the fixes that make it run as it did on the Mac.Welcome, by its CONTRIBUTING.md.
tpw-modsOptional changes to how the game plays, each one off until the player turns it on. tpw-port carries it as a submodule at mods/.Welcome, by its CONTRIBUTING.md.

The test for where a change goes: does a park play the same with it on and with it off? If it does, the change belongs in tpw-port. If it changes the rules, the money, the visitors, the staff, the rides, the advisor, the game's content, what a control does or the save files, it belongs in tpw-mods, even as a setting that is off by default.

One exception: an option the original game already had in its .sam data files belongs in tpw-port, even when it changes how a park plays, as long as it offers only the values the original accepts and its default is the original's. Players set it in the launcher or a game menu, never by editing a .sam file.

Two additions to the game's own screens. The online login panel has a "Create account" button, a sign-up popup and a password reset ("Forgot password?"), drawn in the game's own style. The original made accounts and reset passwords on EA's website, which is gone. It belongs in tpw-port, and with the port's fixes off the panel is the original's. And Buy Ride's picture of a ride the Gold Edition added has a small "GOLD" badge, display only, so players can tell those rides apart. It belongs in tpw-port too, and the launcher's Settings switch "Show Ride Badges" (on by default) turns it off. The "PS1" badge on the PlayStation rides is the tpw-