Skip to content

Debugging

Prerequisites

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

  • jdk.jdwp.agent

Info

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

Run and attach Remote Debugger

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

Info

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

Example:
remote debug configuration