5.1 KiB
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_resolutionin 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:
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
- 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.
- 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.
- Check Number 0 gives the coarse minimum. Compare Number 1 + Number 23 to the unnumbered default. Oversized values clamp instead of crashing.
- Add numbered color Pages before the resolution digits; verify the tint and resolution work independently.
- 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.
- 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; this release does not resolve them.