Skip to content



In order to debug your code using an embedded JRE, make sure to include the following modules:

  • jdk.jdwp.agent


Example for AMD64 systems: jlink --add-modules java.base,java.logging,jdk.jdwp.agent --output jre-amd64
Example for ARM64 systems: jlink --add-modules java.base,java.logging,jdk.jdwp.agent --output jre-arm64

If you're still using the jdk installed on your system though, you don't need to do this.

Run and attach Remote Debugger

Run your game with the commandline option --jvm-debug-port=<port (normally 5005)> and attach a remote debugger.


If you specify either --jvm-debug-port or --jvm-debug-address the execution of the game will suspend until you attach a remote debugger. You can configure this behaviour by specifying --wait-for-debugger=true or --wait-for-debugger=false

remote debug configuration