What's new?
- Added an automated, one-time installer which is able to install OpenJKDF2 for the current user, if
resource/jk_.cdis not found.- Filenames for each required asset that needs to be installed are displayed in an error dialog before prompting an install.
- Assets can be installed either from an existing GOG/Steam installation, or via original game CDs.
- Assets are installed to the following locations:
%appdata%/Local/openjkdf2/on Windows, or~/.local/share/openjkdf2on macOS and Linux.
- Fatal errors will now check for missing essential assets, and prompt a reinstall if necessary.
- Windows can now load game assets from
%appdata%/Local/openjkdf2/, if assets are not found in the launching directory. resource/shadershas been removed from the distribution zips and are now embedded in the game executable. Custom shaders can still be loaded from<install_root>/resource/shaders/for development/modding purposes, however it is suggested to delete this folder to allow for more streamlined updating.
About these builds
Currently, I am only providing 64-bit builds for Windows and MacOS to find regressions and undefined behavior; Linux users have to compile for now (See BUILDING.md for instructions). It is recommended to backup any savedata you place significant value on before running.
Running
Windows: Extract the distribution zip so that openjkdf2-64.exe is in the same directory as JK.EXE and then run openjkdf2-64.exe.
MacOS: Copy OpenJKDF2.app into your Applications folder and run it.
Linux: openjkdf2-64 into the same directory as JK.EXE and run.
If game assets are missing, an install prompt will show on startup and ask for either:
- An existing GOG/Steam/original installation
- An original Disk 1, followed by Disk 2
If you are not using custom shaders, delete resource/shaders/ to revert to the default graphical settings.
My game crashed, what do I do?
I'm looking for regressions and crashes! File an issue or email me at mtinc2@gmail.com with a crash stacktrace. If it's reproducible, a savefile or instructions to reproduce would also be appreciated.
Linux: Copy the crash log from crash.log or the console output.
MacOS: Cmd+Space, type Console.app and copy the entire crash report from openjkdf2-64. Alternatively, copy the crash log from crash.log
Windows: Copy the crash log from openjkdf2-64.RPT.
Crash logs will be located in directory assets are located. If you cannot find them, be sure to check %appdata%/Local/openjkdf2/ on Windows, or ~/.local/share/openjkdf2 on macOS/Linux.
QoL feature notes:
- Music is loaded from audio tracks dumped to
MUSIC/TrackN.oggin ogg vorbis format (same as the GOG release), if they are present. - Menus and the game viewport auto-rescale to the window size, with appropriate aspect ratio vertex projection (ultrawide, or at least wide-er monitor support).
- Game runs at full framerates instead of 30FPS/50FPS in Singleplayer (validated up to 144FPS)
- Weapon waggle is scaled properly with FPS
- FOV is adjustable in Settings > General
- HiDPI is configurable in Settings > General
- HUD elements are scaled with screen resolution
- LOD and mipmap distances are scaled with render resolution to ensure textures and models don't degrade noticeably on higher-resolution screens.
What isn't working:
- Joystick menu in Setup > Controls (input bindings are still loaded and written to config, though)
- Load Configuration and Save Configuration in Setup > Controls > Options
- Multiplayer menu and all submenus
- Multiplayer tally screen
- Multiplayer character builder
- Map view in ESC menu
- Using plus or minus to resize the screen (with SDL2, resolution auto-resizes to window size)
- Subtitles and credits
- In-game screenshots