[BUG] UnsatisfiedLinkError on opening chat window

[bjmdev]

Bug Description

Describe the bug:
When opening the chat window, an exception is thrown:

java.lang.UnsatisfiedLinkError: 'long org.jetbrains.skiko.swing.Direct3DSwingRedrawer.chooseAdapter(int)'
	at org.jetbrains.skiko.swing.Direct3DSwingRedrawer.chooseAdapter(Native Method)
	at org.jetbrains.skiko.swing.Direct3DSwingRedrawer.<init>(Direct3DSwingRedrawer.kt:18)
	at org.jetbrains.skiko.swing.SwingRedrawerKt.createSwingRedrawer(SwingRedrawer.kt:42)
	at org.jetbrains.skiko.swing.SkiaSwingLayer$redrawerManager$1.invoke(SkiaSwingLayer.kt:71)
	at org.jetbrains.skiko.swing.SkiaSwingLayer$redrawerManager$1.invoke(SkiaSwingLayer.kt:69)
	at org.jetbrains.skiko.redrawer.RedrawerManager.findNextWorkingRenderApi(RedrawerManager.kt:31)
	at org.jetbrains.skiko.swing.SkiaSwingLayer.init(SkiaSwingLayer.kt:99)
	at org.jetbrains.skiko.swing.SkiaSwingLayer.addNotify(SkiaSwingLayer.kt:94)
	at java.desktop/java.awt.Container.addImpl(Container.java:1150)
	at java.desktop/javax.swing.JLayeredPane.addImpl(JLayeredPane.java:233)
	at java.desktop/java.awt.Container.add(Container.java:440)
	at androidx.compose.ui.awt.ComposePanel.add(ComposePanel.desktop.kt:175)
	at androidx.compose.ui.scene.ComposeSceneMediator.<init>(ComposeSceneMediator.desktop.kt:350)
	at androidx.compose.ui.scene.ComposeSceneMediator.<init>(ComposeSceneMediator.desktop.kt:113)
	at androidx.compose.ui.scene.ComposeContainer.<init>(ComposeContainer.desktop.kt:130)
	at androidx.compose.ui.scene.ComposeContainer.<init>(ComposeContainer.desktop.kt:84)
	at androidx.compose.ui.awt.ComposePanel.createComposeContainer(ComposePanel.desktop.kt:198)
	at androidx.compose.ui.awt.ComposePanel.addNotify(ComposePanel.desktop.kt:187)
	at java.desktop/java.awt.Container.addNotify(Container.java:2804)
	at java.desktop/javax.swing.JComponent.addNotify(JComponent.java:4847)
	at java.desktop/java.awt.Container.addNotify(Container.java:2804)
	at java.desktop/javax.swing.JComponent.addNotify(JComponent.java:4847)
	at java.desktop/java.awt.Container.addNotify(Container.java:2804)
	at java.desktop/javax.swing.JComponent.addNotify(JComponent.java:4847)
	at com.intellij.ui.JBSplitter.addNotify(JBSplitter.java:102)
	at java.desktop/java.awt.Container.addNotify(Container.java:2804)
	at java.desktop/javax.swing.JComponent.addNotify(JComponent.java:4847)
	at java.desktop/java.awt.Container.addNotify(Container.java:2804)
	at java.desktop/javax.swing.JComponent.addNotify(JComponent.java:4847)
	at java.desktop/java.awt.Container.addNotify(Container.java:2804)
	at java.desktop/javax.swing.JComponent.addNotify(JComponent.java:4847)
	at java.desktop/java.awt.Container.addNotify(Container.java:2804)
	at java.desktop/javax.swing.JComponent.addNotify(JComponent.java:4847)
	at com.intellij.toolWindow.InternalDecoratorImpl.addNotify(InternalDecoratorImpl.kt:931)
	at java.desktop/java.awt.Container.addImpl(Container.java:1150)
	at java.desktop/java.awt.Container.add(Container.java:440)
	at com.intellij.openapi.ui.ThreeComponentsSplitter.doAddComponent(ThreeComponentsSplitter.kt:441)
	at com.intellij.openapi.ui.ThreeComponentsSplitter.setLastComponent(ThreeComponentsSplitter.kt:98)
	at com.intellij.toolWindow.ToolWindowPane.setComponent(ToolWindowPane.kt:303)
	at com.intellij.toolWindow.ToolWindowPane.addDecorator(ToolWindowPane.kt:233)
	at com.intellij.openapi.wm.impl.ToolWindowManagerImpl.doShowWindow(ToolWindowManagerImpl.kt:1103)
	at com.intellij.openapi.wm.impl.ToolWindowManagerImpl.showToolWindowImpl(ToolWindowManagerImpl.kt:1053)
	at com.intellij.openapi.wm.impl.ToolWindowManagerImpl.activateToolWindow$intellij_platform_ide_impl(ToolWindowManagerImpl.kt:749)
	at com.intellij.openapi.wm.impl.ToolWindowManagerImpl.activateToolWindow$intellij_platform_ide_impl$default(ToolWindowManagerImpl.kt:716)
	at com.intellij.openapi.wm.impl.ToolWindowManagerImpl.activated$intellij_platform_ide_impl(ToolWindowManagerImpl.kt:2370)
	at com.intellij.openapi.wm.impl.SquareAnActionButton.setSelected(SquareStripeButton.kt:356)
	at com.intellij.openapi.actionSystem.ToggleAction.actionPerformed(ToggleAction.java:62)
	at com.intellij.openapi.actionSystem.impl.ActionButton.actionPerformed(ActionButton.java:244)
	at com.intellij.openapi.actionSystem.impl.ActionButton.lambda$performAction$2(ActionButton.java:223)
	at com.intellij.openapi.actionSystem.impl.ActionManagerImpl.performWithActionCallbacks$lambda$0(ActionManagerImpl.kt:1164)
	at com.intellij.concurrency.ThreadContext.installThreadContext(threadContext.kt:305)
	at com.intellij.openapi.actionSystem.impl.ActionManagerImpl.performWithActionCallbacks(ActionManagerImpl.kt:1162)
	at com.intellij.openapi.actionSystem.impl.ActionButton.performAction(ActionButton.java:222)
	at com.intellij.openapi.actionSystem.impl.ActionButton.processMouseEvent(ActionButton.java:538)
	at java.desktop/java.awt.Component.processEvent(Component.java:6444)
	at java.desktop/java.awt.Container.processEvent(Container.java:2266)
	at java.desktop/java.awt.Component.dispatchEventImpl(Component.java:5049)
	at java.desktop/java.awt.Container.dispatchEventImpl(Container.java:2324)
	at java.desktop/java.awt.Component.dispatchEvent(Component.java:4877)
	at java.desktop/java.awt.LightweightDispatcher.retargetMouseEvent(Container.java:4963)
	at java.desktop/java.awt.LightweightDispatcher.processMouseEvent(Container.java:4577)
	at java.desktop/java.awt.LightweightDispatcher.dispatchEvent(Container.java:4518)
	at java.desktop/java.awt.Container.dispatchEventImpl(Container.java:2310)
	at java.desktop/java.awt.Window.dispatchEventImpl(Window.java:2823)
	at java.desktop/java.awt.Component.dispatchEvent(Component.java:4877)
	at java.desktop/java.awt.EventQueue.dispatchEventImpl(EventQueue.java:783)
	at java.desktop/java.awt.EventQueue$4.run(EventQueue.java:728)
	at java.desktop/java.awt.EventQueue$4.run(EventQueue.java:722)
	at java.base/java.security.AccessController.doPrivileged(AccessController.java:400)
	at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(ProtectionDomain.java:87)
	at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(ProtectionDomain.java:98)
	at java.desktop/java.awt.EventQueue$5.run(EventQueue.java:755)
	at java.desktop/java.awt.EventQueue$5.run(EventQueue.java:753)
	at java.base/java.security.AccessController.doPrivileged(AccessController.java:400)
	at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(ProtectionDomain.java:87)
	at java.desktop/java.awt.EventQueue.dispatchEvent(EventQueue.java:752)
	at com.intellij.ide.IdeEventQueue.defaultDispatchEvent(IdeEventQueue.kt:664)
	at com.intellij.ide.IdeEventQueue.dispatchMouseEvent(IdeEventQueue.kt:570)
	at com.intellij.ide.IdeEventQueue._dispatchEvent$lambda$2(IdeEventQueue.kt:508)
	at com.intellij.platform.locking.impl.NestedLocksThreadingSupport.doRunWriteIntentReadAction(NestedLocksThreadingSupport.kt:736)
	at com.intellij.platform.locking.impl.NestedLocksThreadingSupport.runPreventiveWriteIntentReadAction(NestedLocksThreadingSupport.kt:710)
	at com.intellij.ide.IdeEventQueue._dispatchEvent(IdeEventQueue.kt:508)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$0$0$0$0(IdeEventQueue.kt:337)
	at com.intellij.openapi.progress.impl.CoreProgressManager.computePrioritized(CoreProgressManager.java:901)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$0$0$0(IdeEventQueue.kt:336)
	at com.intellij.ide.IdeEventQueueKt.performActivity$lambda$1(IdeEventQueue.kt:1065)
	at com.intellij.openapi.application.TransactionGuardImpl.performActivity(TransactionGuardImpl.java:117)
	at com.intellij.ide.IdeEventQueueKt.performActivity(IdeEventQueue.kt:1065)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$0(IdeEventQueue.kt:331)
	at com.intellij.ide.IdeEventQueue.dispatchEvent(IdeEventQueue.kt:371)
	at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(EventDispatchThread.java:207)
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(EventDispatchThread.java:128)
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(EventDispatchThread.java:117)
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:113)
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:105)
	at java.desktop/java.awt.EventDispatchThread.run(EventDispatchThread.java:92)

