v0.5.0 - Jazz Jackrabbit 2 for the Miyoo Mini

Jazz Jackrabbit 2 on the Miyoo Mini and Miyoo Mini Plus, running on OnionOS at a steady 30 FPS with
sound, music and the cinematics.

You need your own copy of Jazz Jackrabbit 2. No game data is distributed here. A converter is
included that turns your installation into the data the port loads, on your own PC.

Installing

1. Unpack jazz2-miyoo-v0.5.0-SDcard.zip into the root of your SD card.
2. On a Windows PC, drag your Jazz Jackrabbit 2 folder onto Tools\Convert Jazz Jackrabbit 2.bat.
   It writes a Content folder next to itself; it takes a few seconds. Point it at the folder that
   holds Anims.j2a and Jazz2.exe — the original CD, the GOG or Steam release, any of them work.
   The Shareware Demo is not enough.
3. Copy that Content folder into Roms/PORTS/Games/Jazz Jackrabbit 2/ on the card.
4. Start Jazz Jackrabbit 2 from the PORTS menu.

Tools/ is only needed for the conversion; delete it from the card afterwards if you want the
space back.

Controls

Button	In game	In menus
D-pad	Move	Navigate
B	Jump	Back
A	Run	Confirm
Y	Fire	—
X	Change weapon	—
START	Pause menu	Confirm
SELECT	Menu	Back
MENU	Quit to the PORTS menu	Quit

Menus follow the console's own convention — A confirms, B goes back — while the game keeps the
engine's layout, where B is the jump button under your thumb.

What works

• The full single-player campaign: all six original episodes, all their levels, Jazz, Spaz and Lori
• Sound effects and module music, the intro and ending cinematics
• Saving, settings, and the in-game menu

What does not

• Multiplayer of any kind
• Custom levels and episodes — only what the original game shipped is converted
• Textured backgrounds. JJ2's warped perspective sky is a per-pixel effect that cost more than a
  third of the frame on this hardware, so that layer draws flat. It is the one visible compromise
• The rendering is not pixel-exact: 304×228 internally, upscaled by the display hardware, and the
  lighting uses a NEON approximation that is a shade off the reference

What's new in 0.5.0

The port itself is unchanged since 0.4.0. This release is what was missing for anyone else to use
it: the Windows converter, a content tree that records what it was built against so a stale one is
refused with a clear message rather than loading wrong assets, and the licensing and documentation.

See CHANGELOG.md for the detail, including the measurements behind each performance decision.

Reporting a problem

Roms/PORTS/Games/Jazz Jackrabbit 2/log.txt holds the last run and log.prev.txt the one before.
Attach the log and say which level it happened in. jazz2-v0.5.0.unstripped is the same binary
with symbols, for resolving crash addresses.

Licence

The engine is Jazz² Resurrection by deathkiller,
GPL-3.0, so this port is too. The corresponding source is this repository:
patches/0001-miyoo-port.patch against upstream b8cba70, applied by docker/fetch-engine.sh.
Third-party components and their licences are listed in LICENSE-NOTES.md.