cb19660fbe
Add version-bound core, world data, geometry, generation and feature implementations with native client/server comparison tools and scoped evidence reports. Apply Horizon project branding. Workspace tests, Clippy and 147 Python tests passed. Full 51-family survival and expanded provider comparisons are still running; complete gameplay parity and a playable Rust client remain unfinished. Private game artifacts and the isolated simple-block placement work are excluded.
68 lines
4.0 KiB
Markdown
68 lines
4.0 KiB
Markdown
# Optional shader world probe
|
|
|
|
The cinematic pack starts with shaders disabled. A world rendering successfully
|
|
with that profile does not establish that its optional shader pack works.
|
|
The separate manual **macOS shader research** workflow explicitly enables the
|
|
pinned Complementary Reimagined pack in private cinematic instances and probes
|
|
OpenGL and Vulkan independently.
|
|
|
|
The probe uses Iris's runtime API through the recorder's existing read-only
|
|
inspection. Success requires available shader status, an active shader pack,
|
|
the exact pinned pack identity, focused world gameplay without an overlay,
|
|
nonuniform framebuffer readback, saved world data and a clean exit. A disabled,
|
|
unavailable or different pack fails even if ordinary world pixels look valid.
|
|
Arbitrary runtime pack names and paths are not exported.
|
|
|
|
```sh
|
|
python3 tools/build_mod.py
|
|
python3 tools/test_client_graphics.py --native-display --profile cinematic --backend opengl --world --shaders
|
|
python3 tools/test_client_graphics.py --native-display --profile cinematic --backend vulkan --world --shaders
|
|
```
|
|
|
|
Shader instances use separate runtime folders and a 6 GiB maximum heap. Other
|
|
graphics probes keep their 3 GiB budget. The fixture reports the actual maximum
|
|
heap and observed shader status. Playable packs and their shader defaults are
|
|
unchanged. Full logs, PNGs, world files, assets and shader ZIPs stay private.
|
|
|
|
The research workflow runs both cases and retains selected failed outcomes.
|
|
It fails if either case fails and remains separate from required OpenGL CI.
|
|
This is a short initialization/readback/save check, not a shader FPS, physical
|
|
M2 GPU, exhaustive visual quality or distant-terrain completion benchmark.
|
|
|
|
## Observed results
|
|
|
|
The [selected shader observations](../benchmarks/shader-worlds-2026-10-04/live-observations.json)
|
|
retain successful and failed cases. On Linux llvmpipe, the OpenGL cinematic
|
|
world probe passes with the pinned shader pack actually active, matching identity,
|
|
nonuniform readback and clean save/exit. Its private image was visually inspected.
|
|
This is a software-renderer startup result, not a shader FPS or physical Mac claim.
|
|
|
|
The Linux Vulkan cinematic case fails before readback, with a Distant Horizons
|
|
lightmap handler in selected stack locations. A fresh private isolation instance
|
|
with the DH JAR removed reaches ordinary Vulkan world readback but Iris reports
|
|
shaders inactive. The strict activation assertion rejects it; ordinary world
|
|
pixels alone would have produced a misleading shader success.
|
|
|
|
Hosted Mac run 37198566508 times out in both OpenGL and Vulkan cinematic cases,
|
|
with no completed probe report. The previous timeout wrapper retained only
|
|
`completed: false`; initialization/readback/waiting state is unknown. This does
|
|
not establish shader support or incompatibility on physical Apple GPUs.
|
|
|
|
Later timeout diagnostics preserve selected initialization/readback stages,
|
|
actual child exit status after bounded cleanup, and the last private waiting-state
|
|
snapshot. Waiting state contains only six booleans and a tick count; arbitrary
|
|
screen names, messages and paths are excluded. An unsuccessful research run
|
|
remains unsuccessful. Playable shader/backend defaults remain unchanged.
|
|
|
|
Diagnostic repeat [37199837867](https://github.com/ludovic111/Horizon/actions/runs/37199837867)
|
|
uses the richer diagnostics. Both cases again hit the 240-second timeout and
|
|
require bounded termination. OpenGL initializes its device and loads a world
|
|
with a player, no overlay, an active window and no pause; a screen remains
|
|
present and the fixture never reaches readback readiness. Selected stack
|
|
locations include Iris terrain rendering, but do not identify the screen or
|
|
establish a root cause. Vulkan initializes its device and client entrypoint,
|
|
but provides no waiting-state snapshot or readback request before timeout.
|
|
Neither case yields an actual shader-activation assertion or saved/clean-exit
|
|
success. The research workflow correctly fails; required non-shader OpenGL
|
|
checks pass independently on Windows, Linux and macOS.
|