mulfyx/w4me-station: Run WASM-4 games on Java ME phones — CLDC 1.1 / MIDP 2.0 · GitHub

Run WASM-4 games on Java ME phones.

W4ME Station brings unmodified WebAssembly cartridges to CLDC 1.1 / MIDP 2.0
devices, including feature phones from the mid 2000s.

Thirteen bundled cartridges ship in a 275 KB JAR. The runtime uses no JIT, and
the bundled library needs no network connection. Both release variants stay
below 300 KB.

SHA-256 checksums are stored beside the version 1.0.0
artifacts.

W4ME Station targets CLDC 1.1 / MIDP 2.0 devices. It is independent from and not
endorsed by the WASM-4 maintainers.

Further .wasm files can be installed from the device.

• validated WebAssembly execution with a persistent fixed-width W4IR cache;
• WASM-4 graphics, input, audio, disk, text, and tracing host APIs;
• thirteen bundled cartridges plus HTTP(S), RMS, URL, and optional JSR-75 loading;
• phone keys, keyboard controls, pointer input, and an on-screen touch pad;
• per-cartridge persistent disk storage with checksummed RMS generations;
• sampled MMAPI audio with streamed MIDI, playTone, and silent fallbacks;
• global RMS-backed sound On/Off and master-volume controls;
• deterministic host, KEmulator, and optional phoneME verification.

The release version is 1.0.0. The verified scope and remaining limitations
are documented in Compatibility.

Development requires Linux with just, Podman, and Distrobox installed. The
project toolchain contains JDK 8, ProGuard, KEmulator, WABT, and supporting
utilities. Version-sensitive components are pinned by the container definition.

Java sources and classfiles remain pinned to Java 1.3.

Artifacts are written to dist/:

Both variants contain the same thirteen cartridges. The base build works on MIDP
2.0 devices that do not implement the optional FileConnection API.

Download one matching .jad/.jar pair from the table above and keep both
files in the same directory. Use the full build on devices with JSR-75
FileConnection support; use the base build if the full build is rejected or the
device lacks that optional API.

Open the .jad from the phone’s application manager or file manager. If the
device does not accept JAD installation, transfer and open the matching .jar
directly. Installation details and troubleshooting are covered in
Installation.

Touchscreen devices display an on-screen directional pad and action buttons.
The controls stay outside the 160×160 framebuffer whenever the screen is large
enough.

Sound settings is available from the cartridge library and the in-game
command menu. It contains Automatic/Compatible audio mode, a hard global
Sound On/Off mute, and master volume when the backend supports it. Confirmed
settings persist across MIDlet restarts.

The launcher includes the thirteen cartridges listed above, in that order.

Additional .wasm files can be installed from HTTP(S), entered as a file://
URL, or selected with the JSR-75 browser on supported devices. Installed
cartridges are copied into RMS and can be relaunched without their original
file or network source.

Cartridges are third-party works. Their authors, upstream sources, hashes, and
licenses are listed in Third-party notices.

just test
just verify
just run

The stable commands are listed by just --list. Specialized KEmulator,
phoneME, and profiling commands are described in
Development. Generated logs, screenshots, and benchmark
receipts are written under build/reports/.

W4ME Station source code is available under the MIT License.
Bundled cartridges retain their own licenses and are not covered by the MIT
License.

The optional local phoneME rig is GPL-2.0-only and is not distributed with the
project. Its modified corresponding source is not public yet, so its binaries
must remain local and ignored. See Performance.