Troubleshooting

Is something in Bevy not working as expected? Maybe one of these will resolve your problem:

Unable to find a GPU

thread 'main' panicked at 'Unable to find a GPU! Make sure you have installed required drivers!'

This error message means that bevy is unable to draw to your screen. Causes include:

1. Vulkan-compatible drivers not installed. To fix this, install/update the drivers. On Linux this may be vulkan-intel or vulkan-radeon.
2. Trying to run an example on a headless machine. To fix this, install a GPU!

Unable to debug dynamically linked Bevy application in VSCode on Windows

The program '[10184] my-game.exe' has exited with code -1073741515 (0xc0000135).

Whilst cargo run may load the application successfully, running via the debugging UI in VSCode may yield the above error. This error means that the required libraries were not loaded correctly (likely due to a pathing quirk with VSCode debug extensions on Windows).

Edit your launch configurations in .vscode/launch.json so that the rust libraries are found correctly.

For cppvsdbg:

"environment": [
    {"name":"PATH", "value":"%USERPROFILE%/.rustup/toolchains/nightly-x86_64-pc-windows-msvc/bin;${workspaceFolder}/target/debug/deps;%PATH%"}
    // Switch `nightly` to `stable` if you're using Rust stable
],

Or for codelldb:

"env": {
    "PATH": "${env:USERPROFILE}/.rustup/toolchains/nightly-x86_64-pc-windows-msvc/bin;${workspaceFolder}/target/debug/deps;${env:PATH}",
    // Switch `nightly` to `stable` if you're using Rust stable
},

Unable to compile getrandom when building for web

   Compiling getrandom v0.3.4
   Compiling getrandom v0.4.2
error: The wasm32-unknown-unknown targets are not supported by default; you may need to enable the "wasm_js" crate feature.

If you have only one tree dependency on getrandom, then adding getrandom = { version = "*", features = ["wasm_js"] } might solve the issue.

However, if your crate depends on multiple versions of getrandom, then this will not be enough: The wildcard version pattern still ends up reflecting only a single version of the crate you want to add a feature for.

Since you cannot specify two dependencies with the same name, and since cargo does not know that you want the feature to apply to every instance of the crate (what if a cargo feature only exists for some versions of the dependency?), you might have to use this workaround sometimes referred to as 'renaming' the dependency:

# under the [dependencies] section of `Cargo.toml`
getrandom_a = { package = "getrandom", version = "0.3.4", features = ["wasm_js"] }
getrandom_b = { package = "getrandom", version = "0.4.2", features = ["wasm_js"] }