https://github.com/grenderg/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.
https://github.com/grenderg/opendoja
Last synced: 11 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/grenderg/opendoja
- Owner: GrenderG
- License: gpl-3.0
- Created: 2026-03-30T17:40:21.000Z (28 days ago)
- Default Branch: master
- Last Pushed: 2026-04-04T22:48:21.000Z (22 days ago)
- Last Synced: 2026-04-05T14:03:14.790Z (22 days ago)
- Language: Java
- Size: 1.97 MB
- Stars: 8
- Watchers: 0
- Forks: 1
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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.
## Build
```bash
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:
```bash
java -jar opendoja-{version}.jar
```
Launch a specific JAM directly through the packaged launcher:
```bash
java -jar opendoja-{version}.jar --run-jam
```
Launch a JAM directly without the launcher UI, with explicit host scale, synth, user ID, and terminal ID:
```bash
java \
-Dopendoja.hostScale= \
-Dopendoja.mldSynth= \
-Dopendoja.userId= \
-Dopendoja.terminalId= \
-jar opendoja-{version}.jar --run-jam
```
Print all available launcher options:
```bash
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/`.