OpenGothic — iOS port

Patches and build tooling that take the half-finished iOS port of OpenGothic — the open-source reimplementation of Gothic II: Night of the Raven — to a playable state on iPhone and iPad.

Upstream already had the foundations (Metal renderer through the Tempest engine, an iOS window and touch handling, a CMake section for iOS). What was missing was usable controls, and a number of things were broken — on a current SDK the app did not even launch.

This repository contains patches, scripts and documentation only. No game content. You need your own copy of Gothic II: NotR (GOG or Steam) to play.

Quick start

Requirements: macOS with Xcode and the iOS SDK, cmake (brew install cmake), and an Apple ID — a free account is enough.

./setup-ios.sh

The script clones upstream at a tested commit, applies the patches and generates OpenGothic/build-ios/Gothic2Notr.xcodeproj. Then:

1. Open the project in Xcode
2. Target Gothic2Notr → Signing & Capabilities → pick your team
3. Connect an iPhone or iPad, select it as the run destination, Cmd+R
4. On a free account, trust the developer on the device (Settings → General → VPN & Device Management)

The script is safe to re-run: each run discards local edits in the clone and reapplies the patches from scratch. You do not need it for a normal rebuild — Cmd+R is enough.

Game data

The app has File Sharing enabled:

1. Connect the device to a Mac → Finder → device → Files → Gothic2Notr (or use the Files app on the device itself)
2. Copy the contents of a Gothic II installation there, so that Data/, _work/ and system/ sit directly at the top level of Gothic2Notr/, not inside a subfolder
3. Launch the game — it finds the data on its own

The data survives reinstalling from Xcode, so you only copy it once.

Documentation

docs/controls.md	touch controls — joystick, buttons, menus
docs/performance.md	performance tuning, Gothic.ini keys, what headroom is left
docs/mods.md	mod support and its limits
docs/patches.md	what each of the 31 patches fixes, and which belong upstream
docs/distribution.md	how to get this to people, and what stands in the way

Layout

opengothic-ios/
├── setup-ios.sh          # clone + patches + Xcode project
├── patches/
│   ├── opengothic/       # 18 patches for the main repo
│   └── tempest/          # 14 patches for lib/Tempest (submodule)
└── docs/

The working clone is created in OpenGothic/ and is gitignored — it runs to several gigabytes and is reproducible at any time from the pinned commit plus the patches.

Status

Playable on iPhone (tested on A17 Pro). Controls, saving and loading, mods and persistent settings all work.

Known limitations:

• Text input — Tempest does not bring up the iOS keyboard, so savegames cannot be named (they get an automatic Save <n>) and the Marvin console is unreachable
• Gamepad — not supported yet; it needs GameController framework support in Tempest
• Autosave on suspend — not implemented; backgrounding the app only pauses it

License

MIT. The patches are derivative of OpenGothic and Tempest, both MIT, © Try.