Release OpenJKDF2 for iOS v0.9-beta2 "Yun" · sithewok13-dev/OpenJKDF2-iOS

Build 139 · 2026-11-12

OpenJKDF2 for iOS v0.9-beta2 "Yun": an unofficial iPhone and iPad build of OpenJKDF2, the open-source Jedi Knight: Dark Forces II engine, with on-screen touch controls. This beta is named after Yun, the first dark Jedi you duel.

New in this release: AUTO PLAY, a self-playing show for screen recordings; a tap to skip a level's own scenes before a duel; SAVE and LOAD, which open the game's own Save and Load screens on a tap (a hold still quick saves and loads); LAST WPN, back to the weapon you had before; POWERS, the Force wheel button, now beside FORCE; LIGHT, IR and BACTA as the game's own pictures of them; RUN, LOOK and OPACITY in MENU's tray; and a sharper FILM CROSS whose side blades light after the blade. Much of it hasn't been played on an iPhone yet, and none of it on an iPad (see Known limitations). Coming from v0.8-beta2? You also get build your own lightsaber (a hilt for each hand and a colour for each blade), FILM, RANDOM, Saber Throw for Kyle and installing from SideStore or AltStore (v0.9-beta1). From v0.8-beta1? Also joining games hosted by the original 1997 Jedi Knight and easier-to-read multiplayer menus (v0.8-beta2). From v0.7? Also multiplayer and co-op for up to four players, game controllers, and keyboard and mouse (v0.8-beta1), in both apps. From v0.6? Also Force Jump by how long you hold and endless ammo with sithewok (v0.7). From v0.5 or older? Also lightsaber colours and two sabers, cheat mode and Action Freeze (v0.6), the selfie camera, and Mysteries of the Sith in its own app, OpenMoTS. It's still experimental, so expect bugs.

You need your own copy of the game; no game files are included. OpenJKDF2 needs Star Wars Jedi Knight: Dark Forces II, and OpenMoTS needs Star Wars Jedi Knight: Mysteries of the Sith (GOG and Steam sell both).

Two apps, one for each game: OpenJKDF2 (OpenJKDF2-iOS-unsigned.ipa) plays Jedi Knight, and OpenMoTS (OpenJKDF2-MotS-iOS-unsigned.ipa) plays Mysteries of the Sith. Install the one for the game you have, or both: they sit side by side, each with its own icon and its own folder for its files and saves. OpenMoTS (new in v0.4) has had much less testing than OpenJKDF2 (see Known limitations). If something goes wrong in it, please report it (see Found a bug?).

Setup guide: https://github.com/sithewok13-dev/OpenJKDF2-iOS/blob/HEAD/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 v0.9-beta2

New since v0.9-beta1:

