Devlog: H1, R1 and H2

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-14 00:11:13 -05:00
co-authored by Claude Opus 5.5
parent 54c255e912
commit 4ea7caf3df
+19
View File
@@ -1138,3 +1138,22 @@ high-priority issues, and A3, A7, A12 and A13 deferred.
- So the smoke fault check expects only a non-zero exit in package mode.
- The systemd unit already has `Restart=on-failure`.
- This makes the debug-only checks in `make check` and the soak the real guard for script errors.
**H2 (#55): graphics presets and Linux compatibility.**
- Presets (`GameSettings.QUALITY`):
- Low: no sun shadows, 75% render scale, FXAA.
- Medium: shadows to 200 m with 2 cascades, 100%, FXAA.
- High: shadows to 400 m with 4 cascades, 100%, MSAA 2x.
- `GameSettings.apply_to_viewport` sets render scale, MSAA and FXAA. `MatchView.apply_settings` sets the sun's cascades.
- **Decision:** no preset changes prop or piece draw distances, so a lower preset can never show a player through cover that a higher one draws. A test guards it.
- **Vulkan fallback:**
- Godot's `fallback_to_opengl3` is on by default.
- `RendererCheck` notices when the renderer isn't the one asked for (and the player didn't choose it on the command line). The main menu then shows a notice in ochre red, and the game prints it.
- Proven with the new `CAPTURE_RENDERER=no_vulkan` mode of `tools/capture.sh`, which hides the Vulkan ICD in the container and expects `gl_compatibility`. The `menu_main_no_vulkan` capture shows the notice.
- Captures `quality_{low,medium,high}` in Forward+ and in Compatibility were opened and reviewed:
- Shadows appear and disappear as they should.
- Low is slightly softer from the 75% scale.
- Draw calls: 218, 354 and 432 (Forward+); 250, 391 and 464 (Compatibility).
- Found: under Compatibility, shadows on makes the ground and rocks paler. It happens in the default view too, so it's the renderer, not the presets. Filed as H14 (#81), low priority.
- `docs/PLAY.md`: presets, renderers, Wayland (XWayland by default, `--display-driver wayland` to try native), hybrid-GPU offload variables, and a tested-configurations table that marks every row as software-only or not tested. Wayland and real or hybrid GPUs are untested until R6.
- Tests: `test_game_settings` +4 (presets rise from Low to High; viewport and sun settings; presets never touch draw distance; the fallback notice logic).