:video_game: · Jazz² Resurrection: An open-source reimplementation of Jazz Jackrabbit 2
Jazz² Resurrection is reimplementation of the game Jazz Jackrabbit 2 released in 1998. Supports various versions of the game (Shareware Demo, Holiday Hare '98, The Secret Files and Christmas Chronicles). Also, it partially supports some features of JJ2+ extension and MLLE. Further information can be found here.
This project uses parts of Duality - A 2D GameDev Framework.
Contentdirectory to
‹Game›/Content/)
‹Game›/Import.exe "Path to original JJ2"(or drag and drop original Jazz Jackrabbit 2 directory on
Import.exe)
mono Import.exe "Path to original JJ2"
‹Game›/Jazz2.exe
mono Jazz2.exe
‹Game›is path to Jazz² Resurrection. You can run
Import.exewithout parameters to show additional options.
Contentdirectory to
‹Game›/Content/)
‹Game›/Import.exe "Path to original JJ2"(or drag and drop original Jazz Jackrabbit 2 directory on
Import.exe)
‹Game›/Content/directory to
‹Storage›/jazz2.android/Content/
‹Storage›/Android/Data/jazz2.android/Content/instead
.nomediain
‹Storage›/jazz2.android/to hide files from Android Gallery
Jazz2.apkon Android device
Requires device with Android 5.0 (or newer) and OpenGL ES 3.0 support.
‹Storage›could be internal (preferred) or external storage. The application tries to autodetect correct paths.
Contentdirectory from Desktop release to build target directory
Requires Google Chrome 57 (or newer), Firefox 53 (or newer) or other browser supporting WebAssembly and WebGL.
x86/openal32.dllto
‹Game›/Extensions/OpenALSoft.x86.dll
x64/openal32.dllto
‹Game›/Extensions/OpenALSoft.x64.dll
libopenmpt.dll(x86, and its dependencies) to
‹Game›directory
sudo apt install openal1if it's missing
libopenmpt.so(x86, and its dependencies) to
‹Game›directory
libopenmpt.dylib(x86, and its dependencies) to
‹Game›directory
Mono.WebAssembly.Sdk(included as NuGet)
/Packages/AdamsLair.OpenTK.x.y.z/lib/OpenTK.dll.configto
/Jazz2/Bin/Debug/OpenTK.dll.config
/Jazz2/Bin/Debug/or
/Jazz2/Bin/Release/
Debugwith
Releasein paths above
msbuildin directory with the solution file (.sln):
/Packages/AdamsLair.OpenTK.x.y.z/lib/OpenTK.dll.configto
/Jazz2/Bin/Debug/OpenTK.dll.config
libopenmpt.soto
/Jazz2/Bin/Debug/libopenmpt.soto enable music playback
msbuildcommand
msbuild /p:Configuration=Releaseto build Release configuration, you have to replace
Debugwith
Releasein paths above
/Packages/AdamsLair.OpenTK.x.y.z/lib/OpenTK.dll.configto
/Jazz2/Bin/Debug/OpenTK.dll.config
libopenmpt.dylibto
/Jazz2/Bin/Debug/libopenmpt.dylibto enable music playback
Debugwith
Releasein paths above
**.NET Core 3.0* build can be compiled in a similar way (use*
Jazz2.DotNetCoreproject). Compile errors about
Jazz2.Androidproject can be ignored, if the Android build is not needed.
Jazz2.Androidproject
Jazz2.Wasmproject
Alternative OpenGL ES 2.0 backend can be built separately. It does not contain all features that are available in default OpenGL 2.1 backend, but it should run faster on low-end configurations. Don't use it if you have no reason to do so!
To use it, build
Extensions/Es20Backendproject. The library will be copied to
/Jazz2/Bin/Debug/Extensions/Es20Backend.core.dllautomatically. Then copy all files from
Content/_ES20directory to
/Jazz2/Bin/Debug/Contentand replace them.
Also, you have to remove
/Jazz2/Bin/Debug/Extensions/GL21Backend.core.dllfile to disable default OpenGL 2.1 backend.
This project is licensed under the terms of the GNU General Public License v3.0.