Troubleshooting

If Xeno is crashing, read this before opening a ticket on GitHub or Discord.

Common Crashes VK_ERROR_DEVICE_LOST The GPU stopped responding to the driver. This usually means Xeno pushed a command the GPU couldn't process, or your driver crashed. Update your graphics drivers. If it persists, lower your render distance to see if it is a VRAM limitation.

VK_ERROR_OUT_OF_DEVICE_MEMORY Your graphics card ran out of VRAM. Xeno uses a VMA-based allocator, but if you push the render distance too high on a system with shared or limited memory, Vulkan will kill the process. Turn down your render distance or close background applications.

Missing Textures / Black Screen Usually caused by another mod trying to bind an OpenGL texture while Xeno is expecting a Vulkan descriptor set. Check your mod list against the Incompatible Mods list.

How to Report a Bug If you have a genuine bug, we need logs.

Replicate the crash.

Go to your .minecraft/crash-reports folder.

Upload the text file to a site like mclo.gs or Pastebin.

Create a GitHub issue and include the link, your exact GPU model, and your driver version. Do not paste the raw log directly into the issue description.