openDoJa

openDoJa is a desktop-focused clean-room reimplementation of the DoJa 5.1 runtime and related APIs, aimed at running i-appli Java games on modern computers.

Requirements

Java 22+

Build

mvn -q -DskipTests package

GitHub Actions

• Every push to master rebuilds the rolling nightly GitHub release and replaces its attached JAR.
• A GitHub release is created when the pom.xml version changes.

Download

• Nightly (most up-to-date) version: https://github.com/GrenderG/openDoJa/releases/download/nightly/opendoja-nightly.jar
• Latest (stable) version: https://github.com/GrenderG/openDoJa/releases/latest

Run

Open the desktop launcher UI:

java -jar opendoja-{version}.jar

Launch a specific JAM directly through the packaged launcher:

java -jar opendoja-{version}.jar --run-jam <game.jam>

Launch a JAM directly without the launcher UI, with explicit host scale, synth, user ID, and terminal ID:

java \
  -Dopendoja.hostScale=<x|fullscreen> \
  -Dopendoja.mldSynth=<fuetrek|ma3> \
  -Dopendoja.userId=<uid> \
  -Dopendoja.terminalId=<tid> \
  -jar opendoja-{version}.jar --run-jam <game.jam>

Print all available launcher options:

java -jar opendoja-{version}.jar --help

Reporting Broken Games

If a game does not work, please open a GitHub issue using the broken game report template.

Include:

• a text description of the issue
• the exact game that does not work
• screenshots or videos if they help explain the problem
• logs or stack traces if the issue is a crash

For the bundled local workflow used during development, see scripts/.

Third-party Dependencies

• jogl
• input4j