Repository navigation
Releases
OpenJKDF2 for iOS v0.9-beta2 "Yun"
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
sithewokon 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
sithewokon: 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). AnEmperorfolder in your game files' folder (jk1ormots) 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...
OpenJKDF2 for iOS v0.9-beta1
OpenJKDF2 for iOS v0.9-beta1: an unofficial iPhone and iPad build of OpenJKDF2, the open-source Jedi Knight: Dark Forces II engine, with on-screen touch controls. New in this release: build your own lightsaber. A new saber wheel gives each hand its own hilt (the game's own, Kylo Ren's crossguard, a double-bladed staff or a folding double saber) and each blade its own colour. Also new: a FILM look like the films' blades, a RANDOM button, Saber Throw for Kyle in Jedi Knight, and installing and updating both apps from SideStore or AltStore. Most of it has been played on an iPhone in test builds, but not all of it, and not on an iPad (see Known limitations). Coming from v0.8-beta1? You also get 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-beta1
New since 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
sithewokis 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
Emperorin 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
sithewokis 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.
- **Dea...
OpenJKDF2 for iOS v0.8-beta2
OpenJKDF2 for iOS v0.8-beta2: an unofficial iPhone and iPad build of OpenJKDF2, the open-source Jedi Knight: Dark Forces II engine, with on-screen touch controls. New in this release: join games hosted by the original 1997 Jedi Knight on a PC, easier-to-read multiplayer menus, new lightsaber colours with a CLASSIC / REFORGED switch, and the cheat's level pick on a LEVEL button of its own. None of this has been tried on a real iPhone, iPad, router or Windows PC yet (see Known limitations). Coming from v0.7? You also get multiplayer and co-op for up to four players, game controllers, and keyboard and mouse, from 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.8-beta2
New since 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. REFORGED is the default; CLASSIC is every colour exactly as in v0.8-beta1, green included. 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
sithewokis 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 picked DUAL (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.
- The Emperor has three greetings for cheat mode now: his laugh, "the dark side" or "unlimited power".
- 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
sithewokswitches the cheat on or off. Typed on, the CHEAT button appears (with the Emperor's laugh); typed off, it goes away. There's no separatesithewok offany 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 DUAL on the saber wheel and Kyle (or Mara) fights with a saber in each hand, each in its own colour. The second blade strikes too. In first person b...
OpenJKDF2 for iOS v0.8-beta1
OpenJKDF2 for iOS v0.8-beta1: an unofficial iPhone and iPad build of OpenJKDF2, the open-source Jedi Knight: Dark Forces II engine, with on-screen touch controls. New in this release: multiplayer, game controllers, and keyboard and mouse. Play with up to three friends: fight each other, or play the whole story together in co-op and carry on another day. Games on the same Wi-Fi find each other by themselves. Or put the touch buttons away and play with an Xbox, PlayStation or Backbone controller, or a keyboard and mouse. It's all in both apps, Jedi Knight and Mysteries of the Sith. These are new and haven't been tried on a real iPhone or iPad yet (see Known limitations). Coming from v0.6? You also get Force Jump by how long you hold and endless ammo with sithewok, from 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.8-beta1
New since 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 picked DUAL (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.
- The Emperor has three greetings for cheat mode now: his laugh, "the dark side" or "unlimited power".
- 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
sithewokswitches the cheat on or off. Typed on, the CHEAT button appears (with the Emperor's laugh); typed off, it goes away. There's no separatesithewok offany 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 with 17 colours: the game's own (ORIGINAL), red, crimson, orange, amber, yellow, lime, green, teal, cyan, light blue, blue, purple, magenta, pink, white and black. It changes only how your blade looks, in first and third person and in photos. See The lightsaber: SABER below.
- Two sabers: choose DUAL on the saber wheel 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
sithewokgoes on, with a laugh from the Emperor. Hold the emblem for half a second to switch the cheat off or on again. See Cheats below. - New cheat powers while
sithewokis on: hold JUMP to fly, hold ACT for noclip (through walls), and hold DUCK to pick any level. 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 it...
OpenJKDF2 for iOS v0.7
OpenJKDF2 for iOS v0.7: an unofficial iPhone and iPad build of OpenJKDF2, the open-source Jedi Knight: Dark Forces II engine, with on-screen touch controls. New in this release: Force Jump the way you remember it, and a cheat that never runs dry. Hold FORCE and a gold ring fills as Kyle gathers the Force: a tap is a small hop, a full hold the highest leap your stars allow, so you choose every jump. With sithewok on, every kind of ammo is full and stays full however much you fire, and typing sithewok again switches it off. It's all in both apps, Jedi Knight and Mysteries of the Sith. Coming from v0.5? You also get lightsaber colours and two sabers, cheat mode with its Sith emblem button, and Action Freeze from v0.6. From v0.4 or older? Also 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.7
New since v0.6, in both apps:
- 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): 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
sithewokswitches the cheat on or off. Typed on, the CHEAT button appears (with the Emperor's laugh); typed off, it goes away. There's no separatesithewok offany 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 with 17 colours: the game's own (ORIGINAL), red, crimson, orange, amber, yellow, lime, green, teal, cyan, light blue, blue, purple, magenta, pink, white and black. It changes only how your blade looks, in first and third person and in photos. See The lightsaber: SABER below.
- Two sabers: choose DUAL on the saber wheel 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
sithewokgoes on, with a laugh from the Emperor. Hold the emblem for half a second to switch the cheat off or on again. See Cheats below. - New cheat powers while
sithewokis on: hold JUMP to fly, hold ACT for noclip (through walls), and hold DUCK to pick any level. 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
sithewokcheat 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 (
jk1in OpenJKDF2,motsin 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 injk1, 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 wh...
OpenJKDF2 for iOS v0.6
OpenJKDF2 for iOS v0.6: an unofficial iPhone and iPad build of OpenJKDF2, the open-source Jedi Knight: Dark Forces II engine, with on-screen touch controls. New in this release: lightsabers your way, cheat mode, and a photo camera that stops time. Pick your blade's colour from 17, or fight with two sabers at once, each in its own colour. Switch on cheat mode and a red Sith emblem button turns sithewok on and off, with new powers on the buttons you already use: fly, walk through walls, and jump to any level. And the camera now does Action Freeze: stop the fight mid-blast, swing the camera round it and take your shot, or let it sweep round the action by itself for five cinematic photos. It's all in both apps, Jedi Knight and Mysteries of the Sith. Coming from v0.4? You also get the selfie camera from v0.5. From v0.3 or older? Also 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/First-repo-for-Claude-for-JKDF2/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.6
New since v0.5, in both apps:
- Lightsaber colours: a SABER button on the top row (once you have the lightsaber) opens a saber wheel with 17 colours: the game's own (ORIGINAL), red, crimson, orange, amber, yellow, lime, green, teal, cyan, light blue, blue, purple, magenta, pink, white and black. It changes only how your blade looks, in first and third person and in photos. See The lightsaber: SABER below.
- Two sabers: choose DUAL on the saber wheel 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
sithewokgoes on, with a laugh from the Emperor. Hold the emblem for half a second to switch the cheat off or on again. See Cheats below. - New cheat powers while
sithewokis on: hold JUMP to fly, hold ACT for noclip (through walls), and hold DUCK to pick any level. 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
sithewokcheat 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 (
jk1in OpenJKDF2,motsin 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 injk1, 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 FORCE LIGHT IR BACTA CAMERA SABER CHEAT (FPS) QUICK QUICK MENU
WPN WHEEL (only items you have) SAVE LOAD
[GYRO] [FPS] [CAMERA] [CHEAT] [keyboard]
(MENU's tray, when held)
[MODE] [SENS] (GYRO held in the tray)
[PHOTO] [SELFIES] [FREEZE] (CAMERA held in the tray)
(^^) 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 ...
OpenJKDF2 for iOS v0.5
OpenJKDF2 for iOS v0.5: an unofficial iPhone and iPad build of OpenJKDF2, the open-source Jedi Knight: Dark Forces II engine, with on-screen touch controls. New in this release: the selfie camera. Hold the camera button and the whole game freezes, bosses and all. Everyone nearby turns to face you and strikes a pose: they wave, flex, salute, kneel in the front row, throw an arm round a neighbour. You hold the phone out at arm's length, the flash goes off, and you've got a selfie with your enemies. Then everything snaps back exactly as it was and the fight goes on. Tap the same button for ordinary photos of your game, or slide off it for a burst, all straight into your Photos app. It's all in both apps, Jedi Knight and Mysteries of the Sith. Coming from v0.3? You also get Mysteries of the Sith in its own app, OpenMoTS, from v0.4. From v0.2 or older? Also the sithewok cheat, the weapon wheel and tilt aiming. 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/First-repo-for-Claude-for-JKDF2/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.5
New since v0.4, in both apps:
- The selfie camera: hold the camera button still for half a second. The whole game freezes, enemies and bosses included, and the HUD and buttons get out of the way. Up to 8 people near you turn to the camera and strike a random pose: wave, flex, salute, point, shrug, fist up, victory sign, hands behind the head, hand on the heart, arms crossed, an arm round a neighbour, and more.
- Every selfie is different. 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. The camera angle changes too: a little higher or lower, sometimes slightly tilted. You (Kyle, or Mara Jade in Mysteries of the Sith) put your weapon away for the photo, hold the phone out in your right or left hand, pose with the other, and look toward the lens.
- A real flash lights everyone up, with the shutter sound, and blaster bolts frozen in front of someone's face are left out of the shot. The photo stays on screen for a moment, then everyone goes back to exactly what they were doing, as if nothing happened. Nobody nearby? Then it's a selfie of you alone.
- The camera button lives in MENU's hidden tray: hold MENU, tap the camera symbol, and the button appears in the middle of the top row. Your selfies and photos go straight into your Photos app (the app asks once, the first time).
- Photos and bursts with the same button: tap it for a photo of the game, with a flash and a shutter sound, or slide off it for a burst: a photo every fifth of a second for as long as your finger stays down (up to 10), each with its own quick tick. Hold the camera symbol in the tray to choose what a photo shows: CLEAN (just the game, the default), HUD (with the gauges) or HUD+BTNS (with the touch buttons too), or any mix.
- Easier-to-read mission text: the game's messages and mission text now 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
sithewokcheat 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 (
jk1in OpenJKDF2,motsin 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 injk1, 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 FORCE LIGHT IR BACTA (CAMERA) (FPS) QUICK QUICK MENU
WPN WHEEL (only items you have) SAVE LOAD
[SENS] [GYRO] [FPS] [CAMERA] [keyboard]
(MENU's tray, when held)
[CLEAN] [HUD] [HUD+BTNS]
(CAMERA's options, when CAMERA is held in the tray)
(^^) 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.
The selfie camera (and photos)
Switching it on: hold MENU, then tap the camera symbol in the tray. A camera button (CAMERA in this guide) appears in the middle of the top row, and stays there (the app remembers) until you tap the camera symbol in the tray again. The first time, 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.
Selfies: hold CAMERA still for half a second (a ring fills around it).
- 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 ca...
OpenJKDF2 for iOS v0.4
OpenJKDF2 for iOS v0.4: an unofficial iPhone and iPad build of OpenJKDF2, the open-source Jedi Knight: Dark Forces II engine, with on-screen touch controls. New in this release: Mysteries of the Sith, the expansion, in an app of its own, OpenMoTS, with the same touch controls. Both apps also find your game files in more places now. Coming from v0.2? You also get the sithewok cheat from v0.3. From v0.1? Also the weapon wheel, tilt aiming and more from v0.2. 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 is new in this release and has had much less testing than OpenJKDF2: so far it has been tested on a computer and checked to start and run on an iPhone (see Known limitations). If something goes wrong in it, please report it (see Found a bug?).
Setup guide: https://github.com/sithewok13-dev/First-repo-for-Claude-for-JKDF2/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.4
New since 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
sithewokcheat 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 (
jk1in OpenJKDF2,motsin 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 injk1, nothing changes.
The Jedi Knight app is otherwise unchanged: apart from finding the files in more places, OpenJKDF2 is the same as in v0.3. If v0.3 works for you, you don't need to update OpenJKDF2. Updating keeps your game files and saves (see Install).
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 FORCE LIGHT IR BACTA (FPS) QUICK QUICK MENU
WPN WHEEL (only items you have) SAVE LOAD
[SENS] [GYRO] [FPS] [keyboard]
(MENU's tray, when held)
(^^) 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.
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 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.
- 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. |
| 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. See The FORCE button and the Force meter below. |
| NEXT WPN | top left | Tap: next weapon. Swipe or long-press: the weapon wheel. |
| FORCE WHEEL | top left | Tap: next learned Force power. Swipe or long-press: the Force wheel. |
| LIGHT, IR, BACTA | top left, after FORCE WHEEL | Tap to use the field light, IR goggles or a bacta tank. Each button only appears once you have that item, always in the same spot. LIGHT and IR turn yellow while switched on. BACTA shows how many you have when it's more than one. |
| QUICK SAVE | top right | Hold for about a third of a second. See Quick save and quick load below. |
| QUICK LOAD | top right | Hold for about a third of a second. |
| MENU | top right corner | Tap: the game's menu (objectives, map, Jedi powers, save, load, setup). Hold: the hidden tray. |
FIRE, ALT, DUCK, ACT, JUMP and FORCE act as soon as you touch them. LIGHT, IR, BACTA, MENU and the tray buttons act when you lift your finger, so if you touch one by mistake, slide off before you lift.
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 four buttons, from left to right:
| Tray button | What it does |
|---|---|
| SENS | Tilt aiming's sensitivity: 1.0x, 1.5x (the default), 2.0x or 3.0x. At 1.0x the view turns exactly as far as the phone does. Dimmed while GYRO is off. |
| GYRO | Tilt aiming: OFF (the default), TOUCH or ALWAYS. Lit ... |
OpenJKDF2 for iOS v0.3
OpenJKDF2 for iOS v0.3: an unofficial iPhone and iPad build of OpenJKDF2, the open-source Jedi Knight: Dark Forces II engine, with on-screen touch controls. This release adds a new cheat, sithewok: everything at once (invincibility included) and a Force meter that never drains. Coming from v0.1? You also get what v0.2 added, including a weapon wheel, tilt aiming, Force power levels on the Force wheel, three ways to use the wheel buttons, and a shorter, safer QUICK LOAD. It's still experimental, so expect bugs.
You need your own copy of Star Wars Jedi Knight: Dark Forces II (GOG or Steam). No game files are included.
Setup guide: https://github.com/sithewok13-dev/First-repo-for-Claude-for-JKDF2/blob/HEAD/docs/ios/README.md
New here? Requirements and Install are at the bottom of this page, just above the download.
What's in v0.3
New since v0.2:
- A new cheat,
sithewok: everything at once, and a Force meter that never drains. During a level, hold MENU, tap the keyboard button in the tray, typesithewokand tap return. You get all weapons and ammo, every item and Force power (at 4 stars), full health and shields, and invincibility.sithewok offends the invincibility and the endless Force. Careful: it can decide your story path, andsithewok offdoesn't undo that. More catches in 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. Both buttons now work the same way: a quick tap steps to the next power or weapon, a swipe opens the wheel to pick by sliding, and a long press opens it to pick by tapping. See Tap, swipe or long-press below.
- Changed: a quick tap on FORCE WHEEL now selects your next learned Force power straight away. In v0.1 it opened the wheel. To open the wheel for tapping, long-press it instead.
- Changed: NEXT WPN now switches weapon when you lift your finger, not as soon as you touch it.
- Force power levels on the Force wheel: under each power you've learned, four stars show its level (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). There are three settings (OFF, TOUCH, ALWAYS) and four sensitivities.
- MENU's hidden tray (hold MENU) has two new buttons: it now holds SENS, GYRO, FPS and the keyboard (v0.1 had just FPS and the keyboard).
- QUICK LOAD needs a much shorter hold: about a third of a second, the same as QUICK SAVE (it was a full second). Both now follow the same safety rules: slide off to cancel, two fingers on one button save or load only once, and pressing both together only does the one whose ring fills first.
- QUICK LOAD no longer works while the cheat typing line is open (like QUICK SAVE).
- 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, and it stays clear of MENU's bigger tray.
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.
NEXT FORCE LIGHT IR BACTA (FPS) QUICK QUICK MENU
WPN WHEEL (only items you have) SAVE LOAD
[SENS] [GYRO] [FPS] [keyboard]
(MENU's tray, when held)
(^^) 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.
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 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.
- 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. |
| 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. See The FORCE button and the Force meter below. |
| NEXT WPN | top left | Tap: next weapon. Swipe or long-press: the weapon wheel. |
| FORCE WHEEL | top left | Tap: next learned Force power. Swipe or long-press: the Force wheel. |
| LIGHT, IR, BACTA | top left, after FORCE WHEEL | Tap to use the field light, IR goggles or a bacta tank. Each button only appears once you have that item, always in the same spot. LIGHT and IR turn yellow while switched on. BACTA shows how many you have when it's more than one. |
| QUICK SAVE | top right | Hold for about a third of a second. See Quick save and quick load below. |
| QUICK LOAD | top right | Hold for about a third of a second. |
| MENU | top right corner | Tap: the game's menu (objectives, map, Jedi powers, save, load, setup). Hold: the hidden tray. |
FIRE, ALT, DUCK, ACT, JUMP and FORCE act as soon as you touch them. LIGHT, IR, BACTA, MENU and the tray buttons act when you lift your finger, so if you touch one by mistake, slide off before you lift.
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 four buttons, from left to right:
| Tray button | What it does |
|---|---|
| SENS | Tilt aiming's sensitivity: 1.0x, 1.5x (the default), 2.0x or 3.0x. At 1.0x the view turns exactly as far as the phone does. Dimmed while GYRO is off. |
| GYRO | Tilt aiming: OFF (the default), TOUCH or ALWAYS. Lit yellow while tilt aiming is on. See Tilt aiming below. |
| FPS | Shows or hides a frame-rate counter, to the left of QUICK SAVE. Yellow while the counter is on. |
| Keyboard (the keyboard symbol) | Opens the game's typing line with the iPhone keyboard, for cheats. Tap it again to close the line. |
- SENS and GYRO show their current setting on the button (for example SENS 1.5x, GYRO OFF).
- 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 SENS or GYRO goes on to the next setting, and the tray stays open so you can tap again. The tray closes after FPS or the keyboard, 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.
- The app remembers SENS, GYRO and FPS next time you open it.
- 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.
Tilt aiming (gyro)
Turn and tilt the phone to aim, on top of dr...
OpenJKDF2 for iOS v0.2
OpenJKDF2 for iOS v0.2: an unofficial iPhone and iPad build of OpenJKDF2, the open-source Jedi Knight: Dark Forces II engine, with on-screen touch controls. This release adds a weapon wheel, tilt aiming, Force power levels on the Force wheel, three ways to use the wheel buttons, and a shorter, safer QUICK LOAD. It's still experimental, so expect bugs.
You need your own copy of Star Wars Jedi Knight: Dark Forces II (GOG or Steam). No game files are included.
Setup guide: https://github.com/sithewok13-dev/First-repo-for-Claude-for-JKDF2/blob/HEAD/docs/ios/README.md
New here? Requirements and Install are at the bottom of this page, just above the download.
What's in v0.2
New since 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. Both buttons now work the same way: a quick tap steps to the next power or weapon, a swipe opens the wheel to pick by sliding, and a long press opens it to pick by tapping. See Tap, swipe or long-press below.
- Changed: a quick tap on FORCE WHEEL now selects your next learned Force power straight away. In v0.1 it opened the wheel. To open the wheel for tapping, long-press it instead.
- Changed: NEXT WPN now switches weapon when you lift your finger, not as soon as you touch it.
- Force power levels on the Force wheel: under each power you've learned, four stars show its level (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). There are three settings (OFF, TOUCH, ALWAYS) and four sensitivities.
- MENU's hidden tray (hold MENU) has two new buttons: it now holds SENS, GYRO, FPS and the keyboard (v0.1 had just FPS and the keyboard).
- QUICK LOAD needs a much shorter hold: about a third of a second, the same as QUICK SAVE (it was a full second). Both now follow the same safety rules: slide off to cancel, two fingers on one button save or load only once, and pressing both together only does the one whose ring fills first.
- QUICK LOAD no longer works while the cheat typing line is open (like QUICK SAVE).
- 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, and it stays clear of MENU's bigger tray.
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.
NEXT FORCE LIGHT IR BACTA (FPS) QUICK QUICK MENU
WPN WHEEL (only items you have) SAVE LOAD
[SENS] [GYRO] [FPS] [keyboard]
(MENU's tray, when held)
(^^) 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.
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 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.
- 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. |
| 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. See The FORCE button and the Force meter below. |
| NEXT WPN | top left | Tap: next weapon. Swipe or long-press: the weapon wheel. |
| FORCE WHEEL | top left | Tap: next learned Force power. Swipe or long-press: the Force wheel. |
| LIGHT, IR, BACTA | top left, after FORCE WHEEL | Tap to use the field light, IR goggles or a bacta tank. Each button only appears once you have that item, always in the same spot. LIGHT and IR turn yellow while switched on. BACTA shows how many you have when it's more than one. |
| QUICK SAVE | top right | Hold for about a third of a second. See Quick save and quick load below. |
| QUICK LOAD | top right | Hold for about a third of a second. |
| MENU | top right corner | Tap: the game's menu (objectives, map, Jedi powers, save, load, setup). Hold: the hidden tray. |
FIRE, ALT, DUCK, ACT, JUMP and FORCE act as soon as you touch them. LIGHT, IR, BACTA, MENU and the tray buttons act when you lift your finger, so if you touch one by mistake, slide off before you lift.
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 four buttons, from left to right:
| Tray button | What it does |
|---|---|
| SENS | Tilt aiming's sensitivity: 1.0x, 1.5x (the default), 2.0x or 3.0x. At 1.0x the view turns exactly as far as the phone does. Dimmed while GYRO is off. |
| GYRO | Tilt aiming: OFF (the default), TOUCH or ALWAYS. Lit yellow while tilt aiming is on. See Tilt aiming below. |
| FPS | Shows or hides a frame-rate counter, to the left of QUICK SAVE. Yellow while the counter is on. |
| Keyboard (the keyboard symbol) | Opens the game's typing line with the iPhone keyboard, for cheats. Tap it again to close the line. |
- SENS and GYRO show their current setting on the button (for example SENS 1.5x, GYRO OFF).
- 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 SENS or GYRO goes on to the next setting, and the tray stays open so you can tap again. The tray closes after FPS or the keyboard, 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.
- The app remembers SENS, GYRO and FPS next time you open it.
- 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.
Tilt aiming (gyro)
Turn and tilt the phone to aim, on top of dragging. It starts switched off. Hold MENU and tap GYRO to step through the settings:
- 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 t...