# Static Sky resolution — issue #109 Local test builds: **Minecraft 1.21.1 / 1.21.1.0.5** and **Minecraft 26.3 / 26.3.0.8**. Pending player validation; not committed or published. ## Authoring Place one or more Number Pages **immediately before Static Sky**. Digits are 0–24 in base 25, as with Flooded. No Number Pages means the existing **48 × 48 cells on each of six faces**. | Written sequence | Resolution on each face | | --- | --- | | Static Sky | 48 × 48 | | Number 0 → Static Sky | 1 × 1 (minimum) | | Number 8 → Static Sky | 8 × 8 | | Number 24 → Static Sky | 24 × 24 | | Number 1 → Number 23 → Static Sky | 48 × 48 | | Number 5 → Number 3 → Static Sky | 128 × 128 (maximum) | | Number 24 → Number 24 → Static Sky | 128 × 128 (624 clamps) | Any intervening non-number Page breaks the digit run. A Number followed by a color still modifies that color, not the later sky. Other Sky styles do not consume resolution numbers. Duplicate Sky controllers retain the existing last-choice recovery and instability rules; the final unnumbered Static Sky returns to 48. Dangling/misplaced numbers retain their usual diagnostics. Higher values make smaller cells. Resolution does not change the animation cadence, colors, celestial geometry, terrain or lighting. Random/unmodified Static Ages retain 48; no new Page or recipe is added. Creative and JEI use the existing Static Sky and Number items, with updated tooltips. ## Persistence and synchronization - **1.21.1:** derive resolution from the persisted ordered semantic writing, include it in AgeSkyProfile and its server-to-client sky payload. - **26.3:** freeze resolution in the existing presentation settings record (PortAgeColors), save optional `static_resolution` in the Age index and synchronize it with the full Age catalog. Old records without the field default to 48. - Require matching updated client/server builds: sky payload protocol is 19 on 1.21.1 and Age catalog protocol is 12 on 26.3. - No existing chunks or writing are rewritten. Existing unnumbered Static Ages retain their old appearance. Save/revisit/reconnect/restart preserve newly authored settings. ## Render bounds and lifecycle Shared bounds are **1–128** cells per face, including the constructors and client render entry points. Long digit runs saturate safely before clamping. The 1.21.1 procedural renderer draws at most 98,304 quads (393,216 vertices), roughly 6 MiB of position/color vertex data per draw. The bound limits its existing per-cell work; the normal 48 setting is unchanged. The 26.3 renderer keeps one 24-vertex cube. Its current noise atlas is at most 768 × 128 RGBA pixels (384 KiB of image data). It creates a replacement only when the extracted resolution changes, closes the previous texture, invalidates the frame/tint cache, and reuses the cube. World metadata is read during extraction, never during drawing. Extracted state resets to 48; renderer close releases both GPU resources. No growing per-Age texture cache is introduced. ## Automated checks Run separately, sequentially: ```sh python3 scripts/regression_static109.py mc1211 python3 scripts/regression_static109.py mc263 ``` These use the server lock, isolated startup fixtures and new temporary worlds, with a 60-second stall handoff. They delete worlds and fixture outputs on success or failure and retain logs in `build/verification/static109/`. The probes do not enter the production JAR or default GameTest suite. Results: 34 checks passed on 1.21.1 and 42 on 26.3 for unmodified/default, zero, single and multi-digit writing, bounds, ordering, saved plan/codec and full packet/catalog round trips, independent color, old-save defaults, non-Static behavior and unchanged Flooded digit grammar. Actual GPU appearance and preview interactions remain player checks. ## Player checks — both versions 1. Bind fresh Ages with Static Sky alone, Number 8 + Static Sky, Number 24 + Static Sky, and Number 5 + Number 3 + Static Sky. Prefer the same remaining Pages and an explicit celestial choice to make comparison straightforward. 2. Look up, down and around: all six faces should show the selected cell size and keep animating. The plain book retains the previous fine static. 3. Check Number 0 gives the coarse minimum. Compare Number 1 + Number 23 to the unnumbered default. Oversized values clamp instead of crashing. 4. Add numbered color Pages before the resolution digits; verify the tint and resolution work independently. 5. Travel between different-resolution Ages, the Overworld and a non-Static Age. Check book/portal destination views with the installed optional renderer for leaked settings. 6. Revisit, reconnect and restart; the selected resolution must persist. Update both ends if using a dedicated server. ## Release validation (2026-11-17) Player in-game checks passed. Included in releases 1.21.1.0.6 and 26.3.0.10 (Seamless integration applies to 26.3 only). Earlier candidate notes above describe development history. Known Reborn/Seamless acknowledgement and rendering failures remain tracked in [#118](https://git.paddedcell.org/dnorberg/rivencraft/issues/118); this release does not resolve them.