18.11.2022
Quake 1 port for Apple Watches that uses software rendering and has mostly working audio playback. Runs shareware and registered versions of the game with optional “cd” audio.
https://www.youtube.com/watch?v=89TAt72eYt4 (Series 5 gameplay video)
This port started from the original Quake Watch port by Tomas “MyOwnClone” Vymazal.
Changes by ByteOverlord
- Save and load game on watchOS
- Music playback (“cd” audio)
- Camera look and tweaked controls
- Autosaving options
- Map quick select and cheats screens
- Automatic native resolution on watches
Features
- PAK0 and PAK1 loading
- Menu screen
- Save and load game support
- Autosaving options
- Map quick select screen
- Cheat activation screen
- Tweaked controls for watch interface
- Config.cfg with settings saving support
- Underwater audio effect
- Position and animation interpolation support
- Music playback (tracks have to be converted to a specific WAV format)
- Automatic native resolution on watch models (Series 5 40mm -> Ultra)
Known issues
- Audio will not transmit through Bluetooth
- Audio stutters occasionally
- Camera rotates suddenly on some occasions
- R_AliasDrawModel trivial_accept disabled (Incorrect bounding box?)
- Sound does not playback on app start (Put the game to the dock and open it from there again.)
- App does not start anymore (Build the app to the watch from Xcode. Force quit the app on the watch while Xcode is still running. Close Xcode and disconnect the iPhone from the computer. Start the app from the watch)
Building Requirements
- Apple Watch Series 5 or later with watchOS 9.1 or later
- iPhone 8 or later with iOS 16 or later
- Xcode 14.1 or later with command-line tools
- Homebrew
- Innoextract
- bchunk (only for music)
- Audacity (only for music)
Building the Watch Quake
Install Xcode through Apple AppStore and install command-line tools when Xcode asks for it.
Download the Watch Quake from GitHub. (https://github.com/ByteOverlord/Watch_Quake)
Get Quake through gog.com (if you just want to use the shareware jump to “Copy PAK…” and only use the shareware’s PAK0.PAK)
From Quake’s “View Downloads” download the Windows “offline backup game installer”
Install Homebrew from terminal:
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/homebrew/go/install)"
Install innoextract from Homebrew:
brew update
brew install innoextract
In terminal extract the Quake game files with innoextract:
innoextract “downloaded setup_quake_the_offering_2.0.0.6.exe file location”
(innoextract will extract it to an “app” folder in current working directory.)
Copy PAK0.PAK and PAK1.PAK files to WatchQuake project (PAK names have to be uppercase (case sensitive)):
/WatchQuake Watch App/Resources/id1/
Open the GitHub WatchQuake Xcode project.
In WatchQuake project file go to “Targets” and for the “WatchQuake” select your own “Team” and write a unique “Bundle Identifier” in “Signing & Capabilities”.
Then select the “WatchQuake Watch App” in “Targets” and select the same “Team” as in “WatchQuake” and the “Bundle Identifier” Should be the same as in “WatchQuake” target with “.watchkitapp” added at the end.
If the project “Frameworks” folder shows the framework texts in red:
Goto “Targets” -> “WatchQuake Watch App” -> “Build Phases” and in “Link Binary With Libraries” add:
AVFoundation.framework
CoreGraphics.framework
Foundation.framework
SwiftUI.framework
UIKit.framework
And after adding them delete the frameworks with red text.
Check that the project is on release setting.
Select first a watch simulator to test the build.
After testing connect iPhone to the Mac and make sure Apple Watch is connected to it. Select the Apple Watch as target.
Build it to the watch. (Depending on the game files that were added. Transfer might take from 5-20 min)
Adding music to the game (Optional)
Install bchunk from terminal:
brew install bchunk
Extract game music from the gog game files:
bchunk -w “game.gog file location” “game.cue file location” track
(Music tracks will extract in to current working directo
