🛠️ Linux Performance Fix: Map Lag / Stuttering Resolution (Wayland/CachyOS)

[whitevamp]

🛠️ Linux Performance Fix: Map Lag / Stuttering Resolution (Wayland/CachyOS)

For anyone running the AutoDrive Course Editor on Linux and experiencing severe screen lag or stuttering—especially after loading a map image and attempting to zoom or pan—this comprehensive command line tweak resolves the issue.

This problem is commonly caused by a conflict between Java's built-in graphics engine (Java 2D) and modern Linux display compositors (like Wayland/XWayland).

The Working Command

Use the following command to launch the application. This forces Java to use a more stable, CPU-based rendering path optimized for high-speed image manipulation, which is essential for map editors.
Bash
java -Dsun.java2d.opengl=false -Dsun.java2d.noddraw=true -Dsun.java2d.xrender=false -Dsun.java2d.forceBlit=true -Dswing.defaultlaf=javax.swing.plaf.nimbus.NimbusLookAndFeel -Dawt.useSystemAAFontSettings=lcd -Xms1024m -Xmx1024m -jar AutoDriveEditor.jar

---

Context: Why This Works (Technical Breakdown)

The core issue is Java's failed attempt to use hardware acceleration (your GPU) on specific Linux setups. This command effectively tells the Java Virtual Machine (JVM) to fall back to a more stable, highly optimized CPU-based rendering method.

Flag	Effect on the Application	Purpose
-Dsun.java2d.opengl=false	CRITICAL FIX. Disables the buggy OpenGL hardware acceleration path.	This is the primary fix for the map stuttering/lag.
-Dsun.java2d.forceBlit=true	PERFORMANCE BOOST. Forces the use of fast, direct memory-to-memory image copying.	Significantly improves the speed of dragging and zooming large map textures.
-Dswing.defaultlaf=...NimbusLookAndFeel	STABILITY & AESTHETICS. Forces a modern, vector-based look and feel.	Can resolve scaling/drawing issues and generally provides a better look than old defaults.
-Dawt.useSystemAAFontSettings=lcd	TEXT FIX. Enables high-quality sub-pixel font anti-aliasing.	Corrects the "blocky" or unreadable text that often results when disabling OpenGL.
-Dsun.java2d.noddraw=true and -Dsun.java2d.xrender=false	COMPATIBILITY. Disables other legacy or conflicting Linux/Java rendering paths.	Ensures we only use the most stable rendering route.

---

Environment Where This Was Tested

This solution was specifically tested and confirmed working on a system running:

Distribution: CachyOS (Arch-based, performance-focused)

Display Server: Wayland (Running the Java application through XWayland)

If you are on another Wayland-default distro (like recent Fedora, Ubuntu, or Pop!_OS), this fix is highly likely to work for you as well.

[KillBait]

To be honest, i have not tested the editor in linux myself, but i wasn't aware of any issue's.

The next release (V1.1 hopefully soon) may help with some of the issues you found as there are some major code changes in that version.
When it's released, test it and let me know if it works better without the openGL and blit opions.

[whitevamp]

I look forward to it.