Building Quake 3 with Xcode - rebelancap/Quake3-iOS GitHub Wiki

Building Quake3-iOS

Prerequisites

  • Xcode (latest version recommended)
  • iOS Developer Account (free or paid)
  • Quake 3 Arena game files (baseq3 folder)

Step-by-Step Instructions

1. Clone the Project

  • Open Xcode
  • File → Clone Repository
  • Enter: https://github.com/rebelancap/Quake3-iOS
  • Choose a location and clone

2. Configure Signing

  • Select the Quake3-iOS target
  • Go to Signing & Capabilities tab
  • Change Team to your Apple Developer account
  • Change Bundle Identifier to something unique (e.g., com.yourname.quake3ios)

3. Build and Run

  • Connect your iOS device
  • Select your device from the scheme dropdown (top left)
  • Click the Play button or press Cmd+R (the app will remind you need to place the baseq3 files)

**4. Add baseq3 folder

  • Use Files app or macOS Finder to copy baseq3 (and other mods) to the Quake III Arena Folder

Notes

  • You'll need legitimate Quake 3 Arena game files
  • Make sure your device is trusted for development (Settings → General → VPN & Device Management)
  • Checkout example configuration files and potential iOS Shortcuts and customize to your liking