Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/deathkiller/jazz2

🎮 · Jazz² Resurrection: Open-source reimplementation of Jazz Jackrabbit 2
https://github.com/deathkiller/jazz2

2d 2d-game android game game-2d gamedev jazz-jackrabbit linux macos multi-platform opengl reimplementation steamdeck windows windows-10

Last synced: 29 days ago
JSON representation

🎮 · Jazz² Resurrection: Open-source reimplementation of Jazz Jackrabbit 2

Awesome Lists containing this project

README 

        


    Jazz² Resurrection






    Open-source Jazz Jackrabbit 2 reimplementation






  

    Brought to you by @deathkiller

  






## Introduction

> 🚧 **The game was fully rewritten since version 1.0.0, please visit **[deathkiller/jazz2-native](https://github.com/deathkiller/jazz2-native)** to build it instead.** This repository will contain only new [Releases](https://github.com/deathkiller/jazz2/releases). For more information, visit [the official website](https://deat.tk/jazz2/).



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](https://deat.tk/jazz2/).



[![Build Status](https://img.shields.io/github/actions/workflow/status/deathkiller/jazz2-native/linux.yml?branch=master&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0iI2ZmZmZmZiIgZD0iTTI0IDIuNXYxOUwxOCAyNCAwIDE4LjV2LS41NjFsMTggMS41NDVWMHpNMSAxMy4xMTFMNC4zODUgMTAgMSA2Ljg4OWwxLjQxOC0uODI3TDUuODUzIDguNjUgMTIgM2wzIDEuNDU2djExLjA4OEwxMiAxN2wtNi4xNDctNS42NS0zLjQzNCAyLjU4OXpNNy42NDQgMTBMMTIgMTMuMjgzVjYuNzE3eiI+PC9wYXRoPjwvc3ZnPg==)](https://github.com/deathkiller/jazz2-native/actions)

[![Latest Release](https://img.shields.io/github/v/tag/deathkiller/jazz2?label=release)](https://github.com/deathkiller/jazz2/releases/latest)

[![All Downloads](https://img.shields.io/github/downloads/deathkiller/jazz2/total.svg?color=blueviolet)](https://github.com/deathkiller/jazz2/releases)

[![Code Quality](https://img.shields.io/codacy/grade/64eb3ca12bd04c64bf3f3515744b591a.svg?logo=codacy&logoColor=ffffff)](https://www.codacy.com/app/deathkiller/jazz2-native)

[![License](https://img.shields.io/github/license/deathkiller/jazz2-native.svg)](https://github.com/deathkiller/jazz2-native/blob/master/LICENSE)

[![Discord](https://img.shields.io/discord/355651795390955520.svg?color=839ef7&label=chat&logo=discord&logoColor=ffffff&labelColor=586eb5)](https://discord.gg/Y7SBvkD)



## Preview



    Preview




:tv: Watch gameplay videos



## Running the application

### Windows

* Download the game

* Copy contents of original *Jazz Jackrabbit 2* directory to `‹Game›\Source\`

* Run `‹Game›\Jazz2.exe`, `‹Game›\Jazz2_avx2.exe` or `‹Game›\Jazz2_sdl2.exe` application



`‹Game›` *denotes path to Jazz² Resurrection. The game requires **Windows 7** (or newer) and GPU with **OpenGL 3.0** support. Game files should **not** be copied to* `Program Files`*. Cache is recreated during intro cinematics on the first startup, so it can't be skipped.*



### Linux

* Download the game

* Install dependencies: `sudo apt install libglew2.2 libglfw3 libsdl2-2.0-0 libopenal1 libvorbisfile3 libopenmpt0`

  * Alternatively, install provided `.deb` or `.rpm` package and dependencies should be installed automatically

* Copy contents of original *Jazz Jackrabbit 2* directory to `‹Game›/Source/`

  * If packages are used, the files must be copied to `~/.local/share/Jazz² Resurrection/Source/` or `/usr/local/share/Jazz² Resurrection/Source/` instead, please follow instructions of specific package

* Run `‹Game›/jazz2` or `‹Game›/jazz2_sdl2` application

  * If packages are used, the game should be visible in application list



`‹Game›` *denotes path to Jazz² Resurrection.* `~` *denotes user's home directory. The game requires GPU with **OpenGL 3.0** or **OpenGL ES 3.0** (ARM) support. Cache is recreated during intro cinematics on the first startup, so it can't be skipped.*



Alternatively, you can use package repository for your Linux distribution:


[![ArchLinux](https://img.shields.io/badge/Arch%20Linux-grey?logo=archlinux&logoColor=ffffff)](https://aur.archlinux.org/packages/jazz2-bin)

[![Flathub](https://img.shields.io/flathub/v/tk.deat.Jazz2Resurrection?label=Flathub&logo=flathub&logoColor=ffffff)](https://flathub.org/apps/tk.deat.Jazz2Resurrection)

[![Gentoo](https://img.shields.io/badge/Gentoo-grey?logo=gentoo&logoColor=ffffff)](https://packages.gentoo.org/packages/games-arcade/jazz2)

[![NixOS](https://img.shields.io/badge/NixOS-grey?logo=nixos&logoColor=ffffff)](https://search.nixos.org/packages?channel=unstable&show=jazz2&from=0&size=50&sort=relevance&type=packages&query=jazz2)

[![OpenSUSE](https://img.shields.io/obs/games/jazz2/openSUSE_Tumbleweed/x86_64?label=OpenSUSE&logo=opensuse&logoColor=ffffff)](https://build.opensuse.org/package/show/games/jazz2)

[![Ubuntu](https://img.shields.io/badge/Ubuntu-grey?logo=ubuntu&logoColor=ffffff)](https://xtradeb.net/play/jazz2/)



### macOS

* Download the game and install provided `.dmg` application bundle

* Copy contents of original *Jazz Jackrabbit 2* directory to `~/Library/Application Support/Jazz² Resurrection/Source/`

* Run the newly installed application



`~` *denotes user's home directory. Cache is recreated during intro cinematics on the first startup, so it can't be skipped.*



Alternatively, you can install it using [![Homebrew](https://img.shields.io/homebrew/cask/v/jazz2-resurrection?logo=homebrew&logoColor=ffffff&label=Homebrew&color=b56b2b)](https://formulae.brew.sh/cask/jazz2-resurrection) `brew install --cask jazz2-resurrection`



### Android

* Download the game

* Install `Jazz2.apk` or `Jazz2_x64.apk` on the device

* Copy contents of original *Jazz Jackrabbit 2* directory to `‹Storage›/Android/data/jazz2.resurrection/files/Source/`

  * On **Android 11** or newer, you can *Allow access to external storage* in main menu, then you can use these additional paths:

    * `‹Storage›/Games/Jazz² Resurrection/Source/`

    * `‹Storage›/Download/Jazz² Resurrection/Source/`

* Run the newly installed application



`‹Storage›` *usually denotes internal storage on your device.* `Content` *directory is included directly in APK file, no action is needed. The game requires **Android 5.0** (or newer) and GPU with **OpenGL ES 3.0** support. Cache is recreated during intro cinematics on the first startup.*



### Nintendo Switch

* Download the game

* Install `Jazz2.nro` package (custom firmware is needed)

* Copy contents of original *Jazz Jackrabbit 2* directory to `/Games/Jazz2/Source/` on SD card

* Run the newly installed application with enabled full RAM access



*Cache is recreated during intro cinematics on the first startup, so it can't be skipped. It may take more time, so white screen could be shown longer than expected.*



### Web (Emscripten)

* Go to https://deat.tk/jazz2/wasm/

* Import episodes from original *Jazz Jackrabbit 2* directory in main menu to unlock additional content



*The game requires browser with **WebAssembly** and **WebGL 2.0** support – usually any modern web browser.*



### Xbox (Universal Windows Platform)

* Download the game

* Install `Jazz2.cer` certificate if needed (the application is self-signed)

* Install `Jazz2.msixbundle` package

* Run the newly installed application

* Copy contents of original *Jazz Jackrabbit 2* directory to destination shown in the main menu

  * Alternatively, copy the files to `\Games\Jazz² Resurrection\Source\` on an external drive to preserve settings across installations, the application must be set to `Game` type, `exFAT` is recommended or correct read/write permissions must be assigned

* Run the application again



## Building the solution

**The game was fully rewritten since version 1.0.0, please build [deathkiller/jazz2-native](https://github.com/deathkiller/jazz2-native) instead.** This repository will contain only new [Releases](https://github.com/deathkiller/jazz2/releases). For more information, visit [the official website](https://deat.tk/jazz2/). There is also [the developer documentation](https://deat.tk/jazz2/docs/).



## License

This project is licensed under the terms of the [GNU General Public License v3.0](./LICENSE).