more troubleshooting info

This commit is contained in:
yuni 2024-04-25 03:23:56 +02:00
parent 729e6be59d
commit 4661bec5c7

View file

@ -98,15 +98,36 @@ No releases for these operating systems exist yet. For MacOS, you can build OutF
# Troubleshooting # Troubleshooting
## My GPU doesn't support Vulkan! ## My GPU doesn't support Vulkan!
Try running outfly with the "--gl" option, with one of these commands: Try running outfly with the command-line option "--gl", with one of these commands:
``` ```
./outfly --gl ./outfly --gl
cargo run --release -- --gl cargo run -- --gl
``` ```
This will result in some visual glitches, reduced performance, as well as a lot of error messages about CubeArrays which you can safely ignore. Internally, this option sets `WGPU_BACKEND` to `gl`. This will result in some visual glitches, reduced performance, as well as a lot of error messages about CubeArrays which you can safely ignore. Internally, this option sets `WGPU_BACKEND` to `gl`.
## The game instantly crashes!
Try changing the full screen mode with the command line option "--fs-legacy":
```
./outfly --fs-legacy
cargo run -- --fs-legacy
```
If this doesn't work, please open an issue on https://codeberg.org/hut/outfly and provide as many details as you can, including the crash log.
## Crash with "error while loading shared libraries"
If you build with `--features dev`, then you must not run the game `./outfly`. Use `cargo run` instead.
## I'm on Windows. How do I use command-line options?
Create a shortcut, change the target from `[...]outfly.exe` to e.g. `[...]outfly.exe --gl`.
See https://superuser.com/questions/1202989/how-to-you-add-a-parameter-to-an-executable-in-windows-10
# Building # Building
If there is no package for the version or operating system that you need, or if you wish to tinker on the game, you can also build outfly yourself. If there is no package for the version or operating system that you need, or if you wish to tinker on the game, you can also build outfly yourself.