MeBoy

Game Boy / Game Boy Color emulator for Java MIDP 2.0, plus a desktop builder (MeBoyBuilder) to generate a bundled MIDlet JAR.

Project Structure

• MeBoy/: MIDlet emulator sources (meboy.* classes).
• MeBoyBuilder/: Swing desktop app to bundle ROMs into a new MeBoy.jar + .jad.

Requirements

• JDK 8.
• Java ME Wireless Toolkit in C:\WTK2.5.2_01.
• NetBeans project metadata is included (nbproject/).

Build Order (Important)

1. Build MeBoy first.
2. Build and run MeBoyBuilder.
3. In MeBoyBuilder, add ROMs and create output JAR/JAD.

MeBoyBuilder now searches required emulator resources in:

• ../MeBoy/build/compiled/
• ../MeBoy/build/preverified/
• ../MeBoy/resources/
• ../MeBoy/dist/MeBoy.jar

So the emulator project must exist and be built before bundling.

Notes About Bundled ROMs

• Bundled ROM chunks are stored under meboy/<cartID><index>.
• MIDlet-1 points to meboy.MeBoy.
• Split logic uses ceil division, so final partial ROM chunk is not lost.

Builder Icon Resources

Default builder icons must be on the classpath:

• MeBoyBuilder/src/meboy0.png
• MeBoyBuilder/src/meboy1.png
• MeBoyBuilder/src/meboy2.png

Run In KEmulator Lite

Use 32-bit Java to match KEmulator SWT DLLs:

& 'C:\Program Files (x86)\Java\jre1.8.0_202\bin\java.exe' "-Djava.library.path=C:\Users\chiju\Downloads\java me\KEmulator_JavaEmulator.com" -jar 'C:\Users\chiju\Downloads\java me\KEmulator_JavaEmulator.com\KEmulator.jar'

If KEmulator reports Unsupported major.minor version, rebuild MIDlet classes with Java 5 target before creating MeBoy.jar.

Changelog

See CHANGELOG.md.

GitHub Releases

Release management is tied to MeBoy/resources/version.properties.

1. Update MeBoy/resources/version.properties.
2. Add or update the matching entry in CHANGELOG.md.
3. Commit the changes.
4. Create a Git tag that matches the version exactly, for example v2.4.2.
5. Push the commit and tag to GitHub.

The workflow at .github/workflows/release.yml will:

• verify that the tag matches app.version
• generate release notes from CHANGELOG.md
• publish a GitHub Release named MeBoy X.Y.Z

If CHANGELOG.md has no exact X.Y.Z section, the workflow also accepts the shorter X.Y heading as a fallback.

License

MeBoy is distributed under GPLv2 license.

LEGAL: This product is not affiliated with, nor authorized, endorsed or licensed in any way by Nintendo Corporation, its affiliates or subsidiaries.

Credits

• Neil Millstone millstone - JavaBoy, original Java-based Game Boy emulator behind MeBoy.
• Bjorn Carlin arktos - Creator of the original MeBoy for J2ME.