Public Access
Add native biome families, desert vegetation, static sky controls and Seamless views
Build and smoke / changes (push) Waiting to run
Build and smoke / changes (push) Waiting to run
This commit is contained in:
1 parent
90e4a98a7a
commit
d199ac253e
92 files changed
+2520
-224
No files matched your search
@@ -0,0 +1,102 @@
|
||||
# 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.
|
||||
Reference in new issue
Block a user