Jazz Jackrabbit for Sega Genesis / Mega Drive

Project Status: Jazz Jackrabbit (Sega Genesis/Mega Drive Port)

Github repo: https://github.com/haroldo-ok/jazz-jackrabbit-for-sega-genesis

Warning: this is a very early work in progress prototype.

Current Deliverable: JazzJackrabbitGenesis.bin (A working 512 KB game file)

We have successfully taken assets from the classic 1994 PC shareware game Jazz Jackrabbit and used them to build a playable, stable prototype for the Sega Genesis hardware.

The initial prototype was created using Arena, and later versions were refined using Claude.

🛠️ What We Did

• Made it Work on Real Hardware: Early versions had critical code errors that caused the Sega Genesis to crash. We fixed how the game code is built so that it now runs perfectly smoothly on real Sega Genesis hardware and popular emulators (like BlastEm or Gens) without crashing.
• Controller Support: Fully mapped out the Genesis controller buttons:
  • D-Pad: Run Left/Right
  • A Button: Fire Weapon
  • B or C Buttons: Jump
  • Start: Pause the game
• Original Graphics & Animation: The game now extracts and uses the original graphics from the PC version. Jazz has eight of his original running and jumping animation frames, the backgrounds have their iconic blue/white gradient sky, and the red, green, and blue springs are all present.
• Smart Level Loading (Streaming): Instead of trying to force a massive PC level into the tiny memory of a Sega Genesis all at once, the engine now "streams" the map in real-time. It quietly loads new rows and columns of the map right as they are about to scroll onto your screen, resulting in smooth performance.
• Accurate Physics & Springs: We calibrated Jazz's movement based on the original PC game data. Walking up and down slopes works correctly, and jumping on the red, green, or blue springs launches you into the air with the correct, authentic speeds.
• Sound Effects: Three classic sound effects have been converted to the Genesis format: the machine gun firing (MACHGUN1), jumping (JUMPA11), and picking up items (YUM1).
• Automated Testing: We set up a testing system that automatically plays through parts of the game and takes hidden "screenshots" in the emulator to ensure updates don't break the graphics or gameplay. (Currently, all core tests are PASSING).

⚠️ Important Remaining Work (What's Still Missing)

While the foundational engine is solid, this is still a prototype and not a complete game yet. The biggest missing pieces are:

• 👾 Enemies & Bosses: There are no enemies on the map yet, and enemy AI has not been programmed.
• 💎 Pickups & Items: Gems, food, and extra ammunition cannot be collected yet, and a score system is missing.
• ⚙️ Advanced Obstacles: Moving platforms, conveyor belts, teleporters, water zones, and breakable walls are not yet functional.
• 🎵 Music: While a few sound effects work, the iconic PC music tracks have not yet been converted or added.
• 🖥️ Game Flow: There are no menus, cutscenes, bonus stages, or save-game systems yet.

📊 The Bottom Line

The hard part---getting the Sega Genesis to talk to, read, and smoothly display the original PC files---is done. The prototype features three playable test levels with functioning physics, jumping, shooting, and audio, paving the way to add enemies, items, and music next!