AUTO PLAY, a self-playing show (single player, both apps), for screen recordings: hold MENU and tap AUTO PLAY in the tray. Pick the levels (all of them, shuffled, or one), the difficulty, how big the crowds are, whether the enemies are alerted, the weapons, and whether the HUD and the touch controls show, then tap START. It saves your game first (Before AUTOPLAY), quietly switches sithewok on and plays by itself through the game's own controls, with a new lightsaber look each fight. Double-tap for a new fight. Touch and hold still for half a second, away from the screen's edges, to stop: your game, the cheat, the difficulty and your sabers are put back as they were.
AUTO PLAY fights with the lightsaber unless you pick other weapons: its WEAPONS start with only the LIGHTSABER. Touch and hold LIGHTSABER there to pick a look on the saber wheel, and the show keeps it for every fight (YOUR LOOK); you keep it afterwards too. Boss duels (Yun, Gorc and Pic, Maw, Sariss, Boc, Jerec) are fought to the end, for 4 minutes at most, and Kyle steers clear of ledges and drops (if he falls in a duel, he's put back).
Tap to skip a level's own scenes: the short scenes the game plays before a duel (Yun, Gorc and Pic, Maw, Sariss, Boc, Jerec; in Mysteries of the Sith the rancor, Abron and the last level) and at some levels' ends. Tap to skip shows as one starts: tap anywhere and the fight starts a moment later. The game plays the rest of the scene unseen and fast, so everything ends up as if you had watched it. Not in multiplayer or co-op. In these scenes Kyle (or Mara) now holds your own lightsabers.
SAVE and LOAD (were QUICK SAVE and QUICK LOAD): a tap opens the game's own Save or Load screen, and you're back in the game straight after. A hold (a third of a second, with a ring) still quick saves or quick loads, as before.
LAST WPN (top left, where FORCE WHEEL was): a tap goes back to the weapon you held before, and a second tap swaps back. Slide or hold it for the weapon wheel, as with NEXT WPN.
POWERS (was FORCE WHEEL) is now a small button beside FORCE, so picking a power and using it are both under your right thumb. It works as before: tap for the next power, slide or hold for the Force wheel. A touch between the two counts as FORCE, so a hurried press never changes your power.
FORCE shows just the power's name, as big as it fits (two-word names such as DEADLY SIGHT on two lines). With no power yet it says FORCE, dimmed, as before.
LIGHT, IR and BACTA look like the items themselves: the game's own pictures of the field light, IR goggles and bacta tank, made bigger and smoother from your game files. The lamp glows and the goggles' eyes light up red while they're on, and a lit one takes the place of the game's own small square at the top right. The tank's liquid shows how many tanks you carry, with the number on the tank, and glows brighter as you hold it. If the pictures can't be read from your files, the buttons show their names as before.
New in MENU's tray: RUN switches the game's Always Run on or off, LOOK sets how fast dragging turns the view (0.5x to 3x), OPACITY sets how see-through the touch controls are (20% to 100%), and AUTO PLAY opens the show. Hold FPS to switch between 60 frames a second (the default) and 120, on screens that can show 120. Under the tray, small text says which build you have (for example build 80 · Nov 9), the same number as at the top of this page.
LEVEL in cheat mode opens a list: tap it for every level by name, read from your own game files: Jedi Knight's levels 15 and 16 in both their light and dark side versions, and in Mysteries of the Sith the secret level once it's set up. Holding LEVEL still counts to a level, as before. In co-op, the host picks for everyone.
The Emperor greets you however you switch sithewok on: with CHEAT in the tray, by holding the CHEAT button, or by typing it. He stays quiet when you switch it off, and only speaks if you've added clips of your own (see Your own Emperor). An Emperor folder in your game files' folder (jk1 or mots) works too.
CROSS with FILM: a finer, rougher crackle and a sharper, ragged tip, and its side blades now light after the main blade, as in the films: about 0.8 seconds after it, both sparking on together. In first person a CROSS also stands more upright, so its tip no longer sits lower than the other blades'.
Two sabers in first person: where the blades cross, the nearer one is drawn over the other and their glows show through each other, instead of one blade looking cut or notched. A STAFF or an open FOLD held across the view sits a little further out than the other saber, so the two look apart rather than tangled, and with FILM a blade's glow is a little softer further from your eye.
WHITE with FILM has a softer, silver-blue glow, in your hand and thrown.
Enemy Jedi's sabers get FILM's look too (with FILM on): Yun, Gorc, Pic, Maw, Sariss, Boc and Jerec, and in Mysteries of the Sith the Sith statues and dark visions, each in its own colour.
The game's sound takes over from other apps' audio: music or a podcast playing in another app stops when the game's sound starts, instead of playing on underneath. The game still plays with the silent switch on.
Co-op follows the story more closely: everyone's weapons and Force follow the story as in single player (in Jedi Knight, no Force in levels 1 to 3, and the lightsaber from level 4), each level's stars come to everyone to spend on the Force powers screen, secrets count for the whole team, and killing innocents counts for whoever did it. Guests go straight to the level the host picks. The guide's new The Force in co-op section has the details: https://github.com/sithewok13-dev/OpenJKDF2-iOS/blob/HEAD/docs/ios/README.md#the-force-in-co-op
Fixes: with a gun in hand in first person, quick weapon switches right after drawing the saber could make the game read past the end of the gun's hand model (seen in co-op). It no longer does.

Added in v0.9-beta1 (if you're coming from v0.8-beta2):

A saber wheel with a card for each hand: each card has its own HILT button and a dot for each blade: tap a card (or a dot), then a colour. + 2ND SABER adds a saber in your left hand. SAME COLOUR and SAME HILT set both sabers at once. A controller or keyboard can do it all too. See The lightsaber: SABER below.
Four hilts, one per hand: NORMAL (the game's own), CROSS (Kylo Ren's crossguard saber, with a crackling hum), STAFF (Darth Maul's double-bladed saber) and FOLD (Dark Rey's folding double saber). Mix them, for example CROSS in one hand and STAFF in the other. Only the look and the sound change: hits and damage are the game's own, and a second blade doesn't hit anything.
FOLD folds and opens: with AUTO OPEN on (the default), it opens on your first swing and folds again 5 seconds after your last. Or tap SABER to flip it yourself (with a FOLD in each hand, a tap flips the right one and a double tap both). It opens with a whoosh and a heavy clunk, and folds with a lighter click.
A FILM look: a switch for blades like the films': the same width all the way, a white-hot core and a soft glow, at the game's own length. With FILM on, a CROSS is Kylo Ren's unstable blade: its edges crackle and flicker, and now and then it spits a small spark. Off to start.
A RANDOM button: tap the die on the saber wheel for new hilts and colours, or hold it for new colours only.
Saber Throw for Kyle (Jedi Knight): switch on SABER THROW on the saber wheel and Mysteries of the Sith's Saber Throw joins the Force wheel. It never uses your stars and never changes your path. Single player only, and on by itself while sithewok is on. See Saber Throw below.
Install and update from SideStore or AltStore: add this project's source once, then install and update both apps right there. See Install below.
The Emperor's voice clips no longer come with the app. Cheat mode is silent unless you add sound clips of your own, in a folder called Emperor in the Files app. See Your own Emperor below.
CLASSIC is the look to start with again (it was REFORGED in v0.8-beta2). If you picked REFORGED yourself, you keep it. If you never touched that switch, your sabers are CLASSIC now: to have REFORGED again, tap CLASSIC at the top of the saber wheel's middle.
Better in third person: a STAFF or an open FOLD is carried along his side, clear of his legs, and its back blade is kept out of his body in most swings. With a STAFF or an open FOLD as your one saber, the game's idle fidget (lifting the saber to look at it) no longer runs a blade through his head.
Multiplayer: other players on this release see your hilts, every blade's colour and a FOLD open or folded, and hear a CROSS crackle. Players on v0.8-beta2 see plain sabers, each in its first blade's colour.
Fixes: long Force power names (SABER THROW, DEADLY SIGHT, CHAIN LIGHT) now fit inside the round FORCE button instead of running under its ring. A rare crash is fixed: about one launch in a thousand, the game could crash when part of some models went off the edge of the view (Mysteries of the Sith's thrown saber, for one).

Added in v0.8-beta2 (if you're coming from v0.8-beta1):

Join games hosted by the original 1997 Jedi Knight (JK.EXE on a PC), for example a community game night. In Join Game, type the host's address (numbers or a name) and tap Join. If that address has several games, a list shows each one's name, level and players: pick one. The app asks your router to open the ports it needs (TCP 2300 and UDP 2350) while you play, or you can forward them by hand. It needs Wi-Fi, not mobile data. Experimental: it has only been tried against a stand-in on a test computer, never against a real PC game or a real router. Jedi Knight only (not OpenMoTS), and joining only. See Joining a game of the original 1997 Jedi Knight below.
Easier-to-read multiplayer menus: the text on the multiplayer screens sits on dark panels, brighter and with a dark outline, and a bar marks a list's chosen row. The host settings screens (and Advanced), which have the most small text, get it strongest: near-white text on darker panels. Everything is where it was.
New lightsaber colours (REFORGED): most colours now have a white-hot core in a haze of their colour, like the film blades. BLUE is the deep blue it was, and LIGHT BLUE is a new film-like sky blue, in place of the old pale one. YELLOW is the game's own yellow blade. GREEN is gone from Jedi Knight's wheel, because ORIGINAL there is the game's own green; OpenMoTS keeps GREEN. ORIGINAL is unchanged. See The lightsaber: SABER below.
CLASSIC or REFORGED: a switch in the middle of the saber wheel. CLASSIC is every colour exactly as in v0.8-beta1, green included (REFORGED was the default in v0.8-beta2; CLASSIC is now). A controller's L3 or the keyboard's 4 flips it too, with the saber wheel open. It changes how your device draws every saber, other players' too. In Jedi Knight, a green you kept shows as ORIGINAL while REFORGED is on, and other players see it as ORIGINAL too.
The cheat's level pick has moved to a LEVEL button in MENU's hidden tray, right after CHEAT, shown only while sithewok is on. Hold it to count, lift to go to that level, slide off to cancel. DUCK is a plain crouch again, so crouching behind cover can't take you to another level by accident. See Cheats below.
Multiplayer stops its background work when you're not playing it: once a game ends, a join fails or a level doesn't load, and when you leave Join Game. Before, it kept running until you closed the app.
Fixes: a controller no longer does anything while a wheel you opened by touch or with the keyboard is open (no menu, quick save or quick load over it, and no button press going off after it closes). In multiplayer with this port's computer builds, you now see the computer players' saber colours, and their two sabers.

Added in v0.8-beta1 (if you're coming from v0.7), in both apps:

Multiplayer, up to four players: tap Multiplayer, then Host Game, Join Game or Resume Co-op. Games on the same Wi-Fi appear in the list by themselves, hosts you've joined before are remembered, and you can type an address for a friend elsewhere. If joining fails, it says why: a mistyped address, no game there, a full game or a wrong password. See Multiplayer and co-op below.
Co-op campaign in both games: play the story together, with shared objectives, each player keeping their own weapons and Force powers from level to level. The host's game saves the campaign at the start of every level, and Resume Co-op carries on later, even if someone dropped out.
Deathmatch and the original multiplayer games: Jedi Training, Jedi Capture the Flag, Sith Multiplayer Duel, Sith Lightsaber Training (saber-only, as in the original) and Kill the Fool with the Ysalamiri can all be hosted, and the Join list names each one.
Passwords: a game can have one, and a game with a password is encrypted. To play over the internet, the free Tailscale app is the easy way (see the setup guide).
Your saber in multiplayer: other players see your colours, and your two sabers if you chose two (in multiplayer the second one is for looks only). The host can also allow cheats (off unless ticked).
Game controllers: Xbox, PlayStation, Backbone and other controllers that work with iOS play the whole game, menus included, with the wheels on the bumpers and an options screen on Start. The touch buttons get out of the way while you use one. See Game controllers below.
Keyboard and mouse: WASD to move and the mouse to look, with keys for the wheels, the camera and quick save, as on a computer. On an iPhone, mouse look may not work (see Known limitations). See Keyboard and mouse below.
VIEW: a new button (switch it on in MENU's tray) that flips between first and third person with one tap.
CONTROLS: a new switch in MENU's tray that swaps the sides: the move stick on the right and FIRE and its buttons on the left.
Force Jump starts on STEPS on a new install. If you picked a style in v0.7, it's kept.
Two sabers at rest now hang casually, hands apart and a little low, keeping the middle of the view clear.
Saber Throw with two sabers (Mysteries of the Sith): each tap of FORCE throws one, and a thrown saber flies in its own colour.
Fixes: lightsaber blades no longer show a small nub near the tip, in first person especially.

Added in v0.7 (if you're coming from v0.6):

Force Jump by how long you hold: a new JUMP button in MENU's hidden tray picks how FORCE's hold works. SMOOTH (the default then): a tap is the lowest Force Jump, and the longer you hold, the higher it goes, up to the highest for your stars, with a gold ring filling inside FORCE so you can see how high you'll go. STEPS: the same heights in clear steps, with a tick at each. CLASSIC: the original game, where a quick tap is the highest jump. See Force Jump below.
Endless ammo with sithewok: every kind of ammo is filled to its most and refills as you fire, the battery for the field light and IR goggles too.
Typing sithewok switches the cheat on or off. Typed on, the CHEAT button appears; typed off, it goes away. There's no separate sithewok off any more.
SABER shows whenever Kyle has a lightsaber, however he got it. A lightsaber only the cheat gave still goes when the cheat goes off; one the story gave him stays.

Added in v0.6 (if you're coming from v0.5):

Lightsaber colours: a SABER button on the top row (once you have the lightsaber) opens a saber wheel of colours: the game's own (ORIGINAL) and many more (the colours changed in v0.8-beta2, see above). It changes only how your blade looks, in first and third person and in photos. See The lightsaber: SABER below.
Two sabers: choose two on the saber wheel (now with + 2ND SABER) and Kyle (or Mara) fights with a saber in each hand, each in its own colour. The second blade strikes too. In first person both arms move, and between fights the two sabers settle into a few natural resting stances, with a faint shimmer on each blade.
Cheat mode: a CHEAT switch in MENU's hidden tray. Switched on, a red Sith emblem button appears on the top row and sithewok goes on. Hold the emblem for half a second to switch the cheat off or on again. See Cheats below.
New cheat powers while sithewok is on: hold JUMP to fly, hold ACT for noclip (through walls), and pick any level (since v0.8-beta2 with LEVEL in MENU's tray, no longer by holding DUCK). Falls never hurt, the Force catches you if you drop into a pit, and the cheat now stays on through new levels and loaded games, keeping your weapon and Force power.
Action Freeze: slide down off CAMERA and the game stops exactly where it is, blaster bolts and explosions in mid-air. Turn the camera round with one finger, move and zoom it with two, then take your photo. See Action Freeze below.
The cinematic burst: slide up off CAMERA for five photos as the camera sweeps round the action (a duel, a boss, a blast), then the game carries on.
Selfies of 1, 3 or 5 photos (3 by default), each one posed afresh. Kyle sometimes shows off his gun or saber, and now and then something unexpected happens: someone points at something, someone didn't notice the photo, or a passer-by photobombs.
MENU's tray is rearranged: GYRO, FPS, CAMERA, CHEAT and the keyboard. Tap GYRO to switch tilt aiming on or off; hold GYRO for its MODE and SENS. Hold CAMERA for PHOTO, SELFIES and FREEZE. See MENU's hidden tray below.
CAMERA shows from the start on a new install (switch it off in the tray if you don't want it).
BACTA needs a short hold (a third of a second, with a ring) so a stray touch can't waste a bacta tank.
Fixes: a saber put away quickly could stay lit on the next weapon (a gun with a giant blade). The blue blade looked white: it's properly blue now. A level-count message could switch the cheat off by mistake.

Added in v0.5 (if you're coming from v0.4):

The selfie camera: hold the camera button and the whole game freezes. Everyone nearby turns to the camera and strikes a pose, you hold the phone out, the flash goes off, and then everything carries on exactly as it was. Tap the same button for ordinary photos of your game, or slide off it for a burst, all straight into your Photos app.
Easier-to-read mission text: the game's messages appear just below the top row of buttons instead of behind them, a third bigger, and long lines wrap between words.

Added in v0.4 (if you're coming from v0.3):

Mysteries of the Sith, in its own app: OpenMoTS. The same engine and the same touch controls as Jedi Knight, in a second app with its own icon and its own folder in the Files app, so it installs next to OpenJKDF2 and keeps its files and saves apart. Its Force wheel and weapon wheel show Mysteries of the Sith's own Force powers and weapons, and the sithewok cheat works there too. See Mysteries of the Sith: the OpenMoTS app below.
Both apps find your game files in more places. The recommended place is still the game folder the app makes (jk1 in OpenJKDF2, mots in OpenMoTS). But the apps now also find the files straight in the app's own folder in the Files app (OpenJKDF2 or OpenMoTS), or in a folder inside it, such as one made by unpacking a .zip. If your files are already in jk1, nothing changes.

Added in v0.3 (if you're coming from v0.2):

A cheat of this build's own, sithewok: everything at once (all weapons and ammo, every item, every Force power at 4 stars, full health and shields, and invincibility) and a Force meter that never drains. Careful: in Jedi Knight it can decide your story path. See Cheats below.

Added in v0.2 (if you're coming from v0.1):

A weapon wheel on NEXT WPN: every weapon at once, with its ammo count, so you can pick the one you want. A quick tap still switches to the next weapon.
Tap, swipe or long-press on FORCE WHEEL and NEXT WPN (see Tap, swipe or long-press below). Changed: a quick tap on FORCE WHEEL now selects your next learned Force power (in v0.1 it opened the wheel: long-press it instead), and NEXT WPN switches weapon when you lift your finger.
Force power levels on the Force wheel: four stars under each power you've learned, one gold star per level.
Tilt aiming (gyro): aim by turning the phone, on top of dragging. It's off until you switch it on in MENU's hidden tray (hold MENU), which now holds SENS, GYRO, FPS and the keyboard.
QUICK LOAD needs a much shorter hold: about a third of a second, the same as QUICK SAVE, with the same safety rules. Neither works while the cheat typing line is open.
FORCE sits a little further from the buttons along the top, so a thumb reaching for FORCE won't land on QUICK SAVE, QUICK LOAD or MENU.

Still here from v0.1: the floating move stick with its run marker, drag to look, FIRE / ALT / DUCK / ACT / JUMP / FORCE, the Force meter ring, LIGHT / IR / BACTA item buttons, a HUD that fits rounded and notched screens, tap to skip cutscenes, and the sound fixes. Still based on OpenJKDF2 0.9.9 (upstream as of September 2026).

How to play: every control explained

The touch controls appear once you're playing a level, and hide in menus and cutscenes (there you just tap, like clicking with a mouse). The game runs in landscape, either way round. Both apps have the same controls. What's different in Mysteries of the Sith (its wheels and cheats) is in Mysteries of the Sith: the OpenMoTS app below.

 NEXT   LAST    LIGHT  IR  BACTA  CAMERA  SABER  CHEAT  VIEW  (FPS)  SAVE   LOAD   MENU
 WPN    WPN     (the items' own pictures,
                 only items you have)
      [GYRO] [RUN] [LOOK] [OPACITY] [FPS] [CAMERA] [AUTO PLAY] [CHEAT] ([LEVEL]) [VIEW] [JUMP] [CONTROLS] [keyboard]
                  (MENU's tray, when held; LEVEL only while sithewok is on)
                                build 80 · Nov 9            (which build this is, under the tray)
                             [MODE] [SENS]             (GYRO held in the tray)
                             [PHOTO] [SELFIES] [FREEZE] (CAMERA held in the tray)
                             [====o=========]          (OPACITY tapped in the tray)
                                                       POWERS
                                                       (small)
      (^^)  run marker                              JUMP   FORCE
       |                                     ACT
     ( o )  move stick: appears                            ALT
            under your left thumb         DUCK     FIRE
                                                         [ammo gauge]

Exact positions shift a little to fit your screen, the camera cutout and the HUD. Buttons are slightly see-through until you touch them. SABER shows once you have the lightsaber, and CHEAT only in cheat mode (see Cheats). Where the top row gets crowded, the FPS counter moves to the bottom middle of the screen.

The camera: selfies, photos, bursts and Action Freeze

CAMERA (the camera symbol) sits in the middle of the top row. It's there from the start; to hide it (or show it again), hold MENU and tap the camera symbol in the tray. The first time you use it, iOS asks whether the app may add photos to your library: say yes, and the photos go straight into your Photos app. The game holds still while iOS asks. The app can only add photos; it can't see the ones already in your library.

What CAMERA does depends on how you touch it:

Gesture	What it does
Hold still (half a second, a ring fills)	A selfie (1, 3 or 5 photos).
Tap	A photo of the game.
Slide off sideways	A burst: a photo every fifth of a second while your finger stays down.
Slide down (a long slide)	Action Freeze: stop the game and move the camera round it.
Slide up (towards the top edge)	The cinematic burst: five photos as the camera sweeps round the action.

With FREEZE switched off (in CAMERA's options, below), a slide in any direction is a burst.

Selfies: hold CAMERA still for half a second.

The whole game freezes, enemies and bosses included, and the HUD and touch buttons hide.
The view switches to the phone, held out at arm's length and facing you. Up to 8 people near you, in sight, turn to it and strike a random pose: wave, fist up, hand on hip, point, flex, salute, hands behind the head, victory sign, shrug, hand on the chin or the heart, arms crossed, an arm round a neighbour, and more. Some of the front row kneel on one knee or crouch, some turn three-quarters to the camera or lean, and now and then a whole group strikes the same pose like a team photo. Droids and creatures just turn to face the camera.
You (Kyle, or Mara Jade in her levels of Mysteries of the Sith) hold the phone out in your right or left hand and strike a pose with the other, looking toward the lens. Sometimes you show off your gun or lightsaber instead. The camera angle changes from shot to shot: sometimes a little higher or lower, sometimes slightly tilted.
Now and then something unexpected happens: someone points at something, someone hasn't noticed the photo, someone stares, or a passer-by photobombs.
1, 3 or 5 photos: a selfie takes 3 unless you change it with SELFIES in CAMERA's options. Everyone poses afresh for each one, and the game stays frozen the whole time.
The flash lights everyone up, and shots or blasts flying in front of someone's face are left out of the photo.
After the flash and the shutter, the photo stays on screen for a moment. Then everyone goes back to exactly what they were doing, and the game carries on. A selfie changes nothing in your game.
Nobody nearby? It's a selfie of you alone. If people are spread out too far to fit in one photo, the ones furthest away are left out.
Selfies are always clean photos (... selfie.png), whatever PHOTO is set to.
When it can't: if there's no room to hold the camera out (right up against a wall), or the game is showing a cutscene, a scope or another camera, or you're dead, it says Can't take a selfie here. If the last photos are still being saved, it says Still saving the last photo: try again in a moment. While the typing line is open, holding CAMERA does nothing (a tap still takes a photo).

Photos and bursts:

Tap CAMERA: a white flash, the camera's shutter sound, and the photo. A line at the top of the screen says when it's saved (1 photo saved).
Burst: touch CAMERA and slide your finger off it sideways (a short slide is enough). The app takes a photo every fifth of a second for as long as your finger stays down, up to 10, with a quick tick for each and a counter beside the button. Lift your finger to stop. Burst photos are always clean ones, without the HUD.

Action Freeze (new in v0.6): touch CAMERA and slide your finger down, further than for a burst.

The game stops exactly where it is: blaster bolts, explosions, flying debris and everyone mid-move. The buttons hide, apart from CAMERA, and an X appears at the top right.
One finger turns the camera round what it's looking at. Two fingers move it, and pinch to zoom in or out.
The camera stays out of walls, closed doors and lifts. If it can't go somewhere, it stops. Close to a wall it moves in a little, and glides back out when there's room.
Tap CAMERA to take a clean photo, as many as you like. Tap the X to go back to the game, which carries on from exactly the same moment.
If it can't freeze (a cutscene, a scope, while dead), it says Can't freeze here.

The cinematic burst (new in v0.6): touch CAMERA and slide your finger up. Reaching near the top edge of the screen is enough.

The game freezes for a moment and the camera takes five photos as it sweeps round the action, then the game carries on by itself.
The first photo is exactly what you saw. The other four go round the most interesting thing in front of you: someone you're fighting, a shot in flight or an explosion. In a duel or a boss fight, you and your opponent are both in the shots, seen from the side. With nobody around, it goes round you.
The sweep picks the side with the most room, so the camera doesn't end up inside a wall or behind someone. In a cramped spot it sweeps less, or just zooms in.

CAMERA's options: open the tray (hold MENU), then touch and hold the camera symbol in the tray until its ring fills. A row opens under the tray with three buttons:

PHOTO: what a tap takes. Tap PHOTO for its three tick boxes: CLEAN (just the game, no gauges or buttons: ticked unless you change it), HUD (the game with its health and ammo gauges) and HUD+BTNS (with the touch buttons too, as you see the screen). At least one stays ticked. If you tick more than one, each tap of CAMERA takes one photo of each, all of the same moment.
SELFIES: how many photos a selfie takes: 1, 3 (the default) or 5. Each tap goes on to the next.
FREEZE: ON (the default) or OFF. Off, sliding CAMERA down or up is just a burst, as before v0.6.
Touch anywhere else to close the row and the tray.

Where the photos go:

Photos are full-screen PNGs, named after the app and the time, for example OpenJKDF2 2026-10-12 14.05.09 clean.png (a burst's are numbered: ... burst 01.png). In Mysteries of the Sith they start with OpenMoTS.
If Photos access is off (you said no, or turned it off in Settings), the photos go to the Files app instead, in OpenJKDF2 > Screenshots (or OpenMoTS > Screenshots), and the message says so. To use the Photos app again: Settings > Privacy & Security > Photos, then the app, then Add Photos Only.

Moving, running and Always Run

Move: put your left thumb down anywhere on the left side of the screen (a bit less than half of it). The stick appears right under your thumb and disappears when you lift it. It walks at the same speed however far you push it.
Run: a small circle with ^^ in it sits above the stick, joined to it by a line. Push your thumb up past the stick's ring onto that circle to run straight ahead. It lights up blue and you feel a light tap. It doesn't lock: slide back down and you walk again, lift and you stop.
- If your thumb lands near the top of the screen, the circle sits closer to the stick, and if there's no room at all, there's no circle that time.
Always Run: to run all the time, in every direction, turn on the game's own Always Run option: tap RUN in MENU's tray (or tap MENU, then Setup > Controls > Options). While it's on, the ^^ circle goes away (you're always running anyway), and there's no way to walk slowly until you turn it off again. Turn it off and the circle comes back.

Looking and aiming

Drag to look: drag anywhere else on the screen, which mostly means the right side. LOOK in MENU's tray sets how fast it turns.
Dragging on FIRE, ALT, DUCK, ACT, JUMP or FORCE also turns the view, so if your thumb lands on one while you're aiming, just keep dragging. You can hold FIRE and aim with the same thumb.
You can also aim by turning the phone: see Tilt aiming below.

Buttons

Button	Where	What it does
FIRE	bottom right, the big one	Fires your weapon, for as long as you hold it.
DUCK	left of FIRE	Crouches while held (only ever a crouch, in cheat mode too).
ACT	up and left of FIRE	Activate: doors, switches, elevators, consoles.
JUMP	above FIRE	Jumps.
ALT	up and right of FIRE, above the ammo gauge	Secondary fire (each weapon's second mode).
FORCE	right of JUMP (or above it on smaller screens)	Uses your selected Force power, and shows just its name (FORCE, dimmed, until you have one). See The FORCE button and the Force meter below.
NEXT WPN	top left	Tap: next weapon. Slide or hold: the weapon wheel.
LAST WPN	top left, right of NEXT WPN	Tap: back to the weapon you held just before; tap again to swap back. Dimmed until you've changed weapon once (or while that weapon is gone or out of ammo). Slide or hold: the weapon wheel, as with NEXT WPN. A Saber Throw doesn't count as a change, and loading a game or starting a level starts it afresh.
POWERS (the Force wheel button)	small, beside FORCE (above it or next to it, wherever it fits; under MENU on the smallest iPhones)	Tap: next learned Force power. Slide or hold: the Force wheel. A touch in the gap between it and FORCE counts as FORCE, so a hurried press on FORCE never changes your power.
LIGHT, IR, BACTA	top left, after LAST WPN	The game's own pictures of the field light, IR goggles and bacta tank, made from your game files. Tap LIGHT or IR to switch it on or off: the lamp glows, the goggles' eyes light up red, and they're dimmed while off. A lit one takes the place of the game's own small square at the top right. Hold BACTA for about a third of a second to use a tank: the liquid glows brighter from the bottom up as you hold, then drops a step with a light tick (at full health nothing is used). One per press, and a tap or a brush past uses none. The liquid and the number on the tank show how many you carry; after your last one, the empty tank fades away. Each button only appears once you have that item, always in the same spot. If the pictures can't be read from your game files, the buttons show their names instead (yellow while on, and BACTA with a ring as you hold).
SAVE	top right	Tap: the game's own Save screen. Hold for about a third of a second (a ring fills): quick save. See SAVE and LOAD below.
LOAD	top right	Tap: the game's own Load screen. Hold for about a third of a second: quick load.
MENU	top right corner	Tap: the game's menu (objectives, map, Jedi powers, save, load, setup). Hold: the hidden tray.
CAMERA (the camera symbol)	top, in the middle	Hold still: a selfie. Tap: a photo. Slide sideways: a burst. Slide down: Action Freeze. Slide up: the cinematic burst. See The camera above.
SABER (your sabers)	top, right of CAMERA (once you have the lightsaber)	The saber wheel: one saber or two, each hand's hilt, each blade's colour. With a FOLD in your hand, a tap flips it instead (one in each hand: a tap flips the right one, a double tap both). See The lightsaber: SABER below.
CHEAT (the Sith emblem)	top, right of SABER (cheat mode only)	Hold for half a second: `sithewok` off or on. Red while it's on. See Cheats below.
VIEW (1P or 3P)	top, right of CHEAT (once switched on in MENU's tray)	Tap: first person or third person, at once.

FIRE, ALT, DUCK, ACT, JUMP and FORCE act as soon as you touch them. LIGHT, IR, MENU, SAVE, LOAD, CAMERA and the tray buttons act when you lift your finger (SAVE and LOAD, held, quick save and quick load instead), so if you touch one by mistake, slide off before you lift (on CAMERA, a slide starts a burst or Action Freeze instead: see The camera above). BACTA and CHEAT need a hold, so a brush past does nothing. NEXT WPN, LAST WPN and POWERS act on a quick tap when you lift, or open their wheel when you slide or hold. SABER opens its wheel however you touch it, but with a FOLD in your hand a quick tap flips the FOLD (slide or hold to open the wheel). While sithewok is on, JUMP and ACT show a small red second line (FLY, NOCLIP) for their cheat holds: see Cheats below.

MENU's hidden tray

Tap MENU for the game's menu, as before. Hold MENU until its ring fills (about half a second) and a small tray opens just under it with these buttons, from left to right (LEVEL only while sithewok is on; in co-op, only for the host). Just under the tray, small dim text shows which build you have (for example build 80 · Nov 9), the same number as at the top of the release page.

Tray button	What it does
GYRO	Tap: tilt aiming on or off (it comes back on in the mode you last used: TOUCH the first time). Lit yellow while it's on. Touch and hold until its ring fills: a row under the tray with MODE (TOUCH or ALWAYS) and SENS (1.0x, 1.5x, the default, 2.0x or 3.0x). See Tilt aiming below.
RUN (the run marker, `^^`)	Tap: the game's own Always Run option on or off (the same as in its control options). Lit yellow while it's on: then the stick always runs and has no run marker.
LOOK	How fast dragging turns the view, shown on the button (LOOK 1x). Each tap goes up a step: 0.5x, 0.75x, 1x (the default), 1.25x, 1.5x, 2x, 2.5x, 3x, then round to 0.5x; the tray stays open. Touch and hold until its ring fills: back to 1x.
OPACITY	How see-through the touch controls are (OPACITY 100%, the default). Tap: a slider opens under the tray, from 20% to 100% in 5% steps, and the controls change as you slide; it's kept when you lift. Tap OPACITY again, or touch anywhere else, to close it. Touch and hold: back to 100%. The tray, the wheels and the FPS counter always stay at full strength.
FPS	Tap: shows or hides a frame-rate counter, to the left of SAVE (yellow while it's on). Touch and hold until its ring fills: 60 frames a second (the default) or 120, on screens that can show 120. The button shows which (FPS 60).
CAMERA (the camera symbol)	Tap: shows or hides the CAMERA button (yellow while it's shown). Touch and hold until its ring fills: CAMERA's options, PHOTO, SELFIES and FREEZE. See The camera above.
AUTO PLAY (single player)	Opens the panel for AUTO PLAY, a self-playing show: see AUTO PLAY below.
CHEAT	Cheat mode on or off. On: the CHEAT button appears and `sithewok` goes on. Off: `sithewok` goes off and the button goes away. Yellow while cheat mode is on. See Cheats below.
LEVEL (only while `sithewok` is on; in co-op, only for the host)	Tap: a list of the game's levels, numbered in order, each with its name and file (read from your own game files). Jedi Knight's levels 15 and 16 have a light and a dark side version, and both are listed: the one you tap goes on along its own path. In Mysteries of the Sith, the last row is Bonus, the secret level, once it's set up. Tap a level to go there, or tap the X or anywhere off the list to close it. Hold to count instead: after half a second it shows LEVEL 1, then counts up one every 0.4 seconds, with a tick each and Level 7 of 21 on the message line; lift to go to that level, slide off to cancel. See Cheats below.
VIEW	Shows or hides the VIEW button on the top row (yellow while it's shown). Tap VIEW to switch between first person (1P) and third person (3P) at once. The app remembers both; hiding the button keeps the view you picked. The game's own idle camera still swings round to show you after 30 seconds without a touch, and goes back to your view when you play on.
JUMP	How Force Jump works: STEPS (the default), SMOOTH or CLASSIC. Each tap goes on to the next, and the tray stays open. See Force Jump below.
CONTROLS	NORMAL (the default): the move stick on the left, FIRE and its buttons on the right. SWAPPED: the other way round, the move stick where your right thumb lands and FIRE, ALT, DUCK, ACT, JUMP and FORCE mirrored to the left. Takes effect at once, the tray stays open, and the app remembers it. The top row stays as it is.
Keyboard (the keyboard symbol)	Opens the game's typing line with the iPhone keyboard, for cheats. Tap it again to close the line.

GYRO, LOOK, OPACITY, FPS, JUMP and CONTROLS show their setting on the button (for example GYRO OFF, OPACITY 60%), and MODE and SENS show theirs.
Either keep your thumb down, slide it onto a tray button and lift, or lift first and then tap one. Anywhere on the tray's dark backing counts as the nearest button.
Each tap on LOOK, JUMP, CONTROLS, MODE or SENS goes on to the next setting, and the tray (or row) stays open so you can tap again. The tray closes after FPS, CAMERA, AUTO PLAY, CHEAT, VIEW or the keyboard, after LEVEL takes you to a level, or when you touch anywhere else. That touch still counts: touching FIRE closes the tray and fires. Touching MENU again only closes it.
If you slide off MENU while holding it, nothing happens.
While the tray is open, the game's messages (such as LEVEL's count) show just under it, clear of the buttons.
The app remembers GYRO, SENS, LOOK, OPACITY, FPS (the counter and the 60 or 120), CAMERA and its options, CHEAT, VIEW, JUMP and CONTROLS next time you open it (RUN is the game's own setting, saved with it). The sithewok cheat itself always starts off when you open the app: hold the CHEAT button to switch it on.
On smaller screens (camera cutout on the right, Display Zoom, a large HUD Scale) the tray sits further left, so it stays clear of FORCE and the buttons around FIRE.

AUTO PLAY: a self-playing show

New in this release, single player, both apps. Hold MENU and tap AUTO PLAY in the tray: a panel opens with seven rows, all remembered:

LEVELS: SHUFFLE ALL (every level once in a shuffled order, then again) or PICK ONE from the list of levels.
DIFFICULTY, CROWD (1x, 2x or 3x: copies of the enemies near the fight, of kinds the level has at least two of, up to a limit) and ALARM (everyone near woken at once).
WEAPONS: the weapon wheel's weapons, in their colours. It starts with only the LIGHTSABER. Touch and hold LIGHTSABER (a ring fills, half a second) to pick its look on the saber wheel: the show then keeps that look for every fight (the tile says YOUR LOOK), and you keep it afterwards. Tap LIGHTSABER once to go back to a new look each fight.
HUD (the game's HUD shown or not) and CONTROLS (the move stick and lit buttons drawn as they're used, just to see, or nothing).

Tap START. The game is saved first (Before AUTOPLAY), sithewok goes on quietly for the show (and the Emperor stays quiet), and a level loads straight in. One of its groups of enemies is picked, Kyle (or Mara) is put nearby with a clear view, and he fights by himself, through the game's own controls: turning, aiming, moving, firing in bursts, changing weapons in the lulls, throwing detonators at groups, saber swings and Saber Throw, and Force powers now and then. Each fight has a new lightsaber look (unless you picked YOUR LOOK). When a group is down, more come from out of sight. A finished level goes on to the show's next one, never a cutscene, and a level's own scenes are skipped. Boss duels are fought to the end, for 4 minutes at most.

Double-tap anywhere: a new fight.
Touch and hold still for half a second, away from the screen's edges: stop. Your saved game loads, and the cheat, the difficulty and your sabers are as they were before.

Tilt aiming (gyro)

Turn and tilt the phone to aim, on top of dragging. It starts switched off. Hold MENU and tap GYRO to switch it on or off. To choose between TOUCH and ALWAYS, or change the sensitivity, hold GYRO in the tray until its ring fills, then tap MODE or SENS:

GYRO OFF (the default): no tilt aiming. The app doesn't read the motion sensor at all.
GYRO TOUCH: turning the phone aims while either thumb is touching the game: your left thumb on the move stick (even resting without moving), or your right thumb on the look area or on FIRE, ALT, DUCK, ACT, JUMP or FORCE. So with your left thumb on the stick, hopping your right thumb onto FIRE doesn't interrupt aiming. To move the phone back to a comfortable position, lift both thumbs: the view stays exactly where it is, like lifting a mouse off the desk, and carries on from there when you touch again. The buttons along the top don't count.
GYRO ALWAYS: turning the phone always aims, with or without a thumb down.

Good to know:

The view never springs back. There's no "straight ahead" position: however you hold the phone when you start is where you start from.
Turning left and right works however far back you tip the phone, even lying flat on a table. Tilting the top edge of the screen toward you looks up.
Tilt aiming pauses while a wheel, the cheat typing line or MENU's tray is open, and for a moment after you turn the phone round to the other landscape side.
The game's mouse sensitivity doesn't change it: use SENS (hold GYRO in the tray).
On a device without a motion sensor, GYRO says NO GYRO and does nothing.

Tap, swipe or long-press

POWERS, NEXT WPN and LAST WPN each have three gestures (the setup guide calls them tap, slide and hold). NEXT WPN and LAST WPN open the same weapon wheel:

Quick tap: lift within about a third of a second, without sliding. POWERS selects your next learned Force power, skipping ones you haven't learned (the FORCE button shows which you have now). NEXT WPN switches to your next weapon, and LAST WPN back to the one before (dimmed, a tap does nothing). No wheel opens.
Swipe (the quickest way to pick): touch the button and slide your thumb away. The wheel opens at once. Keep sliding towards a slot: a short slide in the right direction is enough. The slot pops out, its name shows in the middle, and you feel a light tap. Lift to select it.
Long press: touch and hold still for about a third of a second. A ring fills round the button, then the wheel opens and stays open. Lift, then tap a slot to select it. (Or, without lifting, slide out from the button to pick by sliding after all.)

Then:

The middle of the wheel tells you what lifting will do, for example lift to select, not learned yet, no ammo or lift to cancel.
To cancel while sliding: lift in the gap at the bottom of the wheel (marked cancel), in the middle of the wheel, or back where you started. Lifting on a power you haven't learned or a weapon you can't pick also cancels. A slide too short to point at anything leaves the wheel open for tapping.
To cancel a wheel that's open for tapping: tap anywhere that isn't a slot (the middle, the gap, outside the wheel, or the buttons at the top left). Tapping a power you haven't learned, or a weapon you can't switch to, does nothing and leaves the wheel open.
The game pauses while a wheel is open, so take your time.

The Force wheel

POWERS, the small button by FORCE, opens the Force wheel (see Tap, swipe or long-press above).

In Jedi Knight, every Force power always has the same slot, whether you've learned it yet or not (powers you haven't learned are grey):

Left side, blue: light side. From the top: Healing, Persuasion, Blinding, Absorb, Protection.
Across the top, gold: neutral. From the left: Jump, Speed, Seeing, Pull.
Right side, red: dark side. From the top: Throw, Grip, Lightning, Destruction, Deadly Sight.
On the wheel and the FORCE button, a few names are shortened: PERSUADE, PROTECT and DESTRUCT.
The gap at the bottom means cancel.
Saber Throw (new in this release, with SABER THROW on in the saber wheel, or while sithewok is on): gold, at the very top, between Speed and Seeing. The slices get a little narrower to make room, so on most screens the stars are a little smaller, and so are the names DESTRUCT and DEADLY SIGHT. See Saber Throw below.
Stars (added in v0.2): under each power you've learned, a row of four stars shows its level, one gold star per level (a level 2 power shows two gold stars and two empty ones).

Once you've picked a power, use it with FORCE.

The weapon wheel

NEXT WPN and LAST WPN open it when you slide or hold them (added in v0.2). In Jedi Knight, every weapon always has the same slot, whether you've found it yet or not, in the order of the PC number keys, clockwise from the bottom left: Fists, Bryar Pistol, Stormtrooper Rifle, Thermal Detonator, Bowcaster, Repeater, Rail Detonator, Sequencer Charge, Concussion Rifle, Lightsaber. The gap at the bottom means cancel.

Colours show the kind of ammo: gold for the fists and the lightsaber (no ammo), blue for energy cells, green for power cells, red for explosives.
Ammo counts: under each weapon you have, its ammo shows, the same number the HUD shows with that weapon in hand. Weapons that share ammo show the same number. The fists and the lightsaber show no count.
Grey, with no count = you haven't found it yet.
Dark in its own colour, with its count (usually 0) = you have it but can't fire it, so it can't be selected. The bowcaster needs at least 2 power cells and the concussion rifle at least 8, as in the game. Thermal detonators and sequencer charges are their own ammo, so with none left they show as not found.
The weapon in your hand has a white edge.
If you pick a weapon while the game is still in the middle of switching, it switches as soon as the game is ready. That includes the weapon you're putting away: pick it to switch straight back.

The lightsaber: SABER

New in v0.6, and rebuilt in this release. Once you have the lightsaber (or while sithewok is on), a SABER button appears on the top row. Its picture shows your sabers as they are: each in its hilt's shape and each blade in its colour, two crossed in an X when you hold two.

Tap or hold SABER to open the saber wheel, then tap a colour, or slide off SABER towards a colour and lift. The gap at the bottom cancels, and the game holds still while the wheel is open. With a FOLD in your hand, a tap on SABER flips it (open or folded) instead. With a FOLD in each hand, a tap flips the right one and a quick second tap the left one too. A slide, or a short hold until its ring fills, still opens the wheel. While the saber wheel is open, FIRE and the buttons round it are hidden to make room; the buttons along the top stay.

A card for each hand:

Beside the colour ring there's a card for each hand: RIGHT, and with two sabers LEFT. Each shows that hand's colours and has its own HILT button.
Tap a card to choose which hand the ring paints (its edge turns gold), then tap a colour. The line under the colour's name, in the middle of the wheel, says where it goes, for example colour for the right saber.
Each blade has its own colour. A card shows a dot for each blade: one for NORMAL and CROSS, two for STAFF and FOLD. A new STAFF or FOLD starts with both blades the same (two joined dots). Tap the second dot, then a different colour, and the dots split, each blade with its own colour. Tap the card itself to paint the whole saber again.
HILT on a card changes only that hand's saber. Each tap goes on to the next: NORMAL (the game's own saber), CROSS (Kylo Ren's crossguard saber), STAFF (Darth Maul's double-bladed saber) and FOLD (Dark Rey's folding double saber), then round again.
One saber or two: with one, there's only the RIGHT card, and a dashed + 2ND SABER box where the LEFT card goes: tap it for a second saber in your left hand. With two, tap the small x at the top right of the LEFT card to go back to one.
SAME COLOUR and SAME HILT, two switches under the LEFT card (with two sabers): with SAME COLOUR on, a colour goes to every blade of both sabers; with SAME HILT on, HILT changes both sabers. Both start off.

The rest of the wheel:

The colours: ORIGINAL (the game's own, unchanged: green in Jedi Knight, orange in Mysteries of the Sith), red, crimson, orange, amber, yellow, lime, green, teal, cyan, light blue, blue, purple, magenta, pink, white, and black with a bright edge.
CLASSIC or REFORGED, at the top of the wheel's middle (above the colour's name), picks how every colour looks. Tap it to switch: the wheel and the blade in your hand change at once.
- CLASSIC (the default): every colour's earlier look, with GREEN on the wheel in both games. If you picked REFORGED before, you keep it.
- REFORGED: most colours glow like the film blades, a white-hot core in a haze of colour. BLUE is the deep blue, LIGHT BLUE a film-like sky blue, and YELLOW the game's own yellow blade. In Jedi Knight there's no GREEN on the wheel, because ORIGINAL is the game's own green.
- It changes how your device draws every saber, yours and other players'. In Jedi Knight, a green you kept shows as ORIGINAL while REFORGED is on, and other players see it as ORIGINAL too. Switch to CLASSIC and it's green again.
FILM, a switch under the RIGHT card, picks the blade's shape. Off (the default): the game's own blade, which narrows to a point. On: a blade as in the films, as long as the game's own, the same width all the way with a rounded end, a white-hot core and a soft glow in its colour. It works with every colour and hilt, in both looks, in first and third person, in Action Freeze, and on a thrown saber. Hits are the same either way.
AUTO OPEN, a switch under FILM, shows only while you hold a FOLD (see FOLD below).
RANDOM (a small die), under the RIGHT card's switches: tap it and every saber you hold gets a different hilt and a different colour. Hold it for about a third of a second (a gold ring fills) for new colours only, the hilts kept. With SAME HILT or SAME COLOUR on, both sabers get the same. It never changes how many sabers you hold, or any switch.
SABER THROW (Jedi Knight only), a switch at the top right of the wheel: see Saber Throw below.
EQUIP, in the middle of the wheel, closes it and puts the lightsaber in your hand. It's dim while you don't have the saber.
Every tap on a card, a dot, HILT, a switch or RANDOM gives a small tick and leaves the wheel open, so you can set everything in one go. Close it with the gap at the bottom, or tap an empty spot. The app remembers your sabers, colours and switches.

The hilts:

STAFF and FOLD have a blade out of each end of the hilt, each in its own colour. The second blade is only for looks: it doesn't hit anything.
FOLD folds its two halves side by side, or opens into a staff. It lights up folded.
- AUTO OPEN on (the default): it opens on your first swing and folds again 5 seconds after your last. Two FOLDs open and fold together.
- AUTO OPEN off: it only changes when you flip it, and stays as you left it, across levels and loads.
- To flip it yourself: tap SABER, or pick the lightsaber again on the weapon wheel. Your flip always wins over AUTO OPEN. With a FOLD in each hand, a tap on SABER flips the right one and a double tap both (two open ones fold, one open and one folded swap); the weapon wheel flips both.
- Its sounds: opened by hand, a whoosh as the second blade swings out, then a heavy clunk as it locks. Opened by AUTO OPEN, your swing and the clunk. Folding, a lighter click, so you can tell the two apart.
- A thrown FOLD flies the way it left your hand (a folded one snaps open just after the throw).
CROSS: a jagged blade that crackles and comes to a point, two short blades out of small vents either side of the top of the hilt, and a strong glow in the blade's colour. Its hum is rougher and lower than a plain saber's, made from the game's own saber sounds. Between swings, Kyle (or Mara) carries it low at the side, the blade angled down and out. With FILM on, it's Kylo Ren's blade as the films show it: FILM's white-hot core and glow, narrowing to a small soft point, its edges crackling and its width flickering, and now and then it spits a small spark. The short side blades don't hit anything.
Mixed pairs: with two sabers each arm holds its own saber its own way: a CROSS low at the side, a STAFF or open FOLD along his side as a staff, a NORMAL in the usual two-saber stance.
Two sabers fight for real: the second blade strikes, deals damage and throws sparks like the first. In first person both arms move, and between swings he holds the two sabers casually, hands apart and a little low, the middle of the view clear, now and then shifting his guard; the longer he stands still, the more restless he gets. Kyle has no new animations, so in his two-handed swings the blades come from nearly the same place.
Only the look changes: the saber's damage, your saves and the levels are untouched. Your sabers show in first and third person and in Action Freeze.
A lightsaber that only sithewok gave you goes away again when the cheat goes off (see Cheats). One the game gave you stays.

Saber Throw:

In Mysteries of the Sith it's the game's own Force power. A thrown saber flies with its hilt, its colours and FILM. With two sabers, each tap of FORCE throws one: the right saber first, then the left (at least a quarter of a second later, on a slightly different path). Mara fights on with the one still in her hand, each saber comes back to its own hand, and with both thrown she's on her fists until one comes back, as in the original. With one saber, Saber Throw is exactly the original.
SABER THROW (new in this release, Jedi Knight only), a switch at the top right of the saber wheel, gives Kyle Mysteries of the Sith's Saber Throw. It's off to start, and the app remembers it.
- On: Saber Throw is on the Force wheel, at the top between Speed and Seeing. Pick it there and use it with FORCE. Kyle throws his saber, which spins out, hits whatever it meets and flies back to his hand. He's on his fists until it's back, and it's back within 5 seconds whatever happens. With two sabers, each tap of FORCE throws one, the right first.
- Stars: it follows Kyle's Jedi rank (one star for every two ranks) and never uses your stars: your powers, your light or dark side and the ending stay as they were.
- Force: 100, 80, 60 or 40 at one to four stars, and a full Force meter always throws. It needs the lightsaber: without one, it's dimmed.
- While sithewok is on, Saber Throw is on the wheel at four stars even with the switch off, and costs no Force. It's never in multiplayer or co-op.

The FORCE button and the Force meter

FORCE uses your selected Force power for as long as you hold it: tap for a single use, hold for powers that charge up (Force Jump) or keep going (Lightning).
The button shows just the name of the power it will use (for example SPEED), as big as it fits inside the ring, two-word names such as DEADLY SIGHT on two lines. Until you have a power it says FORCE, dimmed.
The blue ring around FORCE is your Force meter. It follows the game's meter live: it shrinks as you use the Force, disappears when the meter is empty, and grows back as the meter refills. When the meter is full, the ring glows and gently pulses.
The ring and the HUD's Force bar (in the gauge at the bottom right, next to the ammo count) show the same meter, but on different scales. The ring is full at your current maximum, which rises with your Jedi rank. The HUD bar is only full at the top rank. So early on, the ring can be full and glowing while the HUD bar isn't. Before your first Jedi rank there's no ring.
Pick a power with POWERS, the small button beside FORCE (tap for the next one, or open the wheel).

Force Jump

Force Jump jumps when you lift your finger off FORCE, and how long you held it decides how high. It has 4 levels (the stars on the Force wheel): each star raises the highest jump, and gives you a little longer to reach it (0.35 s a star, so 1.4 s at 4 stars). Choose how holding works with JUMP in MENU's tray:

SMOOTH: a tap is the lowest Force Jump (a bit under half the full height). The longer you hold, the higher it goes, smoothly, up to the highest for your stars. A gold ring fills inside FORCE as you hold, with a light tick when it's full: lift whenever the ring shows the height you want.
STEPS (the default): the same heights in clear steps, one a star. A tap is the lowest step, and every 0.35 s you hold goes up a step, with a tick and a quarter more of the gold ring (at 4 stars), to the highest.
CLASSIC: exactly as the original game: a quick tap is the highest jump, and so is a hold past the highest; only a hold in between is lower. No ring.

In every style the jump costs the same Force and needs you on the ground (or on water), and the other Force powers work as before.

SAVE and LOAD

Tap SAVE to open the game's own Save screen, the one in the game's menu: type a name (or keep the one it offers) and save, or cancel. Tap LOAD to open its Load screen and pick any of your saves (a save from another level loads that level), or cancel. Either way you're back in the game straight after.

Hold SAVE for about a third of a second to quick save, to the game's quick-save slot (the same one F9 uses on PC), and hold LOAD to load that quick save. A ring fills around the button, and when it's full the game saves or loads, once, with your finger still down.

Why the hold? So a stray touch can't save over your quick save or throw away your progress by loading an old one. These buttons sit at the top of the screen next to MENU.

To cancel, slide off before you lift (a tap) or before the ring fills (a hold). It won't go off even if you slide back on.
Even with two fingers on one button, it saves or loads only once. To do it again, touch and hold again.
SAVE and LOAD held together: only the one whose ring fills first goes off (if both fill at the same moment, it saves).
Neither works while the cheat typing line is open.
After a quick load the game shows Quick-loaded. If the quick save is from another level, that level is loaded. If you haven't quick saved yet, it says No quicksave yet.
Where the game doesn't offer saving or loading, a tap does nothing: in multiplayer and co-op, during one of a level's scenes (holding still quick saves there), during AUTO PLAY's show, and SAVE while you're dead. In Mysteries of the Sith, also while a cutscene plays or Mara can't move.

Cheats

During a level, hold MENU and tap the keyboard button in the tray.
A typing line opens at the top of the screen with the iPhone keyboard. Type the cheat (autocorrect is off here) and tap return.
To close the line without sending anything, tap MENU (or the keyboard button in the tray again). While the line is open, MENU and the keyboard button are lit yellow.

While you're typing, most touch buttons don't work. A swipe or long press on POWERS, NEXT WPN or LAST WPN closes the line and opens its wheel (a quick tap does nothing while you type). Cheats only work in single player. A few favourites in Jedi Knight: sithewok (everything at once, see below), red5 (all weapons and ammo), bactame (full health and shields), yodajammies (full Force meter), jediwannabe on (invincibility). The full list is in the guide: https://github.com/sithewok13-dev/OpenJKDF2-iOS/blob/HEAD/docs/ios/README.md#cheats

sithewok is this iOS build's own cheat (the original game doesn't have it). It gives you everything at once: all weapons and ammo, all items, every Force power at 4 stars with the top Jedi rank, full health, shields and Force meter, and invincibility. While it's on:

The Force meter never drains, however much you use your powers.
Ammo never runs out: every kind is filled to its most when it goes on, and refills as you fire, the battery for the field light and IR goggles too.
Falls never hurt you, however far you drop.
The Force catches you if you fall into a bottomless pit: a soft blue flash, and you're back on the ledge you fell from.
Saber Throw (Jedi Knight) is on the Force wheel at four stars, and costs no Force (see Saber Throw above).
It stays on through new levels and loaded games, and puts everything back at the start of each level. Your weapon in hand and your selected Force power come with you to the next level.
JUMP and ACT get new holds (each shows its name in small red letters under the button while the cheat is on), and LEVEL in MENU's tray picks a level:
- Hold JUMP still for half a second (a ring fills): fly. You float, forward goes where you look, hold JUMP to rise and DUCK to sink. Hold JUMP again for half a second, or double-tap JUMP, to land. Walls still stop you.
- Hold ACT still for half a second: noclip, flying straight through walls. Hold it again to switch it off.
- LEVEL in MENU's tray (hold MENU; LEVEL is right of CHEAT while the cheat is on): pick a level. Tap it for a list of the levels by name, or hold it to count to one (after half a second LEVEL 1, then up one every 0.4 seconds), and lift to go there.
- A quick press of JUMP or ACT does what it always does. DUCK only ever crouches (before v0.8-beta2, holding it picked a level).

Typing sithewok again switches it off (so does the CHEAT button, below): no more invincibility, endless Force, safe falls, flying or noclip. You keep the weapons, items and Force powers it gave you, except a lightsaber you only had from the cheat. Type sithewok once more to switch it back on and fill everything back up. It also goes off when you close the app (swipe it away).

Cheat mode: the CHEAT button. Hold MENU and tap CHEAT in the tray. A CHEAT button with the red Sith emblem appears on the top row and sithewok goes on. If you've added sound clips of your own (see Your own Emperor below), the Emperor greets you with one of them, and he does whenever sithewok goes on: with CHEAT in the tray, by holding the CHEAT button, or by typing it. He stays quiet when it goes off. Then:

Hold CHEAT for half a second (a ring fills) to switch sithewok off (the emblem goes grey) or on again (red). A tap does nothing, so you can't switch it by accident.
Typing works too: typing sithewok while it's off switches it on and brings the CHEAT button back. Typing sithewok while it's on switches it off and the button goes away. Holding the button instead leaves it on screen, grey.
To leave cheat mode, tap CHEAT in the tray again: sithewok goes off and the button goes away.
The app remembers cheat mode, but sithewok itself starts off each time you open the app: hold CHEAT to switch it on.
The Emperor plays at the game's sound effects volume, so turn that down if you'd rather not hear him.

Your own Emperor (new in v0.9-beta1): the app doesn't come with any sound clips. To hear one when cheat mode goes on, add your own:

In the Files app, go to On My iPhone (or On My iPad) > OpenJKDF2 (OpenMoTS for Mysteries of the Sith).
Make a folder there called Emperor (touch and hold an empty spot, then New Folder).
Put your clips in it: mp3, m4a, aac, wav, caf or aif files, with any names, up to 16 MB each. The app picks one at random each time (never the same one twice in a row), from the first 16 by name.

An Emperor folder in your game files' folder works too: next to Episode and Resource, in jk1 (mots for OpenMoTS). If both have clips, the one straight in the OpenJKDF2 (or OpenMoTS) folder is used. Clips you add while you play count from the next time sithewok goes on. With neither folder holding any, cheat mode is silent.

Catches, in Jedi Knight (Mysteries of the Sith's are in its section below):

It can change the story. With every light and dark power at 4 stars, the two sides cancel out, so when the game picks your path (after level 14) you get the light side unless you've killed more than about one in five of the civilians. Switching it off doesn't undo this, because you keep the stars. If you care which side you end up on, keep a save from before you first use sithewok, or wait to use it until your path has been set after level 14.
On the Force screen after level 14, where your path is set, the game takes the other side's stars away one at a time, which takes about 16 seconds if you've used sithewok. Wait until it stops before you tap OK, or your path isn't fully set until a later Force screen.
Picking a level with LEVEL jumps straight there, skipping the story in between, and goes to the level itself rather than the cutscene before it. Where a level number has a light and a dark side version, both are in the list: the one you pick goes on along its own path. Keep a normal save of your real progress.
Pits that a level's own script uses to end you (rather than an ordinary fall) can still kill you.

Game controllers

New in v0.8-beta1. Xbox, PlayStation, Backbone and other controllers that work with iOS play the whole game, menus included. Pair one in the iPhone's Bluetooth settings (or clip the phone into a Backbone). As soon as you use it, the touch buttons disappear; touch the screen (that touch does nothing else) or switch the controller off, and they come back.

Button	What it does
Left stick / right stick	Move / look
RT (R2) / LT (L2)	Fire / alt fire
A (Cross)	Jump
B (Circle)	Duck
X (Square)	Use: doors, switches
Y (Triangle)	Use the Force power
LB (L1)	Tap: next Force power. Hold: the Force wheel
RB (R1)	Tap: next weapon. Hold: the weapon wheel
D-pad left	The saber wheel (once you have the saber)
D-pad up / right / down	Use item / next item / previous item
L3 (press the left stick)	Run (press again, or stop, to walk)
R3 (press the right stick)	First or third person
Start (Options, Menu)	Tap: the game menu. Hold: controller options
Back (View, Share)	Tap: the map. Hold: quick save
Back + D-pad down, held	Quick load

The wheels: hold LB or RB and the wheel opens, and the game holds still. Point the right stick at a power or weapon and let go of the button to pick it. Point at the gap at the bottom, or press B, to cancel.
The saber wheel (D-pad left) has buttons of its own, in the table below. The line at the bottom of the screen shows what each one does right now. With a FOLD in your hand, picking the lightsaber again on the weapon wheel flips it (with one in each hand, both).
Quick save and quick load need a short hold, with a ring at the top of the screen, so a stray press never saves or loads.
Controller options (hold Start): look speed, the stick's response, invert look, turn acceleration, vibration, the FPS counter, and the keyboard for cheats. The app remembers them. If holding Start only opens the game menu, hold Back and press Start instead.
Menus: the D-pad or left stick moves, A picks, B goes back. On a text box (a name, an address), A brings up the keyboard.
Your own buttons: Setup > Controls > Joystick. If you changed them in an older version, yours are kept; if not, you get the layout above.
More detail in the guide: https://github.com/sithewok13-dev/OpenJKDF2-iOS/blob/HEAD/docs/ios/README.md#game-controllers

Button	On the saber wheel
Right stick	Point at a colour (D-pad right steps round)
A (Cross)	Set the colour
Y (Triangle)	The next card or blade
LB (L1)	The next hilt
X (Square)	Add the second saber, or go back to one
RB (R1) / LT (L2)	SAME COLOUR / SAME HILT (two sabers)
RT (R2)	AUTO OPEN (with a FOLD)
D-pad up / down	FILM / SABER THROW (Jedi Knight)
L3	CLASSIC or REFORGED
R3	Take the saber in hand
Back (View, Share)	RANDOM. Hold: new colours only
B (Circle)	Close

Keyboard and mouse

New in v0.8-beta1. A keyboard and a mouse or trackpad (an iPad's Magic Keyboard, or a Bluetooth or USB keyboard and mouse) play the whole game, menus included. As soon as you use them, the touch buttons disappear; touch the screen and they come back. A mouse click never counts as a touch.

iPad: while you play, the pointer disappears and the mouse turns the view, as on a computer. In the menus, the camera modes and MENU's tray, you get the pointer back.
iPhone: a mouse works through AssistiveTouch (Settings > Accessibility > Touch > AssistiveTouch). Whether mouse look works on an iPhone hasn't been tested yet (see Known limitations). The keyboard should work as on an iPad.

Key or button	What it does
W A S D	Move (the arrow keys turn)
Mouse	Look
Left button / right button	Fire / alt fire
Middle button	Jump
C	Duck
Space	Use: doors, switches
Shift	Run
Scroll wheel, or 1 to 0	Weapons
E / Q	Tap: next / previous Force power. Hold: the Force wheel
F	Use the Force power
G	Tap: next weapon. Hold: the weapon wheel
L	The saber wheel (once you have the saber): its keys are below
H	First or third person
P	Tap: a photo. Hold: a selfie
O	Action Freeze on and off
Tab	Map
T	Typing line (cheats, chat)
Enter	Use item
F9 / F10, held	Quick save / quick load
Esc (or Cmd-.)	Game menu; back in menus

The wheels: hold E, Q or G and the wheel opens, and the game holds still. Move the mouse toward a power or weapon and let go of the key to pick it. Right click or Esc cancels.
No Esc key? Cmd-. works as Esc. While you hold Cmd, other keys don't reach the game, so iPad shortcuts like Cmd-Tab don't open the map.
The saber wheel has keys of its own, in the table below. The line at the bottom of the screen shows what each one does right now. With a FOLD in your hand, picking the lightsaber again on the weapon wheel flips it, and in Jedi Knight so does its key (0): with a FOLD in each hand, once flips the right one, twice quickly both. In Mysteries of the Sith, key 1 switches to the fists as always, so flip a FOLD there with SABER or the weapon wheel.
Your own keys and buttons: Setup > Controls > Keyboard and Setup > Controls > Mouse (the mouse sensitivity is there too).
Updating from an older version: unless you changed them before, the right mouse button is now alt fire, the middle one jump, and the scroll wheel switches weapons.
More detail in the guide: https://github.com/sithewok13-dev/OpenJKDF2-iOS/blob/HEAD/docs/ios/README.md#keyboard-and-mouse

Key	On the saber wheel
Mouse, scroll wheel	Point at a colour
Click	Set the colour
1	Add the second saber, or go back to one
2	The next card or blade
3	Take the saber in hand
4	CLASSIC or REFORGED
5 / 6	FILM / SABER THROW (Jedi Knight)
7	The next hilt
8 / 9	SAME COLOUR / SAME HILT (two sabers)
0	AUTO OPEN (with a FOLD)
R	RANDOM. Hold: new colours only
Esc, right click, L	Close

Other things worth knowing

Messages and mission text appear just below the top row of buttons, so the buttons never cover them, and long lines wrap.
The HUD fits rounded, notched screens: the health and ammo gauges sit above the home bar, the rounded corners never cut into the dials, and the health and shield numbers are drawn bigger so they're easy to read. The HUD Scale is 2.5 by default (Setup > Display).
Cutscenes: tap the screen to skip. A level's own scenes (before a duel, or at a level's end) can be skipped too: tap anywhere, and the game plays the rest unseen and fast, so everything ends up as if you had watched it (not in multiplayer or co-op). Menus: tap them as you'd click.
The game's sound takes over from other apps' audio while you play (music from another app stops), and it plays with the silent switch on.
If the game feels slow: in Setup > Display, try an SSAA Multiplier below 1 (for example 0.75 or 0.5), and turn on the FPS counter in MENU's tray to see the difference.
Playing by touch? Leave the keyboard bindings at their defaults (Setup > Controls > Keyboard). The touch buttons press the game's default keys, so if you rebind an action, its touch button stops working.

Multiplayer and co-op

New in v0.8-beta1, in both apps, and not yet tried on real iPhones or iPads: please report what happens on yours. Up to four players. Everyone needs the same app (OpenJKDF2 or OpenMoTS) and the same game files.

Hosting a game:

Tap Multiplayer, then Host Game.
Pick Deathmatch (fight each other) or Co-op Campaign (play the story together).
Pick an episode and a level, and tap OK. A password is optional. Advanced has Allow Cheats (off unless you tick it).
The first time, you make a multiplayer character: your name is filled in, so tap OK, pick a look, tap Save, then OK.

The first time, iOS asks to let the app find devices on your local network. Say Allow, or nobody can find or join your game. (If you said no: Settings > Privacy & Security > Local Network.) A line at the top of the screen shows your address (for example 192.168.1.20) for friends joining from elsewhere.

Joining a game:

Tap Multiplayer, then Join Game.
Games on the same Wi-Fi are listed by themselves: tap one. Played before lists hosts you've joined before. For a friend elsewhere, type their address in the Address box and tap Join.
If the game has a password, type it. If it's wrong, it says so and you can try again.
Pick your character (the first time, you make one), and you're in.

Co-op:

The host plays the story's own character (Kyle, or Mara in OpenMoTS); everyone else plays the character they picked.
Objectives are shared, and when the level ends everyone goes on to the next one together. Each player keeps their own weapons, ammo, items and Force powers.
If you die, you come back at the level's start with what you had when the level began.
The score screen and the Force powers screen between levels go on by themselves, and each player watches the cutscenes on their own: whoever finishes first waits for the next level.

Co-op saves: the host's game saves the campaign at the start of every level, with everyone's gear, in a coop folder next to the game files. Your single-player saves are never touched. To carry on, tap Multiplayer, then Resume Co-op, and pick the campaign. A player who drops out and rejoins gets their gear back. Starting a new campaign over a saved one asks first, and keeps the old save.

Your lightsaber: other players see your sabers as you set them on the saber wheel: each saber's hilt, every blade's colour, and a FOLD open or folded. A CROSS is carried low and crackles on their screen too. Players still on v0.8-beta2 or older see plain sabers, each in its first blade's colour. CLASSIC or REFORGED and FILM are for your own screen: they change how you see every saber, yours and theirs. In multiplayer the second saber is only for looks, and there's no SABER THROW.

Over the internet: install Tailscale (a free VPN app) on every device, and join with the host's Tailscale address (100.x.x.x), which the host's top line also shows. It needs no router setup. A game with a password is encrypted too: use a long one, such as four random words. A game without a password isn't encrypted.

Joining a game of the original 1997 Jedi Knight (new in v0.8-beta2, OpenJKDF2 only, experimental): you can join a game hosted by the original Jedi Knight (JK.EXE) on a PC, for example one announced for a community game night.

Tap Multiplayer, then Join Game.
Type the host's address (numbers or a name) in the Address box, without a port, and tap Join. The app asks for this port's games and the original game's at the same time, and uses whichever answers. Original games aren't listed by themselves, even on your own Wi-Fi: type the address.
If that address has several games, Games at this address lists each one's name, level and players. Pick one and tap Join.

Wi-Fi, not mobile data. For a game on the internet, the original game's host connects back to you, so the app asks your router to let that through (usually TCP 2300 and UDP 2350, by UPnP, NAT-PMP or PCP) while you play, and gives the ports back afterwards.
If your router can't be asked, the app still tries. It works if you forwarded TCP 2300 and UDP 2350 to your phone yourself: give the phone a fixed address on your Wi-Fi in the router's settings, then forward the two ports to it.
If it can't get through, it says so: Couldn't get through to this game. On mobile data that can't work. On Wi-Fi, turn on UPnP or NAT-PMP in your router, or forward TCP 2300 and UDP 2350 to this device. (It names the ports it really used, if they differ.)
Jedi Knight only: OpenMoTS can't join original Mysteries of the Sith games yet. Joining only: you can't host a game for the original to join.
Not tried for real yet: only against a stand-in for the original game and a stand-in router, on a test computer. Please report what happens with a real one (see Found a bug?).
The setup guide has the details: https://github.com/sithewok13-dev/OpenJKDF2-iOS/blob/HEAD/docs/ios/README.md#joining-a-game-of-the-original-1997-jedi-knight

The setup guide has more, including co-op saves and opening a port on your router: https://github.com/sithewok13-dev/OpenJKDF2-iOS/blob/HEAD/docs/ios/README.md#multiplayer

Mysteries of the Sith: the OpenMoTS app

Star Wars Jedi Knight: Mysteries of the Sith (1998), the expansion, plays in its own app, OpenMoTS: the same engine and the same touch controls as OpenJKDF2, in a second app with its own icon and its own folder in the Files app. It installs next to OpenJKDF2 and keeps its files, saves and settings apart from Jedi Knight's (SENS, GYRO, FPS and CAMERA too). It only needs Mysteries of the Sith's own files.

Installing: download OpenJKDF2-MotS-iOS-unsigned.ipa and install it the same way as OpenJKDF2, with the same tool (see Install below). With a free Apple ID, it counts as one more of your 3 sideloaded apps. If your tool says you've reached the limit, don't delete OpenJKDF2 to make room: that deletes its game files and saves too. Deactivate or remove a different app instead.
Its files: open OpenMoTS once, so it makes its folder, then copy the Episode, Resource and MUSIC folders from your Mysteries of the Sith folder into On My iPhone (or On My iPad) > OpenMoTS > mots. Like OpenJKDF2, it also finds them straight in the OpenMoTS folder, or in a folder inside it, but mots is the place the guide uses.
Keep the two games apart: Mysteries of the Sith's files go in OpenMoTS only, and Jedi Knight's in OpenJKDF2 only. Each app only starts with its own game's files.
Expansions & Mods in OpenMoTS has no entry for Jedi Knight: open the OpenJKDF2 app instead.
The setup guide has the steps, with a picture of the folders: https://github.com/sithewok13-dev/OpenJKDF2-iOS/blob/HEAD/docs/ios/README.md#mysteries-of-the-sith

The same as in Jedi Knight: the move stick and its run marker, drag to look, every button, MENU's hidden tray, the camera (selfies, photos, bursts, Action Freeze and the cinematic burst), SABER and its saber wheel (the hilts, colours, FILM and RANDOM, for Mara's sabers), cheat mode and the CHEAT button, VIEW and CONTROLS, multiplayer and co-op (Mara is the host's character), game controllers, keyboard and mouse, tilt aiming, SAVE and LOAD, LAST WPN and POWERS, the LIGHT, IR and BACTA item buttons, AUTO PLAY, skipping a level's own scenes, the FORCE button with its Force meter ring, tap, swipe or long-press on the wheel buttons, the stars on the Force wheel, and the HUD that fits your screen.

Different in Mysteries of the Sith:

The Force wheel has the 17 Force powers you can use in Mysteries of the Sith, sorted into its four tiers (the four columns of its Force screen) instead of light and dark side. Defense is for multiplayer only, so it isn't on the wheel. The gap at the bottom means cancel, as in Jedi Knight.
- Left side, gold: tier I. From the top: Jump, Projection, Seeing, Speed, Push.
- Top left, green: tier II. From the left: Pull, Grip, Far Sight, Saber Throw.
- Top right, blue: tier III. From the top: Chain Lightning, Healing, Blinding, Persuasion.
- Right side, purple: tier IV. From the top: Absorb, Destruction, Protection, Deadly Sight.
The weapon wheel has its 17 weapons, in the order NEXT WPN goes through them, clockwise from the bottom left: Fists, Lightsaber, Bryar, Blastech, Rifle, Scope Rifle, Thermal, Flash Bomb, Bowcaster, Repeater, Rail Det, Rail Seeker, Sequencer, Manual Seq, Conc Rifle, E-Web, Carbo Gun. The E-Web and the Carbo Gun are purple; the others are coloured by their ammo, as in Jedi Knight.
Saber Throw is the game's own Force power here, so the saber wheel has no SABER THROW switch. A thrown saber keeps its hilt, its colours and FILM. On a keyboard, key 1 switches to the fists as always: flip a FOLD with SABER or the weapon wheel.
Cheats go in the typing line as in Jedi Knight (see Cheats above). Mysteries of the Sith's own cheats work: diediedie (weapons), gimmestuff (items), morelife (health and shields), trixie (Force meter), cartograph (map), iamagod (every Force power), trainme (Force level-up), boinga on / boinga off (invincibility), freebird (fly) and gameover (finishes the level). The Jedi Knight names work here too, except imayoda and sithlord, which do nothing in Mysteries of the Sith.

sithewok works in Mysteries of the Sith too, with everything it does in Jedi Knight: all weapons and ammo, all items, every Force power at 4 stars with the top Jedi rank, full health and shields, invincibility, the endless Force, safe falls, the Force catching you in pits, flying, noclip, and picking a level with LEVEL in MENU's tray (13 levels). Cheat mode and the CHEAT button work the same way. The catches in Mysteries of the Sith:

Your Force powers stay through the Force screen at the end of each level. Normally Mysteries of the Sith takes back powers beyond what your rank allows. This lasts until the app is closed, in any game you play (also after you switch sithewok off). If you load a game saved with these powers after reopening the app, switch sithewok on again before the level ends, or the Force screen turns them back into stars.
While you have them, the Force screen's Choose numbers and left-over stars don't matter: just tap Ok.
When the story switches to Mara Jade (level 5), the game gives her her own starting powers, rank and weapons, and sithewok puts everything back once her level has started. If anything's missing, hold CHEAT to switch it off and on again.
After the opening video of a level, your weapon in hand comes back a moment later than in Jedi Knight.

Known limitations

Most of what's new in this release hasn't been played on a real iPhone yet. It has been tested on a computer, with the real game engine and simulated touches: AUTO PLAY and its duels, skipping a level's scenes, SAVE and LOAD's taps, LAST WPN, POWERS beside FORCE, FORCE's name, the LIGHT, IR and BACTA pictures, RUN, LOOK, OPACITY, the 60 or 120 frames a second, the sharper FILM CROSS and its side blades, the two-saber changes, enemy FILM blades and the co-op changes. Some of the earlier changes have been played on an iPhone in test builds, but most of this release's new controls and AUTO PLAY's latest changes haven't, and nothing in it has been tried on an iPad. If something looks, sounds or works wrong, please report it (a screenshot or a screen recording helps; see Found a bug?).
AUTO PLAY can't win Jerec's second fight. In it Jerec can't be hurt until switches in the arena are thrown, which the show doesn't do, so that duel ends at its 4-minute limit and the show goes on to another level (or starts the level again, with PICK ONE).
AUTO PLAY's fights are different every time: they're made by the game's own AI and random numbers, so now and then Kyle (or Mara) may still stand about, fall or get stuck. Double-tap for a new fight.
What was new in v0.9-beta1 (the saber wheel's cards, the four hilts, FOLD and its sounds, FILM, RANDOM, Saber Throw in Jedi Knight and the third-person carry) was mostly played on an iPhone in test builds, but not all of it, and not on an iPad.
A STAFF or an open FOLD can still pass through Kyle now and then in third person: in some swings (the game's swings are made for a one-bladed saber), and sometimes when he walks backwards, turns or crouches holding two. It's only the look: the second blade doesn't hit anything.
A saber's glow doesn't light up what's round it. The glow of FILM and CROSS blades is drawn round the blade itself: walls, floors and people near you don't take its colour (a FILM CROSS doesn't light up a dark room red, for example).
Installing from the source in SideStore or AltStore is new. If it doesn't work for you, download the .ipa files below and install them as before.
Joining the original 1997 Jedi Knight is experimental and untested for real. It has only been tried on a test computer, against a stand-in that answers as the original game does and a stand-in router. It has never been tried against a real PC game, Windows' own DirectPlay or a real router, so it may not work yet. If it doesn't, please report what you see (see Found a bug?).
What was new in v0.8-beta2 (the easier-to-read menus, the new saber colours and the CLASSIC / REFORGED switch, and the LEVEL button) had only been checked on a computer when it came out. If text is hard to read, a colour looks wrong or LEVEL misbehaves, please report it (a screenshot helps).
What was new in v0.8-beta1 had only been tested on a computer when it came out, with the real game: multiplayer and co-op (with two to four copies of the game), game controllers, keyboard and mouse, VIEW, CONTROLS and the saber changes. Multiplayer hasn't been tried between two iPhones yet. If something doesn't work, please report it (see Found a bug?).
Mouse look on an iPhone may not work. iPhones only take a mouse through AssistiveTouch, and Apple may not let the game take the pointer there. On an iPad it's more likely to work. With FPS on (MENU's tray), two small lines show what the app gets from the mouse and keyboard: a screenshot of them helps if you report it. The keyboard should work on both.
Multiplayer only joins games of this port (its iPhone and iPad apps, and its computer builds), and, new and experimental, games hosted by the original 1997 Jedi Knight. Games hosted by the official OpenJKDF2 on a computer can't be joined in this release.
What was new in v0.7 (the Force Jump styles and their ring, the endless ammo, and typing sithewok to switch it) was tested on a computer, with the real game engine and simulated touches. If a jump feels wrong, please report it, and CLASSIC in MENU's tray brings back the original.
What was new in v0.6 has been tested mostly on a computer, with the real game engine and simulated touches: the saber colours and two sabers, cheat mode and its holds (fly, noclip, picking a level), Action Freeze and the cinematic burst, and the new selfies. Some of it has been tried on an iPhone, but not all of it, and not on an iPad. If something looks or works wrong, please report it (see Found a bug?).
Two sabers and the new hilts use Kyle's one-saber moves: there are no new animations, so in his two-handed swings the blades come from nearly the same place, and the casual two-saber resting stances are in first person only.
Action Freeze close to walls: the camera keeps out of walls and closed doors, but very close to one the view behind it can come out black.
The selfie camera has been tried on an iPhone (lots of selfies and photos in Jedi Knight), and tested on a computer with the real game engine, with each selfie checked to put the whole level back exactly as it was. Selfies in Mysteries of the Sith have only been tested on a computer. With low-detail 1990s models, some poses can look a little odd up close. If a selfie looks strange, or the game doesn't carry on as before after one, please report it (see Found a bug?).
OpenMoTS (Mysteries of the Sith) is new in v0.4, and has had much less testing than OpenJKDF2. On an iPhone, it has only been checked to start and run with the files in its folder so far. It hasn't been played through on one, and it hasn't been tried on an iPad.
OpenMoTS on a computer: it has been tested with the real game engine, the Mysteries of the Sith files and simulated touches: the menus, the first level, the HUD, the main buttons, both wheels, the cheats and sithewok, quick save and quick load, the item buttons, finishing a level and starting the next, and Mara Jade's first level. Tilt aiming and the sound haven't been checked in OpenMoTS yet.
Finding the files outside jk1 and mots is new in v0.4, and has mostly been tested on a computer. If an app doesn't find your files, put them in jk1 (or mots) as the guide shows.
In OpenJKDF2, please ignore Install Mysteries of the Sith under Expansions & Mods: Mysteries of the Sith plays in OpenMoTS. If you tapped it, close the app and open it again.
The touch buttons only know the default key bindings (see above).
No previous-power button: use POWERS's wheel. There's no button for the in-game map overlay (MENU > Map shows the map instead), and no button for items other than the field light, IR goggles and bacta.
The run circle only runs straight ahead. Switch on Always Run (RUN in MENU's tray) to run in every direction.
Free Apple ID signing expires every 7 days: refresh the apps in AltStore or SideStore, or install them again with the same tool and Apple ID. Your files and saves are kept.
OpenJKDF2 has been played on an iPhone in earlier versions, but both apps have had only limited testing so far.

Requirements

iPhone or iPad on iOS / iPadOS 18 or newer (iPhone XS / XR or newer, including the iPhone SE 2nd generation and later), for both apps. OpenMoTS has only been tried on an iPhone so far.
Your own game files, at least episode and resource, ideally with resource/video (cutscenes) and MUSIC (soundtrack): Jedi Knight's for OpenJKDF2, and Mysteries of the Sith's for OpenMoTS. Mysteries of the Sith's files take about 450 MB in the copy it was tested with (under 200 MB without the cutscenes and music).
A sideloading tool that can install your own .ipa (for example AltStore, SideStore or Sideloadly). The same tool works for both apps. SideStore and AltStore (AltStore Classic, not AltStore PAL) can also install them from this project's source (see Install). With a free Apple ID, apps have to be re-signed every 7 days, and you can have only 3 sideloaded apps at a time: AltStore or SideStore itself counts as one, and OpenJKDF2 and OpenMoTS count as one each.

Install

Easiest, with SideStore or AltStore: set one of them up first, with its own instructions. Then, on your iPhone, tap Add to SideStore or Add to AltStore and confirm. If that doesn't open the app, open it yourself, go to Sources, tap + and paste this address: https://raw.githubusercontent.com/sithewok13-dev/OpenJKDF2-iOS/HEAD/packaging/ios/altstore-source.json

The source, OpenJKDF2 for iOS (unofficial), lists OpenJKDF2 (Jedi Knight) and OpenMoTS (Mysteries of the Sith). Install the one for your game, or both, then carry on from step 3 below. It always has the newest numbered release, betas included, and you update the apps there too.

Or with any sideloading tool:

Download the .ipa for your game, below: OpenJKDF2-iOS-unsigned.ipa for Jedi Knight, or OpenJKDF2-MotS-iOS-unsigned.ipa for Mysteries of the Sith (MotS in its name). To play both, download both and do each step for each app.
Sign and install it with your sideloading tool. The first time, iOS may ask you to turn on Developer Mode and to trust your Apple ID. On your home screen the app is called OpenJKDF2 (Jedi Knight) or OpenMoTS (Mysteries of the Sith), each with its own icon.
Open the app once. It says the game files are missing (OpenJKDF2 is missing the following required assets, or OpenMoTS is missing...) and asks you to copy your installation into the app's Documents folder. That's expected: it has just made its folder. The app can't go any further without the files, so close it (swipe it away).
Get your Episode, Resource and MUSIC folders onto your phone from the game's folder on your computer, for example with iCloud Drive or as a .zip. Then, in the Files app, copy them into On My iPhone (or On My iPad) > OpenJKDF2 > jk1 for Jedi Knight, or On My iPhone (or On My iPad) > OpenMoTS > mots for Mysteries of the Sith. (The apps also find them straight in OpenJKDF2 or OpenMoTS, or in a folder inside it, but jk1 and mots are the places the guide uses.) Where the game folder is on your computer: https://github.com/sithewok13-dev/OpenJKDF2-iOS/blob/HEAD/docs/ios/README.md#1-get-your-game-files-ready
Open the app again. The intro plays, then you make a player, then the main menu.

The setup guide covers each step, including Developer Mode and "Untrusted Developer": https://github.com/sithewok13-dev/OpenJKDF2-iOS/blob/HEAD/docs/ios/README.md#2-install-the-app

Updating from an older version: if you installed from the source, update the app in SideStore or AltStore. Otherwise, sideload the new .ipa with the same tool and Apple ID. It replaces the app and keeps your game files and saves, and files in jk1 (or mots) stay where they are. (With a different tool or Apple ID, iOS may install it as a separate app with an empty folder: the guide explains how to move your files over.) Tried a test build from the iOS latest build prerelease? Install this release over it the same way: it keeps its files and saves too.

Your saves are in the Files app: OpenJKDF2 > jk1 > player, or OpenMoTS > mots > player. (If you put the game files somewhere else in the app's folder, the player folder is next to them.) Copy it somewhere safe now and then, and always before you delete an app: deleting an app deletes its folder, game files and saves included.

Download: under Assets below (not the Source code files): OpenJKDF2-iOS-unsigned.ipa is Jedi Knight (OpenJKDF2), and OpenJKDF2-MotS-iOS-unsigned.ipa is Mysteries of the Sith (OpenMoTS). The iOS latest build prerelease, also on the Releases page, is rebuilt automatically after every code change and may be broken: use this release.

Found a bug? Please report it here, not to the upstream OpenJKDF2 project, and say you're on v0.9-beta2 and which app, OpenJKDF2 or OpenMoTS (AltStore and Settings show 0.9.9 for both: that's the engine's version): https://github.com/sithewok13-dev/OpenJKDF2-iOS/issues

Unofficial builds. OpenJKDF2 is by shinyquagsire23 (Max Thomas) and the OpenJKDF2 contributors. This is not an official OpenJKDF2 release, and it is not affiliated with or endorsed by Lucasfilm, Disney or LucasArts. Star Wars and Jedi Knight are trademarks of Lucasfilm Ltd. No game assets are included.

The apps include open-source libraries under their own licenses, among them OpenAL Soft and libsmacker (GNU LGPL; OpenAL Soft is linked statically, and the full source and build scripts are in this repository), SDL3 and SDL_mixer (zlib), ANGLE (BSD-style) and ENet (MIT), for multiplayer. The list with links to each license is in the guide: https://github.com/sithewok13-dev/OpenJKDF2-iOS/blob/HEAD/docs/ios/README.md#credits-and-legal

Navigation Menu

Repository navigation

OpenJKDF2 for iOS v0.9-beta2 "Yun"

Choose a tag to compare

Sorry, something went wrong.