Name the pattern before you change settings
Lichii black screen
A black screen on Lichii is not one bug. I split the public reports into patterns so the Docked-mode switch is not offered as a universal cure.
Which black is it?
| Pattern | What you see | First step that has sources | Status |
|---|---|---|---|
| A. 3D black, HUD alive | Hearts or prompts still draw. Menus work. | Switch handheld to Docked. NVIDIA reports improved. AMD reports said no change. | 3 sources |
| B. Black after the logo, audio continues | Title or logo, then black, sound stays. | Update the driver, try build 83 or 93, and try the other graphics backend. | Several AMD reports |
| C. Video-core init error | Popup says the cause is usually an outdated GPU driver. | Try Vulkan and OpenGL. One comment used EDEN_NX2_NO_MESH=1 in front of the AppImage. | 1 source for that variable |
| D. Stuck building shaders | Black, or a shader bar, sometimes with audio. | Let the compile finish. Build 93 new configs compile shaders asynchronously. Do not kill the process mid-compile. | Release notes |
| E. Intel draws nothing | Missing textures or no image. | No confirmed repair. Lower settings or use another GPU. | 1–2 reports |
| F. One game only | Bananza black rectangle, or a Mario Kart load crash. | Use the game page. Issue 78 is closed; it is not a global black-screen fix. | Game issues |
Docked mode, with the disagreement kept
Issue 94 comments describe a DLSS path in handheld mode and Docked as the workaround. The author of issue 117 said handheld was black and Docked restored the scene. ItsOOGWAY shows that handheld-to-docked change on build 75 in the video below. That is one video of one build.
Issue 132 collects AMD black screens across RX 6000, 7000, and 9000 where Docked and handheld were both black. Issue 98 says the same. So the sentence I will stand behind is: try Docked on NVIDIA handheld black-3D, and do not expect that switch to help the AMD reports.
Drivers and backends
The troubleshooting document says to install the latest driver, offers a clean driver removal, a backend switch, and unplugging a second monitor. Issue 238 shows the outdated-driver popup while the driver was already current, Vulkan init failed, and OpenGL launched into a black screen with sound. I keep the popup and that counterexample together.
Graphics documentation mentions OpenGL 4.6 and Vulkan 1.3 thresholds, with a Mesa override when the driver reports a lower version. I list that as a diagnostic, not as a guaranteed repair.
Build 83 repaired an AMD black 3D scene tied to a nested-return shader. Build 93 AMD reports that were stuck on shaders in build 88 could enter the game and still flicker. Upgrading is worth doing. It is not a claim that every black screen ends.
FAQ
Should I switch to Docked?
If the HUD is visible and you are on NVIDIA, yes, try it. AMD reports in issues 132 and 98 said it changed nothing.
The popup says my driver is old. Is it?
Sometimes. Issue 238 had a current driver and still got the popup. Check the backend next.
What is EDEN_NX2_NO_MESH?
A variable from one comment on issue 238. I count it as one source, not a project recommendation.
Sources
Checked 2026-11-07.