Hot Swap Quickstart

Hot Swap Quickstart

To enable debugging and hot swap:

./gradlew runServer -Ddebug=true -Dhotswap=true

For best results:

• Use JetBrains Runtime (JBR) for enhanced class redefinition support.
• Let the plugin resolve the Java toolchain automatically, or set jbrHome if you need a specific JBR installation.
• Optionally configure hotswapAgentPath if you want to use an external HotswapAgent jar.

Example with an external HotswapAgent jar:

hytaleTools {
    hotSwapEnabled = true
    useHotswapAgent = true
    hotswapAgentPath = '/path/to/hotswap-agent.jar'
}

Or via gradle.properties:

./gradlew runServer -Ddebug=true -Dhotswap=true

Verify your JVM and hot swap setup:

./gradlew hytaleJvmDoctor

When launching from IntelliJ using Debug, IntelliJ may provide its own debugger agent. The plugin detects an existing JDWP debugger argument and avoids adding a duplicate one.

---

---

Home | Task Reference | Troubleshooting