# Introduction

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.
Jazz² Resurrection supports various versions of the original game, but it is recommended to use The Secret Files. Also, if you have more than one version, you can import all of them, but it's recommended to import The Secret Files as the last one. If you don't have any JJ2 version, you can run Import.exe by double-click (without parameters) and it will download and import Shareware Demo.

This project is hosted at GitHub.com/deathkiller/jazz2 and uses parts of Duality - A 2D GameDev Framework.

# Downloads

Latest version was released on May 20^th, 2020 (161 days ago). Release notes can be found here.
Once you download and install Android version, you will be prompted with some security permissions to install app outside the Play Store.

# Preview

# Running the application

Windows / Linux / macOS

• Download Desktop release (alternatively, build the solution and copy Content directory to ‹Game›/­Content/­)
• Run ‹Game›/­Import.­exe "Path to original JJ2" (or drag and drop original Jazz Jackrabbit 2 directory on Import.­exe)
  • On Linux and macOS, you can run mono Import.­exe "Path to original JJ2"
• Run ‹Game›/­Jazz2.­exe
  • On Linux and macOS, you can run mono Jazz2.­exe

‹Game› is path to Jazz² Resurrection. You can run Import.­exe without parameters to show additional options.

Android

• Download both Desktop and Android releases (alternatively, build the solution and copy Content directory to ‹Game›/­Content/­)
• Run ‹Game›/­Import.­exe "Path to original JJ2" on PC (or drag and drop original Jazz Jackrabbit 2 directory on Import.­exe)
• Copy ‹Game›/­Content/­ directory to ‹Storage›/­jazz2.­android/­Content/­
  • Alternatively, you can use ‹Storage›/­Android/­Data/­jazz2.­android/­Content/­ instead
  • Create empty file .­nomedia in ‹Storage›/­jazz2.­android/­ to hide files from Android Gallery
• Install Jazz2.­apk on Android device
• Run the newly installed application

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.

WebAssembly

• Go to Jazz² Resurrection page to play Shareware Demo online
  • Alternatively, build the solution and copy Content directory from Desktop release to build target directory

Requires Google Chrome 57 (or newer), Firefox 53 (or newer) or other browser supporting WebAssembly and WebGL.

# Dependencies

Windows

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

Linux

• Mono 5.0 (or newer)
• OpenAL
  • Run sudo apt install openal1 if it's missing
• libopenmpt (included in release)
  • Copy libopenmpt.­so (x86, and its dependencies) to ‹Game› directory

macOS

• Mono 5.0 (or newer)
• OpenAL should be already installed by OS
• libopenmpt
  • Copy libopenmpt.­dylib (x86, and its dependencies) to ‹Game› directory

Android

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

WebAssembly

• .NET Framework 4.5.2 (or newer) / Mono 5.0 (or newer)
• Mono.­WebAssembly.­Sdk (included as NuGet)
• WebGL.NET (included)

# Building the solution

Windows

• Open the solution in Microsoft Visual Studio 2019 (or newer) 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

Linux

• Install Mono 5.0 (or newer)
• Run msbuild in directory with the solution file (.sln):
• 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

macOS

• 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
• Obtain and copy libopenmpt.­dylib to /­Jazz2/­Bin/­Debug/­libopenmpt.­dylib to enable music playback
• If you build Release configuration, you have to replace Debug with Release in paths above

.NET Core 3.0 build can be compiled in a similar way (use Jazz2.­DotNetCore project). Compile errors about Jazz2.­Android project can be ignored, if the Android build is not needed.

Android

• Install Mobile development in .NET for Microsoft Visual Studio 2019 (or newer)
• Open the solution and build Jazz2.­Android project
• Dependencies are already included for common configurations

WebAssembly

• Open the solution and build Jazz2.­Wasm project
• Dependencies are already included for common configurations

# Extensions

OpenGL ES 2.0 (Experimental)

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/­Es20Backend project. The library will 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.

# License

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