Jazz² Resurrection is reimplementation of game Jazz Jackrabbit 2 from year 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.

Uses parts of Duality - A 2D GameDev Framework.

• .NET Framework 4.5.2 (or newer)
• OpenALSoft
  • Copy x86/openal32.dll to ‹Game›/Extensions/OpenALSoft.x86.dll
  • Copy x64/openal32.dll to ‹Game›/Extensions/OpenALSoft.x64.dll
• libopenmpt
  • Copy libopenmpt.dll (x86, and its dependencies) to ‹Game› directory

• Mono 4.6 (or newer)
• OpenAL
• libopenmpt
  • Copy libopenmpt.so (x86, and its dependencies) to ‹Game› directory

• Mono 4.6 (or newer)
• libopenmpt

• Xamarin
• libopenmpt (included for armeabi-v7a and x86)

Requires Microsoft Visual Studio 2017 (or equivalent Mono compiler) to build the solution.

• Build the solution
• Copy Content directory to ‹Game›/Content
• Run ‹Game›/Import.exe "Path to JJ2" (or drag and drop JJ2 directory on Import.exe)
  • On macOS, you can run mono Import.exe "Path to JJ2"
• Run ‹Game›/Jazz2.exe
  • On macOS, you can run mono Jazz2.exe

You can run Import.exe without parameters to show additional options.

• Build the solution
• Run ‹Game›/Import.exe "Path to JJ2" (or drag and drop JJ2 directory on Import.exe)
• Copy ‹Game›/Content directory to ‹SDCard›/Jazz2.Android/Content
• Copy files from Jazz2.Android/Shaders directory to ‹SDCard›/Jazz2.Android/Content/Shaders
• Copy files from Jazz2.Android/Shaders/Internal directory to ‹SDCard›/Jazz2.Android/Content/Internal
• Create empty file .nomedia in ‹SDCard›/Jazz2.Android to hide game files in Android Gallery (optimal)
• Install APK file on Android
• Run the application

Requires device with Android 4.4 (or newer) and OpenGL ES 3.0. ‹SDCard› could be internal or external storage. The application tries to autodetect correct path. Also, you can use ‹SDCard›/Android/Data/Jazz2.Android or ‹SDCard›/Download/Jazz2.Android instead.

• Open the solution in Microsoft Visual Studio 2017 and build it
• Copy /Packages/AdamsLair.OpenTK.x.y.z/lib/OpenTK.dll.config to /Jazz2/Bin/Debug/OpenTK.dll.config
• Copy dependencies to /Jazz2/Bin/Debug/ or /Jazz2/Bin/Release/
• If you build Release configuration, you have to replace Debug with Release in paths above

• Install Mono 5.0 (or newer)
• Run following commands in directory with the solution file (.sln):

sudo apt install nuget
nuget restore
msbuild

• Copy /Packages/AdamsLair.OpenTK.x.y.z/lib/OpenTK.dll.config to /Jazz2/Bin/Debug/OpenTK.dll.config
• Obtain and copy libopenmpt.so to /Jazz2/Bin/Debug/libopenmpt.so to enable music playback
• Then you can rebuild the solution only with msbuild command
• Use msbuild /p:Configuration=Release to build Release configuration, you have to replace Debug with Release in paths above

• Install Mono 5.0 (or newer)
• Open the solution in Microsoft Visual Studio for Mac and build it
• Copy /Packages/AdamsLair.OpenTK.x.y.z/lib/OpenTK.dll.config to /Jazz2/Bin/Debug/OpenTK.dll.config
• If you build Release configuration, you have to replace Debug with Release in paths above

Errors about Jazz2.Android project can be ignored, if you don't need Android build.

• Install Mobile development in .NET to Microsoft Visual Studio 2017
• Open the solution and build Jazz2.Android project

Alternative OpenGL ES 2.0 backend can be built separatelly. 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 for it!

To use it, build Extensions/Es20Backend project. It should be copied to /Jazz2/Bin/Debug/Extensions/Es20Backend.core.dll automatically. Then copy all files from Content/_ES20 directory to /Jazz2/Bin/Debug/Content and replace them.

Also, you have to remove /Jazz2/Bin/Debug/Extensions/GL21Backend.core.dll file to disable default OpenGL 2.1 backend.

This project is licensed under the terms of the GNU General Public License v3.0.