Low, medium and high presets, Vulkan with a fallback to OpenGL, X11 and Wayland support, and correct behaviour on hybrid-GPU systems such as this NVIDIA and Intel desktop.
Acceptance
Each preset produces a reviewed capture in the supported renderers.
If Vulkan is unavailable the game falls back with a message, rather than crashing.
docs/PLAY.md lists tested configurations and honestly marks which ones were only software-rendered.
**Depends on:** H1
Low, medium and high presets, Vulkan with a fallback to OpenGL, X11 and Wayland support, and correct behaviour on hybrid-GPU systems such as this NVIDIA and Intel desktop.
**Acceptance**
- Each preset produces a reviewed capture in the supported renderers.
- If Vulkan is unavailable the game falls back with a message, rather than crashing.
- `docs/PLAY.md` lists tested configurations and honestly marks which ones were only software-rendered.
claude
added this to the v0.9 Hardening milestone 2026-11-09 05:29:40 +00:00
No preset changes how far props or pieces are drawn. A lower preset never shows a player through cover that a higher one would draw, and a test guards this.
Vulkan fallback
Godot's fallback_to_opengl3 handles the switch. RendererCheck detects it, and the main menu shows a notice under the motto (the game prints it too).
New CAPTURE_RENDERER=no_vulkan in tools/capture.sh hides the Vulkan ICD in the container and expects gl_compatibility. In menu_main_no_vulkan the game came up in OpenGL with the notice shown, and didn't crash.
Reviewed captures:quality_{low,medium,high} in Forward+ (Lavapipe) and in Compatibility (llvmpipe). All six were opened.
Shadows go off and on with the presets, and Low is slightly softer from the 75% scale.
Draw calls: 218, 354 and 432 in Forward+; 250, 391 and 464 in Compatibility.
Found: in Compatibility only, turning shadows on makes the ground and rocks paler. The default view does the same, so it comes from the renderer, not the presets. Opened #81 (H14, priority/low).
docs/PLAY.md covers the presets, renderers, X11 and Wayland (XWayland by default; --display-driver wayland for native), hybrid-GPU offload variables, and a table of tested configurations. Every row is marked as software-rendered only or not tested: Wayland and real or hybrid GPUs wait for R6.
Tests:test_game_settings +4. make check passes: 236 scripts, 637 tests, smoke.
— tidewall-build
Done in 54c255e.
**Presets** (`GameSettings.QUALITY`)
| | Shadows | Cascades | Render scale | AA |
|---|---|---|---|---|
| Low | off | n/a | 75% | FXAA |
| Medium | 200 m | 2 | 100% | FXAA |
| High | 400 m | 4 | 100% | MSAA 2x |
No preset changes how far props or pieces are drawn. A lower preset never shows a player through cover that a higher one would draw, and a test guards this.
**Vulkan fallback**
- Godot's `fallback_to_opengl3` handles the switch. `RendererCheck` detects it, and the main menu shows a notice under the motto (the game prints it too).
- New `CAPTURE_RENDERER=no_vulkan` in `tools/capture.sh` hides the Vulkan ICD in the container and expects `gl_compatibility`. In `menu_main_no_vulkan` the game came up in OpenGL with the notice shown, and didn't crash.
**Reviewed captures:** `quality_{low,medium,high}` in Forward+ (Lavapipe) and in Compatibility (llvmpipe). All six were opened.
- Shadows go off and on with the presets, and Low is slightly softer from the 75% scale.
- Draw calls: 218, 354 and 432 in Forward+; 250, 391 and 464 in Compatibility.
- Found: in Compatibility only, turning shadows on makes the ground and rocks paler. The default view does the same, so it comes from the renderer, not the presets. Opened #81 (H14, priority/low).
**docs/PLAY.md** covers the presets, renderers, X11 and Wayland (XWayland by default; `--display-driver wayland` for native), hybrid-GPU offload variables, and a table of tested configurations. Every row is marked as software-rendered only or not tested: Wayland and real or hybrid GPUs wait for R6.
**Tests:** `test_game_settings` +4. `make check` passes: 236 scripts, 637 tests, smoke.
— tidewall-build
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Depends on: H1
Low, medium and high presets, Vulkan with a fallback to OpenGL, X11 and Wayland support, and correct behaviour on hybrid-GPU systems such as this NVIDIA and Intel desktop.
Acceptance
docs/PLAY.mdlists tested configurations and honestly marks which ones were only software-rendered.Done in
54c255e.Presets (
GameSettings.QUALITY)No preset changes how far props or pieces are drawn. A lower preset never shows a player through cover that a higher one would draw, and a test guards this.
Vulkan fallback
fallback_to_opengl3handles the switch.RendererCheckdetects it, and the main menu shows a notice under the motto (the game prints it too).CAPTURE_RENDERER=no_vulkanintools/capture.shhides the Vulkan ICD in the container and expectsgl_compatibility. Inmenu_main_no_vulkanthe game came up in OpenGL with the notice shown, and didn't crash.Reviewed captures:
quality_{low,medium,high}in Forward+ (Lavapipe) and in Compatibility (llvmpipe). All six were opened.docs/PLAY.md covers the presets, renderers, X11 and Wayland (XWayland by default;
--display-driver waylandfor native), hybrid-GPU offload variables, and a table of tested configurations. Every row is marked as software-rendered only or not tested: Wayland and real or hybrid GPUs wait for R6.Tests:
test_game_settings+4.make checkpasses: 236 scripts, 637 tests, smoke.— tidewall-build