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,104 @@
|
||||
# Desert vegetation Pages — issue #108
|
||||
|
||||
Applies to Minecraft 1.21.1 and 26.3. Local test builds: **1.21.1.0.4** and
|
||||
**26.3.0.7**. Minecraft 1.21.1 (including BOP Dryland) passed player validation. The 26.3
|
||||
Flat soil correction awaits player retest; not committed or published.
|
||||
|
||||
## Classification
|
||||
|
||||
The biome tag `rivencraft:desert_vegetation` includes vanilla Desert and the
|
||||
optional common tag `c:is_desert`. No TerraBlender dependency or biome-ID
|
||||
substring guessing is used. In the installed BOP 21.1.0.14 and 26.3.0.0.16
|
||||
assets, Dryland and Lush Desert have that common tag; Cold Desert does not.
|
||||
Cold Desert therefore retains the ordinary non-desert behavior. Hot/dry
|
||||
climate alone does not classify a biome as desert.
|
||||
|
||||
Data packs can extend `data/rivencraft/tags/worldgen/biome/desert_vegetation.json`
|
||||
with additional biome IDs using `replace: false`. The existing exclusion of
|
||||
Nether/End/cave biomes for generic surface vegetation still applies.
|
||||
|
||||
## Authored effects
|
||||
|
||||
| Page | Desert effect per occurrence per chunk |
|
||||
| --- | --- |
|
||||
| Flowers | 16 attempts to place individual dead bushes |
|
||||
| Trees | 8 attempts to place 1–3-block cactus columns |
|
||||
| Huge Trees | 4 attempts to place 5–9-block cactus columns |
|
||||
|
||||
Repeated Pages add independent, deterministic attempts within the existing
|
||||
feature-page limit. Space and ground checks still apply: attempts are not a
|
||||
guarantee of a fixed number of plants. Vanilla biome decoration runs normally
|
||||
before authored vegetation. Non-desert candidates keep the existing vanilla
|
||||
flower, plains-tree and old-growth-spruce features.
|
||||
|
||||
Placement checks the actual candidate biome. Desert writes and neighbor reads
|
||||
stay within the decorating chunk, leave existing structures/plants intact, and
|
||||
require clear air. Cacti require horizontal clearance for their full height.
|
||||
Sand/red sand are preserved. Supported dirt/grass can have just the cactus's
|
||||
base converted to sand, permitting grass-layer Flat Ages without repainting
|
||||
the terrain. Soil over an unsupported block is skipped to avoid falling bases.
|
||||
Dead bushes can grow on supported sand/soil. Other materials are left alone.
|
||||
|
||||
The 1.21.1 Flat generator now applies these three authored plant Pages too;
|
||||
previously that path did not run them. Both versions use the same cactus/bush
|
||||
placement algorithm; version-specific adapters retain their vanilla placement
|
||||
APIs. No new item, recipe, generated texture or hard dependency is introduced.
|
||||
Existing Creative/JEI Pages receive updated tooltip descriptions.
|
||||
|
||||
## Saves
|
||||
|
||||
Only newly decorated chunks change. Existing plants/chunks are not rewritten.
|
||||
Saved written Page order/count and Age seed remain the inputs, with no new
|
||||
saved plan field. Reopening/restarting retains the same placement inputs;
|
||||
it does not rerun decoration on existing chunks.
|
||||
|
||||
## Verification
|
||||
|
||||
Run `python3 scripts/test_desert_vegetation.py` for storage-free checks of all
|
||||
three effects, repeatability, repeated attempts, biome boundaries, chunk
|
||||
bounds, invalid ground, obstruction, Flat base conversion and ceiling limits.
|
||||
Temporary Java outputs are deleted. Test fixtures stay outside production JARs.
|
||||
|
||||
### Player checks, both versions
|
||||
|
||||
1. Create fresh Standard + Desert + Single Biome Ages with a Link Panel and
|
||||
separately Flowers, Trees or Huge Trees. Use a no-feature control and a
|
||||
four-copy version of each page; matching Age seeds improve comparisons.
|
||||
2. Expect additional dead bushes, ordinary cacti, or visibly taller cactus
|
||||
columns respectively. Repeated pages increase attempts; no generic
|
||||
flowers/oak/spruce should be added by these pages in Desert.
|
||||
3. Repeat on Flat + Desert + Single Biome, including the grass-layer surface.
|
||||
Cactus bases may be single sand blocks; other Flat layers remain intact.
|
||||
4. Repeat in BOP Dryland/Lush Desert when installed. Check nearby Plains and
|
||||
Cold Desert keep their previous non-desert behavior.
|
||||
5. Revisit after restart, then explore new chunks. Existing vegetation must
|
||||
remain intact; new chunks should continue the selected behavior.
|
||||
6. Check mixed-biome Ages and occupied/rocky surfaces: vegetation respects the
|
||||
candidate biome, solid obstructions and ground rules.
|
||||
|
||||
No test server or saved test world is required by the offline checks. If a
|
||||
future runtime test stalls, stop it and hand it to the player without retry.
|
||||
|
||||
## 26.3 Flat Dryland regression
|
||||
|
||||
The saved `drybones` Age uses Flat terrain, Single BOP Dryland, and all three
|
||||
plant pages. Its writing and runtime desert tags were correct. In Minecraft
|
||||
26.3, `minecraft:dirt` no longer contains grass blocks; the old soil check
|
||||
therefore rejected the grass surface. The 26.3 adapter now checks both
|
||||
`minecraft:dirt` and `minecraft:grass_blocks`. No 1.21.1 code change was needed.
|
||||
|
||||
An isolated 26.3 server with BOP, TerraBlender and GlitchCore reproduced zero
|
||||
cactus blocks before the fix. With the same seed and pages, the corrected
|
||||
first chunk contained 22 cactus blocks / 15 dead bushes in vanilla Desert and
|
||||
12 cactus blocks / 17 dead bushes in BOP Dryland. These are one-seed observations,
|
||||
not guaranteed densities. The test world and isolated build output were removed;
|
||||
the retained log is `build/verification/desert108/mc263.log`.
|
||||
|
||||
Run `python3 scripts/regression_desert263.py` for this optional-mod runtime
|
||||
check using the local Dev 26.3 mod files. It uses the single-server lock and
|
||||
a 60-second timeout, hands off a stalled test without retry, and removes its
|
||||
temporary world regardless of result.
|
||||
|
||||
## 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.
|
||||
@@ -111,3 +111,7 @@ the Reborn acknowledgement guard. Both player checks passed; publication was
|
||||
explicitly authorized. Reborn is not crash-free: #118 remains open. #117 owns
|
||||
full Seamless support. #116 was user-closed as resolved. Prior dated evidence
|
||||
above remains historical; unchanged earlier artifacts are not relabeled.
|
||||
|
||||
## 2026-11-17 release update
|
||||
|
||||
Player-approved 1.21.1.0.6 and 26.3.0.10 collect #108 desert vegetation, #109 Static Sky resolution and #111 Native biome families. The 26.3 release also includes #117 optional Seamless live rendering. #118 remains open for Reborn/Seamless failures, including the recovered caves_on_top acknowledgement disconnect. Both JARs retain their player-tested hashes.
|
||||
@@ -0,0 +1,139 @@
|
||||
# Native biome families — issue #111
|
||||
|
||||
Release builds: **1.21.1.0.6** and **26.3.0.10**. Player in-game validation passed on both versions (2026-11-17).
|
||||
|
||||
## Pages and terrain
|
||||
|
||||
| Controller Page | Biome selection |
|
||||
| --- | --- |
|
||||
| Native | Existing terrain default. On new Cave Ages, non-Nether cave biomes only. |
|
||||
| Native Caves | All recognized non-Nether caves, using seeded regional placement. |
|
||||
| Native Nether | All recognized Nether biomes, using seeded regional placement. |
|
||||
| Native End | All recognized End biomes, using seeded regional placement. |
|
||||
|
||||
The three explicit family controllers work with Standard, Amplified, Island,
|
||||
Cave, Flat and Void terrain. The **Terrain Page still controls geometry**.
|
||||
Void stays empty; its biomes can affect weather and seasons. These controllers
|
||||
do not select a sky style, dimension type or season.
|
||||
|
||||
The player chose **seeded regional layout including modded biomes** for Native
|
||||
Nether/End, rather than vanilla climate or End-island placement. The family
|
||||
controllers use the established Native Cave/Tiny regional scale (16-block
|
||||
base cells), across the whole frozen family pool. A single available biome
|
||||
uses a FixedBiomeSource.
|
||||
|
||||
Native controllers select their own pool. Individual biome Pages before one
|
||||
retain the existing conflict/recovery rule: the manual biome entries are
|
||||
discarded and instability applies. To choose/weight individual Nether biomes
|
||||
on Cave terrain, use Single/Tiled/region controllers as before.
|
||||
|
||||
## Classification
|
||||
|
||||
- Caves: `rivencraft:cave_biomes`, including optional `c:is_cave`, plus
|
||||
recognized vanilla cave keys. 26.3 retains its new **Sulfur Caves** biome.
|
||||
- Nether: `minecraft:is_nether` **or** membership in a TerraBlender Nether
|
||||
region. No mod-specific name list or namespace heuristic is used.
|
||||
- End: `minecraft:is_end` and known vanilla End members. TerraBlender exposes
|
||||
Overworld and Nether regions, not an End region in either supported API.
|
||||
- Nether classification wins over Cave tagging for Native Caves, including
|
||||
a biome that belongs to a Nether region but lacks `is_nether`.
|
||||
- TerraBlender's internal deferred placeholder is never a native-family biome.
|
||||
|
||||
Family pools are sorted and deduplicated. Vanilla family members provide safe
|
||||
fallbacks when broad tags are empty; Cave fallbacks are still checked against
|
||||
Nether classification. A one-biome pool remains valid. If no cave family member
|
||||
can be used at all, a registered non-Nether biome is the last-resort safety
|
||||
fallback; an entirely unusable registry reports a binding error.
|
||||
|
||||
The broader Cave-compatible authoring pool is preserved. Explicit Nether
|
||||
biome Pages on Cave terrain remain legal and retain existing materials.
|
||||
Other terrain eligibility and non-Native distributions are not filtered by
|
||||
this new default-pool rule.
|
||||
|
||||
## Random Ages and persistence
|
||||
|
||||
Ordinary random-Age controller ranks remain unchanged. When random or
|
||||
seed-completed writing resolves to Cave terrain + Native, its new pool excludes
|
||||
Nether biomes. The new family Pages are explicit authoring choices; they are
|
||||
not added as extra rank tickets to the random controller deck.
|
||||
|
||||
The selected family is saved separately from the existing NATIVE distribution
|
||||
enum, so seeded distribution ordinals/ranks do not change.
|
||||
|
||||
- Authored 1.21.1 plans save optional `NativeKind` with their frozen biome IDs.
|
||||
- New random Native Cave Ages in 1.21.1 generation version **18** also save
|
||||
`RandomBiomes` in the Age definition. Spawn updates and reseeding retain it.
|
||||
- 26.3's existing frozen biome plan saves optional `native_kind`. Random Native
|
||||
Cave Ages now explicitly freeze the CAVES family.
|
||||
- Missing family fields on old saves mean TERRAIN and **do not re-filter the
|
||||
old list**. Existing frozen Cave pools containing Nether biomes are preserved.
|
||||
- Unplanned generation-16/17 Native Cave Ages retain their prior broad pool
|
||||
algorithm; older Ages retain their existing legacy generator. They are not
|
||||
silently migrated to the new family default.
|
||||
- Regions use the Age seed; reseeding can change spatial placement in future
|
||||
chunks while retaining the selected IDs. Existing chunks are not rewritten.
|
||||
|
||||
On 26.3, authored noise-terrain generation can now construct a vanilla noise
|
||||
baseline when the primary Overworld is Flat/custom rather than a Noise generator.
|
||||
This allows the independent Native-family/terrain pairing in that setup instead
|
||||
of failing with “Overworld generator cannot accept authored noise settings.”
|
||||
The existing path for an ordinary noise Overworld is unchanged. Issue #115's
|
||||
separate material-abundance baseline work is not completed by this fix.
|
||||
|
||||
## Creative, JEI and loot policy
|
||||
|
||||
All three new JSON-backed controllers enter the existing **biome generation**
|
||||
Creative category and optional JEI page feed. Glyphs use the existing component
|
||||
renderer and poems; no new generated texture or recipe is needed.
|
||||
Native/Cave tooltips explain the default-pool rule.
|
||||
|
||||
Page allow/block lists categorize the new IDs as biome controllers, separately
|
||||
from individual biome IDs. Manual authoring is still unaffected by those lists.
|
||||
Normal library eligibility can expose the new Pages; Age-only loot uses the
|
||||
Age's own written/result Pages.
|
||||
|
||||
## Verification
|
||||
|
||||
Run one target at a time:
|
||||
|
||||
```sh
|
||||
python3 scripts/regression_native111.py mc1211
|
||||
python3 scripts/regression_native111.py mc263
|
||||
python3 scripts/regression_native111.py mc1211 --biome-mods
|
||||
python3 scripts/regression_native111.py mc263 --biome-mods
|
||||
```
|
||||
|
||||
The optional-mod checks use the installed Dev instance's BOP/TerraBlender/
|
||||
GlitchCore JARs. Every run uses the host-wide server lock, a new temporary
|
||||
world, isolated fixture output and a 60-second stall handoff. Worlds and fixture
|
||||
outputs are deleted on pass or fail; logs remain in
|
||||
`build/verification/native111/`. The fixture code is not shipped in the mod
|
||||
or added to the default GameTest deck.
|
||||
|
||||
Results: **91 checks per version without biome mods; 94 per version with
|
||||
BOP/TerraBlender**. Coverage includes:
|
||||
|
||||
- All three explicit family controllers on all six terrains.
|
||||
- Explicit Native, seed-completed Native and random Native Cave selection.
|
||||
- Overlapping Cave/Nether tags, region-only Nether membership, empty-tag
|
||||
fallback, a valid single-cave saved pool and optional-mod absence.
|
||||
- Explicit Crimson Forest + Cave + Single authoring.
|
||||
- Frozen plan/codec and root random-Age registry save/load behavior.
|
||||
- Preservation of an older mixed Cave/Nether snapshot without a family field.
|
||||
- Controller-policy categories, last-controller recovery, and new Creative/JEI index entries.
|
||||
- 26.3 runtime source overrides on Standard, Void and Cave, including a Flat
|
||||
primary world. Actual world appearance remains player validation.
|
||||
|
||||
### Player checks — both versions
|
||||
|
||||
1. Create **Cave + Native** Ages and explore: no Nether biomes should be selected.
|
||||
Revisit after restart; the chosen cave pool should remain stable.
|
||||
2. Try Native Caves, Native Nether and Native End with Standard or Flat terrain.
|
||||
Confirm their biome IDs and normal travel, including optional BOP biome IDs.
|
||||
3. Try those family Pages on Void terrain: no terrain should be added solely
|
||||
by the controller. Biome-based weather/season behavior can still apply.
|
||||
4. Create **Cave + Crimson Forest + Single** to confirm explicit Nether authoring
|
||||
still works. Native End on Cave should also bind through the explicit family.
|
||||
5. Verify all three Pages appear under biome generation in Creative and JEI.
|
||||
6. Reopen an older Native Cave Age if available. Its saved mixed pool is kept;
|
||||
create a new Age to test the new default rather than expecting migration.
|
||||
@@ -1,10 +1,7 @@
|
||||
# Publishing Rivencraft with the Gitea, Modrinth, and CurseForge APIs
|
||||
|
||||
The local helper is [`scripts/publish_mod_sites.py`](../scripts/publish_mod_sites.py).
|
||||
It previews a release unless `--publish` is explicitly supplied. The current
|
||||
configuration is for the Minecraft **26.3** artifact only. The 1.21.1 line needs
|
||||
its required external dependencies mapped on both sites before API publishing
|
||||
is enabled for it.
|
||||
It previews a release unless `--publish` is explicitly supplied. Both Minecraft **1.21.1** and **26.3** are supported. The publisher maps required Dynamic Dimensions AR Edition and Bad Packets dependencies for 1.21.1; 26.3 uses its first-party backend.
|
||||
|
||||
## One-time token setup
|
||||
|
||||
|
||||
@@ -0,0 +1,61 @@
|
||||
# Rivencraft
|
||||
|
||||
*Write a book. Name an Age. Step into a world that did not exist before.*
|
||||
|
||||
Rivencraft brings the book-writing and dimension-travelling spirit of Mystcraft to **Minecraft 1.21.1 and Minecraft 26.3 on NeoForge**. Collect and arrange Symbol Pages to author an Age, or bind a Link Panel alone to discover a random world. Explore libraries, build crystal portals, and contend with instability when your writing asks too much of an Age.
|
||||
|
||||
Rivencraft is an independent community project inspired by Mystcraft Legacy—not an official Mystcraft release or a byte-for-byte copy.
|
||||
|
||||
## Minecraft versions
|
||||
|
||||
Rivencraft is available for **Minecraft 1.21.1 and 26.3**. Both versions include authored and random Ages, Symbol Pages, writing stations, libraries, crystal portals, and instability. Download the file matching your Minecraft version and install matching builds on clients and servers.
|
||||
|
||||
| Minecraft | NeoForge | Java | Required companion mods |
|
||||
| --- | --- | --- | --- |
|
||||
| **1.21.1** | 21.1.264 or newer in the 21.1 line | **21** | Dynamic Dimensions AR Edition and Bad Packets |
|
||||
| **26.3** | 26.3.0.99 | **25** | None; Rivencraft includes its own Age-loading backend |
|
||||
|
||||
The Minecraft tracks use separate builds and saves. Cross-version world migration is not supported.
|
||||
|
||||
See the [installation guide](https://git.paddedcell.org/dnorberg/rivencraft/wiki/Installation), [26.3 guide](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/ports/mc263/README.md), and [latest releases](https://git.paddedcell.org/dnorberg/rivencraft/releases).
|
||||
|
||||
## What you can do
|
||||
|
||||
- Write Descriptive Books with pages for terrain, biomes, weather, seasons, sky colors, celestials, structures, decorations, and more.
|
||||
- Explore randomly generated Ages and discover pages in Age libraries.
|
||||
- Store and arrange pages in Notebooks; copy pages at the Writing Desk with paper and ink.
|
||||
- Travel with Linking Books, Book Stands, and crystal-frame portals.
|
||||
- Experience Legacy-inspired instability, including decay and environmental hazards.
|
||||
- Preview destinations with the built-in Legacy-style animation or an optional rendering integration for your Minecraft version.
|
||||
- Set an Age’s water level with Flooded and Number Pages.
|
||||
- Select Native Caves, Nether or End biome pools independently of terrain, grow desert vegetation with Trees/Huge Trees/Flowers, and control Static Sky resolution with Number Pages.
|
||||
|
||||
## Getting started
|
||||
|
||||
1. Craft an Ink Vial, Ink Mixer, Writing Desk, and Book Binder.
|
||||
2. Put paper and ink in the Ink Mixer to make a Link Panel Page. Modifier ingredients can change how the link behaves.
|
||||
3. Put leather or an empty Notebook and the Link Panel in the Book Binder. Name the Age and take its Descriptive Book. Add Symbol Pages to author the Age; a Link Panel alone creates a seeded random Age.
|
||||
4. Open the book, then click its destination preview to travel. Bring a bound Linking Book for the return trip—automatic Return Links are disabled by default.
|
||||
|
||||
## Installation and optional integrations
|
||||
|
||||
For **Minecraft 1.21.1**, install **[Dynamic Dimensions AR Edition 0.9.1](https://www.curseforge.com/minecraft/mc-mods/dynamicdimension-ar-edition)** and **[Bad Packets 0.8.2](https://www.curseforge.com/minecraft/mc-mods/badpackets)** alongside Rivencraft on clients and servers. **Minecraft 26.3 does not require either companion mod.**
|
||||
|
||||
Optional integrations include **JEI**, **TerraBlender** and compatible biome mods such as Biomes O’ Plenty, **Serene Seasons** with GlitchCore, and **Ruins**. Use each integration’s Minecraft-specific files. Rivencraft’s core gameplay works without these optional mods. Ecliptic Seasons is not currently supported.
|
||||
|
||||
Destination previews depend on the Minecraft version:
|
||||
|
||||
- **1.21.1:** optional Create/Ponder snapshots or Immersive Portals live views.
|
||||
- **26.3:** optional **Immersive Portals Reborn or Seamless Portals** live book and crystal-portal views, including look-only exploration inside the book panel. Install only one fork per instance. **Known Reborn/Seamless crashes and travel disconnects remain under investigation:** [issue #118](https://git.paddedcell.org/dnorberg/rivencraft/issues/118).
|
||||
|
||||
Built-in animated previews remain available without a portal renderer. Create/Ponder scenes are not currently included in the 26.3 build.
|
||||
|
||||
Back up the **entire world folder** before changing versions, data packs, or biome mods. Age definitions and dimension data must be restored together.
|
||||
|
||||
## Community, issues, and wiki
|
||||
|
||||
Rivencraft is developed at [BlackSheep Git](https://git.paddedcell.org/dnorberg/rivencraft). Please [report bugs or suggest features](https://git.paddedcell.org/dnorberg/rivencraft/issues) there. Want to help document Ages, pages, and crafting? Visit the [Rivencraft wiki](https://git.paddedcell.org/dnorberg/rivencraft/wiki) to contribute, or open an issue with guide ideas and corrections.
|
||||
|
||||
## Thanks and attribution
|
||||
|
||||
Heartfelt thanks to **XCompWiz**, the original creator of Mystcraft, for making such a wonderful mod and inspiring years of exploration and creative world-writing. Please visit the original [Mystcraft](https://www.curseforge.com/minecraft/mc-mods/mystcraft) and his early, unfinished [Mystcraft 2](https://www.curseforge.com/minecraft/mc-mods/mystcraft-2). Rivencraft is independent and is not endorsed by the original Mystcraft team. Selected Legacy-derived assets are credited in the project's NOTICE and asset-provenance document. Rivencraft is licensed under LGPL-3.0-or-later.
|
||||
@@ -0,0 +1,136 @@
|
||||
# Optional Seamless Portals integration — issue #117
|
||||
|
||||
Local candidate **26.3.0.9**, Minecraft 26.3 / NeoForge 26.3.0.99 / Java 25.
|
||||
Pending real-client validation; not committed or published. Minecraft 1.21.1
|
||||
is unchanged by this issue.
|
||||
|
||||
## Supported engines and API boundary
|
||||
|
||||
Install **one** portal fork per instance:
|
||||
|
||||
- Seamless Portals **1.0.0**, installed file `seamlessportals-neoforge-1.0.0.jar`.
|
||||
- Immersive Portals Reborn **7.0.12**, retaining its previously implemented path.
|
||||
- Neither: Rivencraft's animated panels/surfaces and ordinary travel remain.
|
||||
|
||||
The actual installed Seamless JAR was inspected and compiled against, not
|
||||
assumed compatible from its name. Used public GUI rendering, WorldRenderInfo
|
||||
builder, chunk-loader and PortalAPI signatures match Reborn. ClientWorldLoader
|
||||
and Portal have additional fork-specific members; Rivencraft does not use those
|
||||
differences for live views. The native dimension adapter still uses each fork's
|
||||
own `DimIdSyncPacket.createFromServer` factory and wire format.
|
||||
|
||||
The existing Reborn implementation has been renamed into shared
|
||||
`ImmersiveBookPreviews`, `ImmersivePreviewChunks`, `ImmersiveLiveBookPanel`,
|
||||
`ImmersiveCrystalPortals` and `ImmersiveCrystalView` classes. No second copy
|
||||
of the rendering, destination, chunk-stream or mesh algorithms was introduced.
|
||||
Optional API references remain behind availability guards; neither fork is
|
||||
bundled or required.
|
||||
|
||||
The Reborn acknowledgement workaround is still **Reborn-only**. This change
|
||||
does not resolve or establish a root cause for the Reborn crashes in
|
||||
[#118](https://git.paddedcell.org/dnorberg/rivencraft/issues/118).
|
||||
|
||||
## Configuration
|
||||
|
||||
In `config/rivencraft-local.toml`:
|
||||
|
||||
```toml
|
||||
[book_previews]
|
||||
seamless_live_views = true
|
||||
seamless_crystal_live_views = true
|
||||
reborn_live_views = true
|
||||
reborn_crystal_live_views = true
|
||||
```
|
||||
|
||||
The active fork uses its own switches. The existing Reborn preferences keep
|
||||
their meanings; Seamless defaults to enabled. Book views are a local client
|
||||
choice. Crystal views are server-controlled. Disable the relevant switch for
|
||||
animated fallback; portal/book travel remains Rivencraft's responsibility.
|
||||
|
||||
## Books
|
||||
|
||||
Both Linking and Descriptive Books request a rotating live destination panel.
|
||||
Stand books get the panel without exploration. The handheld eye enters
|
||||
look-only exploration inside the book window; movement is disabled, and
|
||||
right-click returns to ordinary book controls. The camera starts at the linked
|
||||
arrival eye position. Missing/unready destination chunks retain the animation.
|
||||
|
||||
Each player has one validated preview stream, tied to source world, held or
|
||||
stand book and session UUID. Requests are rate limited. A 30-second lease is
|
||||
renewed by the open book and released on close, logout, dimension changes,
|
||||
invalid source book, expiry and shutdown. Late responses cannot overwrite a
|
||||
newer book session.
|
||||
|
||||
Only one GUI render target task is queued at once. The target stays alive
|
||||
across deferred GUI frames rather than being destroyed while still referenced.
|
||||
The shared engine hook clears the remote target before rendering and restores
|
||||
the player's local camera afterward. Remote book-world sounds are filtered;
|
||||
source rain/audio and camera restoration remain explicit player checks.
|
||||
|
||||
## Crystal portals
|
||||
|
||||
Native portals are render-only: Rivencraft portal cells retain travel,
|
||||
cooldowns, link properties and destination safety rules. Connected cells are
|
||||
grouped into one coplanar masked mesh per side of an opening, not repeated
|
||||
per-block views. The linked standing eye position maps through the native
|
||||
transform onto the actual destination eye position; the frame sits in front
|
||||
of the live view.
|
||||
|
||||
A complete native surface disables the fallback texture. Missing/disabled
|
||||
native views retain it. Receptacle maintenance restores views after reload;
|
||||
book removal/frame shutdown removes native entities. Existing ownership tags
|
||||
are preserved so maintenance can find saved views rather than duplicate them.
|
||||
|
||||
## Automated and player validation
|
||||
|
||||
The isolated `scripts/regression_portal117.py` probe accepts `none`,
|
||||
`seamless --jar /path/to/seamless.jar`, or `reborn`. Run each separately;
|
||||
the host-wide server lock prevents overlap. Every run uses a new temporary
|
||||
world, removes it and fixture outputs regardless of result, and retains a log
|
||||
under `build/verification/portal117/`. A 60-second stall is stopped and handed
|
||||
to the player without retry.
|
||||
|
||||
The fixture explicitly warms a forced test chunk before querying native
|
||||
entities. An unticked startup chunk does not expose its entities through the
|
||||
normal spatial query. Portal widths/heights use the engine's W/H axes, which
|
||||
can swap relative to world X/Y; assertions check world-space spans and the
|
||||
actual eye transform.
|
||||
|
||||
Final sequential server results: **24 checks passed with Seamless, 24 with
|
||||
Reborn, and 8 with neither**. Earlier fixture assertions were corrected for
|
||||
entity-section visibility and native axis ordering; no stalled run was retried.
|
||||
|
||||
Server checks cover dynamic Age registration/catalog synchronization, six-cell
|
||||
frame formation, one mesh per side, correct physical spans, exact eye mapping,
|
||||
non-teleporting/non-interactive native surfaces, refresh reuse, config fallback,
|
||||
reactivation and cleanup. They do **not** verify GPU output, connected preview
|
||||
leases, multiplayer packet delivery, or real-client restart behavior.
|
||||
|
||||
### Required player matrix
|
||||
|
||||
Use Seamless alone with Rivencraft 26.3.0.9 on both ends:
|
||||
|
||||
1. Bind a new Descriptive Book, open/close it repeatedly and link through it.
|
||||
Compare the live view with the real destination.
|
||||
2. Test a Linking Book and a stand book. Confirm the panel stays inside the
|
||||
book and stands have no eye exploration.
|
||||
3. Enter handheld exploration, look around, right-click out, re-enter, close
|
||||
and reopen. Confirm no movement or full-screen view, and local rain/audio
|
||||
remain correct.
|
||||
4. Form a multi-block crystal opening. Check one continuous view, frame
|
||||
occlusion, no fallback overlay, matching arrival position/facing, and travel.
|
||||
5. Remove/reinsert the book and break/rebuild the frame; no orphan views.
|
||||
6. Reconnect and fully restart. Check saved books, previews and portal
|
||||
reactivation, including initially unloaded destination chunks.
|
||||
7. Explore across chunk boundaries for a sustained period. Do not assume
|
||||
Seamless is free of the Reborn renderer problem without testing.
|
||||
8. On a dedicated server, check two players using different books/portals,
|
||||
closing/logging out independently, and creating a new Age after joining.
|
||||
9. Disable each Seamless switch and verify its animated fallback and normal
|
||||
travel. No portal mod and Reborn are separate regression configurations.
|
||||
|
||||
Inspected Seamless artifact SHA-256: `5d2bfc2a811a6526e3f6722c521d97e5de2869a6ead1c681323c3c472e4367a0`.
|
||||
|
||||
## 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.
|
||||
@@ -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.
|
||||
@@ -23,3 +23,16 @@ Crystal Formations are an authored, material-free feature on exposed solid terra
|
||||
Star Fissures are a material-free feature on every terrain profile, including Cave and Void. The fissure is generated once beside the first resolved spawn, using Legacy's spawn-chunk offset and 10–17 paired, irregular X-span rows running along +Z. Legacy's y=0 portal floor maps to the modern dimension's minimum build height, replacing lower bedrock if present. The rift opens to the sky on ordinary terrain; in Cave terrain it opens into the cavern but stops below the upper bedrock roof. Water in the carved columns is cleared before the portal is placed. Its non-solid portal links to the Overworld spawn with the Legacy fissure sound; the animated starfield is drawn with Minecraft's current End Portal renderer, which uses the same end-sky/end-portal art as Legacy's custom renderer. Random Ages sample Legacy's default small-feature grammar for fissure selection: the stop/one/repeat branches have rank-derived weights 1:1:3, and the fissure has weight 1 of 9 among its small-feature rules. The remainder of random feature selection still follows Rivencraft's current pipeline, rather than running Legacy's entire Age grammar.
|
||||
|
||||
The Rivencraft symbol-page creative tabs read a generated index of bundled symbol definitions and group Pages by each definition's category, except biome-controller roles, which appear in a separate Biome Generation tab rather than the Biome tab. Adding another valid JSON symbol under `src/main/resources/data/rivencraft/rivencraft/symbols/` includes its page in the matching category tab on the next build; a new bundled category receives its own tab. Registry-derived Block and Fluid Pages have separate tabs and both appear in optional JEI. Registry-derived biome pages share a creative/JEI feed; `terrablender:deferred_placeholder` is excluded because it is TerraBlender's internal staging biome, not a player-facing biome choice. Other modded biomes remain listed. Link Pages have a separate tab. Blank Pages appear in neither the creative tabs nor JEI's ingredient list. The server catalog still decides whether a page is valid for writing. External server data-pack symbols are not included in this bundled index.
|
||||
|
||||
## Static Sky resolution (issue #109)
|
||||
|
||||
Adjacent Number Pages before Static Sky form a base-25 cell count per face.
|
||||
Default 48, bounded 1–128; zero clamps to 1. Other sky styles do not consume
|
||||
resolution numbers. See [Static Sky resolution](STATIC_SKY_RESOLUTION.md).
|
||||
|
||||
## Native biome families (issue #111)
|
||||
|
||||
Native Caves, Native Nether and Native End are singular biome controllers,
|
||||
usable on any Terrain Page. They choose a frozen family pool in seeded regions;
|
||||
individual biome Pages retain Native conflict recovery. New ordinary Native Cave
|
||||
pools exclude Nether tags/regions. See [family rules](NATIVE_BIOME_FAMILIES.md).
|
||||
Reference in new issue
Block a user