Skip to content

Releases

Wolf3D for iOS v0.1

Choose a tag to compare

@github-actions github-actions released this 17 Nov 21:59
2b045f6

Build 25 · 2026-11-17

Wolf3D for iOS v0.1: an unofficial iPhone and iPad port of ECWolf, the Wolfenstein 3D source port, playing Wolfenstein 3D, Spear of Destiny and its two mission packs, with on-screen touch controls made for them.

You need your own copy of the game; no game files are included. Wolfenstein 3D on GOG (it comes with Spear of Destiny) or Steam, and Spear of Destiny on Steam, all work. You copy the game's files onto your iPhone (see Install).

Setup guide: https://github.com/sithewok13-dev/ECWolf/blob/ios/docs/ios/README.md

New here? Known limitations, Requirements and Install are near the bottom of this page, just above the download.

What's in ios-v0.1

The first numbered release of Wolf3D, the app. Everything in it:

  • Wolfenstein 3D and Spear of Destiny in one app, from your own files. GOG's folders work just as they are, and with both games' files the tray's GAMES switches between them.
  • Full screen, widescreen, at a steady 60 frames a second, in the game's own sharp pixels.
  • Touch controls: a move stick wherever your left thumb lands (slide up onto the ^^ above it to run), drag anywhere else to turn, FIRE and USE under your right thumb, MAP for the automap.
  • A weapon wheel: slide NEXT WPN, or hold it, and pick a weapon. The game waits while it's open.
  • Quick save and quick load: hold SAVE or LOAD for 0.3 s. A tap opens the game's own Save Game or Load Game menu.
  • Six HUD looks: BJ's face, health, lives, ammo and keys in two small pills (SPLIT) or one (STRIP), the original status bar whole (CLASSIC) or cut to fit the corners (CLASSIC SPLIT, CLASSIC STRIP), or nothing at all. Three sizes and an opacity slider.
  • A camera: photos, bursts, selfies with BJ grinning in the corner and the enemies around you posing for the group shot, Action Freeze (time stops and you fly the camera around the moment) and a cinematic burst. Pictures go to your Photos.
  • The sithewok cheat: a golden Ark of the Covenant button, with a sound made for it. God mode, every weapon, every key and full ammo; hold USE for noclip.
  • LEVEL: a list of every level in the game you're playing. Tap one to go there.

How to play: every control explained

The touch controls appear while you're playing and change in the menus, the title and story screens and between levels (there you tap and slide, see Menus below). The game runs in landscape, either way round.

Where everything is while you play (on a phone, turn it sideways to see the whole picture):

 NEXT  MAP             CAMERA      CHEAT        SAVE  LOAD  MENU
 WPN
   [LOOK] [ALWAYS RUN] [HUD] [FPS] [camera] [CHEAT] [LEVEL] [GAMES] [keyboard]
                        (MENU's tray, while it's open)

                                                        USE    FIRE
     ( o )  move stick: appears
            where your left thumb lands
 [face | health | lives]                           [weapon ammo | keys]

Exact positions shift a little to fit your screen, the camera cutout and the HUD. CHEAT only shows once you've switched the cheat on; LEVEL only in a level; GAMES only when the app has found more than one game.

Moving and turning

  • Move: put your left thumb down anywhere in the left part of the screen. The stick appears right under your thumb and goes away when you lift it. Push up to go forward, down to back away, and sideways to step sideways (strafe).
  • Run: while the stick is out, a small ^^ in a circle sits above it. Slide your thumb up onto it to run straight ahead (you feel a tick). Or hold MENU and switch on ALWAYS RUN in the tray: then the stick always runs and the ^^ goes away.
  • Turn: drag anywhere else that isn't a button, which mostly means the right side. Dragging on FIRE or USE turns too, so you can hold FIRE and aim with the same thumb.
  • Turning speed: hold MENU and tap LOOK in its tray. Each tap goes on to the next speed, 0.5x, 0.75x, 1x (the default), 1.25x, 1.5x, 2x, 2.5x, 3x, and after 3x round to 0.5x; the button shows the speed. Hold LOOK until its ring fills (0.45 s) to go back to 1x. The app remembers your speed.
  • There's no tilt aiming in this port.

Buttons

  • FIRE (bottom right): hold to keep firing.
  • USE (next to FIRE): opens doors, flips the elevator switch and pushes secret walls.
  • NEXT WPN (top left): a tap takes the next weapon. Slide or hold it for the weapon wheel (below).
  • MAP (top left): the automap.
  • SAVE and LOAD (top right): a tap opens the game's own Save Game or Load Game menu. Hold for quick save and quick load (below).
  • MENU (top right): a tap opens the game's menu. Hold it for the tray (below).
  • CAMERA (top, in the middle): photos and more (below).
  • RESUME (in the middle): shows while the game is paused. Tap it to play on.