Steps to Reproduce

1. Open IntelliJ
2. Click on DevoxxGenie sidebar icon
3. See error

Expected Behavior

The chat window opens in a working state.

Actual Behavior

The above mentioned exception is thrown and the chat window has an empty "New Chat" tab.

Environment

• IntelliJ IDEA Version: 2025.3.3
• Plugin Version: 1.2.0
• Operating System: Windows 11
• LLM Provider: not relevant
• Model: not relevant

[stephanj]

The crash happens because the plugin's chat UI uses Compose for Desktop, which relies on a native graphics library called Skiko. On Windows, Skiko tries to initialize Direct3D rendering, but on your system (likely a GPU driver incompatibility), the native library fails to load, throwing an UnsatisfiedLinkError that crashes the entire tool window.

Immediate workaround: Add -Dskiko.renderApi=SOFTWARE to your IDE VM options (Help > Edit Custom VM Options), then restart IntelliJ. This forces software rendering and bypasses the Direct3D issue entirely.

I'm adding graceful error handling so that if Skiko fails to initialize, the plugin shows a helpful fallback message instead of crashing.
You can please test this with this version : https://drive.google.com/file/d/1dvYN0EyFXXZKss-kfXBcSRSoHALya5VY/view?usp=share_link

[bjmdev]

Thank you for the quick fix. Software rendering works!

[stephanj]

Instead of an exception v1.3.1 will show a message about setting this java env variable.
I've also updated the documentation with related info @ https://genie.devoxx.com/docs/getting-started/troubleshooting

[bjmdev]

Unfortunately, that is not the case: