Skip to content

Startup Failure on iPadOS 26.3 (M4): Hardcoded Flag Conflict and JIT Injection Failure #189

@Lhy-wed

Description

@Lhy-wed

Describe the bug

When running on an unjailbroken iPad Air (M4) with iPadOS 26.3, the Amethyst launcher encounters two core issues that prevent the game from running:

JVM Flag Conflict: The launcher forcibly injects the -XX:+MirrorMappedCodeCache flag, which is unrecognized by Java 8, causing the JVM to crash during initialization (see 1.12.2_UniversalJIT.js_log_1.txt). Manually adding -XX:+IgnoreUnrecognizedVMOptions in the JVM settings resolves the crash(see 1.12.2_UniversalJIT.js_log_2), but the screen remains black.

JIT Injection Exception: JIT acquisition fails when using manic.js in StikDebug (v3.0.1)(see 1.12.2_manic.js_log1 and 1.12.2_manic.js_stikdebug_log1_1.png and ...2.png). Even attempting to launch with UniversalJIT26.js (extracted from the Amethyst IPA) does not work.

The log file and images/videos

No response

Steps To Reproduce

1.Use Amethyst v1.0-development on iPadOS 26.3.

2.Attempt to launch version 1.12.2.

3.Scenario A: Launch directly; the JVM exits with the error Unrecognized VM option 'MirrorMappedCodeCache', and StikDebug reports an error.
Scenario B: Launch after adding -XX:+IgnoreUnrecognizedVMOptions; the game stays on a black screen, and StikDebug reports an error.

Expected Behavior

The game should launch and run normally.

Platform

- Device model: iPad Air 8 m4 256GB 11inch
- iOS version: iPad os 26.3
- Amethyst version: Amethyst 1.0-development (main/ba4a002)

Anything else?

1.12.2_manic.js_log1.txt

Image Image

1.12.2_UniversalJIT.js_log_1.txt

1.12.2_UniversalJIT.js_log_2.txt

1.12.2_UniversalJIT.js_stikdebug_log_2.MP4

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions