A personal project to rebuild the look of Star Wars Jedi Knight (1997) on a modern Mac, while keeping it unmistakably Jedi Knight.
Left: the game today, running natively on Apple Silicon. Right: the art direction (AI concept art of the same room, used as a north star, not a promise).
Jedi Knight is one of my all-time favourite games, and this fork is where I'm remastering it: native on Apple Silicon first, then modern lighting, HD materials, new models and upscaled cutscenes. The goal is the game as you remember it, rather than how it actually looked in 1997.
The engine is OpenJKDF2, the community's function-by-function reimplementation of the original engine. All the hard reverse-engineering credit goes to that project. Everything here is built on top of it and kept in sync with it.
What it isn't: a new game, a mod pack or a commercial product. No game assets are included or ever will be. You need your own copy of the game (the GOG version is recommended).
The target is dark, wet, grimy and atmospheric: lived-in industrial rather than clean sci-fi. Light pools on wet metal, haze in the air, light shafts through skylights, dense blacks and a desaturated, warm-brown grade.
That breaks down into concrete engine work:
| The look needs | How | Status |
|---|---|---|
| Lights that pool on surfaces and glint off wet metal | Per-pixel lighting with specular highlights | Done (playtesting) |
| Wet floors reflecting light strips, sky and objects | Screen-space reflections | Done (playtesting) |
| Haze and light shafts | Volumetric fog lit by the baked light, screen-space light shafts | Fog on all 25 levels (playtesting); height fog, smoke and steam next |
| Filmic colour | Colour grading pass with live-reloading .cube LUTs from Resolve | Done |
| Glowing lights and sabers that roll off softly | Bloom (built in) into a half-float buffer with highlight roll-off | Done |
| Every shot lit like a film: side key light, rim light on every character, nothing flat | Light bake with recovered designer lights (Blender Cycles); light probes so characters take the baked light's colour and direction, plus key, rim and floor light | All 25 levels baked: light maps and light probes in game (playtesting) |
| Crisp, detailed, grimy surfaces | HD textures with roughness and normal maps | Stage 3 |
| Detailed characters | New models through a Blender pipeline | Stage 4 |
| Stage | What | Status |
|---|---|---|
| 1 | Native build on Apple Silicon, one-command build and run | Done |
| 2 | Rendering: Retina, filtering, colour grading, per-pixel lighting, atmosphere | In progress |
| 3 | HD textures with material maps, true-colour replacement loader | In progress |
| 4 | Models: Blender import/export for .3DO and .KEY, new Kyle and stormtroopers | In progress |
| 5 | Cutscenes: upscaled and graded, played from modern video files | In progress |
| 6 | Mysteries of the Sith: the same treatment for the expansion | Not started |
- Audit what the renderer already offers (bloom, SSAO, SSAA, filtering, FOV and frame cap are all built in)
- Silent, repeatable screenshot and frame-timing captures for before/after comparisons
- Retina (HiDPI) by default on macOS
- Mipmaps and anisotropic filtering for true-colour textures
- Colour grading: exposure, highlight roll-off, live-reloading .cube LUTs
- Measure the cost of bloom, SSAO and SSAA (130+ fps with everything on)
- Art direction chosen
- Per-pixel lighting with wet highlights for dynamic lights (plan), being playtested
- Highlights from glowing surfaces: built, but reads as blobs rather than wet; off by default
- Screen-space reflections for wet, reflective floors (being playtested)
- Coloured light from sabers, including enemy sabers
- Haze and light shafts (being playtested)
- Volumetric cloud sky with moon shafts on the storm levels (Maw, Sarris, the ascent); other skies to follow
- Cinematic key and rim light on characters and props (first pass)
- Light bake in game: baked light maps replace the 1997 corner light on six test levels (
r_lightmaps, in the remaster preset) (plan) - Light probes: characters and props lit by the bake around them (colour, direction, floor light)
- Light bake on all 25 levels: light maps, light probes and light volumes
- Light bake tuning (sun for day levels)
- Volumetric fog lit by the baked light (
r_volumetricFog, all 25 levels) - Height fog on outdoor levels, distance fog
- Fog volumes placed by hand in Blender (
tools/blender/atmos_volumes.py) - Smoke and steam emitters, placed in Blender, lit by the bake
- Dust in the light; light shafts that stop at walls (plan)
- One-switch preset:
remaster 1in the console
- Research: OpenJKDF2 already loads HD texture packs (colour, glow, displacement maps)
- Tool to extract every original texture to PNG (
tools/mat_extract.py) - Rebuild the community Neural Upscale pack from its installer (555 textures matched so far)
- Rebuild from all three Remastered installers, palette-correct (no wrong colours in other levels)
- Engine fix: HD texture hashes use the level's real palette (coverage went from almost none to dozens per view)
- Performance: full remaster + HD runs at 156 fps on the MacBook's native screen; a 7680x3240 ultrawide gets automatic render scaling (52 -> 77 fps). The earlier slowdowns were Topaz and Texture God sharing the GPU
- Material maps in the engine: roughness, metalness, AO and normal maps per texture (rock defaults to matte)
- Importer for Texture God output (my own AI upscaling and PBR pipeline)
- First full Texture God batch in game (217 level textures, gritty look, own pack)
- Texture God on every level, including per-level palette variants (507 textures in game)
- Roughness and normal maps for the wet, grimy look (loader support plus generation)
- Upscale and hand-finish key textures (hangar, Nar Shaddaa, Kyle)
- Blender tools: the community blender-sith add-on, tested on Kyle and the stormtrooper (model and animation in and out of Blender 5.3, identical in game)
- Tool to pull any model, animation or texture out of the game archives (
tools/gob_extract.py) - Engine limits mapped: 512 vertices and 512 faces per body part, 64 joints
- Raise the per-part limits for detailed models (8192 vertices per mesh)
- Skinning: one continuous mesh bends with the original skeleton, so every original animation drives modern characters (tested pixel-identical)
- Fit Jedi Academy's Kyle onto JK's skeleton (tools/blender/ja_to_jk.py): in game, driven by the original animations
- Stormtrooper from Jedi Academy (keeps JK's own rifle as a rigid part)
- The cast from Jedi Academy: officers, commandos, Grans, Rodians, Trandoshans, Ugnaughts (18 JK models)
- Animation check: crouch, fire, jump, punch and saber swing drive the new Kyle cleanly
- Named characters (Jerec and the Dark Jedi, Jan) and civilians
- Material pass on the converted characters (Texture God) - Kyle done (roughness/AO/normal maps)
- New Kyle, built in the original's 16 rigid parts so every existing animation still drives him
- New stormtrooper
- New lightsaber: Kyle's hilt from Jedi Outcast in third person, first person and the pickups
- Third-person weapons no longer carry the 1997 hand
- Glowing plasma blades: white-hot core, coloured sheath and halo, animated, lighting the room (
r_saberGlow) - Lightsaber swing trails (only on real swings)
- First-person hands: Kyle's gloves and sleeves on every weapon view
- First-person hands v2: bare hands (free PSX arms pack), rounded sleeves, Texture God jacket
- Extract all 25 cutscenes (640x300, 15 fps, 33 minutes) to ProRes for upscaling and grading (
scripts/extract_cutscenes.sh) - Engine plays HD replacements (H.264, HEVC or ProRes, any resolution or frame rate) in place of the originals, with the originals as fallback and subtitles kept
- Upscale all 25 (Topaz, 3x to 1920x900, original 15 fps; interpolation looked janky)
- Grade in After Effects
- Playtest every cutscene in game
Every comparison below is the real 1997 game (original models, textures and lighting) on the left and the remaster on the right. Work in progress lives on feature branches until it's been playtested; the newest items are on stage2-atmosphere.
Baked lighting, light probes and volumetric fog. Every level's lighting has been re-baked in Blender's Cycles path tracer: the level designers' lights (recovered from the 1997 lighting), every glowing strip and lamp as a real light, and sky light through openings, with shadows and bounce light. Levels use the result as light maps; characters and props take their light from baked light probes (colour, direction, a rim from the light behind them and the glow of the floor under their feet); and the air is filled with volumetric fog lit by the same bake, so it glows red over the hangar strips and stays dark between lights. All 25 levels are baked.
Six levels, 1997 vs remaster:
Everything together: HD textures, Jedi Academy's cast on the original skeletons, per-pixel lighting, wet reflections, bloom, ambient occlusion, a filmic grade and the new skies (open the console with backtick and type remaster 1; remaster 0 for the original):
Bloom and lens flares: bright light fixtures (skylights, lamps, light panels) bloom, and everything bright throws a film-style anamorphic streak and lens ghosts:
Fog placed by hand: a Blender add-on loads any level, lets me drop boxes and ellipsoids of fog over it and exports them for the game. First use: low mist rolling across the hangar floor, lit red by the strips:
Smoke, steam and dust: smoke and steam emitters can be placed with the same Blender add-on (they billow, rise, fade into floors and walls and take the baked light); they'll go where something motivates them, like vents, grates and wreckage. Dust motes drift and twinkle wherever the air is lit (hangar clip: fog, floor mist and dust in motion).
Skies: a volumetric cloud sky on the storm levels and presets for the rest (Nar Shaddaa smog, Sulon overcast, day and sunset skies):
Lightsaber: a glowing plasma blade instead of a flat textured strip, a white-hot core, a deep coloured sheath and a halo that lights the room, with swing trails. (video)
The cast: most of Jedi Knight's characters now use Jedi Academy's models, fitted onto the original skeletons so every 1997 animation still drives them (same lighting and framing for each pair):
Texture God on every level: my own AI upscaling and PBR pipeline covers every level texture, including per-level palette variants (507 textures in game). Original texture (left of each pair) vs Texture God:
Cutscenes: all 25 play upscaled in game (Topaz, 1920x900), original (left) vs upscale:
Next up: materials (roughness and normal maps, so wet metal shines and cloth doesn't).
Decisions, findings and dead ends are logged as I go in docs/DECISIONS.md.
git clone --recursive https://github.com/domdino/OpenJKDF2.git
cd OpenJKDF2
brew install cmake imagemagick openal-soft glew libpng openssl@3 protobuf libmodplug innoextract
scripts/build.shExtract your own copy of the game into gamedata/jk1/. For the GOG installer: innoextract --language english -I app <installer.exe>, then move the contents of app/ there. Then:
scripts/run.shTo see the remastered look, open the console in game (backtick) and type remaster 1. Colour grades live in grade/; the game reloads grade/default.cube live whenever it changes.
All engine credit goes to the OpenJKDF2 project and its contributors. Star Wars, Jedi Knight and related marks are the property of Lucasfilm and Disney. This project is not affiliated with or endorsed by them, includes no original game assets, and is for personal, non-commercial use only. Concept images are AI-generated references for art direction.