The weapon wheel

Slide your thumb off NEXT WPN (about 10 points) and the wheel opens at once; or hold NEXT WPN for 0.3 s and it opens for you to tap. It has one slice per weapon (knife, pistol, machine gun, chain gun), with its picture and ammo. Weapons you haven't found yet are faint. Slide onto a slice, or tap it, to take that weapon. The gap at the bottom cancels. The game waits while the wheel is open, and you feel a tick on each slice.

Quick save and quick load: why the short hold

Hold SAVE for 0.3 s (a ring fills) to save at once into the Quicksave slot, with no questions. Hold LOAD the same way to load it. The short hold is there so a thumb that brushes the corner in a fight doesn't throw away your progress. Sliding off the button before the ring fills cancels, and if you hold both, SAVE wins. A plain tap opens the game's own Save Game or Load Game menu, where you can name your saves (the iOS keyboard comes up).

MENU and its hidden tray

Hold MENU for 0.45 s and a tray opens under it:

  • LOOK: turning speed (see Moving and turning).
  • ALWAYS RUN: the game's own Always Run, on (lit) or off.
  • HUD: opens the HUD panel (see The HUD).
  • FPS: shows or hides a frame-rate counter. The game always runs at 60 frames a second.
  • The camera symbol: shows or hides the CAMERA button. Hold it for the camera's options.
  • CHEAT: see The cheat below.
  • LEVEL (in a level): a list of the game's levels. The game holds still while it's open. Tap one to go there: you start that floor fresh, as a new game would, with the pistol and 8 bullets (with the cheat on, you get everything again). The X, or a touch off the list, closes it.
  • GAMES (when the app found more than one game): Switch game, with a card for each game. Pick another and the app saves its settings and closes; tap its notification, or open it again within 10 minutes, and that game starts.
  • The keyboard symbol: the iOS keyboard, for typing a cheat or anything else the game asks for.

Under the tray, in small letters, is the build, for example build 23 · Nov 16.

The camera: photos, selfies, bursts and Action Freeze

  • Tap CAMERA for a photo. You'll see a flash and hear a shutter.
  • Hold CAMERA for 0.5 s (a ring fills) for a selfie: BJ grins in a bottom corner, and the enemies in the area with you (not from elsewhere in the level) are posed in front of the camera, in a different arrangement each time. If no one is near, it says so.
  • Slide sideways off CAMERA for a burst of 10 photos.
  • Slide down for Action Freeze: time stops. Drag one finger to fly the camera around the moment; with two fingers, move it and pinch to zoom. The round white button takes the picture, and the X ends the freeze. In Wolfenstein 3D you see BJ running in the frozen scene; Spear of Destiny has no pictures of him, so he isn't there.
  • Slide up for a cinematic burst of 5.
  • Options: hold the camera symbol in MENU's tray: PHOTO (clean, with the HUD, or with the HUD and buttons), SELFIES (1, 3 or 5 per selfie) and ACTION FREEZE (on or off).
  • A selfie or a freeze changes nothing in the game: everything is put back exactly as it was. Pictures go to your Photos app (the app only asks to add photos, never to see yours). If you don't allow that, they go to Files > On My iPhone > Wolf3D > Screenshots.

The cheat (sithewok)

  • Switch it on: hold MENU, then tap CHEAT in the tray. The CHEAT button appears at the top, a golden Ark of the Covenant, opening with a sound made for it. Or type sithewok with the keyboard (the keyboard symbol in the tray).
  • While it's on: god mode, every weapon, every key and full ammo, given again in each level you start or load.
  • Noclip (walk through walls): hold USE still for 0.5 s (a gold ring fills). A small red NOCLIP ON shows under USE. Hold it agai...
Read more

iOS latest build

iOS latest build Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 10 Nov 04:10
3605bbd

Build 24 · 2026-11-17
Development build of Wolf3D (ECWolf) for iPhone and iPad, rebuilt after every push to the ios branch (run 24, commit 2b045f6). It may not have been tried yet.
Wolf3D-ios.ipa is unsigned: sideload it (for example with Feather), then copy your own game files (Wolfenstein 3D, Spear of Destiny and its mission packs, from GOG, Steam or CD) into Files > On My iPhone > Wolf3D. No game data is included.