Compare commits

..
Author SHA1 Message Date
dnorberg d199ac253e Add native biome families, desert vegetation, static sky controls and Seamless views
Build and smoke / changes (push) Waiting to run
2026-11-17 18:12:07 -05:00
dnorberg 90e4a98a7a Use integer CurseForge dependency project IDs for release uploads
Build and smoke / changes (push) Canceled after 0s
Build and smoke / build (push) Canceled after 0s
2026-11-15 22:11:17 -05:00
dnorberg 441f2896d7 Add Flooded pages across Minecraft versions and fix 1.21.1 workstations
Build and smoke / changes (push) Canceled after 0s
Build and smoke / build (push) Canceled after 0s
2026-11-15 22:08:56 -05:00
dnorberg 4a59fb5d02 Complete 26.3 parity acceptance and dual-version release workflow
Build and smoke / changes (push) Canceled after 0s
Build and smoke / build (push) Canceled after 0s
2026-11-14 12:17:49 -05:00
dnorberg 41daff1e61 Release 26.3.0.1 with live Reborn views and random page policies
Build / build (push) Canceled after 0s
2026-11-11 17:15:46 -05:00
dnorberg f9097967b9 Port optional integrations and finish Age creation and modifier lifecycle
Build / build (push) Canceled after 0s
2026-11-11 04:17:41 -05:00
185 changed files with 8655 additions and 676 deletions

No files matched your search

+64
View File
@@ -0,0 +1,64 @@
name: Build and smoke
on: [push, pull_request]
permissions:
contents: read
jobs:
changes:
runs-on: ubuntu-latest
outputs:
matrix: ${{ steps.targets.outputs.matrix }}
any: ${{ steps.targets.outputs.any }}
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Check release workflow safeguards
run: python3 scripts/test_release_workflow.py -v
- id: targets
env:
BASE: ${{ github.event.pull_request.base.sha || github.event.before }}
run: |
base="$BASE"
if [ -z "$base" ] || ! git cat-file -e "$base^{commit}" 2>/dev/null; then
base=$(git rev-parse HEAD^)
fi
matrix=$(python3 scripts/changed_targets.py --base "$base")
echo "matrix=$matrix" >> "$GITHUB_OUTPUT"
if [ "$matrix" = '{"include":[]}' ]; then
echo "any=false" >> "$GITHUB_OUTPUT"
else
echo "any=true" >> "$GITHUB_OUTPUT"
fi
build:
needs: changes
if: needs.changes.outputs.any == 'true'
runs-on: ubuntu-latest
timeout-minutes: 20
strategy:
fail-fast: false
max-parallel: 1
matrix: ${{ fromJSON(needs.changes.outputs.matrix) }}
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
fetch-tags: true
- uses: actions/setup-java@v4
with:
java-version: ${{ matrix.java }}
distribution: temurin
- uses: gradle/actions/setup-gradle@v4
- name: Build Minecraft target
run: ./gradlew ${{ matrix.gradle_args }} --console=plain
- name: Disposable dedicated-server smoke
run: python3 scripts/smoke_server.py --target ${{ matrix.target }}
- name: Keep smoke logs
if: always()
uses: actions/upload-artifact@v3
with:
name: smoke-${{ matrix.target }}
path: build/verification/${{ matrix.target }}/*.log
if-no-files-found: ignore
+54 -15
View File
@@ -1,25 +1,64 @@
name: Build name: Build and smoke
on: [push, pull_request] on: [push, pull_request]
permissions:
contents: read
jobs: jobs:
build: changes:
runs-on: ubuntu-latest runs-on: ubuntu-latest
outputs:
matrix: ${{ steps.targets.outputs.matrix }}
any: ${{ steps.targets.outputs.any }}
steps: steps:
- name: Checkout repository - uses: actions/checkout@v4
uses: actions/checkout@v4 with:
fetch-depth: 0
- name: Check release workflow safeguards
run: python3 scripts/test_release_workflow.py -v
- id: targets
env:
BASE: ${{ github.event.pull_request.base.sha || github.event.before }}
run: |
base="$BASE"
if [ -z "$base" ] || ! git cat-file -e "$base^{commit}" 2>/dev/null; then
base=$(git rev-parse HEAD^)
fi
matrix=$(python3 scripts/changed_targets.py --base "$base")
echo "matrix=$matrix" >> "$GITHUB_OUTPUT"
if [ "$matrix" = '{"include":[]}' ]; then
echo "any=false" >> "$GITHUB_OUTPUT"
else
echo "any=true" >> "$GITHUB_OUTPUT"
fi
build:
needs: changes
if: needs.changes.outputs.any == 'true'
runs-on: ubuntu-latest
timeout-minutes: 20
strategy:
fail-fast: false
max-parallel: 1
matrix: ${{ fromJSON(needs.changes.outputs.matrix) }}
steps:
- uses: actions/checkout@v4
with: with:
fetch-depth: 0 fetch-depth: 0
fetch-tags: true fetch-tags: true
- uses: actions/setup-java@v4
- name: Setup JDK 21
uses: actions/setup-java@v4
with: with:
java-version: '21' java-version: ${{ matrix.java }}
distribution: 'temurin' distribution: temurin
- uses: gradle/actions/setup-gradle@v4
- name: Setup Gradle - name: Build Minecraft target
uses: gradle/actions/setup-gradle@v4 run: ./gradlew ${{ matrix.gradle_args }} --console=plain
- name: Disposable dedicated-server smoke
- name: Build with Gradle run: python3 scripts/smoke_server.py --target ${{ matrix.target }}
run: ./gradlew build - name: Keep smoke logs
if: always()
uses: actions/upload-artifact@v4
with:
name: smoke-${{ matrix.target }}
path: build/verification/${{ matrix.target }}/*.log
if-no-files-found: ignore
+23 -20
View File
@@ -10,24 +10,25 @@ also lets you author modern terrain, biomes, structures, seasons, and celestial
bodies. It is an independently developed project, not a byte-for-byte copy of bodies. It is an independently developed project, not a byte-for-byte copy of
the 1.12.2 mod. the 1.12.2 mod.
The gameplay guide below describes the **Minecraft 1.21.1 release**. A separate, Current releases: **1.21.1.0.6** and **26.3.0.10**, with separate Minecraft-specific JARs and saves.
incomplete **Minecraft 26.3 beta** is available: Java 25, NeoForge 26.3.0.99,
and a first-party Age backend (no Dynamic Dimensions or Bad Packets). It now The gameplay guide below describes the **Minecraft 1.21.1 release**. The separate
supports authored terrain/biomes, structure and vegetation pages, independent **Minecraft 26.3 release** uses Java 25, NeoForge 26.3.0.99 and a first-party Age
Age weather/lighting, seeded and colorable Overworld/Nether/End/Static skies, backend; it does not require Dynamic Dimensions or Bad Packets. Both tracks include
independent Sun/Moon controls, multiple bodies and eclipses, seeded biome and authored/seeded Ages, writing stations, libraries, crystal portals, celestials,
feature completion, and random structure selection. Nether/End noise-biome instability and Link Modifier controls. JEI, TerraBlender/Biomes O' Plenty,
materials now follow their native rules. Books now have Legacy-style spreads, Serene Seasons and Ruins remain optional. See the [26.3 guide](ports/mc263/README.md)
animated fallback panels and saved destination labels; lectern stands, open-book and [parity review](docs/MC263_PARITY_REVIEW.md).
drops, page collections, stations and basic progression are also ported. The latest
beta adds Age libraries, crystal portals with animated fallback surfaces, saved These releases add [Native biome-family Pages](docs/NATIVE_BIOME_FAMILIES.md),
instability scoring/provider selection, potion providers and four-color decay. [desert vegetation](docs/DESERT_VEGETATION.md) and Number-controlled
Full writing recovery, live material profiling and other hazards remain pending. [Static Sky resolution](docs/STATIC_SKY_RESOLUTION.md).
The beta does not yet provide full On 26.3, optional Immersive Portals Reborn or Seamless Portals provides live book
1.21.1 gameplay or optional-integration parity. and crystal portal views, including look-only exploration in the book panel.
See the [26.3 beta guide](ports/mc263/README.md) and Install only one fork; built-in animations work without either.
[latest beta release notes](ports/mc263/RELEASE_NOTES_1.0.1.120-beta.1.md). Known Reborn/Seamless crashes and travel disconnects remain tracked in
Keep the builds and their saves separate, and back up worlds before updating. [#118](https://git.paddedcell.org/dnorberg/rivencraft/issues/118).
Use matching client/server builds, keep Minecraft tracks separate and back up worlds before updating.
## Getting started ## Getting started
@@ -129,8 +130,10 @@ checks from manual evidence and known limitations.
The JAR is written to `build/libs/`. Development runs need the required mods; The JAR is written to `build/libs/`. Development runs need the required mods;
see [GameTest guidance](docs/GAMETESTS.md) for focused archived suites. see [GameTest guidance](docs/GAMETESTS.md) for focused archived suites.
Versions use `x.y.z.b`: major release, completed milestone, release slice, New versions prefix the Minecraft version, followed by the milestone/release
then fixes/additional work within that slice. slice and fixes/additional-work iteration. For example, `26.3.0.1` produces
`rivencraft-26.3.0.1.jar`. Existing 1.21.1 artifacts keep their published legacy
numbers until that line's next code release. See the [release workflow](docs/DUAL_VERSION_RELEASE.md).
Rivencraft is licensed under LGPL-3.0-or-later. Legacy-derived material is Rivencraft is licensed under LGPL-3.0-or-later. Legacy-derived material is
credited in [NOTICE](NOTICE) and [asset provenance](docs/ASSET_PROVENANCE.md). credited in [NOTICE](NOTICE) and [asset provenance](docs/ASSET_PROVENANCE.md).
+14
View File
@@ -0,0 +1,14 @@
# Rivencraft 1.21.1.0.1
For Minecraft 1.21.1, NeoForge 21.1.264 and Java 21.
Requires Dynamic Dimensions AR Edition and Bad Packets as before.
- Fixed Ink Mixers draining a full vial for one Link Panel. Each panel now costs
one paper and one ink; one full vial produces 16 panels.
- Modifier chances remain in the basin while previewing and reset only when a
panel is taken. Output refreshes immediately; vial exchange still returns a
vanilla glass bottle and respects bottle-slot space.
- Hand-making a panel retains its separate two-ink cost.
- Updated the JEI guide text to state the Mixer cost.
- This is the first 1.21.1 release using Minecraft-prefixed version identity.
The independently maintained 26.3 line already uses the correct mixer cost.
+16
View File
@@ -0,0 +1,16 @@
# Rivencraft 1.21.1.0.2
For Minecraft 1.21.1, NeoForge 21.1.264 and Java 21.
Includes the unpublished 1.21.1.0.1 Ink Mixer fix; requires Dynamic Dimensions AR
Edition and Bad Packets as before.
- Flat Age generation now starts bedrock at Y=0, dirt at Y=1–2 and grass at Y=3,
matching 26.3. The existing footing search uses this surface for arrival.
- Void and non-Flat generation are unchanged. Dimension profiles whose minimum
is already zero do not receive extra padding.
- Existing generated chunks are not rewritten. Newly generated chunks in existing
Flat Ages use the new layout and can meet old chunks at a height discontinuity.
Existing saved arrival positions are retained; create a fresh Age to test.
- Ink Mixers use one paper and one ink per panel (16 panels per full vial).
Modifier chances reset only when a panel is taken; hand-making defaults to two ink.
- JEI mixer text reflects the one-ink cost. Uses Minecraft-prefixed version names.
+40
View File
@@ -0,0 +1,40 @@
# Rivencraft 1.21.1.0.3
For **Minecraft 1.21.1**, **NeoForge 21.1.264** and **Java 21**.
Requires **Dynamic Dimensions AR Edition** and **Bad Packets**.
## Flooded Pages
- Added the Flooded Environment Page for Cave, Standard, Amplified, Island,
Flat and Void terrain. The default highest water block is Y=63.
- Number Pages immediately before Flooded form base-25 digits: Number 24 +
Flooded sets Y=24; Number 2 + Number 24 + Flooded sets Y=74. The visible water
surface is one block above that coordinate. Last Flooded wins.
- Levels are nonnegative and clamp below the dimension ceiling to leave room
for a safe arrival platform and player headroom.
- Flooding fills open space after terrain/carvers/decorations, preserving solid
features and waterloggable blocks. Lower levels drain higher ordinary water.
- Cave default water aquifers are disabled without Flooded. Water policy persists
in saved writing and generator codecs; fallback platforms sit above flood water.
- Included in Creative and optional JEI using existing glyph composition.
## Ink Mixer and Flat Ages
- Each Link Panel from the Ink Mixer consumes one paper and one ink. A full vial
makes 16 panels. Modifier chances reset only when a panel is taken; vial
exchange still returns a vanilla glass bottle. Hand-making defaults to two ink.
- Flat solid layers now start at Y=0: bedrock at 0, dirt at 1–2, grass at 3.
New Flat Ages arrive on their surface rather than far above the ground.
- JEI wording states the mixer cost. This release adopts Minecraft-prefixed
version identity and collects the unpublished 1.21.1.0.1–0.2 fixes.
## Validation and save behavior
The player passed the Mixer, fresh Flat arrival/revisit and Flooded checks.
Focused tests passed: four Mixer checks, three Flat checks and three Flooded
checks, including codecs, two water levels and preserved features. Temporary
test worlds were removed.
Existing generated chunks and saved arrival positions are not rewritten. New
chunks in old Flat Ages may meet previous chunks at a height seam. Use new Ages
for new writing. See [Flooded rules](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/FLOODED_PAGES.md).
+14
View File
@@ -0,0 +1,14 @@
# Rivencraft 1.21.1.0.4
Local test build for issue #108; pending player validation and explicit publication.
- Trees add ordinary cacti in vanilla and tagged modded deserts.
- Huge Trees add tall 5–9-block cactus columns; Flowers add dead bushes.
- Repeated pages add seeded attempts; normal biome decoration remains.
- Uses common `c:is_desert` via a data-pack-extensible Rivencraft tag. BOP
Dryland/Lush Desert are included; Cold Desert is unchanged.
- Candidate biome, air, ground and bounds checks protect existing blocks.
- Existing chunks are not rewritten. Creative/JEI tooltips describe the behavior.
- Flat Ages now apply these authored vegetation pages as well.
Shared placement checks passed. See [desert vegetation rules](docs/DESERT_VEGETATION.md).
+13
View File
@@ -0,0 +1,13 @@
# Rivencraft 1.21.1.0.5
Local test build for Minecraft 1.21.1; pending player validation and explicit publication.
- Number Pages immediately before Static Sky set its cells per face in base 25.
Default 48; supported range 1–128, with zero and oversized inputs clamped.
- Resolution persists across travel/save/reload and synchronizes with clients.
Matching updated server/client builds are required.
- Static animation timing and tint remain independent; other skies are unchanged.
- Existing Static Sky/Number Pages and Creative/JEI descriptions are updated.
- Includes the previously validated desert vegetation changes from issue #108.
Focused checks passed; GPU appearance awaits player validation. See [rules and tests](docs/STATIC_SKY_RESOLUTION.md).
+15
View File
@@ -0,0 +1,15 @@
# Rivencraft 1.21.1.0.6
Release for Minecraft 1.21.1 / NeoForge 21.1.264 / Java 21.
Requires Dynamic Dimensions AR Edition and Bad Packets. Use matching client/server builds.
- Adds Native Caves, Native Nether and Native End Pages, selecting seeded regional biome pools independently of terrain. Includes recognized modded biomes.
- New ordinary Native Cave Ages exclude Nether tags and TerraBlender Nether regions. Explicit Nether biome authoring on Cave terrain remains supported.
- Trees add cacti in vanilla and tagged modded deserts, Huge Trees add tall cactus columns, and Flowers add dead bushes. Works on Flat terrain, including BOP Dryland and Lush Desert.
- Number Pages immediately before Static Sky set resolution in base 25: default 48, clamped to 1–128. Resolution saves and synchronizes with clients.
- New Pages appear in the biome generation Creative tab and optional JEI. Updated tooltips explain the new behavior.
- Saves freeze the selected biome family and IDs. Existing frozen pools and generated chunks are not rewritten.
Player in-game checks passed for both supported Minecraft versions. Focused Native-family checks passed: 91 without biome mods, 94 with BOP/TerraBlender. Desert and Static Sky checks also passed.
Writing examples: Link Panel → Terrain → Native Caves/Nether/End. Native is itself a biome controller; do not add a second distribution controller.
+3 -1
View File
@@ -17,7 +17,7 @@ tasks.named('wrapper', Wrapper).configure {
version = mod_version version = mod_version
group = mod_group_id group = mod_group_id
List<String> archivedGameTestSuites = ['linking', 'environment', 'writing', 'grammar', 'generation', 'desk', 'binder', 'mixer', 'recipe', 'instability'] List<String> archivedGameTestSuites = ['linking', 'environment', 'writing', 'grammar', 'generation', 'desk', 'binder', 'mixer', 'recipe', 'instability', 'flat', 'flood']
List<String> selectedArchivedGameTestSuites = providers.gradleProperty('withArchivedGameTests') List<String> selectedArchivedGameTestSuites = providers.gradleProperty('withArchivedGameTests')
.map { it.toBoolean() }.orElse(false).get() ? archivedGameTestSuites .map { it.toBoolean() }.orElse(false).get() ? archivedGameTestSuites
: providers.gradleProperty('archivedGameTestSuites').orElse('').get() : providers.gradleProperty('archivedGameTestSuites').orElse('').get()
@@ -29,6 +29,8 @@ String enabledGameTestNamespaces = ([mod_id] + selectedArchivedGameTestSuites.co
"rivencraft_archive_${it}" "rivencraft_archive_${it}"
}).join(',') }).join(',')
sourceSets.main.java.srcDir('shared/src/main/java')
sourceSets.main.resources { sourceSets.main.resources {
// Include resources generated by data generators. // Include resources generated by data generators.
srcDir('src/generated/resources') srcDir('src/generated/resources')
+104
View File
@@ -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.
+117
View File
@@ -0,0 +1,117 @@
# Dual-version release workflow
Maintain Minecraft 1.21.1 and 26.3 independently. The 1.21.1 line retains Dynamic
Dimensions AR Edition and Bad Packets. The 26.3 line uses its first-party backend.
Do not widen either artifact's Minecraft dependency range or import saves between
the tracks.
## Version identity
From 26.3.0.1 onward, prefix the Minecraft version and append the milestone/release
slice and iteration: Minecraft.release-slice.iteration. Example:
`26.3.0.1` -> `rivencraft-26.3.0.1.jar`, Gitea tag `V26.3.0.1`.
An explicitly selected prerelease uses a suffix such as `-beta.1`.
The existing 1.21.1 release keeps its published version until its next code update;
then use the corresponding `1.21.1.<slice>.<iteration>` convention.
The user authorized regular release status for 26.3.0.1. Release-channel status
does not close unfinished parity or multiplayer issues automatically.
## Build and publish
For 26.3, update `ports/mc263/gradle.properties`, then run
`./gradlew -p ports/mc263 build --console=plain` with Java 25 available.
Use the exact built/player-validated artifact; naming/metadata-only changes do
not change generation or save behavior.
Write release notes, audit the guide/wiki/project description, commit and push
the changes, then create and push the matching annotated tag. Preview the
`scripts/publish_mod_sites.py release` command with the JAR, changelog, version,
display name, Minecraft version, Java version and channel; add `--publish` to
upload to Gitea, Modrinth and CurseForge. Tokens stay in the system keyring.
Verify published metadata and downloaded artifact hashes. CurseForge approval
may remain pending after a successful upload.
The publisher accepts legacy Minecraft-prefixed archive filenames and beta tags
for already numbered historical uploads; new releases use the identity above.
## Validation gates and issue audit
Run appropriate builds and targeted server checks for changed behavior. The user
performs visual/gameplay validation. Keep temporary test fixtures out of shipped
JARs; use new worlds and remove them regardless of pass/fail. Stop test processes.
If generation stalls, hand the test to the user.
Before closing a port umbrella issue, compare its acceptance criteria and comments
to actual evidence. The expanded-catalog matrix and manual restart/return handoff completed in #100.
See [the final parity review](MC263_PARITY_REVIEW.md) for evidence and limits.
Shared issues need both versions resolved before closure.
For each release, document tested optional versions and no-optional fallbacks,
match client/server JARs, preserve the independent 1.21.1 support line, update wiki
and platform descriptions, and keep known bugs linked in the release notes.
## Changed-target validation policy
Only test a Minecraft target when its code/resources changed. Select targets with
`python3 scripts/changed_targets.py --base <commit>`. Shared assets can select
both; temporary servers must run sequentially. Earlier gameplay sign-off remains
valid for unchanged 1.21.1 code.
Repeatable local checks:
- Java 21 / 1.21.1: `./gradlew build --console=plain`.
- Java 25 / 26.3: `./gradlew -p ports/mc263 build --console=plain`.
- Smoke one changed target: `python3 scripts/smoke_server.py --target mc1211`
or `--target mc263`.
- Two-client 26.3 acceptance: `python3 scripts/regression_multiplayer_263.py`.
Fixture sources remain outside the shipping JAR. If a test stalls, stop it,
preserve logs, delete temporary worlds and hand the remaining check to the user.
Do not automatically retry.
GitHub and Gitea workflow definitions select changed targets and use
`max-parallel: 1`. Hosted execution is not yet verified. Repository runner
inventory alone does not establish availability of instance-wide runners.
The publisher checks embedded version/Minecraft metadata, Java selection,
filename identity, absence of test fixtures and required 1.21.1 dependencies.
Apply relevant fixes to both supported lines, with separate implementation and
validation per target. Keep version-specific fixes on the affected line. Advancing
the newer Minecraft/NeoForge target requires a compatibility audit and must not
silently replace 1.21.1 support or widen an existing JAR dependency range.
## Current acceptance evidence (2026-11-14)
26.3.0.3 builds and the user passed book-window mouse-look, right-click return
and re-entry. Beta branding is removed. The release collects these changes,
the workflow tools and the final parity review.
The expanded-catalog dedicated matrix ran with two real clients. Both received
runtime-created Ages and authored environment data, traveled using normal books,
and passed stale-ack rejection/recovery, occupied-unload refusal, empty-Age
reload/reseed and retirement checks. After full server restart both reconnected in
the surviving Age with its saved seed and presentation, without the retired Age.
The run stalled at the final post-restart return Linking Book step (phase 22).
It was stopped, temporary worlds deleted, and the last check handed off rather
than retried. Singleplayer preview sign-off does not replace that dedicated check.
The player completed the manual dedicated-server restart/return check on
2026-11-14 and explicitly accepted #100. This was one player-operated client,
complementing the automated two-client evidence; it is not described as a new
automated two-client pass. The test server was stopped, logs retained under
build/verification/issue100-manual, and its temporary world removed.
See [the final parity review](MC263_PARITY_REVIEW.md). Renderer bug #116 remains
separately tracked. #103/#104 and parent #96 close after release verification.
## 2026-11-15 release update
The first Minecraft-prefixed 1.21.1 release is 1.21.1.0.3, collecting Mixer #105,
Flat #106 and Flooded #107. The matching 26.3 release is 26.3.0.5 with Flooded and
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.
+98
View File
@@ -0,0 +1,98 @@
# Flooded Pages (issue #107)
Available in releases 1.21.1.0.3 and 26.3.0.5. The player passed both game
versions, with Reborn crashes separately tracked in
[#118](https://git.paddedcell.org/dnorberg/rivencraft/issues/118).
## Writing
Flooded is an Environment Page in Creative and the page feed used by optional
JEI. It reuses glyph composition, without a new bitmap.
Number Pages immediately before Flooded encode the absolute topmost water block
Y as base-25 digits, most significant first.
| Number Pages before Flooded | Water block Y |
| --- | --- |
| None | 63 |
| 0 | 0 |
| 24 | 24 |
| 2, 13 | 63 |
| 2, 24 | 74 |
| 4, 0 | 100 |
The visible surface is at Y+1. Only an adjacent number run applies; other pages
break it. The last Flooded wins. An unnumbered final Flooded returns to Y=63.
Duplicates follow ordinary singular-controller recovery and instability.
Number chains are special to Flooded; color/celestial number behavior is unchanged.
Existing Number Pages are unsigned. Requested levels clamp between
max(0, dimension minimum Y) and dimension maximum Y minus 5, leaving emergency
platform/headroom space. Overflow saturates safely. There is no signed Number
Page for a negative surface; open spaces below zero still flood.
## Generation and travel
Works with Cave, Standard, Amplified, Flat, Island and Void terrain.
Without Flooded, Cave default fluid is air and water aquifers are disabled;
separate authored fluid/lake features retain their own behavior.
Flooding runs after terrain, carvers and decorations. It fills air, preserves
solid terrain/material features and roofs, and wets waterloggable blocks. A lower
requested line drains ordinary water/aquatic plants above it and dries waterlogged
solids without deleting them. It is generation, not a per-tick refill system.
Neighbor features and normal fluid physics can still change blocks afterward.
The policy is frozen into generator state/ordered writing and survives codec
reload. Worldgen does not consult mutable SavedData. Arrival searches reject
submerged space. Fallback platforms rise above the water; no-platform travel may
fail safely when natural footing is unavailable.
Existing generated chunks are not rewritten or retroactively drained. Existing
saved arrival positions remain. Use new Ages for validation; mixed old/new chunks
can retain different earlier layouts.
## Validation
1.21.1: three focused tests passed for ordered numbers, plan/generator codecs,
two water levels in Cave-like in-memory chunks, dry Cave settings, solid/waterlogged
block preservation and the public page feed.
26.3: 21 isolated dedicated checks passed for equivalent grammar/support/feed,
two levels, block preservation/draining, codec and authored non-Cave biome, dry
Cave defaults and safe-height bounds. The first probe exposed an adjacent-number
grammar penalty; it was corrected before the passing run. No test stalled.
The port probe stays outside shipping sources and uses a disposable world/build:
python3 scripts/regression_flood263.py
Player checks on both versions:
1. A fresh Cave Age without Flooded stays free of default water flooding.
2. Cave Ages using 24 + Flooded and 2 + 24 + Flooded stop at water block Y=24
and Y=74 respectively.
3. A Flat/Plains Age with Flooded uses the selected/default level and safe arrival.
4. Return, save/reload, revisit, and check new chunks retain the same water level.
Books/portals must not spawn the player underwater.
5. Flooded appears in Environment Creative pages and JEI when installed.
Optionally verify a large number chain clamps safely near the ceiling.
Both game versions are tested sequentially. Test logs remain under
build/verification/flood107; temporary worlds and fixture outputs are removed.
## Reborn travel disconnect during player validation
The 26.3.0.4 client disconnected on a block-change acknowledgement after Age
travel. Reborn 7.0.12 called getClientWorlds while its world map was uninitialized
after dimension replacement. The integrated server stopped after the client left;
the report was not a Flooded generator server exception.
26.3.0.5 adds a client-only compatibility guard: on the game thread, while Reborn's
map is uninitialized, use vanilla acknowledgement handling for the packet
listener's world. Initialized Reborn retains its normal multiworld handling.
No networking payload format, 1.21.1 code or saved player data changed for this fix.
Build and target-method signatures verified. The player accepted 26.3 Flooded,
but subsequently encountered a different null-section rebuild crash while exploring.
That renderer failure remains unresolved in #118; 26.3.0.5 is not advertised as
crash-free with Reborn. Full Seamless support is tracked in #117.
+11 -1
View File
@@ -26,7 +26,7 @@ core tests when investigating an issue:
``` ```
Available suite names are `linking`, `environment`, `writing`, `grammar`, Available suite names are `linking`, `environment`, `writing`, `grammar`,
`generation`, `desk`, `binder`, `mixer`, `recipe`, and `instability`. The `generation` archive `generation`, `desk`, `binder`, `mixer`, `recipe`, `instability`, `flat`, and `flood`. The `generation` archive
keeps the detailed feature, structure, ore, crystal, and fissure regressions keeps the detailed feature, structure, ore, crystal, and fissure regressions
out of the default smoke run. The `instability` archive adds multi-player loaded-chunk selection, policy gates, and protected-block checks without rerunning the default scoring and migration tests. Three checks formerly registered twice in the out of the default smoke run. The `instability` archive adds multi-player loaded-chunk selection, policy gates, and protected-block checks without rerunning the default scoring and migration tests. Three checks formerly registered twice in the
core and their archives now run only through the core wrapper. Run all core and their archives now run only through the core wrapper. Run all
@@ -175,3 +175,13 @@ server, so physical placement is handed to the player for in-game verification:
Repeat Repeat
with `gl` or `glo` to confirm names do not change page validity. An explicit with `gl` or `glo` to confirm names do not change page validity. An explicit
Flat or Cave Terrain Page with Rocks should still be rejected. Flat or Cave Terrain Page with Rocks should still be rejected.
The `flat` archive covers issue #106 without loading dynamic Ages: Y=0 layer/height
queries, authored-biome generator codec reload, zero-minimum dimension profiles,
and unchanged empty Void columns. Travel/revisit/full-world restart remains a
player check in a fresh Flat Age.
The flood archive covers #107 grammar/codecs and in-memory water filling.
The 26.3 equivalent is scripts/regression_flood263.py. Run servers sequentially.
See [Flooded Pages](FLOODED_PAGES.md) for the travel/reload player checklist.
+84
View File
@@ -0,0 +1,84 @@
# 26.3 port parity and acceptance review
Update 2026-11-15: Flooded passed on both versions (#107). #116 was later closed
by the user as resolved; current Reborn crashes are separately tracked in #118.
Full Seamless live views remain future work in #117. The dated port review below
does not imply all subsequent third-party renderer bugs are fixed.
Reviewed 2026-11-14 for 26.3.0.3 against the independently maintained 1.21.1
implementation. This closes the port feature checklist, not every open bug or
future enhancement. The dated development entries in MINECRAFT_26_3_PORT.md
retain their original evidence and are superseded by later slices where stated.
## Feature comparison
| Area | 1.21.1 implementation | 26.3 counterpart / acceptance |
| --- | --- | --- |
| Page language | Ordered writing, registry-backed pages, modifiers, recovery and corrupted pages | PortAuthoredWriting, PortWritingRecovery, PortMaterialCompletion, PortRegistryPages and the shared symbol resources retain source writing, material pairing and diagnostics. Port slices received player sign-off. |
| Ink Mixer | Paper/ink, additive modifiers, vial/bottle exchange and output reset | InkMixerMenu/Screen, InkModifierIngredients and InkVialExchange port the interaction and assets. One ink and paper per panel; additives reset on removal. The separate 1.21.1 correction remains a shared follow-up. |
| Page storage | Notebook, folders, portfolios, sealed notebooks | NotebookMenu/Screen and the corresponding item components port sparse storage, selection/moving, held-slot protection and bulk import. Legacy glyph/page assets reused. |
| Desk / Binder | Tab catalog, ink/paper copy transactions, collection input, named books and OP diagnostics | WritingDeskMenu/Screen, WritingDeskCatalog and PortBookBinderMenu/Screen with authoritative networking and existing textures/models. Input, output pickup and naming fixes passed in game. |
| Link Modifier | Name, properties, seed and retirement | LinkModifierMenu/Screen and explicit edit payloads provide six property controls, title/seed edits and guarded retirement. Player-approved before this audit. |
| Terrain and biomes | Standard/amplified/flat/cave/void/sky-island profiles and biome distributions | PortAgeTerrain, PortBiomePlan, native registry biome pools and first-party generators. Authored and random plans persist their own seeds. Version-specific terrain/biome follow-ups remain separate. |
| Decorations and structures | Material features, vegetation, lakes, carvers, vanilla structures, libraries, crystals and fissures | Port terrain/vegetation/lake/carver/structure plans and generation passes implement these families, with modern structures and registry-backed materials. Family-specific terrain restrictions are retained; this audit does not claim every possible combination can generate. |
| Time, sky and celestials | Authored/random bodies, number/color modifiers, time modes, eclipses and ambient lighting | PortDayCycle, PortAgeColors, PortCelestialDiscs and sky/light mixins; colors, multiple bodies, sizes, positions, frozen time and eclipse rendering received player checks. Static Sky with Reborn has known bug #116. |
| Weather and seasons | Per-Age weather and optional Serene policies | PortWeatherMode, PortSeasonPolicies and Serene adapters preserve independent Age policy. Serene is optional; Ecliptic integration remains deferred on both lines. |
| Instability | Writing and live material scores, provider plans, effects and operator controls | PortInstabilityData/Plan/Runtime, block profiling, status/decay/hazard/meteor/environment providers and operator commands. Scores remain OP-only. Accelerated ticks use bounded loaded-world budgets; machine parity work remains tracked separately. |
| Travel | Handheld books, stands, receptacles, portals, footing/platform, modifiers and return links | Shared port destination/travel services, PortalTravelQueue and CrystalPortalNetwork keep book properties authoritative. Return links default disabled. Unsafe or unsynchronized travel leaves the player at source. |
| Presentation | Legacy books/pages/models/sounds, dropped open books and preview renderers | Existing assets reused through 26.3 extracted render states and modern input. Live Reborn book/portal views and look-only exploration are implemented; right-click return/re-entry passed on 26.3.0.3. |
| Discovery / guides | Libraries, loot, crafting, advancements, creative pages and JEI | Libraries/stands, sealed notebook discovery, progression and JEI guides ported. Random eligibility controls apply to new random choices/loot while existing authored pages remain usable. |
| Backend lifecycle | Dynamic Dimensions AR plus catalog/travel behavior | Rivencraft-owned backend with atomic creation, seed persistence, catalog acknowledgement, unload/reseed/retire. #99/#101 and now #100 accepted. |
## Deliberate platform differences
- Java 21 / NeoForge 21.1.264 and Dynamic Dimensions AR + Bad Packets stay on
1.21.1. The tested 26.3 target uses Java 25 / NeoForge 26.3.0.99 and a first-party
Age backend. No optional integration is bundled or made mandatory.
- 26.3 starts fresh saves. Importing 1.21.1 dimension/save internals is unsupported.
New chunk algorithms and random streams need not produce identical terrain.
- Create/Ponder has no ported 26.3 integration. Built-in animation is always
available; Reborn 7.0.12 provides optional live book/crystal views and look-only
exploration. Seamless has the dimension bridge, not this Reborn rendering path.
- Optional libraries, registry contents and vanilla generation APIs differ across
game versions. Changes to shared symbols/assets must be considered for both;
version-specific implementations and dependency requirements stay separate.
- Shared requested enhancements in #105–#115 and renderer bug #116 are separate
work. Port closure does not close those issues or describe their work as done.
## Regression evidence and limits
Earlier recorded 1.21.1 client/dedicated/optional-mod sign-offs remain valid:
its game code did not change during this work, so it was not retested merely
because the 26.3 target changed. Both build targets were built during the workflow
audit; only changed-target gameplay checks are required going forward.
The expanded-catalog 26.3 test used two actual clients on one dedicated server.
Runtime Age creation, catalog/environment delivery, normal-book travel,
stale-ack rejection/recovery, occupied unload refusal, empty reload/reseed and
retirement passed. On full restart both reconnected in the surviving Age with
the saved seed/presentation; retired data stayed absent. The final return-book
step stalled and was handed off without retry, per the user's instruction.
The player then created and entered an Age on the current local dedicated server
with the Dev optional stack, requested a full restart, reconnected, and returned
to the Overworld by Linking Book. Server logs confirm restored Age
rivencraft:age/random, seed -1985136355166262436, and the Overworld return.
The player explicitly accepted #100. This final handoff used one player-operated
client, not a new two-client automated pass. Logs are retained locally under
build/verification; temporary worlds and server processes were removed.
Production 26.3.0.3 builds and its book-window look/exit/re-entry received an
in-game pass. Earlier slices record no-optional startup, generation, portal
geometry/lifecycle and optional integration checks. This is cumulative evidence,
not a claim that every historical test was rerun on the final JAR.
## Release gate
[DUAL_VERSION_RELEASE.md](DUAL_VERSION_RELEASE.md) defines changed-target builds,
sequential temporary servers, stalled-test handoff, maintenance policy and upload
identity checks. Offline tooling checks cover track selection, release naming,
required dependencies, wrong-artifact/fixture rejection and server exclusion.
Hosted workflow execution remains unverified; repeatable local commands provide
the supported fallback. Release acceptance is recorded in Gitea after publication
and artifact verification. The existing published 1.21.1 release is retained;
unchanged code is not republished merely to adopt the new filename scheme.
+528 -3
View File
@@ -8,6 +8,33 @@ The user wants both Minecraft lines maintained after the port, not a one-time
26.3 release. Gitea milestone "Dual-version support: 1.21.1 and 26.3" 26.3 release. Gitea milestone "Dual-version support: 1.21.1 and 26.3"
tracks issues #97–#103 under parent #96. tracks issues #97–#103 under parent #96.
## Final port acceptance — 2026-11-14
The 26.3 port is playable on the regular release channel. The complete writing,
generation, instability, travel, discovery and presentation review is in
[MC263_PARITY_REVIEW.md](MC263_PARITY_REVIEW.md). #100 is complete: the
expanded-catalog two-client checks and the player-operated full-restart return
handoff passed. The look-only book-window overlay and its right-click exit fix
also passed on 26.3.0.3. #103/#104 closure follows the workflow/release audit.
The original introductory audit and slice entries below are historical, not a
list of currently missing features. 1.21.1 remains maintained independently.
Known issues and shared enhancements remain tracked separately.
## Published status — 2026-11-11
[26.3.0.1](../ports/mc263/RELEASE_NOTES_26.3.0.1.md) collects the player-validated
.137–.142 slices: random-page eligibility, random-Age glyph descriptions, optional
portal-engine dimension synchronization, and Reborn live book/crystal portal views.
It is published on the regular release channel at the user's request, using the
new Minecraft-prefixed version scheme. Minecraft 1.21.1 remains unchanged.
#102's optional-integration audit/port is complete; the Static Sky/Reborn rendering
bug is tracked separately in #116. #100 still requires the current expanded-catalog
dedicated two-client matrix. #103/#104 and parent #96 retain the remaining workflow
and parity gates. Full parity is not implied by the release channel. Shared
follow-ups stay open where one or both implementations are pending. Earlier
entries are historical records and may describe limitations resolved later.
## Version boundary ## Version boundary
Local slice `1.0.1.106-beta.1` ports the Writing Desk's two-part block, Local slice `1.0.1.106-beta.1` ports the Writing Desk's two-part block,
@@ -87,8 +114,8 @@ range of the 1.21.1 JAR. The official [26.3 release notes](https://www.minecraft
[NeoForge 26.3 Maven metadata](https://maven.neoforged.net/releases/net/neoforged/neoforge/maven-metadata.xml), [NeoForge 26.3 Maven metadata](https://maven.neoforged.net/releases/net/neoforged/neoforge/maven-metadata.xml),
[NeoForge Java 25 setting](https://github.com/neoforged/NeoForge/blob/26.3.x/gradle.properties), [NeoForge Java 25 setting](https://github.com/neoforged/NeoForge/blob/26.3.x/gradle.properties),
and [NeoForge migration primers](https://docs.neoforged.net/primer/docs/) and [NeoForge migration primers](https://docs.neoforged.net/primer/docs/)
are the version sources. NeoForge 26.3.0.99 is the newest listed stable build are the version sources. NeoForge 26.3.0.99 is the validated target for this release; the availability
at the time of this check. of newer NeoForge builds does not imply they have been validated.
## Dependency availability ## Dependency availability
@@ -106,7 +133,8 @@ Rivencraft. Recheck immediately before choosing versions for a port build.
| [Biomes O' Plenty](https://modrinth.com/mod/biomes-o-plenty) | Optional TerraBlender test addon | Yes | Test modded biome registration and decoration. | | [Biomes O' Plenty](https://modrinth.com/mod/biomes-o-plenty) | Optional TerraBlender test addon | Yes | Test modded biome registration and decoration. |
| [Ruins (Structure Spawning System)](https://www.curseforge.com/minecraft/mc-mods/ruins-structure-spawning-system) | Optional authored ruins integration | Yes | Port and verify its generation hooks. | | [Ruins (Structure Spawning System)](https://www.curseforge.com/minecraft/mc-mods/ruins-structure-spawning-system) | Optional authored ruins integration | Yes | Port and verify its generation hooks. |
| [Create](https://modrinth.com/mod/create) / bundled Ponder | Optional scene renderer | No advertised 26.3 version | Use Rivencraft's existing legacy-animation preview fallback for this target until a compatible release exists. | | [Create](https://modrinth.com/mod/create) / bundled Ponder | Optional scene renderer | No advertised 26.3 version | Use Rivencraft's existing legacy-animation preview fallback for this target until a compatible release exists. |
| [Immersive Portals for (Neo)Forge](https://modrinth.com/mod/immersive-portals-neoforge) | Optional live views and portal teleport integration | No advertised 26.3 version | Use the fallback portal surface and normal Rivencraft linking. Do not claim live destination views on 26.3. | | [Immersive Portal / Seamless Portals](https://www.curseforge.com/minecraft/mc-mods/immersive-portal/files/9218525) | Optional live views and portal integration | Latest file 9218525: displayed 10.0.0, internal 1.0.0 | Runtime-Age/native packet checks passed; live rendering still pending. Old file 8937394 has an upstream startup failure. |
| [Immersive Portals Reborn](https://www.curseforge.com/minecraft/mc-mods/immersive-portals-reborn-unofficial-fork/files/9435354) | Alternative optional portal engine | NeoForge 7.0.12 for 26.3; later 7.0.18 is Fabric | .141–.142 port live book/crystal views; player, dedicated/client and restart checks passed. Static Sky bug: #116. Use one fork per instance. |
Ecliptic Seasons publishes 26.3, but Rivencraft's Ecliptic integration was Ecliptic Seasons publishes 26.3, but Rivencraft's Ecliptic integration was
deferred and is not a replacement for the current Serene integration. deferred and is not a replacement for the current Serene integration.
@@ -2588,3 +2616,500 @@ new server run was performed; the previous 19 checks covered server actions, not
client input. Please click each option with an inserted Linking Book and verify client input. Please click each option with an inserted Linking Book and verify
its selected shading and tooltip/book properties change, then repeat supported its selected shading and tooltip/book properties change, then repeat supported
options with a Descriptive Book. No commit, push or publication. options with a Descriptive Book. No commit, push or publication.
## .130 Link Modifier seed editing
Ported the 1.21.1 station's seed field into the Legacy GUI. It is visible for a
bound Descriptive Book whose Age is still indexed, including an unloaded Age.
The complete signed 64-bit seed synchronizes through four 16-bit menu data words;
zero and negative seeds are not treated as missing data. Linking Books and unbound
or retired references do not expose an editable seed.
Enter/keypad Enter or clicking outside the field applies the edit; Escape closes
without applying unfinished text. Focused typing consumes inventory/hotbar shortcuts.
Modern InputConstants are used rather than legacy numeric key values. The bounded
payload validates the open menu ID and expected Age ID, plus menu owner, station
identity and distance. Invalid/overflowing input and occupied Ages are refused.
This matches 1.21.1's ordinary creative-acquired station editing permissions.
Successful edits use RuntimeAgeBackend.reseed, not a display-only book component.
Existing chunks and book identity remain intact, while newly generated chunks use
the changed seed. Existing backend unload/save/catalog synchronization is reused;
frozen written choices and instability history are not rerolled. Retirement UI
remains a later port slice.
Version 1.0.1.130-beta.1 builds. A temporary dedicated-server fixture passed 16 menu/
backend checks plus two restart checks: bound/unbound visibility, malformed/overflow
input, stale expected Age, occupied and remote refusal, retained old terrain,
changed index/level seed, unloaded reseeding including Long.MIN_VALUE, retained
book identity and full restart persistence. Future-chunk height fingerprints from
the menu-reseeded Age matched a fresh new-seed control and differed from an old-seed
control (new=-1541880620; retained origin=924831745). The initial flat-world fixture
could not distinguish terrain seeds; the terrain comparison used a normal-world
fixture. All temporary test worlds and fixture sources were removed and the server
stopped. The production JAR was rebuilt without fixtures. Client field input,
feedback and real travel validation are delegated to the player. No commit, push
or publication.
## .131 Link Modifier Age retirement
The player passed .130 seed editing. Ported the remaining 1.21.1 station retirement
control through the existing 26.3 lifecycle backend. A bound, active Descriptive
Book exposes the control only to players with modern Gamemaster (OP level 2)
permission. The first native button arms retirement; a separate red confirmation
button performs it. The arm and confirm actions have distinct IDs so repeating the
initial click cannot silently confirm. Normal book editing permissions are unchanged.
Confirmation is server-owned and tied to the exact Age and book components.
Replacing/removing the book, renaming, changing properties or applying a seed edit
clears confirmation; reopening the menu starts unarmed. Invalid, stale, non-OP and
remote actions cannot retire an Age. The target must be empty of players, including
the operator. A failed attempt clears confirmation and reports refusal.
Successful retirement uses RuntimeAgeBackend.retire: flush/unload the target,
persist its tombstone, archive only its directory beside the active world and
synchronize the runtime catalog. Other Ages are retained. The inserted book keeps
its now-dead identity, cannot reopen the retired Age, and no longer exposes seed or
retirement controls. Storage failures reuse backend rollback and display failure.
This follows 1.21.1 archival behavior rather than permanently erasing the files.
Version 1.0.1.131-beta.1 builds. Eighteen temporary dedicated-server checks plus four
restart checks passed: permission boundary, arm/confirm order, edits and book swaps,
occupied/remote refusal, successful retirement, exact archive and surviving control
Age, retained dead-book identity, repeated confirmation refusal, persisted tombstone,
and refusal to reload/recreate after restart. Test servers were stopped and all
worlds, archives and fixture sources removed. Production JAR rebuilt without the
fixture. Client button visibility, tooltip/feedback, occupied refusal and travel
through an old book are delegated to the player. No commit, push or publication.
## .132 failed Age-creation rollback (#99)
The player passed .131 retirement. Wrapped new runtime Age setup in one rollback
boundary: library writing, level construction/load event, weather and Accelerated
settings, index/initial display name, instability record and initial SavedData save.
The catalog is published only after those steps succeed. Book creation now supplies
its initial name to this operation and no longer configures acceleration/name after
commit. Operator/default callers retain the prior overloads.
A failed attempt closes the level stores, dispatches unload cleanup, removes its
new index/environment entries without leaving a retirement tombstone, restores the
prior library/instability metadata and saves that restoration. It removes only the
exact, newly allocated Age directory with a non-following tree walk. Existing Age
storage, live levels, retired IDs and unsafe/symlink paths are refused before any
setup. Pre-existing directories are never reused or erased. Cleanup failures are
attached to the original exception; if stores cannot close, files are retained to
avoid racing an active writer. Book failures are logged/reported and do not move
the caller. This covers recoverable runtime exceptions, not arbitrary process death
or a guarantee against persistent filesystem/I/O failure.
Index entry cleanup is shared with retirement without removing the retained display
name needed by retirement rollback. No existing Age scores, generation or settings
are migrated. No production fault-injection command/hook was introduced.
Version 1.0.1.132-beta.1 builds. A temporary dedicated fixture passed 36 checks plus
seven restart checks. Injected failures during LevelEvent.Load, instability creation
and late display-name validation left no live/indexed Age, restored prior writing,
dispatched one unload and removed only the new directory. Clean retries of the same
IDs succeeded. An existing directory marker survived refusal. A failed book-creation
call returned no Age and left its caller in the original world. Restart confirmed
failed metadata stayed absent while committed names/Accelerated settings persisted.
Fixture source, worlds and servers were removed/stopped; production JAR rebuilt
without the fixture. Client validation: create two Ages with distinct names, travel
and restart, including a book with Accelerated pages, and confirm their names,
settings and destinations remain independent. No commit, push or publication.
## .133 optional JEI integration (#102)
The player passed .132. Adapted the 1.21.1 JEI plugin to the current 26.3 API and
render extraction path. At the player's request, the target is the newest published
26.3 NeoForge build, 31.17.0.109 (JEI labels it beta), verified against its official
Maven metadata and Modrinth release API. This supersedes the initially inspected
installed 31.17.0.94. The latest release channel differs from the latest published
build; this slice deliberately targets the newer 31.17.0.109 build.
Added searchable component-aware Symbol Pages, all eight mixer Link Panel variants
and category/volume Symbol Portfolios. Registered biome and eligible Block/Fluid
pages use the same pools as Creative, including installed registry content. Runtime
registration fills any missing world-dependent variants; Blank Pages and the empty
base portfolio are removed from JEI's ingredient list. Future pages entering the
shared category pools participate automatically. Shared link-panel variant creation
now supplies both Creative and JEI.
Reused the Writing and Ink Mixer recipe-guide categories, additive chance guides,
and Ink Vial/Writing Desk/Book Binder/Ink Mixer catalysts. The port-specific mixer
text correctly states one paper plus one ink per panel, 16 units per vial and reset
of additives on output pickup. Added Link Modifier information, without a recipe.
Wrapped guide text uses opaque, shadow-free rendering and extra Mixer guide height.
These are explanatory guides; no auto-transfer handler or fictitious Blank Page
crafting recipe is introduced.
JEI is compile-only and isolated in its annotated scanner plugin. It is not bundled
or a required runtime dependency; no common class loads its plugin. The developer
`-PwithJei` option adds JEI locally, including its Maven dependencies. The current
109 POM requires MezzConfig 0.6.10 (and its GUI module); the existing test instance's
0.6.9 must be updated alongside JEI as required by the mod's distribution metadata.
Maven repository filters include JEI and MezzConfig groups only.
Version 1.0.1.133-beta.1 builds against the 109 API. A fresh dedicated server started
without JEI or any optional mods and stopped normally; its world was removed. Client
plugin discovery, ingredient counts/subtype uniqueness, guide rendering and category
navigation await the player's check with JEI 31.17.0.109 and its dependencies. Other
optional integrations remain unported; #102 is not complete. No commit, push or
publication, and no user's instance files were replaced.
## .134 optional TerraBlender regions (#102)
The player passed .133 JEI. Ported the 1.21.1 optional TerraBlender region adapter
to the current 26.3 API, compile-only at 26.3.0.0.9 (the latest published 26.3
build checked on Modrinth). The core boundary never exposes TerraBlender types.
Absent/broken optional API falls back to existing tags/native pools, with one
warning for API failures. No content mod is required or bundled. A developer
`-PwithTerraBlender` runtime option is available.
Enumerates registered non-vanilla biome keys from Overworld and Nether regions,
excluding TerraBlender's deferred placeholder. Overworld additions extend random
and seed-completed Standard/Amplified/Island/Flat pools. Nether-region membership
extends Cave-compatible selection and Cave Page classification even without an
is_nether tag. Registry-derived Creative and JEI page pools share that result.
Runtime Age construction primes membership before biome validation/generation;
Nether material-rule conditions also include recognized TerraBlender Nether keys.
Region scans are cached per registry access with weak keys; hot generation queries
use weak-holder membership rather than rescanning all regions. Tags updates refresh
the relevant registry entry, and a lowest-priority server-about-to-start callback
refreshes after TerraBlender loads data-driven regions. Frozen saved biome pools
are not rerolled or migrated. No mod-specific biome names are hardcoded.
Both 1.21.1 and 26.3 APIs expose OVERWORLD/NETHER, but no CAVE or END region type.
This distinction and the need for cave tags/metadata were posted and verified in
#111 (comment 605), including Nether precedence for overlapping Cave/Nether tags,
explicit authoring, and the planned Native Nether/End pages. This slice retains
current Native Cave eligibility: excluding Nether from its default pool and adding
those new pages remain #111, for both version tracks. No 1.21.1 code was changed.
Version 1.0.1.134-beta.1 builds. A clean dedicated server without TerraBlender
starts normally. A fresh server with TerraBlender 26.3.0.0.9, BOP 26.3.0.0.16 and
GlitchCore 26.3.0.0.5 passed nine focused checks: 59 Overworld additions, five Nether
additions, placeholder exclusion, completion pools, Cave Page placement, an injected
Nether region referencing an untagged biome, cache removal after region removal,
and Cave Age acceptance/reload with a modded Nether biome. No bulk generation or
client rendering was claimed. Test servers stopped, worlds and fixture sources
removed; production JAR rebuilt without fixtures. Client Creative/JEI placement,
actual BOP surface/Cave terrain materials and decoration remain player checks.
No commit, push or publication. Other #102 integrations remain incomplete.
## .135 optional Serene Seasons per-Age policies (#102)
The player passed .134. Ported 1.21.1's six modes: No Seasons, cycling Seasons,
Eternal Winter/Summer/Fall/Spring. Uses the latest published 26.3 Serene build
26.1.2.0.7 (QnvW5HPm) and GlitchCore 26.3.0.0.5 (pQgy3bfh), matching the test
instance. Both APIs are compile-only behind a guarded adapter, never bundled or
required. The developer -PwithSereneSeasons flag adds them to the local runtime.
New Ages freeze an authored or seed-selected policy in separate SavedData. Omitted
choices randomize only when Serene is installed, matching root Legacy ranks:
Seasons weight 6, No Seasons 5 and each Eternal 1. Cave terrain always disables
seasons. Existing Ages without a stored policy retain legacy cycling behavior
when integration/auto-whitelisting is enabled; they are not randomly reassigned.
No Seasons is usable without the optional mod; other seasonal pages require it.
Singular page recovery keeps the last seasonal controller with existing penalties.
The guarded adapter writes only the target Age's whitelist entry and persists it
through Serene/GlitchCore's config API. Connected-client updates and login replay
apply the same entries without a restart. Existing unrelated entries are retained.
Eternal policies hold the middle sub-season in a bounded mid-season window, avoiding
per-tick dirty data and leaving the Overworld calendar unchanged. Server config
serene_seasons.auto_whitelist_ages defaults true, matching 1.21.1: explicit policies
still apply when disabled, while existing whitelist entries are not removed merely
by disabling automatic behavior.
Policy selection participates in creation rollback before catalog publication;
optional whitelist changes happen only after successful creation. Reload/reseed
reuse the frozen policy. Retirement removes its whitelist entry only after backend
retirement succeeds, while policy history can remain in global metadata. Client
messages are limited to Rivencraft Age IDs. Compatibility failures log once rather
than flood every level tick. No Ecliptic Seasons support is added.
Version 1.0.1.135-beta.1 builds. A clean dedicated server starts without optional
mods. With Serene/GlitchCore, 25 checks passed on creation and 22 after full restart:
all six saved modes/whitelist policies, each eternal mid-season and recovery from a
changed cycle value, unchanged Overworld season data, unrelated whitelist entries,
deterministic omitted choices, no random choice when the mod is absent, and Cave
suppression. The initial restart assertion was corrected to allow the deliberate
mid-season hold window inherited from 1.21.1. Test worlds/fixtures were removed and
servers stopped; production JAR rebuilt without fixtures. Client visual effects,
reconnect/live whitelist synchronization, normal season progression, authoring and
retirement with a real connected client remain player validation. No commit, push
or publication; other #102 integrations remain open.
### Optional Ruins template pages — 1.0.1.136-beta.1
The preceding Serene Seasons slice passed the player's in-game check. Ruins now
uses the 1.21.1 exact-template bridge: each unambiguous installed `.tml` filename
gets a dynamic glyph page in a Ruins creative tab, portfolios, and JEI's page pool.
Names preserve case and Unicode through reversible IDs. Discovery reads Ruins'
active `config/ruins_config` directory, with its bundled archive as the first-launch
fallback. Duplicate basenames disable the bridge because Ruins' event cannot
identify which directory supplied the template.
Authored template choices and all duplicate counts are frozen in the Age's terrain
feature plan and restored before its load event. Only selected templates pass the
Age dimension and pre-spawn gates; other worlds retain Ruins' own behavior. Ruins'
biome/surface/distance requirements remain applicable. Copies multiply template
weight and increase attempts by one per extra page, capped at 32 attempts without
lowering an explicitly higher Ruins configuration. The first three copies are free;
each later copy adds 100 instability, including copies beyond the attempt cap.
Material pages do not modify Ruins structures. Unloading clears bridge state and
reloading restores it; optional Ruins classes are not loaded when the mod is absent.
The reproducible compile-only baseline is Ruins 26.3.1NF (CurseForge file 8962119);
the installed Ruins 26.3.2NF was used for integration validation. For development,
`-PwithRuins` adds the baseline runtime, or combine it with
`-PruinsJar=/absolute/path/to/ruins-26.3.2NF.jar` to run a local current build.
Neither dependency is bundled or required to run Rivencraft.
Build and clean dedicated-server startup without Ruins passed. With Ruins 26.3.2NF,
21 checks passed on creation and 10 after restart, covering 25 discovered templates,
creative/JEI pool parity, readable/case-sensitive IDs, authoring, codec roundtrip,
50 retained copies, attempt limits, 4,700 excess-page instability, exact template
filtering, both dimension gates, spawn-event veto, and a real Tiki Head placement
(149 non-air blocks counted in the checked volume). Restart, unload, and reload
retained the counts. Temporary fixtures and test worlds were removed; test servers
were stopped. Client glyph/GUI checks and natural spawning while exploring an Age
remain player validation. No commit, push, or publication; #102 remains open.
### Random Page eligibility and library discovery — 1.0.1.137-beta.1
The player passed .136 and authorized its publication. This slice adapts 1.21.1's
RandomPagePolicy and random_pages allowlist/blocklist. Short paths (sky/static)
and fully namespaced Page IDs are accepted; blocklist wins, and allowlist entries
restrict only their own categories. Biome controllers are a separate category
from individual biomes. Creative/JEI availability and manual book authoring are
not filtered.
Normal Link-Panel-only book creation takes one immutable policy snapshot and
passes it through terrain, biome distribution/Page completion, environment,
celestial kinds, material features/materials, optional formations and structures.
Seasons use the same snapshot before their saved policy is committed. Resolved
choices are already frozen in Age index/season data, so reload/reseed never reads
the current lists to reselect an old Age. Authored and partly authored books use
the existing unrestricted completion behavior, matching the 1.21.1 boundary.
Required empty categories use Standard terrain, Native distribution, Normal
lighting/weather, inherited Overworld sky, or No Seasons. Optional features or
materials with no candidates are omitted, not filled with a forbidden random
Page. Non-Native biome distributions preserve their required minimum using the
terrain's preferred/native fallback pool; necessary fallback biomes can therefore
bypass a filter. Native noise biomes come from the preset, not biome Page selection,
and remain unfiltered just as in 1.21.1. Void still has its required Void biome.
Cave weather/season safety overrides remain unchanged. Original unrestricted
terrain/distribution seed choices are unchanged; filtered ranks are recalculated
using the shared Legacy rank chooser instead of a duplicate weighted routine.
Newly placed direct library Pages apply the current policy in both LEGACY and
AGE_ONLY modes. Existing inventory contents are not rewritten. The Legacy library
pool now includes exact Ruins templates and semantic bundled pages rather than
reusing the Sealed Notebook's narrower pool. Sealed Notebook opening retains its
1.21.1 pool behavior; this setting does not retroactively edit unopened/old loot.
No policy filtering is applied to JEI or creative portfolios.
Build passed. A disposable no-optional dedicated server passed 766 creation/policy
checks over 48 seeds and six restart checks: normal book binding, manual blocked
Page authoring, immutable saved settings under a changed policy, unload/reload,
required category/biome fallbacks, optional empty pools, material eligibility,
Native distinction, season policies without requiring Serene classes, library
filtering and unchanged Creative entries. The later rank revision added default
seed-compatibility and minimum-biome checks. These are temporary fixtures, not
new permanent game tests. Worlds and fixtures removed, servers stopped, production
JAR rebuilt. Player config/GUI/world validation remains pending. No commit, push
or publication.
### Random-Age book glyph prose — 1.0.1.138-beta.1
The player passed the .137 eligibility slice. Ported 1.21.1's first-page random-Age
glyph description: the Age name and author remain ordinary text on the left,
followed by layered Legacy word glyphs and real base-25 numerals for terrain,
distribution, lighting, weather and the first celestial cycle's period/angle/phase.
Authored books keep their existing name/author front page and single-symbol middle
pages; no writing notes or instability scores are introduced. The right-side
animated link panel and its click-to-travel behavior are unchanged.
The existing symbolcomponents.png atlas and deterministic word mappings are reused
directly with tinted GUI_TEXTURED blits; no generated art or per-frame dynamic
textures are added. A common prose layout helper handles Unicode word boundaries,
numeric width and wrapping. Writing Desk tab numerals now use the same rendering
routine, retaining their existing size/position/color.
Public terrain/distribution/lighting/weather metadata is sent in the Age catalog,
with celestial data reused from its existing saved-cycle map. These are actual
loaded Age settings rather than a reroll from the book ID or current config.
Metadata excludes seeds, instability scores and providers. It does not load an
unavailable destination merely to display a book. Full catalog replacement removes
unloaded/retired entries; logout clears description/cycle caches. Older books with
no authored symbol component use the random-description path. Existing Age/save
formats remain readable. Catalog network protocol is now 11 (previously 10):
client and server must use matching builds.
Build passed; disposable no-optional dedicated-server checks passed catalog
serialization, immutable snapshots, actual saved setting capture, cache
replacement/clear, real restart, unload/reload and retirement. Pure layout checks
covered Legacy word splitting, Unicode, wrapping, base-25 width and oversized
numeric fallback. Test worlds and fixtures removed, server stopped and production
JAR rebuilt. Visual glyph layering, book/lectern appearance and actual client
catalog receipt remain player validation. No commit, push or publication.
### Renamed Immersive Portals dimension bridge — 1.0.1.139-beta.1
The player passed .138. Confirmed the user's correction: the 26.3 Immersive Portal
implementation uses the Seamless Portals name/mod ID, retaining qouteall rendering,
chunk-loading and dimension APIs. Added an optional shared dimension-ID adapter
before Rivencraft catalog publication/acknowledgement. It synchronizes integer
IDs and native type/sea-level metadata without delegating Age ownership. Failed
synchronization blocks acknowledgement/travel rather than making a successfully
committed Age appear to have failed binding. Startup, unload/reload, reseed and
retirement are covered. Live book/crystal rendering remains later work.
The installed working build passed 35 server creation/catalog checks plus 13 after
restart. Normal book binding, native metadata, API ID roundtrips, two Ages,
lifecycle changes and failed-creation nonpublication were checked. No-optional
startup passed. Real client travel remains pending; Prism files were not changed.
Correction to the initial artifact audit: old CurseForge file 8937394 fails during
its own constructor on .99 with missing DataPackRegistryEvent$NewRegistry; this is
NOT the latest release. The latest file is 9218525, displayed as 10.0.0 while its
filename/internal metadata still say 1.0.0. Its SHA-256 exactly matches the user's
installed working file:
5d2bfc2a811a6526e3f6722c521d97e5de2869a6ead1c681323c3c472e4367a0.
The compile dependency is corrected to 9218525 in .140. The earlier broad claim
that the current published build cannot start was wrong and is superseded here.
NeoForge audit on 2026-11-11: official Maven metadata lists .102 as latest in the
26.3 line. Its universal JAR still lacks the old NewRegistry class, so upgrading
cannot fix that OLD portal artifact. Current target remains validated .99; a
separate .102 build/client/server check is recommended. No release authorized.
### Immersive Portals Reborn comparison and shared bridge — 1.0.1.140-beta.1
The user suggested Reborn. Verified the NeoForge 26.3 release is 7.0.12, file
9435354 in CurseForge project 1721833. The newer 7.0.18 is Fabric. The Reborn JAR
registers immersive_portals_reborn plus its legacy core aliases and retains the
qouteall GUI rendering/portal/chunk/dimension APIs. It starts on NeoForge .99
without Cloth Config or other optional mods in the test environment.
Generalized the optional bridge to recognize either Reborn or Seamless. Both
share DimensionIntId.onServerDimensionChanged and the createFromServer packet
factory. Seamless's createPacket returns a vanilla Packet; Reborn's returns a
CustomPacketPayload. The adapter now wraps createFromServer in the vanilla
clientbound payload packet, preserving each fork's native two-/three-tag wire
format. No cross-fork packet schema is invented and neither dependency is bundled.
The compat probe recognizes both. A development run may select
-PwithImmersivePortalsReborn or -PwithSeamlessPortals; requesting both is rejected
because the forks share classes/mixins. The normal build remains optional-free.
Reborn passed 32 creation/catalog checks and 15 after restart: real book-binding
entry point, two runtime Ages, ID/type metadata, native wire roundtrip, per-player
packet preparation, unload/reload, reseed, retirement isolation and persistence.
Seamless latest file 9218525 passed the same 32 lifecycle/packet and 15 restart checks against the shared adapter.
These are server/packet checks, not evidence of renderer quality or real client
packet receipt. Reborn is a viable next client-test target; no performance
superiority is claimed. Live snapshots, chunk leases/audio isolation, and live
crystal surfaces still need porting. Player files were not modified. Temporary
worlds/fixtures removed; no commit, push or publication.
### Reborn live book previews — 1.0.1.141-beta.1
Linking and Descriptive Book front panels now use Immersive Portals Reborn's
live GUI-world renderer when Reborn is installed on both sides. This carries
forward the 1.21.1 camera orbit (11-block radius, five blocks above the focus),
destination sky/fog, chunk streaming and remote-audio isolation. Server destination
resolution uses the actual held book or a nearby loaded stand's matching book;
the client cannot request arbitrary destination coordinates.
A unique session ID prevents stale replies or close packets from replacing or
releasing another book's preview. One per-player eight-chunk-radius loader streams
the view asynchronously, renews while the book stays open, and expires if its
heartbeat is lost. Closing, logout, death/source invalidation, dimension changes,
and shutdown release the lease. Destination resolution for Descriptive Books
uses the same footing/platform rules as book travel.
The rendering integration uses 26.3 GPU texture views with the deferred GUI.
Reborn may resize its target before extraction records the texture view; clearing
is deferred to its render hook, and the normal GUI draws the image beneath the
Legacy panel cutout. The target uses the main framebuffer's depth/stencil format.
The player camera is restored after remote rendering, and remote preview-world
sounds are suppressed without muting the player's world.
Set `[book_previews] reborn_live_views = false` in the local configuration to use
animated panels. Missing Reborn or unavailable terrain also retains the animated
fallback. Seamless's dimension-ID bridge remains available, but this live GUI
implementation is activated only for Reborn. Live crystal portal surfaces and
preview exploration controls remain separate port work.
Validation: production build passed. An isolated real NeoForge 26.3.0.99
dedicated-server/client run with Reborn 7.0.12 displayed the remote live Linking
Book view; screenshot inspected for the panel cutout, upright image and actual
terrain. The client completed without a renderer exception and logout left no
preview chunk leases. The user also reported that the books displayed live views
perfectly. All temporary worlds/client directories and fixture sources were
removed, and the distributable was rebuilt without test classes.
Startup warnings in this isolated run included Reborn's four deprecated
`logoFile` metadata entries; these are upstream branding metadata warnings.
The Linux narrator also lacks `libflite`, unrelated to the book renderer.
### Reborn live crystal portals — 1.0.1.142-beta.1
Crystal portals now create optional native Reborn render-only surfaces. Each
coplanar opening is one masked mesh on each side, including irregular outlines;
the destination image does not repeat once per portal block. Mesh planes sit
inside the portal block thickness so the crystal frame remains in front. Once
native surfaces are established, LIVE_VIEW hides only the animated portal model.
The blocks and their receptacle owner pointers stay intact.
Live views share destination resolution with portal book travel. Linking Books
use their written facing, while Descriptive Books preserve the approaching
entity's facing as their travel path does. The reference camera is anchored to
standing eye height above the opening's floor, rather than to its vertical center.
This prevents taller frames from shifting the preview's arrival height. Relative
links resolve using the opening's center as the view reference; the actual
entity's departure position is still used for travel.
Native surfaces cannot teleport entities, accept remote interaction or perform
cross-portal collision. Existing Rivencraft collision/queue and book rules remain
authoritative, including catalog readiness, Disarm, momentum and arrival safety.
Reborn handles visible-destination streaming through its normal portal system.
Geometry/destination tags allow maintenance to reuse matching entities and replace
stale ones. Activation establishes views immediately; normal receptacle maintenance
restores them after restart. Book removal, frame shutdown, missing destinations
and disabling the integration remove the native surfaces. Without Reborn the
animated surface and ordinary travel continue to work. The server setting is
[book_previews] reborn_crystal_live_views, default true.
Validation on NeoForge 26.3.0.99 / Reborn 7.0.12: 68 server checks passed, covering
all three plane axes, both sides, one mesh per opening, eye-position and facing
transforms, entity reuse, fallback toggling and book removal. Five additional
restart checks passed. An isolated real client/dedicated server rendered the live
opening, then crossed into the correct Age through normal Rivencraft travel.
Screenshots before/after were inspected; the user also reported success.
An initial render test mistakenly bound its synthetic Linking Book at Y=1 inside
the flat world's solid layers. The view correctly displayed underground terrain
and the collision check refused travel. The corrected fixture bound to the actual
surface (Y=4) and passed. No production spawn-height workaround was added for an
invalid synthetic book. All temporary fixtures and test worlds were removed, and
the distributable was rebuilt without test classes.
+139
View File
@@ -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 -4
View File
@@ -1,10 +1,7 @@
# Publishing Rivencraft with the Gitea, Modrinth, and CurseForge APIs # Publishing Rivencraft with the Gitea, Modrinth, and CurseForge APIs
The local helper is [`scripts/publish_mod_sites.py`](../scripts/publish_mod_sites.py). 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 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.
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.
## One-time token setup ## One-time token setup
+61
View File
@@ -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.
+136
View File
@@ -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.
+102
View File
@@ -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.
+13
View File
@@ -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. 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. 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).
+2 -2
View File
@@ -35,8 +35,8 @@ mod_id=rivencraft
mod_name=Rivencraft mod_name=Rivencraft
# The license of the mod. Review your options at https://choosealicense.com/. All Rights Reserved is the default. # The license of the mod. Review your options at https://choosealicense.com/. All Rights Reserved is the default.
mod_license=LGPL-3.0-or-later mod_license=LGPL-3.0-or-later
# The mod version. Rivencraft uses the x.y.z.b policy documented in README.md. # Minecraft.release-slice.iteration; independent of the 26.3 release track.
mod_version=1.0.1.1 mod_version=1.21.1.0.6
immersive_portals_version=6.0.7 immersive_portals_version=6.0.7
terrablender_version=4.1.0.8 terrablender_version=4.1.0.8
serene_seasons_version_id=pHEgQQUE serene_seasons_version_id=pHEgQQUE
+532 -17
View File
@@ -1,21 +1,39 @@
# Minecraft 26.3 beta port workspace # Minecraft 26.3
This is an **experimental beta port** for issues #97–#104, not gameplay parity The current **Minecraft 26.3 release is 26.3.0.10**, for NeoForge 26.3.0.99 and
with the Minecraft 1.21.1 release. The 26.3 backend persists separate Ages and Java 25. It uses Rivencraft's first-party Age backend, with no Dynamic Dimensions
their seeds. Books, lectern book stands, the Book Binder, Ink Mixer, Writing Desk and page collections or Bad Packets dependency. The writing loop, authored/seeded Ages, generation
are ported, and the Binder can features, weather/skies/celestials, libraries, crystal portals, live instability,
author Standard, Amplified, Island, Flat, Void, or Cave terrain with supported and Link Modifier controls are ported. JEI, TerraBlender/Biomes O' Plenty, Serene
biome-distribution pages, selected material/vegetation/structure features, and Seasons/GlitchCore and Ruins are optional.
independent Age weather and lighting, multiple authored or seeded celestial
bodies and eclipses, biome/material completion, and random features/structures. Immersive Portals Reborn 7.0.12 or Seamless Portals 1.0.0 optionally supplies
Crystal portals and libraries are ported. Instability scoring/provider selection, rotating live book previews, look-only exploration and continuous crystal portal
status effects, colored decay, lightning, explosions, meteors, burning and erosion, views. Install only one fork per instance. Built-in animations and normal travel
ordered writing recovery, live material profiling and all six Link Modifier controls are now ported. remain available without either. Independent settings under book_previews control
Link Modifier seed editing/retirement, remaining discovery/configuration and optional each fork's live book and crystal views.
integrations remain unfinished. The latest published beta is
[1.0.1.129-beta.1](RELEASE_NOTES_1.0.1.129-beta.1.md). **Known portal-mod failures:** [#118](https://git.paddedcell.org/dnorberg/rivencraft/issues/118)
Use a test world and keep a backup; do not tracks Reborn section-rebuild crashes and Reborn/Seamless acknowledgement disconnects
substitute this JAR for the 1.21.1 mod or import 1.21.1 saves. during travel. Rejoining recovered the observed Seamless Age-loading disconnect.
This release does not fix those failures. See [integration details](../../docs/SEAMLESS_PORTALS.md).
Native Caves/Nether/End Pages, desert vegetation and Number-controlled Static Sky
resolution passed player checks on both supported versions. Native controls select
their own seeded biome pool independently of terrain. Write Link Panel → Terrain
→ one Native choice. See [family rules](../../docs/NATIVE_BIOME_FAMILIES.md).
The port feature and acceptance review is recorded in
[the parity review](../../docs/MC263_PARITY_REVIEW.md). Book exploration matches
1.21.1: use the eye for mouse look inside the book panel and right-click to return;
movement is disabled. The final dedicated-server restart/return check passed.
Create/Ponder scenes are not ported to this target. Use matching client/server
builds, keep saves separate from 1.21.1 and back up before updating.
See [release notes](RELEASE_NOTES_26.3.0.10.md).
Flooded Environment Pages now fill Cave and other terrain to Y=63 by default,
or the absolute base-25 Number Pages immediately before Flooded. Both-version
player checks passed. See [Flooded rules](../../docs/FLOODED_PAGES.md).
The entries below record how the port was built, including earlier alpha-only The entries below record how the port was built, including earlier alpha-only
limitations that were addressed by later slices. limitations that were addressed by later slices.
@@ -2531,3 +2549,500 @@ new server run was performed; the previous 19 checks covered server actions, not
client input. Please click each option with an inserted Linking Book and verify client input. Please click each option with an inserted Linking Book and verify
its selected shading and tooltip/book properties change, then repeat supported its selected shading and tooltip/book properties change, then repeat supported
options with a Descriptive Book. No commit, push or publication. options with a Descriptive Book. No commit, push or publication.
## .130 Link Modifier seed editing
Ported the 1.21.1 station's seed field into the Legacy GUI. It is visible for a
bound Descriptive Book whose Age is still indexed, including an unloaded Age.
The complete signed 64-bit seed synchronizes through four 16-bit menu data words;
zero and negative seeds are not treated as missing data. Linking Books and unbound
or retired references do not expose an editable seed.
Enter/keypad Enter or clicking outside the field applies the edit; Escape closes
without applying unfinished text. Focused typing consumes inventory/hotbar shortcuts.
Modern InputConstants are used rather than legacy numeric key values. The bounded
payload validates the open menu ID and expected Age ID, plus menu owner, station
identity and distance. Invalid/overflowing input and occupied Ages are refused.
This matches 1.21.1's ordinary creative-acquired station editing permissions.
Successful edits use RuntimeAgeBackend.reseed, not a display-only book component.
Existing chunks and book identity remain intact, while newly generated chunks use
the changed seed. Existing backend unload/save/catalog synchronization is reused;
frozen written choices and instability history are not rerolled. Retirement UI
remains a later port slice.
Version 1.0.1.130-beta.1 builds. A temporary dedicated-server fixture passed 16 menu/
backend checks plus two restart checks: bound/unbound visibility, malformed/overflow
input, stale expected Age, occupied and remote refusal, retained old terrain,
changed index/level seed, unloaded reseeding including Long.MIN_VALUE, retained
book identity and full restart persistence. Future-chunk height fingerprints from
the menu-reseeded Age matched a fresh new-seed control and differed from an old-seed
control (new=-1541880620; retained origin=924831745). The initial flat-world fixture
could not distinguish terrain seeds; the terrain comparison used a normal-world
fixture. All temporary test worlds and fixture sources were removed and the server
stopped. The production JAR was rebuilt without fixtures. Client field input,
feedback and real travel validation are delegated to the player. No commit, push
or publication.
## .131 Link Modifier Age retirement
The player passed .130 seed editing. Ported the remaining 1.21.1 station retirement
control through the existing 26.3 lifecycle backend. A bound, active Descriptive
Book exposes the control only to players with modern Gamemaster (OP level 2)
permission. The first native button arms retirement; a separate red confirmation
button performs it. The arm and confirm actions have distinct IDs so repeating the
initial click cannot silently confirm. Normal book editing permissions are unchanged.
Confirmation is server-owned and tied to the exact Age and book components.
Replacing/removing the book, renaming, changing properties or applying a seed edit
clears confirmation; reopening the menu starts unarmed. Invalid, stale, non-OP and
remote actions cannot retire an Age. The target must be empty of players, including
the operator. A failed attempt clears confirmation and reports refusal.
Successful retirement uses RuntimeAgeBackend.retire: flush/unload the target,
persist its tombstone, archive only its directory beside the active world and
synchronize the runtime catalog. Other Ages are retained. The inserted book keeps
its now-dead identity, cannot reopen the retired Age, and no longer exposes seed or
retirement controls. Storage failures reuse backend rollback and display failure.
This follows 1.21.1 archival behavior rather than permanently erasing the files.
Version 1.0.1.131-beta.1 builds. Eighteen temporary dedicated-server checks plus four
restart checks passed: permission boundary, arm/confirm order, edits and book swaps,
occupied/remote refusal, successful retirement, exact archive and surviving control
Age, retained dead-book identity, repeated confirmation refusal, persisted tombstone,
and refusal to reload/recreate after restart. Test servers were stopped and all
worlds, archives and fixture sources removed. Production JAR rebuilt without the
fixture. Client button visibility, tooltip/feedback, occupied refusal and travel
through an old book are delegated to the player. No commit, push or publication.
## .132 failed Age-creation rollback (#99)
The player passed .131 retirement. Wrapped new runtime Age setup in one rollback
boundary: library writing, level construction/load event, weather and Accelerated
settings, index/initial display name, instability record and initial SavedData save.
The catalog is published only after those steps succeed. Book creation now supplies
its initial name to this operation and no longer configures acceleration/name after
commit. Operator/default callers retain the prior overloads.
A failed attempt closes the level stores, dispatches unload cleanup, removes its
new index/environment entries without leaving a retirement tombstone, restores the
prior library/instability metadata and saves that restoration. It removes only the
exact, newly allocated Age directory with a non-following tree walk. Existing Age
storage, live levels, retired IDs and unsafe/symlink paths are refused before any
setup. Pre-existing directories are never reused or erased. Cleanup failures are
attached to the original exception; if stores cannot close, files are retained to
avoid racing an active writer. Book failures are logged/reported and do not move
the caller. This covers recoverable runtime exceptions, not arbitrary process death
or a guarantee against persistent filesystem/I/O failure.
Index entry cleanup is shared with retirement without removing the retained display
name needed by retirement rollback. No existing Age scores, generation or settings
are migrated. No production fault-injection command/hook was introduced.
Version 1.0.1.132-beta.1 builds. A temporary dedicated fixture passed 36 checks plus
seven restart checks. Injected failures during LevelEvent.Load, instability creation
and late display-name validation left no live/indexed Age, restored prior writing,
dispatched one unload and removed only the new directory. Clean retries of the same
IDs succeeded. An existing directory marker survived refusal. A failed book-creation
call returned no Age and left its caller in the original world. Restart confirmed
failed metadata stayed absent while committed names/Accelerated settings persisted.
Fixture source, worlds and servers were removed/stopped; production JAR rebuilt
without the fixture. Client validation: create two Ages with distinct names, travel
and restart, including a book with Accelerated pages, and confirm their names,
settings and destinations remain independent. No commit, push or publication.
## .133 optional JEI integration (#102)
The player passed .132. Adapted the 1.21.1 JEI plugin to the current 26.3 API and
render extraction path. At the player's request, the target is the newest published
26.3 NeoForge build, 31.17.0.109 (JEI labels it beta), verified against its official
Maven metadata and Modrinth release API. This supersedes the initially inspected
installed 31.17.0.94. The latest release channel differs from the latest published
build; this slice deliberately targets the newer 31.17.0.109 build.
Added searchable component-aware Symbol Pages, all eight mixer Link Panel variants
and category/volume Symbol Portfolios. Registered biome and eligible Block/Fluid
pages use the same pools as Creative, including installed registry content. Runtime
registration fills any missing world-dependent variants; Blank Pages and the empty
base portfolio are removed from JEI's ingredient list. Future pages entering the
shared category pools participate automatically. Shared link-panel variant creation
now supplies both Creative and JEI.
Reused the Writing and Ink Mixer recipe-guide categories, additive chance guides,
and Ink Vial/Writing Desk/Book Binder/Ink Mixer catalysts. The port-specific mixer
text correctly states one paper plus one ink per panel, 16 units per vial and reset
of additives on output pickup. Added Link Modifier information, without a recipe.
Wrapped guide text uses opaque, shadow-free rendering and extra Mixer guide height.
These are explanatory guides; no auto-transfer handler or fictitious Blank Page
crafting recipe is introduced.
JEI is compile-only and isolated in its annotated scanner plugin. It is not bundled
or a required runtime dependency; no common class loads its plugin. The developer
`-PwithJei` option adds JEI locally, including its Maven dependencies. The current
109 POM requires MezzConfig 0.6.10 (and its GUI module); the existing test instance's
0.6.9 must be updated alongside JEI as required by the mod's distribution metadata.
Maven repository filters include JEI and MezzConfig groups only.
Version 1.0.1.133-beta.1 builds against the 109 API. A fresh dedicated server started
without JEI or any optional mods and stopped normally; its world was removed. Client
plugin discovery, ingredient counts/subtype uniqueness, guide rendering and category
navigation await the player's check with JEI 31.17.0.109 and its dependencies. Other
optional integrations remain unported; #102 is not complete. No commit, push or
publication, and no user's instance files were replaced.
## .134 optional TerraBlender regions (#102)
The player passed .133 JEI. Ported the 1.21.1 optional TerraBlender region adapter
to the current 26.3 API, compile-only at 26.3.0.0.9 (the latest published 26.3
build checked on Modrinth). The core boundary never exposes TerraBlender types.
Absent/broken optional API falls back to existing tags/native pools, with one
warning for API failures. No content mod is required or bundled. A developer
`-PwithTerraBlender` runtime option is available.
Enumerates registered non-vanilla biome keys from Overworld and Nether regions,
excluding TerraBlender's deferred placeholder. Overworld additions extend random
and seed-completed Standard/Amplified/Island/Flat pools. Nether-region membership
extends Cave-compatible selection and Cave Page classification even without an
is_nether tag. Registry-derived Creative and JEI page pools share that result.
Runtime Age construction primes membership before biome validation/generation;
Nether material-rule conditions also include recognized TerraBlender Nether keys.
Region scans are cached per registry access with weak keys; hot generation queries
use weak-holder membership rather than rescanning all regions. Tags updates refresh
the relevant registry entry, and a lowest-priority server-about-to-start callback
refreshes after TerraBlender loads data-driven regions. Frozen saved biome pools
are not rerolled or migrated. No mod-specific biome names are hardcoded.
Both 1.21.1 and 26.3 APIs expose OVERWORLD/NETHER, but no CAVE or END region type.
This distinction and the need for cave tags/metadata were posted and verified in
#111 (comment 605), including Nether precedence for overlapping Cave/Nether tags,
explicit authoring, and the planned Native Nether/End pages. This slice retains
current Native Cave eligibility: excluding Nether from its default pool and adding
those new pages remain #111, for both version tracks. No 1.21.1 code was changed.
Version 1.0.1.134-beta.1 builds. A clean dedicated server without TerraBlender
starts normally. A fresh server with TerraBlender 26.3.0.0.9, BOP 26.3.0.0.16 and
GlitchCore 26.3.0.0.5 passed nine focused checks: 59 Overworld additions, five Nether
additions, placeholder exclusion, completion pools, Cave Page placement, an injected
Nether region referencing an untagged biome, cache removal after region removal,
and Cave Age acceptance/reload with a modded Nether biome. No bulk generation or
client rendering was claimed. Test servers stopped, worlds and fixture sources
removed; production JAR rebuilt without fixtures. Client Creative/JEI placement,
actual BOP surface/Cave terrain materials and decoration remain player checks.
No commit, push or publication. Other #102 integrations remain incomplete.
## .135 optional Serene Seasons per-Age policies (#102)
The player passed .134. Ported 1.21.1's six modes: No Seasons, cycling Seasons,
Eternal Winter/Summer/Fall/Spring. Uses the latest published 26.3 Serene build
26.1.2.0.7 (QnvW5HPm) and GlitchCore 26.3.0.0.5 (pQgy3bfh), matching the test
instance. Both APIs are compile-only behind a guarded adapter, never bundled or
required. The developer -PwithSereneSeasons flag adds them to the local runtime.
New Ages freeze an authored or seed-selected policy in separate SavedData. Omitted
choices randomize only when Serene is installed, matching root Legacy ranks:
Seasons weight 6, No Seasons 5 and each Eternal 1. Cave terrain always disables
seasons. Existing Ages without a stored policy retain legacy cycling behavior
when integration/auto-whitelisting is enabled; they are not randomly reassigned.
No Seasons is usable without the optional mod; other seasonal pages require it.
Singular page recovery keeps the last seasonal controller with existing penalties.
The guarded adapter writes only the target Age's whitelist entry and persists it
through Serene/GlitchCore's config API. Connected-client updates and login replay
apply the same entries without a restart. Existing unrelated entries are retained.
Eternal policies hold the middle sub-season in a bounded mid-season window, avoiding
per-tick dirty data and leaving the Overworld calendar unchanged. Server config
serene_seasons.auto_whitelist_ages defaults true, matching 1.21.1: explicit policies
still apply when disabled, while existing whitelist entries are not removed merely
by disabling automatic behavior.
Policy selection participates in creation rollback before catalog publication;
optional whitelist changes happen only after successful creation. Reload/reseed
reuse the frozen policy. Retirement removes its whitelist entry only after backend
retirement succeeds, while policy history can remain in global metadata. Client
messages are limited to Rivencraft Age IDs. Compatibility failures log once rather
than flood every level tick. No Ecliptic Seasons support is added.
Version 1.0.1.135-beta.1 builds. A clean dedicated server starts without optional
mods. With Serene/GlitchCore, 25 checks passed on creation and 22 after full restart:
all six saved modes/whitelist policies, each eternal mid-season and recovery from a
changed cycle value, unchanged Overworld season data, unrelated whitelist entries,
deterministic omitted choices, no random choice when the mod is absent, and Cave
suppression. The initial restart assertion was corrected to allow the deliberate
mid-season hold window inherited from 1.21.1. Test worlds/fixtures were removed and
servers stopped; production JAR rebuilt without fixtures. Client visual effects,
reconnect/live whitelist synchronization, normal season progression, authoring and
retirement with a real connected client remain player validation. No commit, push
or publication; other #102 integrations remain open.
### Optional Ruins template pages — 1.0.1.136-beta.1
The preceding Serene Seasons slice passed the player's in-game check. Ruins now
uses the 1.21.1 exact-template bridge: each unambiguous installed `.tml` filename
gets a dynamic glyph page in a Ruins creative tab, portfolios, and JEI's page pool.
Names preserve case and Unicode through reversible IDs. Discovery reads Ruins'
active `config/ruins_config` directory, with its bundled archive as the first-launch
fallback. Duplicate basenames disable the bridge because Ruins' event cannot
identify which directory supplied the template.
Authored template choices and all duplicate counts are frozen in the Age's terrain
feature plan and restored before its load event. Only selected templates pass the
Age dimension and pre-spawn gates; other worlds retain Ruins' own behavior. Ruins'
biome/surface/distance requirements remain applicable. Copies multiply template
weight and increase attempts by one per extra page, capped at 32 attempts without
lowering an explicitly higher Ruins configuration. The first three copies are free;
each later copy adds 100 instability, including copies beyond the attempt cap.
Material pages do not modify Ruins structures. Unloading clears bridge state and
reloading restores it; optional Ruins classes are not loaded when the mod is absent.
The reproducible compile-only baseline is Ruins 26.3.1NF (CurseForge file 8962119);
the installed Ruins 26.3.2NF was used for integration validation. For development,
`-PwithRuins` adds the baseline runtime, or combine it with
`-PruinsJar=/absolute/path/to/ruins-26.3.2NF.jar` to run a local current build.
Neither dependency is bundled or required to run Rivencraft.
Build and clean dedicated-server startup without Ruins passed. With Ruins 26.3.2NF,
21 checks passed on creation and 10 after restart, covering 25 discovered templates,
creative/JEI pool parity, readable/case-sensitive IDs, authoring, codec roundtrip,
50 retained copies, attempt limits, 4,700 excess-page instability, exact template
filtering, both dimension gates, spawn-event veto, and a real Tiki Head placement
(149 non-air blocks counted in the checked volume). Restart, unload, and reload
retained the counts. Temporary fixtures and test worlds were removed; test servers
were stopped. Client glyph/GUI checks and natural spawning while exploring an Age
remain player validation. No commit, push, or publication; #102 remains open.
### Random Page eligibility and library discovery — 1.0.1.137-beta.1
The player passed .136 and authorized its publication. This slice adapts 1.21.1's
RandomPagePolicy and random_pages allowlist/blocklist. Short paths (sky/static)
and fully namespaced Page IDs are accepted; blocklist wins, and allowlist entries
restrict only their own categories. Biome controllers are a separate category
from individual biomes. Creative/JEI availability and manual book authoring are
not filtered.
Normal Link-Panel-only book creation takes one immutable policy snapshot and
passes it through terrain, biome distribution/Page completion, environment,
celestial kinds, material features/materials, optional formations and structures.
Seasons use the same snapshot before their saved policy is committed. Resolved
choices are already frozen in Age index/season data, so reload/reseed never reads
the current lists to reselect an old Age. Authored and partly authored books use
the existing unrestricted completion behavior, matching the 1.21.1 boundary.
Required empty categories use Standard terrain, Native distribution, Normal
lighting/weather, inherited Overworld sky, or No Seasons. Optional features or
materials with no candidates are omitted, not filled with a forbidden random
Page. Non-Native biome distributions preserve their required minimum using the
terrain's preferred/native fallback pool; necessary fallback biomes can therefore
bypass a filter. Native noise biomes come from the preset, not biome Page selection,
and remain unfiltered just as in 1.21.1. Void still has its required Void biome.
Cave weather/season safety overrides remain unchanged. Original unrestricted
terrain/distribution seed choices are unchanged; filtered ranks are recalculated
using the shared Legacy rank chooser instead of a duplicate weighted routine.
Newly placed direct library Pages apply the current policy in both LEGACY and
AGE_ONLY modes. Existing inventory contents are not rewritten. The Legacy library
pool now includes exact Ruins templates and semantic bundled pages rather than
reusing the Sealed Notebook's narrower pool. Sealed Notebook opening retains its
1.21.1 pool behavior; this setting does not retroactively edit unopened/old loot.
No policy filtering is applied to JEI or creative portfolios.
Build passed. A disposable no-optional dedicated server passed 766 creation/policy
checks over 48 seeds and six restart checks: normal book binding, manual blocked
Page authoring, immutable saved settings under a changed policy, unload/reload,
required category/biome fallbacks, optional empty pools, material eligibility,
Native distinction, season policies without requiring Serene classes, library
filtering and unchanged Creative entries. The later rank revision added default
seed-compatibility and minimum-biome checks. These are temporary fixtures, not
new permanent game tests. Worlds and fixtures removed, servers stopped, production
JAR rebuilt. Player config/GUI/world validation remains pending. No commit, push
or publication.
### Random-Age book glyph prose — 1.0.1.138-beta.1
The player passed the .137 eligibility slice. Ported 1.21.1's first-page random-Age
glyph description: the Age name and author remain ordinary text on the left,
followed by layered Legacy word glyphs and real base-25 numerals for terrain,
distribution, lighting, weather and the first celestial cycle's period/angle/phase.
Authored books keep their existing name/author front page and single-symbol middle
pages; no writing notes or instability scores are introduced. The right-side
animated link panel and its click-to-travel behavior are unchanged.
The existing symbolcomponents.png atlas and deterministic word mappings are reused
directly with tinted GUI_TEXTURED blits; no generated art or per-frame dynamic
textures are added. A common prose layout helper handles Unicode word boundaries,
numeric width and wrapping. Writing Desk tab numerals now use the same rendering
routine, retaining their existing size/position/color.
Public terrain/distribution/lighting/weather metadata is sent in the Age catalog,
with celestial data reused from its existing saved-cycle map. These are actual
loaded Age settings rather than a reroll from the book ID or current config.
Metadata excludes seeds, instability scores and providers. It does not load an
unavailable destination merely to display a book. Full catalog replacement removes
unloaded/retired entries; logout clears description/cycle caches. Older books with
no authored symbol component use the random-description path. Existing Age/save
formats remain readable. Catalog network protocol is now 11 (previously 10):
client and server must use matching builds.
Build passed; disposable no-optional dedicated-server checks passed catalog
serialization, immutable snapshots, actual saved setting capture, cache
replacement/clear, real restart, unload/reload and retirement. Pure layout checks
covered Legacy word splitting, Unicode, wrapping, base-25 width and oversized
numeric fallback. Test worlds and fixtures removed, server stopped and production
JAR rebuilt. Visual glyph layering, book/lectern appearance and actual client
catalog receipt remain player validation. No commit, push or publication.
### Renamed Immersive Portals dimension bridge — 1.0.1.139-beta.1
The player passed .138. Confirmed the user's correction: the 26.3 Immersive Portal
implementation uses the Seamless Portals name/mod ID, retaining qouteall rendering,
chunk-loading and dimension APIs. Added an optional shared dimension-ID adapter
before Rivencraft catalog publication/acknowledgement. It synchronizes integer
IDs and native type/sea-level metadata without delegating Age ownership. Failed
synchronization blocks acknowledgement/travel rather than making a successfully
committed Age appear to have failed binding. Startup, unload/reload, reseed and
retirement are covered. Live book/crystal rendering remains later work.
The installed working build passed 35 server creation/catalog checks plus 13 after
restart. Normal book binding, native metadata, API ID roundtrips, two Ages,
lifecycle changes and failed-creation nonpublication were checked. No-optional
startup passed. Real client travel remains pending; Prism files were not changed.
Correction to the initial artifact audit: old CurseForge file 8937394 fails during
its own constructor on .99 with missing DataPackRegistryEvent$NewRegistry; this is
NOT the latest release. The latest file is 9218525, displayed as 10.0.0 while its
filename/internal metadata still say 1.0.0. Its SHA-256 exactly matches the user's
installed working file:
5d2bfc2a811a6526e3f6722c521d97e5de2869a6ead1c681323c3c472e4367a0.
The compile dependency is corrected to 9218525 in .140. The earlier broad claim
that the current published build cannot start was wrong and is superseded here.
NeoForge audit on 2026-11-11: official Maven metadata lists .102 as latest in the
26.3 line. Its universal JAR still lacks the old NewRegistry class, so upgrading
cannot fix that OLD portal artifact. Current target remains validated .99; a
separate .102 build/client/server check is recommended. No release authorized.
### Immersive Portals Reborn comparison and shared bridge — 1.0.1.140-beta.1
The user suggested Reborn. Verified the NeoForge 26.3 release is 7.0.12, file
9435354 in CurseForge project 1721833. The newer 7.0.18 is Fabric. The Reborn JAR
registers immersive_portals_reborn plus its legacy core aliases and retains the
qouteall GUI rendering/portal/chunk/dimension APIs. It starts on NeoForge .99
without Cloth Config or other optional mods in the test environment.
Generalized the optional bridge to recognize either Reborn or Seamless. Both
share DimensionIntId.onServerDimensionChanged and the createFromServer packet
factory. Seamless's createPacket returns a vanilla Packet; Reborn's returns a
CustomPacketPayload. The adapter now wraps createFromServer in the vanilla
clientbound payload packet, preserving each fork's native two-/three-tag wire
format. No cross-fork packet schema is invented and neither dependency is bundled.
The compat probe recognizes both. A development run may select
-PwithImmersivePortalsReborn or -PwithSeamlessPortals; requesting both is rejected
because the forks share classes/mixins. The normal build remains optional-free.
Reborn passed 32 creation/catalog checks and 15 after restart: real book-binding
entry point, two runtime Ages, ID/type metadata, native wire roundtrip, per-player
packet preparation, unload/reload, reseed, retirement isolation and persistence.
Seamless latest file 9218525 passed the same 32 lifecycle/packet and 15 restart checks against the shared adapter.
These are server/packet checks, not evidence of renderer quality or real client
packet receipt. Reborn is a viable next client-test target; no performance
superiority is claimed. Live snapshots, chunk leases/audio isolation, and live
crystal surfaces still need porting. Player files were not modified. Temporary
worlds/fixtures removed; no commit, push or publication.
### Reborn live book previews — 1.0.1.141-beta.1
Linking and Descriptive Book front panels now use Immersive Portals Reborn's
live GUI-world renderer when Reborn is installed on both sides. This carries
forward the 1.21.1 camera orbit (11-block radius, five blocks above the focus),
destination sky/fog, chunk streaming and remote-audio isolation. Server destination
resolution uses the actual held book or a nearby loaded stand's matching book;
the client cannot request arbitrary destination coordinates.
A unique session ID prevents stale replies or close packets from replacing or
releasing another book's preview. One per-player eight-chunk-radius loader streams
the view asynchronously, renews while the book stays open, and expires if its
heartbeat is lost. Closing, logout, death/source invalidation, dimension changes,
and shutdown release the lease. Destination resolution for Descriptive Books
uses the same footing/platform rules as book travel.
The rendering integration uses 26.3 GPU texture views with the deferred GUI.
Reborn may resize its target before extraction records the texture view; clearing
is deferred to its render hook, and the normal GUI draws the image beneath the
Legacy panel cutout. The target uses the main framebuffer's depth/stencil format.
The player camera is restored after remote rendering, and remote preview-world
sounds are suppressed without muting the player's world.
Set `[book_previews] reborn_live_views = false` in the local configuration to use
animated panels. Missing Reborn or unavailable terrain also retains the animated
fallback. Seamless's dimension-ID bridge remains available, but this live GUI
implementation is activated only for Reborn. Live crystal portal surfaces and
preview exploration controls remain separate port work.
Validation: production build passed. An isolated real NeoForge 26.3.0.99
dedicated-server/client run with Reborn 7.0.12 displayed the remote live Linking
Book view; screenshot inspected for the panel cutout, upright image and actual
terrain. The client completed without a renderer exception and logout left no
preview chunk leases. The user also reported that the books displayed live views
perfectly. All temporary worlds/client directories and fixture sources were
removed, and the distributable was rebuilt without test classes.
Startup warnings in this isolated run included Reborn's four deprecated
`logoFile` metadata entries; these are upstream branding metadata warnings.
The Linux narrator also lacks `libflite`, unrelated to the book renderer.
### Reborn live crystal portals — 1.0.1.142-beta.1
Crystal portals now create optional native Reborn render-only surfaces. Each
coplanar opening is one masked mesh on each side, including irregular outlines;
the destination image does not repeat once per portal block. Mesh planes sit
inside the portal block thickness so the crystal frame remains in front. Once
native surfaces are established, LIVE_VIEW hides only the animated portal model.
The blocks and their receptacle owner pointers stay intact.
Live views share destination resolution with portal book travel. Linking Books
use their written facing, while Descriptive Books preserve the approaching
entity's facing as their travel path does. The reference camera is anchored to
standing eye height above the opening's floor, rather than to its vertical center.
This prevents taller frames from shifting the preview's arrival height. Relative
links resolve using the opening's center as the view reference; the actual
entity's departure position is still used for travel.
Native surfaces cannot teleport entities, accept remote interaction or perform
cross-portal collision. Existing Rivencraft collision/queue and book rules remain
authoritative, including catalog readiness, Disarm, momentum and arrival safety.
Reborn handles visible-destination streaming through its normal portal system.
Geometry/destination tags allow maintenance to reuse matching entities and replace
stale ones. Activation establishes views immediately; normal receptacle maintenance
restores them after restart. Book removal, frame shutdown, missing destinations
and disabling the integration remove the native surfaces. Without Reborn the
animated surface and ordinary travel continue to work. The server setting is
[book_previews] reborn_crystal_live_views, default true.
Validation on NeoForge 26.3.0.99 / Reborn 7.0.12: 68 server checks passed, covering
all three plane axes, both sides, one mesh per opening, eye-position and facing
transforms, entity reuse, fallback toggling and book removal. Five additional
restart checks passed. An isolated real client/dedicated server rendered the live
opening, then crossed into the correct Age through normal Rivencraft travel.
Screenshots before/after were inspected; the user also reported success.
An initial render test mistakenly bound its synthetic Linking Book at Y=1 inside
the flat world's solid layers. The view correctly displayed underground terrain
and the collision check refused travel. The corrected fixture bound to the actual
surface (Y=4) and passed. No production spawn-height workaround was added for an
invalid synthetic book. All temporary fixtures and test worlds were removed, and
the distributable was rebuilt without test classes.
@@ -0,0 +1,60 @@
# Rivencraft 26.3 beta 1.0.1.136-beta.1
Collects the player-validated .130–.136 port slices since 1.0.1.129-beta.1.
For Minecraft 26.3, NeoForge 26.3.0.99 and Java 25. The Minecraft 1.21.1
release and its Dynamic Dimensions backend are unchanged. This remains an
incomplete beta port; use matching client/server builds and separate saves.
## Link Modifier and Age creation
- Edit a Descriptive Book Age's full signed 64-bit seed. Existing chunks remain;
newly generated terrain uses the new seed. Occupied Ages and stale/remote menu
requests are refused. Seed input supports Enter or focus loss without game keys
taking over while typing.
- Operators can retire an unoccupied Age through a separate confirmation action.
Its exact dimension directory is archived under `world-retired-ages`; the Age
is tombstoned and cannot reload after restart. Other Age data remains intact.
- Failed Age creation now rolls back the new level, index, initial name, library
writing, instability and season policy before publishing the catalog. Cleanup
removes only the newly created directory; pre-existing storage is protected.
Persistent filesystem failures or process crashes are not transactional guarantees.
## Optional integrations
All integrations remain optional and are never bundled.
- **JEI:** searchable symbol pages, Link Panel variants and portfolios, with Ink
Mixer/Writing Desk/Book Binder guidance. Internal Blank Pages and empty portfolios
remain hidden. Tested with JEI 31.17.0.109 and MezzConfig 0.7.1.
- **TerraBlender:** recognizes registered Overworld and Nether region biomes from
installed biome mods, including Biomes O' Plenty. Nether-region biomes join the
Cave-compatible authoring pool and use Nether material rules. Tested with
TerraBlender 26.3.0.0.9 and Biomes O' Plenty 26.3.0.0.16. The requested Native Cave
pool changes and Native Nether/End pages remain separate work in #111.
- **Serene Seasons:** No Seasons, Seasons and all four Eternal modes operate per
Age. Missing policies are seed-selected only when Serene is installed; Cave Ages
disable seasons. Dynamic whitelist updates synchronize without restarting, while
eternal policies leave the Overworld calendar unchanged. Tested with Serene
Seasons 26.1.2.0.7 and GlitchCore 26.3.0.0.5.
- **Ruins:** exact-template pages appear in creative and JEI. Authored Ages permit
only their selected templates; Ruins' surface, biome and distance checks remain.
Duplicate pages increase selection weight and attempts (32-attempt cap, without
lowering higher Ruins settings). The first three copies are free; each later
copy adds 100 instability, even beyond the attempt cap. Tested with Ruins
26.3.2NF. Duplicate template basenames disable the bridge to prevent ambiguity.
## Validation and remaining work
Both Minecraft builds pass. Every included slice passed player in-game checks;
the latest client log confirms JEI, TerraBlender/BOP, Serene/GlitchCore and Ruins
loaded together. Disposable dedicated-server checks covered seed changes with
unchanged old chunks, retirement/archive isolation, injected creation failures,
optional-mod absence, region discovery, season policies, Ruins template placement
and restart/unload/reload persistence. Test fixtures/worlds were removed and test
servers stopped. No permanent game tests were added.
Books and crystal portals still use animated fallback previews. Live destination
renderers, remaining discovery/configuration parity and random-Age glyph descriptions
remain unfinished. The current expanded-catalog dedicated two-client regression
and full parity/release gates remain open. Shared 1.21.1/26.3 follow-up issues are
not complete merely because one version's implementation works.
+81
View File
@@ -0,0 +1,81 @@
# Rivencraft 26.3.0.1
For **Minecraft 26.3**, **NeoForge 26.3.0.99** and **Java 25**.
This regular release collects the player-validated .137–.142 development slices
since 1.0.1.136-beta.1. Versions now use the Minecraft version followed by the
release slice and its iteration: `26.3.0.1`. The JAR is
`rivencraft-26.3.0.1.jar`. The existing Minecraft 1.21.1 release is unchanged.
## Live destination views with Immersive Portals Reborn
- Optional live rotating destination views in Linking and Descriptive Books,
including books on stands. Reborn streams the actual destination chunks.
- Crystal portals show a continuous live view across each coplanar opening,
masked to its shape, with the crystal frame remaining in front.
- Linking Book views use the written destination/facing; Descriptive Book
portals preserve the traveler's facing. Views anchor standing eye height to
the opening's floor, so taller frames do not shift arrival height.
- Rivencraft retains control of portal travel, Disarm, momentum and arrival
safety. The native view cannot independently teleport or interact remotely.
- Preview sessions release their chunk streams on close, logout, invalidation
or expiry. Remote book-preview audio is suppressed and the player camera
restored after rendering.
- Portal maintenance restores views after restart and removes them when the
book is removed or the frame is shut down.
- Tested with **[Immersive Portals Reborn 7.0.12 for NeoForge 26.3](https://www.curseforge.com/minecraft/mc-mods/immersive-portals-reborn-unofficial-fork/files/9435354)**.
Use one portal fork per instance. No optional mod is bundled or required.
- The renamed Seamless fork also receives runtime Age dimension/metadata
synchronization; this release's live rendering is enabled for Reborn.
## Random Ages, pages and book descriptions
- New random-Age and library-page allowlists/blocklists accept short paths such
as `sky/static`, as well as full namespaced IDs.
- Blocklists take precedence. An allowlist restricts only the categories it
mentions. Existing Ages and manually authored books remain usable.
- Required empty categories use safe defaults; optional empty categories can be
omitted. Native preset biome pools and necessary biome minimum fallbacks can
bypass individual biome-page exclusions.
- Random-Age Descriptive Books show Legacy glyph descriptions of their public
traits, beneath the readable Age name/author. Seed and instability scores
remain absent from these descriptions.
- Optional portal-engine dimension IDs and native metadata synchronize before
the Rivencraft catalog acknowledgement permits travel.
## Configuration
In `config/rivencraft-local.toml`:
- `random_pages.allowlist` and `random_pages.blocklist`: default empty.
- `book_previews.reborn_live_views`: default `true`; disable locally for
animated book panels.
- `book_previews.reborn_crystal_live_views`: default `true`; the server
controls live crystal surfaces. Disabling retains animated surfaces and travel.
The built-in Legacy animation remains available without optional renderers.
Dynamic Dimensions and Bad Packets are not required by the 26.3 line.
## Validation and known limits
The user passed the included slices in game. Disposable checks covered random
policy resolution, description/catalog serialization and persistence, native
dimension IDs and packet formats for both portal forks, preview rendering and
chunk-lease cleanup, all three crystal portal plane axes, both sides, destination
eye/facing transforms, fallback toggling and full restart restoration. A real
dedicated server/client displayed the live crystal view and crossed into its Age.
The no-optional-mod server also started successfully. Temporary fixtures/worlds
were removed and the production JAR contains no test or optional-engine classes.
**Known issue [#116](https://git.paddedcell.org/dnorberg/rivencraft/issues/116):**
with Reborn active, a Static Sky Age can render its sky outside the book GUI.
Use the animated book panel option if affected.
26.3 is now published on the regular release channel at the user's request.
This is not a claim that every 1.21.1 behavior or the final expanded-catalog
two-client regression is complete. The remaining multiplayer, parity and shared
follow-up issues stay open. Preview exploration controls and Create/Ponder scenes
are not included in this release.
Use matching client/server JARs. Back up worlds, keep the Minecraft tracks and
saves separate, and do not downgrade worlds containing newer data.
+19
View File
@@ -0,0 +1,19 @@
# Rivencraft 26.3.0.10
Release for Minecraft 26.3 / NeoForge 26.3.0.99 / Java 25.
Uses Rivencraft's first-party Age backend. Use matching client/server builds.
- Adds Native Caves, Native Nether and Native End Pages, selecting seeded regional biome pools independently of terrain. Includes recognized modded biomes and 26.3 Sulfur Caves.
- New ordinary Native Cave Ages exclude Nether tags and TerraBlender Nether regions. Explicit Nether authoring remains supported.
- Authored noise terrain can use a vanilla noise baseline when the primary Overworld uses Flat/custom generation.
- Trees add cacti in vanilla and tagged modded deserts, Huge Trees add tall cactus columns, and Flowers add dead bushes. Fixes Flat grass-surface placement in BOP Dryland.
- Number Pages immediately before Static Sky set resolution in base 25: default 48, clamped to 1–128. Resolution persists and synchronizes; the renderer releases replaced textures.
- Enables optional Seamless Portals 1.0.0 live book previews, look-only book exploration and continuous crystal-portal views. Install only one portal fork.
- Adds independent seamless_live_views and seamless_crystal_live_views configuration options. Animated previews and ordinary travel remain available without an optional renderer.
- New Pages enter the biome generation Creative/JEI feeds. Existing frozen pools and generated chunks are not rewritten.
Player in-game checks passed. Native-family checks passed: 91 without biome mods, 94 with BOP/TerraBlender. Optional-portal server probes passed sequentially: Seamless 24, Reborn 24, neither 8.
Known issue: [#118](https://git.paddedcell.org/dnorberg/rivencraft/issues/118) tracks Reborn renderer crashes and Reborn/Seamless acknowledgement disconnects during travel. A Seamless disconnect occurred loading “caves on top”; rejoining loaded the Age successfully. This release does not fix that failure. Disable optional live views or remove the optional renderer if needed.
Writing examples: Link Panel → Terrain → Native Caves/Nether/End. Native is itself a biome controller; do not add a second distribution controller.
+38
View File
@@ -0,0 +1,38 @@
# Rivencraft 26.3.0.3
For **Minecraft 26.3**, **NeoForge 26.3.0.99** and **Java 25**.
## Book preview exploration
- The eye button now matches 1.21.1: it grabs the mouse for look-only exploration
while the destination view remains inside the book panel. Movement is disabled.
- Right-click returns to the ordinary book controls without releasing the preview.
Books on stands retain their disabled exploration button.
- Fixed the exit crash caused by a forced render and duplicate Reborn render-target
submission. Pending target submissions are reused until the renderer drains them.
- Removed remaining Beta branding from the in-game mod name/description.
## Port acceptance and maintenance
- Completed dedicated-server restart/return-link acceptance for #100, following
the two-client matrix and its manual handoff. The player confirmed return travel.
- Added changed-target build/smoke workflows, sequential test-server exclusion and
repeatable dual-version validation commands.
- Hardened release uploads against mismatched filename, embedded version,
Minecraft/Java target and accidental test-fixture packaging. The 1.21.1 metadata
declares its required Dynamic Dimensions AR and Bad Packets dependencies.
- Documented the feature parity review and ongoing independent support of 1.21.1.
Existing 1.21.1 code and published artifacts are unchanged.
## Validation and known issues
The player passed the live-view exploration/right-click/re-entry check and the
dedicated-server Age restart/Linking Book return check. The expanded-catalog
two-client matrix passed creation/catalog/travel/stale-ack/lifecycle checks;
its final return step stalled and was completed by the player, not retried.
Release-tooling checks pass. No optional mod or test fixture is bundled.
**Known issue #116:** Static Sky can leak outside book previews with Reborn.
It remains separately tracked. Other shared follow-ups remain open where needed.
Create/Ponder is not ported to 26.3. Without Reborn, built-in animated previews
and normal book/portal travel remain available. 1.21.1 saves are not imported.
+17
View File
@@ -0,0 +1,17 @@
# Rivencraft 26.3.0.4
Minecraft 26.3 / NeoForge 26.3.0.99 / Java 25. Local test build.
- Added Flooded Environment Pages with the same 1.21.1 rules: default water block
Y=63, or adjacent base-25 Number Pages (2,24 means Y=74). Last Flooded wins.
- Works with Cave and other terrain, preserving solid features. Cave defaults
remain dry without Flooded.
- Lower lines drain higher ordinary water; waterlogged solids are wet/dried.
Policy persists in generator writing/codecs.
- Safe fallback platforms rise above water within build-height limits.
Creative and optional JEI reuse the existing glyph/page pipeline.
- Existing generated chunks are not rewritten. See docs/FLOODED_PAGES.md.
Known Static Sky/Reborn bug #116 remains separate.
Awaiting player acceptance and explicit publication instruction; not committed,
pushed or published.
+46
View File
@@ -0,0 +1,46 @@
# Rivencraft 26.3.0.5
For **Minecraft 26.3**, **NeoForge 26.3.0.99** and **Java 25**.
Dynamic Dimensions and Bad Packets are not required. All integrations remain optional.
## Flooded Pages
- Added Flooded Environment Pages for Cave and other terrain. Default highest
water block Y=63; adjacent Number Pages encode a base-25 absolute height.
Number 24 + Flooded means Y=24; Number 2 + Number 24 + Flooded means Y=74.
- Last Flooded wins. Unsigned heights clamp below the ceiling with safe
platform/headroom space. Cave defaults remain dry without Flooded.
- Flooding preserves solid terrain/features, wets waterloggable blocks and drains
ordinary water above a lower requested line. Policy persists in generator writing.
- Safe fallback platforms sit above water; no-platform travel can fail safely.
- Creative and optional JEI use the existing glyph/page pipeline.
- Existing generated chunks are not rewritten.
## Reborn compatibility and known crashes
- Added a targeted Reborn 7.0.12 acknowledgement guard for the reported protocol
disconnect during Age travel. While Reborn's world map is uninitialized, keep
vanilla acknowledgement handling for the packet listener's world; normal
multiworld handling resumes once ready. Packet scheduling stays on the game thread.
- **Known issue [#118](https://git.paddedcell.org/dnorberg/rivencraft/issues/118):**
Reborn can still crash during exploration when a queued section rebuild resolves
to null. This release does not fix that renderer crash or establish which mod
made the queue stale. The player accepted Flooded with these Reborn issues noted.
- [#117](https://git.paddedcell.org/dnorberg/rivencraft/issues/117) tracks full
Seamless live-view support. Seamless currently has native dimension synchronization
and normal travel, with animated fallback views; live views remain Reborn-only.
- The earlier Static Sky leak #116 was closed after the user reported it had gone
away with recent changes, possibly after interactive view was implemented.
That timing is not a verified root-cause fix. It is not the new section rebuild failure.
- Built-in animated book/portal views and ordinary travel remain available without
a portal renderer. Disabling only Rivencraft live views has not been proven to
prevent all Reborn crashes. No required or bundled portal-mod dependency is added.
## Validation
Both-version Flooded in-game checks passed. Three focused 1.21.1 tests and 21
isolated 26.3 checks covered grammar, two water levels, codecs, preserved solids,
dry Cave defaults and page availability. The 26.3.0.5 build and acknowledgement
target signatures were verified. No claim that Reborn is crash-free is made.
Temporary worlds/fixtures were removed; production JAR contains no test fixtures.
See [Flooded rules](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/FLOODED_PAGES.md).
+13
View File
@@ -0,0 +1,13 @@
# Rivencraft 26.3.0.6
Local test build for issue #108; pending player validation and explicit publication.
- Trees add ordinary cacti in vanilla and tagged modded deserts.
- Huge Trees add tall 5–9-block cactus columns; Flowers add dead bushes.
- Repeated pages add seeded attempts; normal biome decoration remains.
- Uses common `c:is_desert` via a data-pack-extensible Rivencraft tag. BOP
Dryland/Lush Desert are included; Cold Desert is unchanged.
- Candidate biome, air, ground and bounds checks protect existing blocks.
- Existing chunks are not rewritten. Creative/JEI tooltips describe the behavior.
Shared placement checks passed. See [desert vegetation rules](../../docs/DESERT_VEGETATION.md).
+14
View File
@@ -0,0 +1,14 @@
# Rivencraft 26.3.0.7
Local test build for issue #108; pending player retest and explicit publication.
- Includes the desert Trees, Huge Trees and Flowers page behavior from 26.3.0.6.
- Fixes cactus placement on Flat grass surfaces in BOP Dryland and other tagged
deserts: Minecraft 26.3 splits dirt and grass-like soils into separate tags.
- Keeps existing plants/blocks and normal biome decoration; old generated
chunks are not rewritten.
- The isolated BOP/TerraBlender server probe reproduced the failure, then
confirmed cactus and dead-bush placement with the corrected ground rule.
- Minecraft 1.21.1.0.4 passed player validation and is unchanged by this fix.
See [desert vegetation rules](../../docs/DESERT_VEGETATION.md).
+16
View File
@@ -0,0 +1,16 @@
# Rivencraft 26.3.0.8
Local test build for Minecraft 26.3; pending player validation and explicit publication.
- Number Pages immediately before Static Sky set its cells per face in base 25.
Default 48; supported range 1–128, with zero and oversized inputs clamped.
- Resolution persists across travel/save/reload and synchronizes with clients.
Matching updated server/client builds are required.
- Static animation timing and tint remain independent; other skies are unchanged.
- Existing Static Sky/Number Pages and Creative/JEI descriptions are updated.
- Includes the previously validated desert vegetation changes from issue #108.
The 26.3 renderer reuses its cube, resizes only the current noise texture,
and releases the previous texture on resolution changes.
Focused checks passed; GPU appearance awaits player validation. See [rules and tests](../../docs/STATIC_SKY_RESOLUTION.md).
+23
View File
@@ -0,0 +1,23 @@
# Rivencraft 26.3.0.9
Local candidate for Minecraft 26.3 / NeoForge 26.3.0.99 / Java 25.
Pending player validation and explicit publication.
- Enables optional Seamless Portals 1.0.0 live rotating Linking/Descriptive Book
panels and handheld look-only exploration, reusing the established renderer.
- Enables continuous masked crystal portal views through the same adapter,
with Rivencraft retaining teleportation and link-property handling.
- Adds independent `seamless_live_views` and `seamless_crystal_live_views`
options under `book_previews`. Existing Reborn options remain unchanged.
- Shares preview leases, camera/audio restoration and portal maintenance across
the two optional forks. Install only one fork per instance.
- Retains animations/ordinary travel without a renderer or when disabled.
- Keeps the Reborn acknowledgement workaround Reborn-only. Known Reborn
renderer crashes in issue #118 are not fixed by this release.
- Includes the validated desert vegetation and Static Sky resolution changes
from issues #108 and #109.
Sequential focused server checks pass: Seamless 24, Reborn 24, no portal mod 8.
Actual client rendering and multiplayer/restart behavior await player validation.
See [Seamless integration and manual checks](../../docs/SEAMLESS_PORTALS.md).
+35
View File
@@ -0,0 +1,35 @@
# Random Page policy test — 1.0.1.137-beta.1
Install the new JAR and launch once so the new entries appear in
Minecraft's config/rivencraft-local.toml. Close the instance before editing.
On a dedicated server edit its own config, not the client's.
For a visible check, replace only the existing random_pages section with:
```toml
[random_pages]
allowlist = ["terrain/flat", "biome/single", "biome/plains", "sky/static", "lighting/normal", "weather/off", "feature/not_present"]
blocklist = ["sky/nether", "celestial/sun", "celestial/moon"]
```
The deliberately nonexistent feature entry restricts only optional features,
leaving an empty feature pool for this test.
1. Bind a Descriptive Book with only a Link Panel. Enter it: expect Flat terrain,
Plains, Static Sky, normal lighting, no rain and no suns/moons. Optional Page
features/structures should be absent; native biome decoration is independent.
2. Bind an authored Flat/Plains/Single/Nether Sky book. Nether Sky remains usable
despite the blocklist; the setting controls random generation and direct
library loot, not manual authorship. The Page remains visible in Creative/JEI.
3. Change sky/static to sky/end, restart and revisit the first Age. It must retain
Static Sky. A newly bound Link-Panel-only book should get End Sky.
4. Optional library check: allowlist = ["sky/static"], blocklist = ["sky/nether"].
New library direct Pages may include Static Sky or other unrestricted
categories, but never another Sky Page. Test both library loot modes where
desired. Existing chests/stands remain untouched; AGE_ONLY may have no Pages
when the book's written Page set has no eligible entries.
Restore both lists to [] afterward unless you want the restrictions to persist.
No existing Age should change. Keep the full world backup customary for beta
updates. Native biome presets and required minimum-biome fallbacks intentionally
bypass biome-Page filters; Sealed Notebooks keep their separate 1.21.1 draw pool.
+21
View File
@@ -0,0 +1,21 @@
# Random-Age glyph description test — 1.0.1.138-beta.1
Use the new build on both client and server (Age catalog protocol 11).
1. Open an existing or new Link-Panel-only Descriptive Book. Its front spread
should retain the plain-text Age name and author on the left, with the generated
description below rendered as Legacy glyphs. The destination animation remains
on the right and clicking it still travels.
2. Put the same book on a lectern and open it. The description and panel should
match handheld use.
3. Open an authored book containing Symbol Pages. Its front spread should retain
just the name/author, and page turning should show one authored symbol at a time.
4. Reconnect or restart, then reopen the random book. Glyph traits should remain
consistent with its saved Age. Test a longer name and GUI scale for clipping.
5. Check Writing Desk tab numbers around 24/25 and 49/50. Their existing glyph
size/position and base-25 behavior should be unchanged.
Descriptions are available only for loaded Ages; viewing a book does not force-load
an unloaded/retired Age. No instability score or seed appears in the description.
The desktop glyph display still needs your visual check; server/codec/layout
validation does not substitute for a real client render check.
+8
View File
@@ -0,0 +1,8 @@
# Superseded by the 1.0.1.140-beta.1 portal-fork test
Use TESTING_1.0.1.140-beta.1.md. It covers both supported fork candidates.
Correction: the user's installed Seamless file exactly matches current published
CurseForge file 9218525 (displayed 10.0.0, internal version/filename 1.0.0).
The startup failure applies only to older file 8937394. The earlier recommendation
to avoid the current download was incorrect.
+29
View File
@@ -0,0 +1,29 @@
# Portal fork runtime compatibility — 1.0.1.140-beta.1
Candidate downloads for Minecraft 26.3 / NeoForge:
- Immersive Portals Reborn 7.0.12:
https://www.curseforge.com/minecraft/mc-mods/immersive-portals-reborn-unofficial-fork/files/9435354
Version 7.0.18 is Fabric, so use the NeoForge 7.0.12 file for this test.
- Seamless latest file 9218525:
https://www.curseforge.com/minecraft/mc-mods/immersive-portal/files/9218525
Display name is 10.0.0, but its downloaded filename/internal version remain 1.0.0.
This exactly matches the user's installed working JAR.
Use ONE portal fork per instance: they share engine classes and mixins.
Prism files were left unchanged. Install matching Rivencraft builds on both sides
for dedicated testing. Current tested loader is NeoForge 26.3.0.99.
1. Enable/install the chosen fork and Rivencraft .140.
2. Create an authored Descriptive Book after joining, using a distinctive sky and
lighting. Travel into its newly created Age without reconnecting.
3. Return using a bound Linking Book and test a second freshly created Age.
4. Restart and revisit both Ages. Check for unknown/unloaded-dimension rejection,
disconnects or incorrect sky/lighting.
5. Test existing crystal portals through the usual Rivencraft fallback path.
This slice synchronizes runtime Ages and native metadata. Live book panels and
live crystal portal surfaces are NOT ported yet; animated fallbacks are expected.
Actual client travel/packet handling needs your check. Server lifecycle, packet
serialization and restart checks passed with both Reborn and latest Seamless
(32 lifecycle/packet plus 15 restart checks each). NeoForge .102 is a candidate for a later isolated upgrade
check; the project target has not been changed yet.
+26
View File
@@ -0,0 +1,26 @@
# 1.0.1.141-beta.1 — Reborn live book previews
Use NeoForge 26.3.0.99 and Immersive Portals Reborn 7.0.12, CurseForge file 9435354.
Install one portal fork per instance and matching Rivencraft builds on a dedicated
server/client. Reborn remains optional; nothing is bundled.
The user reports live views working in both book types. Follow-up coverage:
1. View a Linking Book and Descriptive Book pointing to different Ages. Check
orbiting terrain, upright orientation, destination lighting/sky and the panel
cutout. Click the live panel to travel using the existing book controls.
2. Repeat from a book stand, including a destination whose chunks are not loaded.
3. Close/reopen, switch books quickly and restart/revisit the Age. A stale view
must not replace the newly selected destination.
4. During rain, confirm the source world's weather audio remains audible and the
remote world's sounds do not leak into the GUI.
5. Set [book_previews] reborn_live_views = false in rivencraft-local.toml to
verify the animated fallback; restore true for live views.
The live image streams actual destination chunks. It is not restricted to the
old fixed block snapshot volume. Exploration controls and live crystal portal
surfaces are not included in this slice.
Build and isolated dedicated/client rendering check passed, with a live Linking
Book screenshot inspected and zero remaining preview leases on logout. Temporary
test worlds were removed regardless of result. Reborn's four deprecated logoFile
startup warnings concern its metadata, not Rivencraft rendering.
+30
View File
@@ -0,0 +1,30 @@
# 1.0.1.142-beta.1 — Reborn live crystal portal surfaces
Use Reborn 7.0.12 for NeoForge 26.3, CurseForge file 9435354, with NeoForge
26.3.0.99. Use one portal fork and matching Rivencraft builds on a server/client.
Implemented and validated:
- One continuous view per opening on each side, masked to the portal cells.
- Correct destination eye-height reference; Linking Book facing and Descriptive
Book inherited facing.
- Native surfaces render only; Rivencraft's blocks retain transport and effects.
- Fallback model hidden only for established live surfaces.
- Maintenance restores views after restart and removes them on shutdown/removal.
- Optional server setting [book_previews] reborn_crystal_live_views = false retains
animated surfaces and ordinary portal travel.
68 server checks and five restart checks passed, plus a real dedicated/client
live-view and walking-through check. Screenshots were inspected and the user
reported success. Temporary worlds were deleted and fixture sources removed.
Useful follow-up manual coverage:
1. Try both book types, compare portal arrival to using the same book, and inspect
both sides of the frame.
2. Try taller, horizontal and irregular frames; check that frame edges occlude the
scene and the view does not repeat per cell.
3. Restart, revisit, remove/reinsert the book and break a frame block.
4. Check a destination with different sky/lighting and an initially unloaded
destination area.
The initial synthetic render fixture used a blocked Y=1 target; that was corrected
to the resolved Y=4 surface. No global landing-height behavior was changed.
+54 -1
View File
@@ -3,11 +3,63 @@ plugins {
id 'net.neoforged.moddev' version '2.0.148' id 'net.neoforged.moddev' version '2.0.148'
} }
repositories {
maven { url = 'https://www.cursemaven.com'; content { includeGroup 'curse.maven' } }
maven { url = 'https://api.modrinth.com/maven'; content { includeGroup 'maven.modrinth' } }
maven {
name = 'TerraBlenderMaven'
url = 'https://maven.minecraftforge.net/releases/'
content { includeGroup 'com.github.glitchfiend' }
}
maven {
name = 'JaredsMaven'
url = 'https://maven.blamejared.com'
content { includeGroup 'mezz.jei'; includeGroup 'net.mezzdev.config' }
}
}
// Optional APIs stay out of published dependency metadata.
configurations {
localRuntime
runtimeClasspath.extendsFrom localRuntime
}
dependencies {
// Both optional forks retain qouteall APIs, but must never be loaded together.
if (project.hasProperty('withSeamlessPortals') && project.hasProperty('withImmersivePortalsReborn'))
throw new GradleException('Choose one Immersive Portals fork for the development run')
def portalDependency = project.hasProperty('withImmersivePortalsReborn')
? 'curse.maven:immersive-portals-reborn-unofficial-fork-1721833:9435354'
: project.hasProperty('seamlessPortalsJar') ? files(project.property('seamlessPortalsJar'))
: project.hasProperty('withSeamlessPortals') ? 'curse.maven:immersive-portal-1511174:9218525'
: 'curse.maven:immersive-portals-reborn-unofficial-fork-1721833:9435354'
compileOnly portalDependency
if (project.hasProperty('withSeamlessPortals') || project.hasProperty('withImmersivePortalsReborn'))
localRuntime portalDependency
// Compile against the 26.3 baseline API; a local current Ruins JAR can override it.
def ruinsDependency = project.hasProperty('ruinsJar') ? files(project.property('ruinsJar'))
: 'curse.maven:ruins-227873:8962119'
compileOnly ruinsDependency
if (project.hasProperty('withRuins')) localRuntime ruinsDependency
compileOnly "maven.modrinth:e0bNACJD:${serene_seasons_version_id}"
compileOnly "maven.modrinth:s3dmwKy5:${glitchcore_version_id}"
if (project.hasProperty('withSereneSeasons')) {
localRuntime "maven.modrinth:e0bNACJD:${serene_seasons_version_id}"
localRuntime "maven.modrinth:s3dmwKy5:${glitchcore_version_id}"
}
compileOnly "com.github.glitchfiend:TerraBlender-neoforge:${minecraft_version}-${terrablender_version}"
if (project.hasProperty('withTerraBlender')) localRuntime "com.github.glitchfiend:TerraBlender-neoforge:${minecraft_version}-${terrablender_version}"
// Plugin-only API dependency: JEI is never bundled or required at runtime.
compileOnly "mezz.jei:jei-${minecraft_version}-neoforge-api:${jei_version}"
if (project.hasProperty('withJei')) localRuntime "mezz.jei:jei-${minecraft_version}-neoforge:${jei_version}"
}
sourceSets.main.java.srcDir('../../shared/src/main/java')
group = 'net.dnorberg.rivencraft' group = 'net.dnorberg.rivencraft'
version = mod_version version = mod_version
base { base {
archivesName = "rivencraft-${minecraft_version}" archivesName = "rivencraft"
} }
java.toolchain.languageVersion = JavaLanguageVersion.of(25) java.toolchain.languageVersion = JavaLanguageVersion.of(25)
@@ -197,6 +249,7 @@ tasks.named('processResources', ProcessResources).configure {
include 'assets/rivencraft/models/block/decay_*.json' include 'assets/rivencraft/models/block/decay_*.json'
include 'assets/rivencraft/textures/block/decay_*.png' include 'assets/rivencraft/textures/block/decay_*.png'
include 'data/rivencraft/tags/block/decay_protected.json' include 'data/rivencraft/tags/block/decay_protected.json'
include 'data/rivencraft/tags/worldgen/biome/desert_vegetation.json'
include 'assets/rivencraft/sounds.json' include 'assets/rivencraft/sounds.json'
include 'assets/rivencraft/sounds/**/*.ogg' include 'assets/rivencraft/sounds/**/*.ogg'
include 'assets/rivencraft/textures/item/crystal_shard.png' include 'assets/rivencraft/textures/item/crystal_shard.png'
+8 -1
View File
@@ -7,4 +7,11 @@ neo_version=26.3.0.99
mod_id=rivencraft mod_id=rivencraft
mod_name=Rivencraft mod_name=Rivencraft
mod_license=LGPL-3.0-or-later mod_license=LGPL-3.0-or-later
mod_version=1.0.1.129-beta.1 mod_version=26.3.0.10
jei_version=31.17.0.109
terrablender_version=26.3.0.0.9
serene_seasons_version_id=QnvW5HPm
glitchcore_version_id=pQgy3bfh
+5 -4
View File
@@ -11,10 +11,8 @@
"symbol.rivencraft.sky.overworld.description": "Use the native Overworld sky. Terrain and lighting remain independently authored.", "symbol.rivencraft.sky.overworld.description": "Use the native Overworld sky. Terrain and lighting remain independently authored.",
"symbol.rivencraft.sky.nether.description": "Use a Nether-style reddish fog backdrop. Authored celestials render over it; terrain and gameplay rules remain independent.", "symbol.rivencraft.sky.nether.description": "Use a Nether-style reddish fog backdrop. Authored celestials render over it; terrain and gameplay rules remain independent.",
"symbol.rivencraft.sky.end.description": "Use the native End sky backdrop with authored celestials over it, without End terrain or a dragon fight.", "symbol.rivencraft.sky.end.description": "Use the native End sky backdrop with authored celestials over it, without End terrain or a dragon fight.",
"symbol.rivencraft.sky.static.description": "Animated static surrounds the Age, behind authored celestials. Preceding colors tint it; otherwise it is gray.",
"symbol.rivencraft.lighting.ambient_color": "Ambient Light Color", "symbol.rivencraft.lighting.ambient_color": "Ambient Light Color",
"symbol.rivencraft.lighting.ambient_color.description": "Apply preceding shared colors to ambient light. Use Bright separately for full effective ambient lighting.", "symbol.rivencraft.lighting.ambient_color.description": "Apply preceding shared colors to ambient light. Use Bright separately for full effective ambient lighting.",
"symbol.rivencraft.number.description": "Before Color: value × 10 per channel. Before Length: value × 0.08 days. Before Phase/Angle: value × 15 degrees. Before Size: 0.25× to 3× (0-24).",
"symbol.rivencraft.size.small.description": "Before Sun/Moon: 0.5× body size. Before Normal Time: size the sun only. A preceding Number overrides the size.", "symbol.rivencraft.size.small.description": "Before Sun/Moon: 0.5× body size. Before Normal Time: size the sun only. A preceding Number overrides the size.",
"symbol.rivencraft.size.normal.description": "Before Sun/Moon: 1× body size. Before Normal Time: size the sun only. A preceding Number selects 0.25× through 3× (0-24).", "symbol.rivencraft.size.normal.description": "Before Sun/Moon: 1× body size. Before Normal Time: size the sun only. A preceding Number selects 0.25× through 3× (0-24).",
"symbol.rivencraft.size.large.description": "Before Sun/Moon: 2× body size. Before Normal Time: size the sun only. A preceding Number selects 0.25× through 3× (0-24).", "symbol.rivencraft.size.large.description": "Before Sun/Moon: 2× body size. Before Normal Time: size the sun only. A preceding Number selects 0.25× through 3× (0-24).",
@@ -85,7 +83,6 @@
"symbol.rivencraft.feature.abandoned_camps": "Abandoned Camps", "symbol.rivencraft.feature.abandoned_camps": "Abandoned Camps",
"symbol.rivencraft.feature.abandoned_camps.description": "Allow abandoned camps on surface noise terrain, including outside their usual biomes.", "symbol.rivencraft.feature.abandoned_camps.description": "Allow abandoned camps on surface noise terrain, including outside their usual biomes.",
"symbol.rivencraft.block.generated.description": "Modify the next compatible feature. Without a following feature, choose a compatible feature from the Age seed.", "symbol.rivencraft.block.generated.description": "Modify the next compatible feature. Without a following feature, choose a compatible feature from the Age seed.",
"symbol.rivencraft.biome.native.description": "Use the terrain's default biome source. Cave uses Tiny regions from recognized Cave/Nether biomes. Do not include Biome pages.",
"symbol.rivencraft.feature.dungeons.description": "Add monster-room dungeon attempts throughout surface noise or Cave terrain, including Nether cave biomes. Not Flat or Void.", "symbol.rivencraft.feature.dungeons.description": "Add monster-room dungeon attempts throughout surface noise or Cave terrain, including Nether cave biomes. Not Flat or Void.",
"symbol.rivencraft.biome.single.description": "Use one biome across the Age. If omitted, choose an eligible biome from the Age seed.", "symbol.rivencraft.biome.single.description": "Use one biome across the Age. If omitted, choose an eligible biome from the Age seed.",
"symbol.rivencraft.terrain.flat.description": "A level, biome-decorated landscape with its foundation at Y=0.", "symbol.rivencraft.terrain.flat.description": "A level, biome-decorated landscape with its foundation at Y=0.",
@@ -106,5 +103,9 @@
"symbol.rivencraft.feature.ruined_portals.description": "Allow ruined portals in noise terrain, including Cave, regardless of normal biome eligibility.", "symbol.rivencraft.feature.ruined_portals.description": "Allow ruined portals in noise terrain, including Cave, regardless of normal biome eligibility.",
"symbol.rivencraft.feature.nether_fossils.description": "Allow Nether fossils in Cave terrain; the authored page overrides biome eligibility.", "symbol.rivencraft.feature.nether_fossils.description": "Allow Nether fossils in Cave terrain; the authored page overrides biome eligibility.",
"symbol.rivencraft.feature.ancient_cities.description": "Allow underground Ancient Cities in noise terrain, including Cave, regardless of biome eligibility.", "symbol.rivencraft.feature.ancient_cities.description": "Allow underground Ancient Cities in noise terrain, including Cave, regardless of biome eligibility.",
"symbol.rivencraft.feature.trail_ruins.description": "Allow Trail Ruins in surface noise terrain, including outside their usual biomes." "symbol.rivencraft.feature.trail_ruins.description": "Allow Trail Ruins in surface noise terrain, including outside their usual biomes.",
"jei.rivencraft.ink_mixer.usage": "Paper + ink makes a Link Panel. Each panel uses one paper and one ink. A vial supplies 16 ink and returns a glass bottle; additives reset when a panel is taken.",
"jei.rivencraft.link_modifier": "Creative-only tool; no crafting recipe. Insert a book to rename it and edit link properties. Bound Descriptive Books also allow seed editing while their Age is empty. Age retirement requires OP permission and a separate confirmation; its data is archived.",
"symbol.rivencraft.ruins.description": "Generates this Ruins template. Repeated pages increase its selection weight and spawn attempts.",
"itemGroup.rivencraft.pages.ruins": "Rivencraft Ruins Pages"
} }
@@ -7,7 +7,14 @@ public final class PortConfig {
public enum LibraryLootMode { LEGACY, AGE_ONLY } public enum LibraryLootMode { LEGACY, AGE_ONLY }
public static final ModConfigSpec.EnumValue<LibraryLootMode> LIBRARY_LOOT_MODE; public static final ModConfigSpec.EnumValue<LibraryLootMode> LIBRARY_LOOT_MODE;
public enum ReturnLinkMode { ON_CREATION, ALWAYS, DISABLED } public enum ReturnLinkMode { ON_CREATION, ALWAYS, DISABLED }
public static final ModConfigSpec.ConfigValue<java.util.List<? extends String>> RANDOM_PAGE_ALLOWLIST;
public static final ModConfigSpec.ConfigValue<java.util.List<? extends String>> RANDOM_PAGE_BLOCKLIST;
public static final ModConfigSpec.BooleanValue LIVE_BOOK_PREVIEWS;
public static final ModConfigSpec.BooleanValue CRYSTAL_LIVE_VIEWS;
public static final ModConfigSpec.BooleanValue SEAMLESS_BOOK_PREVIEWS;
public static final ModConfigSpec.BooleanValue SEAMLESS_CRYSTAL_VIEWS;
public static final ModConfigSpec SPEC; public static final ModConfigSpec SPEC;
public static final ModConfigSpec.BooleanValue AUTO_WHITELIST_SERENE_AGES;
public static final ModConfigSpec.IntValue SYMBOL_INK_COST; public static final ModConfigSpec.IntValue SYMBOL_INK_COST;
public static final ModConfigSpec.IntValue LINK_PANEL_INK_COST; public static final ModConfigSpec.IntValue LINK_PANEL_INK_COST;
public static final ModConfigSpec.EnumValue<ReturnLinkMode> RETURN_LINK_MODE; public static final ModConfigSpec.EnumValue<ReturnLinkMode> RETURN_LINK_MODE;
@@ -16,6 +23,38 @@ public final class PortConfig {
static { static {
var builder = new ModConfigSpec.Builder(); var builder = new ModConfigSpec.Builder();
builder.push("book_previews");
LIVE_BOOK_PREVIEWS = builder.comment("Show live rotating destination views when Immersive Portals Reborn is installed on client and server.",
"Disable locally to retain the animated Legacy link panels.")
.define("reborn_live_views", true);
CRYSTAL_LIVE_VIEWS = builder.comment("Server option: create native live crystal portal surfaces when Reborn is installed.",
"Disabling keeps crystal portal travel with the animated surface.")
.define("reborn_crystal_live_views", true);
SEAMLESS_BOOK_PREVIEWS = builder.comment(
"Show rotating live book views and handheld look-only exploration with Seamless on client and server.",
"Disable locally to retain animated Legacy link panels; existing Reborn switches remain independent.")
.define("seamless_live_views", true);
SEAMLESS_CRYSTAL_VIEWS = builder.comment(
"Server option: create native live crystal portal surfaces when Seamless is installed.",
"Disabling retains normal portal travel and the animated surface.")
.define("seamless_crystal_live_views", true);
builder.pop();
builder.push("random_pages");
RANDOM_PAGE_ALLOWLIST = builder.comment(
"Page paths allowed in new random Ages and newly generated library pages.",
"Restricts only categories it mentions; other categories remain unrestricted.",
"Example: [\"sky/static\"]; full namespaced IDs are accepted too.")
.defineList("allowlist", java.util.List.<String>of(), () -> "sky/static", PortConfig::validPageId);
RANDOM_PAGE_BLOCKLIST = builder.comment(
"Page paths excluded from new random Ages and newly generated library pages.",
"Blocklist wins. Existing Ages, Creative/JEI pages and manually authored books remain usable.",
"Required empty categories use safe defaults; Native biomes come from the preset, not biome pages.")
.defineList("blocklist", java.util.List.<String>of(), () -> "sky/static", PortConfig::validPageId);
builder.pop();
builder.push("serene_seasons");
AUTO_WHITELIST_SERENE_AGES = builder.comment("Automatically whitelist Ages with seed-selected/legacy cycling seasons. Explicit pages still apply; existing entries are preserved when disabled.")
.define("auto_whitelist_ages", true);
builder.pop();
builder.push("descriptive_books"); builder.push("descriptive_books");
RETURN_LINK_MODE = builder.comment("Controls automatic Return Links for successful Descriptive Book travel.", RETURN_LINK_MODE = builder.comment("Controls automatic Return Links for successful Descriptive Book travel.",
"ON_CREATION issues one on the first arrival per Age/world; ALWAYS issues one each arrival; DISABLED issues none.") "ON_CREATION issues one on the first arrival per Age/world; ALWAYS issues one each arrival; DISABLED issues none.")
@@ -42,5 +81,10 @@ public final class PortConfig {
SPEC = builder.build(); SPEC = builder.build();
} }
private static boolean validPageId(Object value) {
if (!(value instanceof String id)) return false;
try { net.dnorberg.rivencraft.age.PortRandomPagePolicy.parsePageId(id); return true; }
catch (IllegalArgumentException exception) { return false; }
}
private PortConfig() {} private PortConfig() {}
} }
@@ -248,15 +248,25 @@ public final class Rivencraft {
MENUS.register(modEventBus); MENUS.register(modEventBus);
COMPONENTS.register(modEventBus); COMPONENTS.register(modEventBus);
RECIPE_SERIALIZERS.register(modEventBus); RECIPE_SERIALIZERS.register(modEventBus);
net.dnorberg.rivencraft.compat.RuinsCompatibility.register();
net.dnorberg.rivencraft.compat.ImmersiveBookPreviews.register();
ModCreativeTabs.register(modEventBus); ModCreativeTabs.register(modEventBus);
PortBiomeSources.register(modEventBus); PortBiomeSources.register(modEventBus);
PortChunkGenerators.register(modEventBus); PortChunkGenerators.register(modEventBus);
NeoForge.EVENT_BUS.addListener(RuntimeAgeBackend::onLevelLoad); NeoForge.EVENT_BUS.addListener(RuntimeAgeBackend::onLevelLoad);
NeoForge.EVENT_BUS.addListener(net.neoforged.bus.api.EventPriority.LOWEST,
net.dnorberg.rivencraft.compat.ImmersivePortalsCompatibility::onServerStarted);
NeoForge.EVENT_BUS.addListener(net.dnorberg.rivencraft.age.PortAgeWeather::onLevelTickPre); NeoForge.EVENT_BUS.addListener(net.dnorberg.rivencraft.age.PortAgeWeather::onLevelTickPre);
NeoForge.EVENT_BUS.addListener(net.dnorberg.rivencraft.age.PortAcceleratedTicks::onLevelTickPost); NeoForge.EVENT_BUS.addListener(net.dnorberg.rivencraft.age.PortAcceleratedTicks::onLevelTickPost);
NeoForge.EVENT_BUS.addListener(PortAgeCommands::register); NeoForge.EVENT_BUS.addListener(PortAgeCommands::register);
NeoForge.EVENT_BUS.addListener(net.dnorberg.rivencraft.compat.TerraBlenderBiomes::onTagsUpdated);
NeoForge.EVENT_BUS.addListener(net.neoforged.bus.api.EventPriority.LOWEST,
net.dnorberg.rivencraft.compat.TerraBlenderBiomes::onServerAboutToStart);
NeoForge.EVENT_BUS.addListener(net.dnorberg.rivencraft.event.BookStandConversionHandler::onRightClickBlock); NeoForge.EVENT_BUS.addListener(net.dnorberg.rivencraft.event.BookStandConversionHandler::onRightClickBlock);
NeoForge.EVENT_BUS.addListener(AgeCatalogSync::onLogin); NeoForge.EVENT_BUS.addListener(AgeCatalogSync::onLogin);
NeoForge.EVENT_BUS.addListener(net.dnorberg.rivencraft.compat.SereneSeasonsCompatibility::onLevelLoad);
NeoForge.EVENT_BUS.addListener(net.dnorberg.rivencraft.compat.SereneSeasonsCompatibility::onLogin);
NeoForge.EVENT_BUS.addListener(net.dnorberg.rivencraft.compat.SereneSeasonsCompatibility::onLevelTickPost);
NeoForge.EVENT_BUS.addListener(AgeCatalogSync::onLogout); NeoForge.EVENT_BUS.addListener(AgeCatalogSync::onLogout);
NeoForge.EVENT_BUS.addListener(AgeCatalogSync::onServerStopped); NeoForge.EVENT_BUS.addListener(AgeCatalogSync::onServerStopped);
modEventBus.addListener(AgeCatalogSync::registerPayloads); modEventBus.addListener(AgeCatalogSync::registerPayloads);
@@ -13,7 +13,8 @@ import net.minecraft.resources.Identifier;
/** Full server level catalog, sent on login and after a runtime Age is added. */ /** Full server level catalog, sent on login and after a runtime Age is added. */
public record AgeCatalogPayload(int version, List<Identifier> dimensions, public record AgeCatalogPayload(int version, List<Identifier> dimensions,
Map<Identifier, PortAgeColors> colors, Map<Identifier, PortAgeColors> colors,
Map<Identifier, PortDayCycle> dayCycles) implements CustomPacketPayload { Map<Identifier, PortDayCycle> dayCycles,
Map<Identifier, PortAgeDescription> descriptions) implements CustomPacketPayload {
public static final Type<AgeCatalogPayload> TYPE = new Type<>( public static final Type<AgeCatalogPayload> TYPE = new Type<>(
Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, "age_catalog")); Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, "age_catalog"));
public static final StreamCodec<RegistryFriendlyByteBuf, AgeCatalogPayload> STREAM_CODEC = StreamCodec.composite( public static final StreamCodec<RegistryFriendlyByteBuf, AgeCatalogPayload> STREAM_CODEC = StreamCodec.composite(
@@ -21,6 +22,7 @@ public record AgeCatalogPayload(int version, List<Identifier> dimensions,
Identifier.STREAM_CODEC.apply(ByteBufCodecs.list()), AgeCatalogPayload::dimensions, Identifier.STREAM_CODEC.apply(ByteBufCodecs.list()), AgeCatalogPayload::dimensions,
ByteBufCodecs.map(HashMap::new, Identifier.STREAM_CODEC, PortAgeColors.STREAM_CODEC), AgeCatalogPayload::colors, ByteBufCodecs.map(HashMap::new, Identifier.STREAM_CODEC, PortAgeColors.STREAM_CODEC), AgeCatalogPayload::colors,
ByteBufCodecs.map(HashMap::new, Identifier.STREAM_CODEC, PortDayCycle.STREAM_CODEC), AgeCatalogPayload::dayCycles, ByteBufCodecs.map(HashMap::new, Identifier.STREAM_CODEC, PortDayCycle.STREAM_CODEC), AgeCatalogPayload::dayCycles,
ByteBufCodecs.map(HashMap::new, Identifier.STREAM_CODEC, PortAgeDescription.STREAM_CODEC), AgeCatalogPayload::descriptions,
AgeCatalogPayload::new AgeCatalogPayload::new
); );
@@ -28,6 +30,7 @@ public record AgeCatalogPayload(int version, List<Identifier> dimensions,
dimensions = List.copyOf(dimensions); dimensions = List.copyOf(dimensions);
colors = Map.copyOf(colors); colors = Map.copyOf(colors);
dayCycles = Map.copyOf(dayCycles); dayCycles = Map.copyOf(dayCycles);
descriptions = Map.copyOf(descriptions);
} }
@Override @Override
@@ -21,7 +21,7 @@ public final class AgeCatalogSync {
} }
public static void registerPayloads(RegisterPayloadHandlersEvent event) { public static void registerPayloads(RegisterPayloadHandlersEvent event) {
var registrar = event.registrar("10"); var registrar = event.registrar("12");
registrar.playToClient(AgeCatalogPayload.TYPE, AgeCatalogPayload.STREAM_CODEC); registrar.playToClient(AgeCatalogPayload.TYPE, AgeCatalogPayload.STREAM_CODEC);
registrar.playToServer(AgeCatalogAckPayload.TYPE, AgeCatalogAckPayload.STREAM_CODEC, registrar.playToServer(AgeCatalogAckPayload.TYPE, AgeCatalogAckPayload.STREAM_CODEC,
(payload, context) -> { (payload, context) -> {
@@ -55,6 +55,9 @@ public final class AgeCatalogSync {
State state = state(server); State state = state(server);
state.version++; state.version++;
state.acknowledged.clear(); state.acknowledged.clear();
// Optional synchronization failures must not turn a committed Age into a
// reported binding failure. Withhold acknowledgements, so travel stays safe.
if (!net.dnorberg.rivencraft.compat.ImmersivePortalsCompatibility.synchronize(server)) return;
for (ServerPlayer player : server.getPlayerList().getPlayers()) { for (ServerPlayer player : server.getPlayerList().getPlayers()) {
try { try {
send(player); send(player);
@@ -76,9 +79,11 @@ public final class AgeCatalogSync {
MinecraftServer server = player.level().getServer(); MinecraftServer server = player.level().getServer();
State state = state(server); State state = state(server);
state.acknowledged.remove(player.getUUID()); state.acknowledged.remove(player.getUUID());
if (!net.dnorberg.rivencraft.compat.ImmersivePortalsCompatibility.beforeCatalog(player))
throw new IllegalStateException("Optional portal dimension catalog is unavailable");
var dimensions = server.levelKeys().stream().map(key -> key.identifier()).sorted().toList(); var dimensions = server.levelKeys().stream().map(key -> key.identifier()).sorted().toList();
PacketDistributor.sendToPlayer(player, new AgeCatalogPayload(state.version, dimensions, PacketDistributor.sendToPlayer(player, new AgeCatalogPayload(state.version, dimensions,
RuntimeAgeBackend.savedColors(server), RuntimeAgeBackend.savedDayCycles(server))); RuntimeAgeBackend.savedColors(server), RuntimeAgeBackend.savedDayCycles(server), RuntimeAgeBackend.loadedDescriptions(server)));
} }
private static void acknowledge(ServerPlayer player, int version) { private static void acknowledge(ServerPlayer player, int version) {
@@ -182,8 +182,15 @@ final class AgeLevelIndex extends SavedData {
setDirty(); setDirty();
} }
void retire(Identifier id) { /** Failed creation is not retirement: release the new identity for a clean retry. */
if (ages.remove(id) == null) throw new IllegalArgumentException("Age not indexed: " + id); void discardCreation(Identifier id) {
if (retired.contains(id)) throw new IllegalArgumentException("Cannot discard a retired Age: " + id);
removeActive(id);
displayNames.remove(id);
setDirty();
}
private void removeActive(Identifier id) {
ages.remove(id);
biomeOverrides.remove(id); biomeOverrides.remove(id);
biomePlans.remove(id); biomePlans.remove(id);
terrain.remove(id); terrain.remove(id);
@@ -196,6 +203,10 @@ final class AgeLevelIndex extends SavedData {
sky.remove(id); sky.remove(id);
colors.remove(id); colors.remove(id);
dayCycles.remove(id); dayCycles.remove(id);
}
void retire(Identifier id) {
if (!ages.containsKey(id)) throw new IllegalArgumentException("Age not indexed: " + id);
removeActive(id);
retired.add(id); retired.add(id);
setDirty(); setDirty();
} }
@@ -3,6 +3,7 @@ package net.dnorberg.rivencraft.age;
import com.mojang.serialization.Codec; import com.mojang.serialization.Codec;
import com.mojang.serialization.codecs.RecordCodecBuilder; import com.mojang.serialization.codecs.RecordCodecBuilder;
import java.util.List; import java.util.List;
import net.dnorberg.rivencraft.shared.StaticSkyResolution;
import java.util.Map; import java.util.Map;
import java.util.Random; import java.util.Random;
import net.minecraft.network.RegistryFriendlyByteBuf; import net.minecraft.network.RegistryFriendlyByteBuf;
@@ -14,26 +15,33 @@ import org.joml.Vector3f;
import org.joml.Vector3fc; import org.joml.Vector3fc;
/** Frozen shared-color writing, adapted from 1.21.1 AgeSkyProfile. -1 means native. */ /** Frozen shared-color writing, adapted from 1.21.1 AgeSkyProfile. -1 means native. */
public record PortAgeColors(int sky, int ambient, int celestial) { public record PortAgeColors(int sky, int ambient, int celestial, int staticResolution) {
public static final PortAgeColors NATIVE = new PortAgeColors(-1, -1); public static final PortAgeColors NATIVE = new PortAgeColors(-1, -1);
public static final Codec<PortAgeColors> CODEC = RecordCodecBuilder.create(instance -> instance.group( public static final Codec<PortAgeColors> CODEC = RecordCodecBuilder.create(instance -> instance.group(
Codec.intRange(-1, 0xffffff).fieldOf("sky").forGetter(PortAgeColors::sky), Codec.intRange(-1, 0xffffff).fieldOf("sky").forGetter(PortAgeColors::sky),
Codec.intRange(-1, 0xffffff).fieldOf("ambient").forGetter(PortAgeColors::ambient), Codec.intRange(-1, 0xffffff).fieldOf("ambient").forGetter(PortAgeColors::ambient),
Codec.intRange(-1, 0xffffff).optionalFieldOf("celestial", -1).forGetter(PortAgeColors::celestial) Codec.intRange(-1, 0xffffff).optionalFieldOf("celestial", -1).forGetter(PortAgeColors::celestial),
Codec.intRange(StaticSkyResolution.MIN, StaticSkyResolution.MAX)
.optionalFieldOf("static_resolution", StaticSkyResolution.DEFAULT).forGetter(PortAgeColors::staticResolution)
).apply(instance, PortAgeColors::new)); ).apply(instance, PortAgeColors::new));
public static final StreamCodec<RegistryFriendlyByteBuf, PortAgeColors> STREAM_CODEC = StreamCodec.composite( public static final StreamCodec<RegistryFriendlyByteBuf, PortAgeColors> STREAM_CODEC = StreamCodec.composite(
ByteBufCodecs.INT, PortAgeColors::sky, ByteBufCodecs.INT, PortAgeColors::ambient, ByteBufCodecs.INT, PortAgeColors::sky, ByteBufCodecs.INT, PortAgeColors::ambient,
ByteBufCodecs.INT, PortAgeColors::celestial, PortAgeColors::new); ByteBufCodecs.INT, PortAgeColors::celestial,
ByteBufCodecs.VAR_INT, PortAgeColors::staticResolution, PortAgeColors::new);
public static final Identifier AMBIENT = Identifier.fromNamespaceAndPath("rivencraft", "lighting/ambient_color"); public static final Identifier AMBIENT = Identifier.fromNamespaceAndPath("rivencraft", "lighting/ambient_color");
private static volatile Map<Identifier, PortAgeColors> clientColors = Map.of(); private static volatile Map<Identifier, PortAgeColors> clientColors = Map.of();
public PortAgeColors { public PortAgeColors {
staticResolution = StaticSkyResolution.clamp(staticResolution);
if (sky < -1 || sky > 0xffffff || ambient < -1 || ambient > 0xffffff if (sky < -1 || sky > 0xffffff || ambient < -1 || ambient > 0xffffff
|| celestial < -1 || celestial > 0xffffff) || celestial < -1 || celestial > 0xffffff)
throw new IllegalArgumentException("Invalid Age color"); throw new IllegalArgumentException("Invalid Age color");
} }
public PortAgeColors(int sky, int ambient) { this(sky, ambient, -1); } public PortAgeColors(int sky, int ambient) { this(sky, ambient, -1); }
public PortAgeColors(int sky, int ambient, int celestial) {
this(sky, ambient, celestial, StaticSkyResolution.DEFAULT);
}
public static void updateClient(Map<Identifier, PortAgeColors> colors) { clientColors = Map.copyOf(colors); } public static void updateClient(Map<Identifier, PortAgeColors> colors) { clientColors = Map.copyOf(colors); }
@@ -60,11 +68,17 @@ public record PortAgeColors(int sky, int ambient, int celestial) {
public static boolean isModifier(Identifier page) { return isColor(page) || number(page) >= 0 || page.equals(AMBIENT); } public static boolean isModifier(Identifier page) { return isColor(page) || number(page) >= 0 || page.equals(AMBIENT); }
public static boolean validNumbers(List<Identifier> pages) { public static boolean validNumbers(List<Identifier> pages) {
for (int i = 0; i < pages.size(); i++) for (int i = 0; i < pages.size(); i++) {
if (number(pages.get(i)) >= 0 && (i + 1 == pages.size() if (number(pages.get(i)) < 0) continue;
|| !isColor(pages.get(i + 1)) && !PortDayCycle.isPeriod(pages.get(i + 1)) int next = i + 1;
&& !PortDayCycle.isPhase(pages.get(i + 1)) && !PortDayCycle.isAngle(pages.get(i + 1)) while (next < pages.size() && number(pages.get(next)) >= 0) next++;
&& !PortDayCycle.isSize(pages.get(i + 1)))) return false; if (next < pages.size() && (pages.get(next).equals(PortStaticSkyResolution.PAGE)
|| pages.get(next).equals(PortFlooding.PAGE))) continue;
if (i + 1 >= pages.size()) return false;
Identifier target = pages.get(i + 1);
if (!isColor(target) && !PortDayCycle.isPeriod(target) && !PortDayCycle.isPhase(target)
&& !PortDayCycle.isAngle(target) && !PortDayCycle.isSize(target)) return false;
}
return true; return true;
} }
@@ -101,7 +115,7 @@ public record PortAgeColors(int sky, int ambient, int celestial) {
} }
} }
if (written) sky = clamp(red) << 16 | clamp(green) << 8 | clamp(blue); if (written) sky = clamp(red) << 16 | clamp(green) << 8 | clamp(blue);
return new PortAgeColors(sky, ambient, celestial); return new PortAgeColors(sky, ambient, celestial, PortStaticSkyResolution.compile(pages));
} }
/** Only pageless random Ages receive a random sky tint, as in 1.21.1. */ /** Only pageless random Ages receive a random sky tint, as in 1.21.1. */
@@ -46,7 +46,7 @@ public final class PortAgeCommands {
StringBuilder mods = new StringBuilder("Optional mods: "); StringBuilder mods = new StringBuilder("Optional mods: ");
for (String id : new String[]{"jei", "terrablender", "biomesoplenty", for (String id : new String[]{"jei", "terrablender", "biomesoplenty",
"sereneseasons", "glitchcore", "ruins", "create", "sereneseasons", "glitchcore", "ruins", "create",
"ponder", "immersive_portals_core"}) { "ponder", "immersive_portals_core", "seamlessportals", "immersive_portals_reborn"}) {
if (mods.length() > "Optional mods: ".length()) mods.append(", "); if (mods.length() > "Optional mods: ".length()) mods.append(", ");
mods.append(id).append('=').append(ModList.get().isLoaded(id)); mods.append(id).append('=').append(ModList.get().isLoaded(id));
} }
@@ -1777,7 +1777,7 @@ public final class PortAgeCommands {
private static void verifyCatalogRoundTrip(net.minecraft.server.MinecraftServer server) { private static void verifyCatalogRoundTrip(net.minecraft.server.MinecraftServer server) {
var payload = new AgeCatalogPayload(1, server.levelKeys().stream().map(key -> key.identifier()).toList(), var payload = new AgeCatalogPayload(1, server.levelKeys().stream().map(key -> key.identifier()).toList(),
RuntimeAgeBackend.savedColors(server), RuntimeAgeBackend.savedDayCycles(server)); RuntimeAgeBackend.savedColors(server), RuntimeAgeBackend.savedDayCycles(server), RuntimeAgeBackend.loadedDescriptions(server));
var buffer = new net.minecraft.network.RegistryFriendlyByteBuf(io.netty.buffer.Unpooled.buffer(), var buffer = new net.minecraft.network.RegistryFriendlyByteBuf(io.netty.buffer.Unpooled.buffer(),
server.registryAccess(), net.neoforged.neoforge.network.connection.ConnectionType.NEOFORGE); server.registryAccess(), net.neoforged.neoforge.network.connection.ConnectionType.NEOFORGE);
try { try {
@@ -0,0 +1,24 @@
package net.dnorberg.rivencraft.age;
import java.util.Map;
import net.minecraft.network.RegistryFriendlyByteBuf;
import net.minecraft.network.codec.ByteBufCodecs;
import net.minecraft.network.codec.StreamCodec;
import net.minecraft.resources.Identifier;
/** Public presentation only: no seed, instability score or provider information. */
public record PortAgeDescription(PortAgeTerrain terrain, PortBiomePlan.Distribution distribution,
PortLighting lighting, PortWeatherMode weather) {
public static final StreamCodec<RegistryFriendlyByteBuf, PortAgeDescription> STREAM_CODEC = StreamCodec.composite(
ByteBufCodecs.STRING_UTF8.map(PortAgeTerrain::valueOf, PortAgeTerrain::name), PortAgeDescription::terrain,
ByteBufCodecs.STRING_UTF8.map(PortBiomePlan.Distribution::valueOf, PortBiomePlan.Distribution::name), PortAgeDescription::distribution,
ByteBufCodecs.STRING_UTF8.map(PortLighting::valueOf, PortLighting::name), PortAgeDescription::lighting,
ByteBufCodecs.STRING_UTF8.map(PortWeatherMode::valueOf, PortWeatherMode::name), PortAgeDescription::weather,
PortAgeDescription::new);
private static volatile Map<Identifier, PortAgeDescription> clientDescriptions = Map.of();
public static void updateClient(Map<Identifier, PortAgeDescription> descriptions) {
clientDescriptions = Map.copyOf(descriptions);
}
public static PortAgeDescription forClient(Identifier id) { return clientDescriptions.get(id); }
}
@@ -51,6 +51,8 @@ final class PortAgeLevel extends ServerLevel {
return ageWeather == null ? super.getWeatherData() : ageWeather; return ageWeather == null ? super.getWeatherData() : ageWeather;
} }
boolean caveTerrain() { return cave; }
PortWeatherMode weatherMode() { return cave ? PortWeatherMode.OFF : weatherSettings.mode(); } PortWeatherMode weatherMode() { return cave ? PortWeatherMode.OFF : weatherSettings.mode(); }
void configureWeather(PortWeatherMode mode) { void configureWeather(PortWeatherMode mode) {
@@ -1,5 +1,7 @@
package net.dnorberg.rivencraft.age; package net.dnorberg.rivencraft.age;
import net.dnorberg.rivencraft.shared.FloodingRules;
import java.util.Set; import java.util.Set;
import net.dnorberg.rivencraft.Rivencraft; import net.dnorberg.rivencraft.Rivencraft;
import net.minecraft.core.BlockPos; import net.minecraft.core.BlockPos;
@@ -36,10 +38,14 @@ public final class PortAgeTravel {
public static BlockPos resolveLanding(ServerLevel target) { return resolveLanding(target, true); } public static BlockPos resolveLanding(ServerLevel target) { return resolveLanding(target, true); }
public static BlockPos resolveLanding(ServerLevel target, net.minecraft.world.entity.Entity entity, public static BlockPos resolveLanding(ServerLevel target, net.minecraft.world.entity.Entity entity,
net.dnorberg.rivencraft.item.LinkProperties properties) { net.dnorberg.rivencraft.item.LinkProperties properties) {
return resolveLanding(target, (ServerLevel) entity.level(), entity.blockPosition(), properties);
}
public static BlockPos resolveLanding(ServerLevel target, ServerLevel source, BlockPos departure,
net.dnorberg.rivencraft.item.LinkProperties properties) {
BlockPos landing = resolveLanding(target, !properties.has(net.dnorberg.rivencraft.item.LinkProperties.DISABLE_PLATFORM)); BlockPos landing = resolveLanding(target, !properties.has(net.dnorberg.rivencraft.item.LinkProperties.DISABLE_PLATFORM));
if (landing == null || !properties.has(net.dnorberg.rivencraft.item.LinkProperties.RELATIVE_LINK)) return landing; if (landing == null || !properties.has(net.dnorberg.rivencraft.item.LinkProperties.RELATIVE_LINK)) return landing;
return findFootedDestination(target, net.dnorberg.rivencraft.item.PortLinkDestinations.relativeOrigin( return findFootedDestination(target, net.dnorberg.rivencraft.item.PortLinkDestinations.relativeOrigin(
(ServerLevel) entity.level(), target, entity.blockPosition())).orElse(null); source, target, departure)).orElse(null);
} }
public static BlockPos resolveLanding(ServerLevel target, boolean generatePlatform) { public static BlockPos resolveLanding(ServerLevel target, boolean generatePlatform) {
boolean fissure = target.getChunkSource().getGenerator() instanceof PortFeatureChunkGenerator features boolean fissure = target.getChunkSource().getGenerator() instanceof PortFeatureChunkGenerator features
@@ -72,14 +78,18 @@ public final class PortAgeTravel {
} }
} }
} }
return generatePlatform ? makePlatform(target, new BlockPos(0, 64, 0)) : null; return generatePlatform ? makePlatform(target, new BlockPos(0, fallbackFeet(target), 0)) : null;
} }
BlockPos surface = findSurfaceLanding(target, 0, 0); BlockPos surface = findSurfaceLanding(target, 0, 0);
if (surface != null) return surface; if (surface != null) return surface;
// Only build above the actual highest obstruction, never in a pocket // Only build above the actual highest obstruction, never in a pocket
// beneath it. Void Ages retain the usual platform floor at Y=63. // beneath it. Void Ages retain the usual platform floor at Y=63.
BlockPos obstruction = highestObstruction(target, 0, 0); BlockPos obstruction = highestObstruction(target, 0, 0);
int y = obstruction == null ? 64 : Math.max(64, obstruction.getY() + 3); boolean flooded = target.getChunkSource().getGenerator() instanceof PortFeatureChunkGenerator features
&& features.floodSurface() != FloodingRules.NONE;
int clearance = flooded && obstruction != null && !target.getFluidState(obstruction).isEmpty() ? 2 : 3;
int y = obstruction == null ? fallbackFeet(target)
: Math.max(fallbackFeet(target), obstruction.getY() + clearance);
return generatePlatform ? makePlatform(target, new BlockPos(0, y, 0)) : null; return generatePlatform ? makePlatform(target, new BlockPos(0, y, 0)) : null;
} }
@@ -120,6 +130,12 @@ public final class PortAgeTravel {
.value().noiseSettings()); .value().noiseSettings());
} }
private static int fallbackFeet(ServerLevel target) {
int requested = target.getChunkSource().getGenerator() instanceof PortFeatureChunkGenerator features
? features.floodSurface() : FloodingRules.NONE;
return FloodingRules.platformFloor(requested, target.getMinY(), target.getMaxY()) + 1;
}
private static BlockPos makePlatform(ServerLevel target, BlockPos foot) { private static BlockPos makePlatform(ServerLevel target, BlockPos foot) {
if (foot.getY() <= target.getMinY() || foot.getY() + 2 >= target.getMaxY()) return null; if (foot.getY() <= target.getMinY() || foot.getY() + 2 >= target.getMaxY()) return null;
// A carved pocket inside a flooded cave immediately refills. Refuse // A carved pocket inside a flooded cave immediately refills. Refuse
@@ -16,12 +16,18 @@ final class PortBiomeMaterialRules {
static Holder<NoiseGeneratorSettings> apply(HolderLookup.Provider registries, NoiseGeneratorSettings base) { static Holder<NoiseGeneratorSettings> apply(HolderLookup.Provider registries, NoiseGeneratorSettings base) {
var biomes = registries.lookupOrThrow(Registries.BIOME); var biomes = registries.lookupOrThrow(Registries.BIOME);
var rules = registries.lookupOrThrow(Registries.MATERIAL_RULE); var rules = registries.lookupOrThrow(Registries.MATERIAL_RULE);
var nether = java.util.stream.Stream.concat(java.util.stream.Stream.of(Biomes.NETHER_WASTES,
Biomes.SOUL_SAND_VALLEY, Biomes.CRIMSON_FOREST, Biomes.WARPED_FOREST, Biomes.BASALT_DELTAS),
net.dnorberg.rivencraft.compat.TerraBlenderBiomes.nether(registries).stream()
.map(id -> net.minecraft.resources.ResourceKey.create(Registries.BIOME, id)))
.distinct().toList();
@SuppressWarnings("unchecked")
net.minecraft.resources.ResourceKey<net.minecraft.world.level.biome.Biome>[] netherKeys = nether.toArray(net.minecraft.resources.ResourceKey[]::new);
var materials = MaterialRules.sequence( var materials = MaterialRules.sequence(
MaterialRules.ifTrue(MaterialRules.isBiome(biomes, Biomes.THE_END, Biomes.END_HIGHLANDS, MaterialRules.ifTrue(MaterialRules.isBiome(biomes, Biomes.THE_END, Biomes.END_HIGHLANDS,
Biomes.END_MIDLANDS, Biomes.SMALL_END_ISLANDS, Biomes.END_BARRENS), Biomes.END_MIDLANDS, Biomes.SMALL_END_ISLANDS, Biomes.END_BARRENS),
MaterialRules.getRule(rules, EndMaterialRules.END)), MaterialRules.getRule(rules, EndMaterialRules.END)),
MaterialRules.ifTrue(MaterialRules.isBiome(biomes, Biomes.NETHER_WASTES, Biomes.SOUL_SAND_VALLEY, MaterialRules.ifTrue(MaterialRules.isBiome(biomes, netherKeys),
Biomes.CRIMSON_FOREST, Biomes.WARPED_FOREST, Biomes.BASALT_DELTAS),
MaterialRules.getRule(rules, NetherMaterialRules.NETHER)), MaterialRules.getRule(rules, NetherMaterialRules.NETHER)),
base.materialRule().value()); base.materialRule().value());
return Holder.direct(new NoiseGeneratorSettings(base.noiseSettings(), base.defaultBlock(), base.defaultFluid(), return Holder.direct(new NoiseGeneratorSettings(base.noiseSettings(), base.defaultBlock(), base.defaultFluid(),
@@ -3,19 +3,29 @@ package net.dnorberg.rivencraft.age;
import com.mojang.serialization.Codec; import com.mojang.serialization.Codec;
import com.mojang.serialization.codecs.RecordCodecBuilder; import com.mojang.serialization.codecs.RecordCodecBuilder;
import java.util.List; import java.util.List;
import net.dnorberg.rivencraft.shared.NativeBiomeKind;
import net.minecraft.resources.Identifier; import net.minecraft.resources.Identifier;
/** Frozen biome choice; Native may carry an explicit Cave pool. Repeats retain weight. */ /** Frozen biome choice; Native may carry an explicit Cave pool. Repeats retain weight. */
public record PortBiomePlan(Distribution distribution, List<Identifier> biomes) { public record PortBiomePlan(Distribution distribution, List<Identifier> biomes, NativeBiomeKind nativeKind) {
public enum Distribution { NATIVE, SINGLE, TILED, GRID, TINY, SMALL, MEDIUM, LARGE, HUGE } public enum Distribution { NATIVE, SINGLE, TILED, GRID, TINY, SMALL, MEDIUM, LARGE, HUGE }
public static final Codec<PortBiomePlan> CODEC = RecordCodecBuilder.create(instance -> instance.group( public static final Codec<PortBiomePlan> CODEC = RecordCodecBuilder.create(instance -> instance.group(
Codec.STRING.xmap(Distribution::valueOf, Distribution::name).fieldOf("distribution") Codec.STRING.xmap(Distribution::valueOf, Distribution::name).fieldOf("distribution")
.forGetter(PortBiomePlan::distribution), .forGetter(PortBiomePlan::distribution),
Identifier.CODEC.listOf().fieldOf("biomes").forGetter(PortBiomePlan::biomes) Identifier.CODEC.listOf().fieldOf("biomes").forGetter(PortBiomePlan::biomes),
Codec.STRING.xmap(NativeBiomeKind::valueOf, NativeBiomeKind::name)
.optionalFieldOf("native_kind", NativeBiomeKind.TERRAIN).forGetter(PortBiomePlan::nativeKind)
).apply(instance, PortBiomePlan::new)); ).apply(instance, PortBiomePlan::new));
public PortBiomePlan(Distribution distribution, List<Identifier> biomes) {
this(distribution, biomes, NativeBiomeKind.TERRAIN);
}
public PortBiomePlan { public PortBiomePlan {
java.util.Objects.requireNonNull(nativeKind, "nativeKind");
if (nativeKind != NativeBiomeKind.TERRAIN && (distribution != Distribution.NATIVE || biomes.isEmpty()))
throw new IllegalArgumentException("A native family requires a nonempty Native pool");
biomes = List.copyOf(biomes); biomes = List.copyOf(biomes);
if (distribution == null || distribution == Distribution.SINGLE && biomes.size() != 1 if (distribution == null || distribution == Distribution.SINGLE && biomes.size() != 1
|| distribution != Distribution.NATIVE && distribution != Distribution.SINGLE && biomes.size() < 2) || distribution != Distribution.NATIVE && distribution != Distribution.SINGLE && biomes.size() < 2)
@@ -144,6 +144,10 @@ public record PortDayCycle(boolean authored, double period, int stoppedTime,
/** Creation-only completion. Exact diagnostic fixtures can still use compile. */ /** Creation-only completion. Exact diagnostic fixtures can still use compile. */
public static PortDayCycle resolve(List<Identifier> pages, long seed, long nativeTicks) { public static PortDayCycle resolve(List<Identifier> pages, long seed, long nativeTicks) {
return resolve(pages, seed, nativeTicks, PortRandomPagePolicy.UNRESTRICTED);
}
public static PortDayCycle resolve(List<Identifier> pages, long seed, long nativeTicks, PortRandomPagePolicy policy) {
if (!validWriting(pages)) if (!validWriting(pages))
throw new IllegalArgumentException("An Age may have at most ten suns and ten moons"); throw new IllegalArgumentException("An Age may have at most ten suns and ten moons");
if (pages.stream().anyMatch(PortDayCycle::isController)) return compile(pages, seed, nativeTicks); if (pages.stream().anyMatch(PortDayCycle::isController)) return compile(pages, seed, nativeTicks);
@@ -152,7 +156,8 @@ public record PortDayCycle(boolean authored, double period, int stoppedTime,
var random = new Random(seed ^ 0x534B5950524F464CL); var random = new Random(seed ^ 0x534B5950524F464CL);
random.nextInt(5); random.nextInt(5);
randomColor(random); randomColor(random);
int suns = random.nextInt(4), moons = random.nextInt(4); int suns = policy.allows(Identifier.parse("rivencraft:celestial/sun")) ? random.nextInt(4) : 0;
int moons = policy.allows(Identifier.parse("rivencraft:celestial/moon")) ? random.nextInt(4) : 0;
var bodies = new java.util.ArrayList<PortCelestialBody>(); var bodies = new java.util.ArrayList<PortCelestialBody>();
for (int i = 0; i < suns + moons; i++) for (int i = 0; i < suns + moons; i++)
bodies.addAll(randomUnmodified(seed, i, nativeTicks, i < suns ? SUN : MOON).bodies); bodies.addAll(randomUnmodified(seed, i, nativeTicks, i < suns ? SUN : MOON).bodies);
@@ -309,6 +314,8 @@ public record PortDayCycle(boolean authored, double period, int stoppedTime,
net.minecraft.core.registries.Registries.WORLD_CLOCK).getOrThrow(WorldClocks.OVERWORLD)).totalTicks(); net.minecraft.core.registries.Registries.WORLD_CLOCK).getOrThrow(WorldClocks.OVERWORLD)).totalTicks();
} }
public static PortDayCycle forClient(Identifier id) { return clientCycles.getOrDefault(id, NATIVE); }
public static void updateClient(Map<Identifier, PortDayCycle> cycles) { clientCycles = Map.copyOf(cycles); } public static void updateClient(Map<Identifier, PortDayCycle> cycles) { clientCycles = Map.copyOf(cycles); }
public static PortDayCycle forLevel(Level level) { public static PortDayCycle forLevel(Level level) {
if (level instanceof PortAgeLevel age) return age.dayCycle(); if (level instanceof PortAgeLevel age) return age.dayCycle();
@@ -1,6 +1,5 @@
package net.dnorberg.rivencraft.age; package net.dnorberg.rivencraft.age;
import java.util.Arrays;
import java.util.List; import java.util.List;
import java.util.Random; import java.util.Random;
import net.minecraft.resources.Identifier; import net.minecraft.resources.Identifier;
@@ -8,21 +7,28 @@ import net.minecraft.resources.Identifier;
/** Seed-completes missing environment controllers once, before an Age is saved. */ /** Seed-completes missing environment controllers once, before an Age is saved. */
public record PortEnvironmentSelection(PortWeatherMode weather, PortLighting lighting, PortSkyStyle sky) { public record PortEnvironmentSelection(PortWeatherMode weather, PortLighting lighting, PortSkyStyle sky) {
public static PortEnvironmentSelection resolve(List<Identifier> pages, long seed, PortAgeTerrain terrain) { public static PortEnvironmentSelection resolve(List<Identifier> pages, long seed, PortAgeTerrain terrain) {
PortLighting lighting = pages.stream().map(PortLighting::forPage).filter(java.util.Objects::nonNull) return resolve(pages, seed, terrain, PortRandomPagePolicy.UNRESTRICTED);
.findFirst().orElseGet(() -> rankedDefault(new Random(seed ^ 0x4C49474854494E47L), PortLighting.values()));
PortWeatherMode weather = terrain == PortAgeTerrain.CAVE ? PortWeatherMode.OFF
: pages.stream().map(PortWeatherMode::forPage).filter(java.util.Objects::nonNull)
.findFirst().orElseGet(() -> rankedDefault(new Random(seed ^ 0x574541544845525FL), PortWeatherMode.values()));
return new PortEnvironmentSelection(weather, lighting, PortSkyStyle.resolve(pages, seed));
} }
private static <T> T rankedDefault(Random random, T[] choices) { public static PortEnvironmentSelection resolve(List<Identifier> pages, long seed, PortAgeTerrain terrain,
PortRandomPagePolicy policy) {
PortLighting lighting = pages.stream().map(PortLighting::forPage).filter(java.util.Objects::nonNull)
.findFirst().orElseGet(() -> rankedDefault(new Random(seed ^ 0x4C49474854494E47L), PortLighting.values(), "lighting", policy));
PortWeatherMode weather = terrain == PortAgeTerrain.CAVE ? PortWeatherMode.OFF
: pages.stream().map(PortWeatherMode::forPage).filter(java.util.Objects::nonNull)
.findFirst().orElseGet(() -> rankedDefault(new Random(seed ^ 0x574541544845525FL), PortWeatherMode.values(), "weather", policy));
return new PortEnvironmentSelection(weather, lighting, PortSkyStyle.resolve(pages, seed, policy));
}
private static <T extends Enum<T>> T rankedDefault(Random random, T[] choices, String category, PortRandomPagePolicy policy) {
// LegacyRankChoice: the first (Normal) option is rank 1, the rest rank 2. // LegacyRankChoice: the first (Normal) option is rank 1, the rest rank 2.
// Its rank-1 weight is the complete rare group plus one. Derive this // Its rank-1 weight is the complete rare group plus one. Derive this
// from the supported pool, rather than selecting unported weather. // from the supported pool, rather than selecting unported weather.
int[] weights = new int[choices.length]; var options = new java.util.ArrayList<PortRankedChoice.Option<T>>();
Arrays.fill(weights, 1); for (int i = 0; i < choices.length; i++)
weights[0] = choices.length; options.add(new PortRankedChoice.Option<>(choices[i], i == 0 ? 1 : 2));
return PortRandomAgeSelection.weighted(random, List.of(choices), weights); return PortRankedChoice.choose(random, policy.required(options,
option -> PortRandomPagePolicy.page(category, option.value()),
new PortRankedChoice.Option<>(choices[0], 1)));
} }
} }
@@ -86,6 +86,7 @@ public final class PortFeatureChunkGenerator extends ChunkGenerator {
private final long ageSeed; private final long ageSeed;
private final boolean libraries; private final boolean libraries;
private final List<Identifier> librarySymbols; private final List<Identifier> librarySymbols;
private final int floodSurface;
public PortFeatureChunkGenerator(ChunkGenerator base, PortRockPlan rocks, public PortFeatureChunkGenerator(ChunkGenerator base, PortRockPlan rocks,
PortVegetationPlan vegetation, int dungeons, PortLakePlan lakes, PortVegetationPlan vegetation, int dungeons, PortLakePlan lakes,
@@ -107,8 +108,10 @@ public final class PortFeatureChunkGenerator extends ChunkGenerator {
this.ageSeed = ageSeed; this.ageSeed = ageSeed;
this.libraries = libraries; this.libraries = libraries;
this.librarySymbols = List.copyOf(librarySymbols); this.librarySymbols = List.copyOf(librarySymbols);
this.floodSurface = PortFlooding.requested(librarySymbols);
} }
public int floodSurface() { return floodSurface; }
public ChunkGenerator base() { return base; } public ChunkGenerator base() { return base; }
public PortRockPlan rocks() { return rocks; } public PortRockPlan rocks() { return rocks; }
public PortVegetationPlan vegetation() { return vegetation; } public PortVegetationPlan vegetation() { return vegetation; }
@@ -289,6 +292,14 @@ public final class PortFeatureChunkGenerator extends ChunkGenerator {
PortShelfMushrooms.decorate(level, chunk, mushroomHosts, random); PortShelfMushrooms.decorate(level, chunk, mushroomHosts, random);
continue; continue;
} }
if (page.equals(PortVegetationPlan.FLOWERS) || page.equals(PortVegetationPlan.TREES)
|| page.equals(PortVegetationPlan.HUGE_TREES)) {
PortSurfaceVegetation.place(level, this, chunk,
page.getPath().substring("feature/".length()),
PortVegetationPlan.placedFeature(page), random);
if (PortVegetationPlan.addsLogs(page)) mushroomHosts = null;
continue;
}
if (!surfaceBiome) continue; if (!surfaceBiome) continue;
Identifier placedId = PortVegetationPlan.placedFeature(page); Identifier placedId = PortVegetationPlan.placedFeature(page);
PlacedFeature vanilla = registry.getOrThrow( PlacedFeature vanilla = registry.getOrThrow(
@@ -300,5 +311,6 @@ public final class PortFeatureChunkGenerator extends ChunkGenerator {
} }
} }
if (libraries) PortLibraryFeature.generate(level, chunk, ageSeed, librarySymbols); if (libraries) PortLibraryFeature.generate(level, chunk, ageSeed, librarySymbols);
PortFlooding.apply(chunk, floodSurface);
} }
} }
@@ -0,0 +1,45 @@
package net.dnorberg.rivencraft.age;
import java.util.List;
import net.dnorberg.rivencraft.shared.FloodingRules;
import net.minecraft.core.BlockPos;
import net.minecraft.resources.Identifier;
import net.minecraft.tags.FluidTags;
import net.minecraft.world.level.block.Blocks;
import net.minecraft.world.level.block.state.properties.BlockStateProperties;
import net.minecraft.world.level.chunk.ChunkAccess;
public final class PortFlooding {
public static final Identifier PAGE = Identifier.fromNamespaceAndPath("rivencraft", "environment/flooded");
private PortFlooding() {}
public static int requested(List<Identifier> pages) {
return FloodingRules.requested(pages.stream().map(page -> {
if (page.equals(PAGE)) return FloodingRules.FLOODED;
if (page.getNamespace().equals("rivencraft") && page.getPath().startsWith("number/")) {
try {
int digit = Integer.parseInt(page.getPath().substring(7));
if (digit >= 0 && digit <= 24) return digit;
} catch (NumberFormatException ignored) { }
}
return FloodingRules.OTHER;
}).toList());
}
public static void apply(ChunkAccess chunk, int requested) {
int surface = FloodingRules.surface(requested, chunk.getMinY(), chunk.getMaxY());
if (surface == FloodingRules.NONE) return;
BlockPos.MutableBlockPos pos = new BlockPos.MutableBlockPos();
int startX = chunk.getPos().getMinBlockX(), startZ = chunk.getPos().getMinBlockZ();
for (int x = 0; x < 16; x++) for (int z = 0; z < 16; z++) {
for (int y = chunk.getMinY(); y < chunk.getMaxY(); y++) {
pos.set(startX + x, y, startZ + z);
var state = chunk.getBlockState(pos);
if (y <= surface && state.isAir())
chunk.setBlockState(pos, Blocks.WATER.defaultBlockState());
else if (state.hasProperty(BlockStateProperties.WATERLOGGED))
chunk.setBlockState(pos, state.setValue(BlockStateProperties.WATERLOGGED, y <= surface));
else if (y > surface && state.getFluidState().is(FluidTags.WATER))
chunk.setBlockState(pos, Blocks.AIR.defaultBlockState());
}
}
}
}
@@ -42,6 +42,11 @@ public final class PortInstabilityData extends SavedData {
private final Map<Identifier, Age> ages = new HashMap<>(); private final Map<Identifier, Age> ages = new HashMap<>();
private PortInstabilityData(Map<Identifier, Age> values) { ages.putAll(values); } private PortInstabilityData(Map<Identifier, Age> values) { ages.putAll(values); }
public static PortInstabilityData get(MinecraftServer server) { return server.overworld().getDataStorage().computeIfAbsent(TYPE); } public static PortInstabilityData get(MinecraftServer server) { return server.overworld().getDataStorage().computeIfAbsent(TYPE); }
Age snapshot(Identifier id) { return ages.get(id); }
void restore(Identifier id, Age snapshot) {
if (snapshot == null) ages.remove(id); else ages.put(id, snapshot);
setDirty();
}
public Age age(ServerLevel level) { public Age age(ServerLevel level) {
Age age = ages.get(level.dimension().identifier()); Age age = ages.get(level.dimension().identifier());
return age != null ? age : new Age(level.getSeed(), return age != null ? age : new Age(level.getSeed(),
@@ -90,6 +95,10 @@ public final class PortInstabilityData extends SavedData {
|| PortDayCycle.isController(page) || PortDayCycle.isPeriod(page) || PortDayCycle.isController(page) || PortDayCycle.isPeriod(page)
|| PortDayCycle.isPhase(page) || PortDayCycle.isAngle(page) || PortDayCycle.isDirection(page))) || PortDayCycle.isPhase(page) || PortDayCycle.isAngle(page) || PortDayCycle.isDirection(page)))
costs.add(new Contribution("cave_ignored_" + path.replace('/', '_'), i, 100)); costs.add(new Contribution("cave_ignored_" + path.replace('/', '_'), i, 100));
if (net.dnorberg.rivencraft.compat.RuinsTemplatePages.isSymbol(page)) {
if (structures.merge(page, 1, Integer::sum) > 3)
costs.add(new Contribution("excess_" + path, i, 100));
}
if (PortStructurePages.supports(page)) { if (PortStructurePages.supports(page)) {
int count = structures.merge(page, 1, Integer::sum); int count = structures.merge(page, 1, Integer::sum);
if (count > 3) costs.add(new Contribution("excess_" + path, i, 100)); if (count > 3) costs.add(new Contribution("excess_" + path, i, 100));
@@ -333,9 +333,14 @@ public final class PortLibraryFeature {
} }
static List<Identifier> symbolsForLoot(List<Identifier> ageSymbols, PortConfig.LibraryLootMode mode) { static List<Identifier> symbolsForLoot(List<Identifier> ageSymbols, PortConfig.LibraryLootMode mode) {
return symbolsForLoot(ageSymbols, mode, PortRandomPagePolicy.configured());
}
static List<Identifier> symbolsForLoot(List<Identifier> ageSymbols, PortConfig.LibraryLootMode mode,
PortRandomPagePolicy policy) {
return mode == PortConfig.LibraryLootMode.AGE_ONLY return mode == PortConfig.LibraryLootMode.AGE_ONLY
? ageSymbols.stream().filter(id -> PortSymbolPages.find(id) != null).distinct().toList() ? ageSymbols.stream().filter(policy::allows).filter(id -> PortSymbolPages.find(id) != null).distinct().toList()
: PortSymbolPages.sealedCandidateIds(); : PortSymbolPages.libraryCandidateIds().stream().filter(policy::allows).toList();
} }
private static ItemStack page(List<Identifier> symbols, RandomSource random) { private static ItemStack page(List<Identifier> symbols, RandomSource random) {
@@ -0,0 +1,53 @@
package net.dnorberg.rivencraft.age;
import java.util.List;
import java.util.stream.Stream;
import net.dnorberg.rivencraft.shared.NativeBiomeKind;
import net.dnorberg.rivencraft.compat.TerraBlenderBiomes;
import net.minecraft.core.Holder;
import net.minecraft.core.HolderLookup;
import net.minecraft.core.registries.Registries;
import net.minecraft.resources.Identifier;
import net.minecraft.resources.ResourceKey;
import net.minecraft.tags.BiomeTags;
import net.minecraft.tags.TagKey;
import net.minecraft.world.level.biome.Biome;
/** Family pools are resolved only when binding new writing, never re-filtered on load. */
public final class PortNativeBiomePools {
private PortNativeBiomePools() {}
public static final TagKey<Biome> CAVES = TagKey.create(Registries.BIOME,
Identifier.fromNamespaceAndPath("rivencraft", "cave_biomes"));
public static List<Identifier> pool(HolderLookup.Provider registries, NativeBiomeKind kind) {
var biomes = registries.lookupOrThrow(Registries.BIOME);
var nether = java.util.Set.copyOf(TerraBlenderBiomes.nether(registries));
java.util.function.Predicate<Holder.Reference<Biome>> isNether =
biome -> biome.is(BiomeTags.IS_NETHER) || nether.contains(biome.key().identifier());
var selected = biomes.listElements()
.filter(biome -> !biome.key().identifier().equals(Identifier.parse("terrablender:deferred_placeholder")))
.filter(biome -> switch (kind) {
case CAVES -> biome.is(CAVES) && !isNether.test(biome);
case NETHER -> isNether.test(biome);
case END -> biome.is(BiomeTags.IS_END);
case TERRAIN -> throw new IllegalArgumentException("Terrain Native uses its own preset");
}).map(biome -> biome.key().identifier()).toList();
// Built-in family members remain recognizable if a data pack replaces the broad tags.
List<String> vanilla = switch (kind) {
case CAVES -> List.of("lush_caves", "dripstone_caves", "deep_dark", "sulfur_caves");
case NETHER -> List.of("nether_wastes", "soul_sand_valley", "crimson_forest", "warped_forest", "basalt_deltas");
case END -> List.of("the_end", "end_highlands", "end_midlands", "small_end_islands", "end_barrens");
default -> List.of();
};
var fallback = vanilla.stream().map(Identifier::withDefaultNamespace)
.filter(id -> biomes.get(ResourceKey.create(Registries.BIOME, id))
.filter(biome -> kind != NativeBiomeKind.CAVES || !isNether.test(biome)).isPresent());
var result = Stream.concat(selected.stream(), fallback).distinct().sorted().toList();
if (!result.isEmpty()) return result; // A one-biome family becomes a safe FixedBiomeSource.
var safe = kind == NativeBiomeKind.CAVES ? biomes.listElements().filter(biome -> !isNether.test(biome)
&& !biome.key().identifier().equals(Identifier.parse("terrablender:deferred_placeholder")))
.map(biome -> biome.key().identifier()).sorted().findFirst()
: java.util.Optional.<Identifier>empty();
return safe.map(List::of).orElseThrow(() -> new IllegalArgumentException("No usable " + kind + " biomes"));
}
}
@@ -17,20 +17,39 @@ public final class PortRandomAgeSelection {
public record Selection(PortAgeTerrain terrain, PortBiomePlan biomes) {} public record Selection(PortAgeTerrain terrain, PortBiomePlan biomes) {}
public static Selection select(MinecraftServer server, long seed) { public static Selection select(MinecraftServer server, long seed) {
return select(server, seed, PortRandomPagePolicy.UNRESTRICTED);
}
public static Selection select(MinecraftServer server, long seed, PortRandomPagePolicy policy) {
// Match the 1.21.1 Legacy-rank choices: Standard and Flat are common; // Match the 1.21.1 Legacy-rank choices: Standard and Flat are common;
// the other terrain families are rarer. The sorted order is deliberate. // the other terrain families are rarer. The sorted order is deliberate.
PortAgeTerrain terrain = terrain(seed); PortAgeTerrain terrain = terrain(seed, policy);
if (terrain == PortAgeTerrain.VOID) if (terrain == PortAgeTerrain.VOID)
return new Selection(terrain, new PortBiomePlan(PortBiomePlan.Distribution.SINGLE, return new Selection(terrain, new PortBiomePlan(PortBiomePlan.Distribution.SINGLE,
List.of(Identifier.withDefaultNamespace("the_void")))); List.of(Identifier.withDefaultNamespace("the_void"))));
PortBiomePlan.Distribution distribution = distribution(seed); PortBiomePlan.Distribution distribution = distribution(seed, policy);
List<Identifier> eligible = eligibleBiomes(server, terrain); List<Identifier> eligible = eligibleBiomes(server, terrain);
if (eligible.size() < 2 && distribution != PortBiomePlan.Distribution.NATIVE) if (distribution != PortBiomePlan.Distribution.NATIVE) {
distribution = PortBiomePlan.Distribution.SINGLE; var filtered = new ArrayList<>(policy.eligible(eligible, PortRegistryPages::biomePageId));
// Native presets are not Page-selected. Other controllers retain their minimum,
// with the same preferred-biome/registry fallback as 1.21.1.
int minimum = distribution == PortBiomePlan.Distribution.SINGLE ? 1 : 2;
Identifier preferred = Identifier.withDefaultNamespace(terrain == PortAgeTerrain.CAVE ? "deep_dark" : "plains");
if (filtered.size() < minimum && eligible.contains(preferred) && !filtered.contains(preferred))
filtered.add(preferred);
for (var candidate : eligible)
if (filtered.size() < minimum && !filtered.contains(candidate)) filtered.add(candidate);
eligible = List.copyOf(filtered);
if (eligible.size() < 2) distribution = PortBiomePlan.Distribution.SINGLE;
}
if (distribution == PortBiomePlan.Distribution.NATIVE) if (distribution == PortBiomePlan.Distribution.NATIVE)
return new Selection(terrain, new PortBiomePlan(distribution, return new Selection(terrain, new PortBiomePlan(distribution,
terrain == PortAgeTerrain.CAVE ? eligible : List.of())); terrain == PortAgeTerrain.CAVE
? PortNativeBiomePools.pool(server.registryAccess(), net.dnorberg.rivencraft.shared.NativeBiomeKind.CAVES)
: List.of(), terrain == PortAgeTerrain.CAVE
? net.dnorberg.rivencraft.shared.NativeBiomeKind.CAVES
: net.dnorberg.rivencraft.shared.NativeBiomeKind.TERRAIN));
int count = distribution == PortBiomePlan.Distribution.SINGLE ? 1 : 2; int count = distribution == PortBiomePlan.Distribution.SINGLE ? 1 : 2;
if (count > 1) { if (count > 1) {
@@ -48,18 +67,28 @@ public final class PortRandomAgeSelection {
} }
public static PortAgeTerrain terrain(long seed) { public static PortAgeTerrain terrain(long seed) {
return weighted(new Random(seed ^ 0x5445525241494E4CL), terrains(), new int[]{1, 1, 5, 1, 6, 1}); return terrain(seed, PortRandomPagePolicy.UNRESTRICTED);
}
public static PortAgeTerrain terrain(long seed, PortRandomPagePolicy policy) {
return ranked(new Random(seed ^ 0x5445525241494E4CL), terrains(), new int[]{3, 3, 2, 3, 1, 3},
policy, value -> PortRandomPagePolicy.page("terrain", value), PortAgeTerrain.STANDARD);
} }
/** First AgeTraits draw in 1.21.1; shared by random and partly authored Ages. */ /** First AgeTraits draw in 1.21.1; shared by random and partly authored Ages. */
public static PortBiomePlan.Distribution distribution(long seed) { public static PortBiomePlan.Distribution distribution(long seed) {
return weighted(new Random(seed ^ 0x524956454E435241L), return distribution(seed, PortRandomPagePolicy.UNRESTRICTED);
}
public static PortBiomePlan.Distribution distribution(long seed, PortRandomPagePolicy policy) {
return ranked(new Random(seed ^ 0x524956454E435241L),
List.of(PortBiomePlan.Distribution.NATIVE, PortBiomePlan.Distribution.SINGLE, List.of(PortBiomePlan.Distribution.NATIVE, PortBiomePlan.Distribution.SINGLE,
PortBiomePlan.Distribution.MEDIUM, PortBiomePlan.Distribution.TILED, PortBiomePlan.Distribution.MEDIUM, PortBiomePlan.Distribution.TILED,
PortBiomePlan.Distribution.GRID, PortBiomePlan.Distribution.TINY, PortBiomePlan.Distribution.GRID, PortBiomePlan.Distribution.TINY,
PortBiomePlan.Distribution.SMALL, PortBiomePlan.Distribution.LARGE, PortBiomePlan.Distribution.SMALL, PortBiomePlan.Distribution.LARGE,
PortBiomePlan.Distribution.HUGE), PortBiomePlan.Distribution.HUGE),
new int[]{3, 3, 3, 1, 1, 1, 1, 1, 1}); new int[]{1, 1, 1, 2, 2, 2, 2, 2, 2}, policy,
value -> PortRandomPagePolicy.page("biome", value), PortBiomePlan.Distribution.NATIVE);
} }
public static List<Identifier> eligibleBiomes(MinecraftServer server, PortAgeTerrain terrain) { public static List<Identifier> eligibleBiomes(MinecraftServer server, PortAgeTerrain terrain) {
@@ -69,24 +98,28 @@ public final class PortRandomAgeSelection {
} }
List<Identifier> surface = server.overworld().getChunkSource().getGenerator().getBiomeSource() List<Identifier> surface = server.overworld().getChunkSource().getGenerator().getBiomeSource()
.possibleBiomes().stream().flatMap(holder -> holder.unwrapKey().stream()) .possibleBiomes().stream().flatMap(holder -> holder.unwrapKey().stream())
.map(key -> key.identifier()).distinct().sorted(Comparator.naturalOrder()).toList(); .map(key -> key.identifier()).filter(id -> !id.equals(PortRegistryPages.DEFERRED_PLACEHOLDER))
.distinct().sorted(Comparator.naturalOrder()).toList();
surface = java.util.stream.Stream.concat(surface.stream(),
net.dnorberg.rivencraft.compat.TerraBlenderBiomes.overworld(server.registryAccess()).stream())
.distinct().sorted().toList();
return surface.isEmpty() ? List.of(Identifier.withDefaultNamespace("plains")) : surface; return surface.isEmpty() ? List.of(Identifier.withDefaultNamespace("plains")) : surface;
} }
public static List<Identifier> caveBiomes(net.minecraft.core.HolderLookup.Provider registries) { public static List<Identifier> caveBiomes(net.minecraft.core.HolderLookup.Provider registries) {
net.dnorberg.rivencraft.compat.TerraBlenderBiomes.nether(registries);
var caves = registries.lookupOrThrow(Registries.BIOME).listElements() var caves = registries.lookupOrThrow(Registries.BIOME).listElements()
.filter(PortRegistryPages::isCaveBiome).map(holder -> holder.key().identifier()).sorted().toList(); .filter(PortRegistryPages::isCaveBiome).map(holder -> holder.key().identifier()).sorted().toList();
return caves.isEmpty() ? List.of(Identifier.withDefaultNamespace("lush_caves")) : caves; return caves.isEmpty() ? List.of(Identifier.withDefaultNamespace("lush_caves")) : caves;
} }
static <T> T weighted(Random random, List<T> choices, int[] weights) { private static <T> T ranked(Random random, List<T> choices, int[] ranks, PortRandomPagePolicy policy,
int total = 0; java.util.function.Function<T, Identifier> page, T fallback) {
for (int weight : weights) total += weight; var options = new ArrayList<PortRankedChoice.Option<T>>();
int ticket = random.nextInt(total); for (int i = 0; i < choices.size(); i++)
for (int index = 0; index < choices.size(); index++) { options.add(new PortRankedChoice.Option<>(choices.get(i), ranks[i]));
ticket -= weights[index]; var eligible = policy.eligible(options, option -> page.apply(option.value()));
if (ticket < 0) return choices.get(index); return eligible.isEmpty() ? fallback : PortRankedChoice.choose(random, eligible);
}
throw new IllegalStateException("Random Age ticket was not consumed");
} }
} }
@@ -14,16 +14,25 @@ public final class PortRandomFeatureSelection {
public static Selection select(net.minecraft.server.MinecraftServer server, long seed, public static Selection select(net.minecraft.server.MinecraftServer server, long seed,
PortAgeTerrain terrain, PortBiomePlan biomes) { PortAgeTerrain terrain, PortBiomePlan biomes) {
var base = select(seed, terrain); return select(server, seed, terrain, biomes, PortRandomPagePolicy.UNRESTRICTED);
var structures = PortRandomStructureSelection.select(server, seed, terrain, biomes); }
public static Selection select(net.minecraft.server.MinecraftServer server, long seed,
PortAgeTerrain terrain, PortBiomePlan biomes, PortRandomPagePolicy policy) {
var base = select(seed, terrain, policy);
var structures = PortRandomStructureSelection.select(server, seed, terrain, biomes, policy);
var plan = base.terrain(); var plan = base.terrain();
plan = plan == null ? new PortTerrainFeaturePlan(List.of(), false, 0, false, structures.structures(), List.of(), true) plan = plan == null ? new PortTerrainFeaturePlan(List.of(), false, 0, false, structures.structures(), List.of(), true)
: new PortTerrainFeaturePlan(plan.choices(), plan.skylands(), plan.denseOres(), plan.starFissures(), : new PortTerrainFeaturePlan(plan.choices(), plan.skylands(), plan.denseOres(), plan.starFissures(),
structures.structures(), plan.carvers(), true); structures.structures(), plan.carvers(), true, plan.ruins());
return new Selection(base.rocks(), base.lakes(), plan, structures.dungeons()); return new Selection(base.rocks(), base.lakes(), plan, structures.dungeons());
} }
public static Selection select(long seed, PortAgeTerrain terrain) { public static Selection select(long seed, PortAgeTerrain terrain) {
return select(seed, terrain, PortRandomPagePolicy.UNRESTRICTED);
}
public static Selection select(long seed, PortAgeTerrain terrain, PortRandomPagePolicy policy) {
var random = new Random(seed ^ 0x4D4154455249414CL); var random = new Random(seed ^ 0x4D4154455249414CL);
int count = random.nextInt(3); int count = random.nextInt(3);
var terrainPage = id("terrain/" + terrain.name().toLowerCase(java.util.Locale.ROOT)); var terrainPage = id("terrain/" + terrain.name().toLowerCase(java.util.Locale.ROOT));
@@ -31,12 +40,13 @@ public final class PortRandomFeatureSelection {
for (String name : List.of("rocks", "floating_islands", "tendrils", "spheres", "spikes", "obelisks", for (String name : List.of("rocks", "floating_islands", "tendrils", "spheres", "spikes", "obelisks",
"surface_lakes", "deep_lakes", "lava_lakes")) { "surface_lakes", "deep_lakes", "lava_lakes")) {
var page = id("feature/" + name); var page = id("feature/" + name);
if (PortAuthoredWriting.supports(List.of(terrainPage, page))) if (policy.allows(page) && PortAuthoredWriting.supports(List.of(terrainPage, page)))
candidates.add(new PortRankedChoice.Option<>(page, rank(name))); candidates.add(new PortRankedChoice.Option<>(page, rank(name)));
} }
var pages = new ArrayList<Identifier>(); var pages = new ArrayList<Identifier>();
pages.add(terrainPage); pages.add(terrainPage);
List<Identifier> solids = PortRegistryPages.solidMaterialIds(), fluids = PortRegistryPages.fluidMaterialIds(); List<Identifier> solids = policy.eligible(PortRegistryPages.solidMaterialIds(), PortRegistryPages::blockPageId);
List<Identifier> fluids = policy.eligible(PortRegistryPages.fluidMaterialIds(), PortRegistryPages::blockPageId);
for (int selected = 0; selected < count && !candidates.isEmpty();) { for (int selected = 0; selected < count && !candidates.isEmpty();) {
Identifier feature = PortRankedChoice.choose(random, candidates); Identifier feature = PortRankedChoice.choose(random, candidates);
candidates.removeIf(option -> option.value().equals(feature)); candidates.removeIf(option -> option.value().equals(feature));
@@ -46,12 +56,12 @@ public final class PortRandomFeatureSelection {
pages.add(feature); pages.add(feature);
selected++; selected++;
} }
if (terrain != PortAgeTerrain.FLAT && terrain != PortAgeTerrain.VOID if (policy.allows(PortTerrainFeaturePlan.SKYLANDS) && terrain != PortAgeTerrain.FLAT && terrain != PortAgeTerrain.VOID
&& Math.floorMod(mix(seed ^ 0x534B594C414E4453L), 8) == 0) && Math.floorMod(mix(seed ^ 0x534B594C414E4453L), 8) == 0)
pages.add(PortTerrainFeaturePlan.SKYLANDS); pages.add(PortTerrainFeaturePlan.SKYLANDS);
if (terrain != PortAgeTerrain.CAVE && terrain != PortAgeTerrain.VOID && random.nextInt(10) == 0) if (policy.allows(PortTerrainFeaturePlan.CRYSTAL_FORMATIONS) && terrain != PortAgeTerrain.CAVE && terrain != PortAgeTerrain.VOID && random.nextInt(10) == 0)
pages.add(PortTerrainFeaturePlan.CRYSTAL_FORMATIONS); pages.add(PortTerrainFeaturePlan.CRYSTAL_FORMATIONS);
if (randomStarFissure(seed)) pages.add(PortTerrainFeaturePlan.STAR_FISSURES); if (policy.allows(PortTerrainFeaturePlan.STAR_FISSURES) && randomStarFissure(seed)) pages.add(PortTerrainFeaturePlan.STAR_FISSURES);
return new Selection(PortAuthoredWriting.rockPlan(pages, seed), PortAuthoredWriting.lakePlan(pages, seed), return new Selection(PortAuthoredWriting.rockPlan(pages, seed), PortAuthoredWriting.lakePlan(pages, seed),
PortAuthoredWriting.terrainFeaturePlan(pages, seed), 0); PortAuthoredWriting.terrainFeaturePlan(pages, seed), 0);
} }
@@ -0,0 +1,66 @@
package net.dnorberg.rivencraft.age;
import java.util.List;
import java.util.Set;
import java.util.stream.Collectors;
import net.dnorberg.rivencraft.PortConfig;
import net.minecraft.resources.Identifier;
/** Creation-time eligibility; the resolved Age settings are saved, never reselected on reload. */
public record PortRandomPagePolicy(Set<Identifier> allowlist, Set<Identifier> blocklist) {
public static final PortRandomPagePolicy UNRESTRICTED = new PortRandomPagePolicy(Set.of(), Set.of());
public PortRandomPagePolicy {
allowlist = Set.copyOf(allowlist);
blocklist = Set.copyOf(blocklist);
}
public static PortRandomPagePolicy configured() {
return new PortRandomPagePolicy(parse(PortConfig.RANDOM_PAGE_ALLOWLIST.get()),
parse(PortConfig.RANDOM_PAGE_BLOCKLIST.get()));
}
private static Set<Identifier> parse(List<? extends String> ids) {
return ids.stream().map(PortRandomPagePolicy::parsePageId).collect(Collectors.toUnmodifiableSet());
}
/** Server config IDs may omit the built-in Rivencraft namespace. */
public static Identifier parsePageId(String value) {
Identifier id = Identifier.tryParse(value.contains(":") ? value : "rivencraft:" + value);
if (id == null) throw new IllegalArgumentException("Invalid Page ID " + value);
return id;
}
public boolean allows(Identifier id) {
if (blocklist.contains(id)) return false;
String category = category(id);
return !restricts(category) || allowlist.contains(id);
}
public boolean restricts(String category) {
return allowlist.stream().anyMatch(entry -> category(entry).equals(category));
}
public <T> List<T> eligible(List<T> candidates, java.util.function.Function<T, Identifier> pageId) {
return candidates.stream().filter(candidate -> allows(pageId.apply(candidate))).toList();
}
public <T> List<T> required(List<T> candidates, java.util.function.Function<T, Identifier> pageId,
T fallback) {
List<T> eligible = eligible(candidates, pageId);
return eligible.isEmpty() ? List.of(fallback) : eligible;
}
private static String category(Identifier id) {
String path = id.getPath();
if (path.startsWith("biome/") && java.util.Set.of("native", "native_caves", "native_nether", "native_end", "single", "tiled", "grid",
"tiny", "small", "medium", "large", "huge").contains(path.substring("biome/".length())))
return "biome_distribution";
return path.substring(0, path.indexOf('/') < 0 ? path.length() : path.indexOf('/'));
}
public static Identifier page(String category, Enum<?> value) {
return Identifier.fromNamespaceAndPath("rivencraft", category + "/"
+ value.name().toLowerCase(java.util.Locale.ROOT));
}
}
@@ -19,6 +19,11 @@ public final class PortRandomStructureSelection {
} }
public static Selection select(MinecraftServer server, long seed, PortAgeTerrain terrain, PortBiomePlan plan) { public static Selection select(MinecraftServer server, long seed, PortAgeTerrain terrain, PortBiomePlan plan) {
return select(server, seed, terrain, plan, PortRandomPagePolicy.UNRESTRICTED);
}
public static Selection select(MinecraftServer server, long seed, PortAgeTerrain terrain, PortBiomePlan plan,
PortRandomPagePolicy policy) {
Set<Identifier> biomes = actualBiomes(server, terrain, plan); Set<Identifier> biomes = actualBiomes(server, terrain, plan);
var eligible = new ArrayList<PortRankedChoice.Option<Identifier>>(); var eligible = new ArrayList<PortRankedChoice.Option<Identifier>>();
for (String name : List.of("dungeons", "mineshafts", "nether_fortresses", "strongholds", "villages", for (String name : List.of("dungeons", "mineshafts", "nether_fortresses", "strongholds", "villages",
@@ -32,7 +37,7 @@ public final class PortRandomStructureSelection {
.get(ResourceKey.create(Registries.PLACED_FEATURE, .get(ResourceKey.create(Registries.PLACED_FEATURE,
Identifier.fromNamespaceAndPath("rivencraft", "dungeons"))).isPresent() Identifier.fromNamespaceAndPath("rivencraft", "dungeons"))).isPresent()
: PortStructurePages.randomEligible(feature, terrain, biomes, server.registryAccess()); : PortStructurePages.randomEligible(feature, terrain, biomes, server.registryAccess());
if (allowed) eligible.add(new PortRankedChoice.Option<>(feature, rank(name))); if (allowed && policy.allows(feature)) eligible.add(new PortRankedChoice.Option<>(feature, rank(name)));
} }
var random = new Random(seed ^ 0x5354525543545552L); var random = new Random(seed ^ 0x5354525543545552L);
int count = random.nextInt(3), dungeons = 0; int count = random.nextInt(3), dungeons = 0;
@@ -0,0 +1,66 @@
package net.dnorberg.rivencraft.age;
import java.util.*;
import com.mojang.serialization.Codec;
import com.mojang.serialization.codecs.RecordCodecBuilder;
import net.minecraft.resources.Identifier;
import net.minecraft.server.MinecraftServer;
import net.minecraft.server.level.ServerLevel;
import net.minecraft.world.level.saveddata.SavedData;
import net.minecraft.world.level.saveddata.SavedDataType;
/** Frozen per-Age season choice, separate from the backend's legacy index codec. */
public final class PortSeasonPolicies extends SavedData {
public enum Mode {
NO_SEASONS, SEASONS, ETERNAL_WINTER, ETERNAL_SUMMER, ETERNAL_FALL, ETERNAL_SPRING;
public boolean eternal() { return this != NO_SEASONS && this != SEASONS; }
}
public record Policy(Mode mode, boolean authored) {
static final Codec<Policy> CODEC = RecordCodecBuilder.create(i -> i.group(
Codec.STRING.xmap(Mode::valueOf, Mode::name).fieldOf("mode").forGetter(Policy::mode),
Codec.BOOL.fieldOf("authored").forGetter(Policy::authored)).apply(i, Policy::new));
}
private static final SavedDataType<PortSeasonPolicies> TYPE = new SavedDataType<>(
Identifier.fromNamespaceAndPath("rivencraft", "season_policies"), () -> new PortSeasonPolicies(Map.of()),
Codec.unboundedMap(Identifier.CODEC, Policy.CODEC).fieldOf("ages").codec()
.xmap(PortSeasonPolicies::new, data -> Map.copyOf(data.policies)));
private final Map<Identifier, Policy> policies = new HashMap<>();
private PortSeasonPolicies(Map<Identifier, Policy> values) { policies.putAll(values); }
public static PortSeasonPolicies get(MinecraftServer server) { return server.overworld().getDataStorage().computeIfAbsent(TYPE); }
Policy snapshot(Identifier id) { return policies.get(id); }
void put(Identifier id, Policy policy) { if (policy == null) policies.remove(id); else policies.put(id, policy); setDirty(); }
public Policy forLevel(ServerLevel level) {
if (level instanceof PortAgeLevel age && age.caveTerrain()) return new Policy(Mode.NO_SEASONS, true);
// Existing Ages retain cycling behavior when integration is installed later.
return policies.getOrDefault(level.dimension().identifier(), new Policy(Mode.SEASONS, false));
}
public static Mode forPage(Identifier id) {
if (!id.getNamespace().equals("rivencraft") || !id.getPath().startsWith("season/")) return null;
try { return Mode.valueOf(id.getPath().substring(7).toUpperCase(Locale.ROOT)); }
catch (IllegalArgumentException e) { return null; }
}
static Policy select(List<Identifier> pages, long seed, PortAgeTerrain terrain, boolean installed) {
return select(pages, seed, terrain, installed, PortRandomPagePolicy.UNRESTRICTED);
}
static Policy select(List<Identifier> pages, long seed, PortAgeTerrain terrain, boolean installed, PortRandomPagePolicy policy) {
if (terrain == PortAgeTerrain.CAVE) return new Policy(Mode.NO_SEASONS, true);
Mode written = null;
for (var page : pages) if (forPage(page) != null) written = forPage(page);
if (written != null) {
if (!installed && written != Mode.NO_SEASONS) throw new IllegalArgumentException("Seasonal pages require Serene Seasons");
return new Policy(written, true);
}
if (!installed) return null;
// 1.21.1 LegacyRankChoice ranks: Seasons=1, None=2, each Eternal=3.
var modes = List.of(new PortRankedChoice.Option<>(Mode.SEASONS, 1),
new PortRankedChoice.Option<>(Mode.NO_SEASONS, 2),
new PortRankedChoice.Option<>(Mode.ETERNAL_WINTER, 3),
new PortRankedChoice.Option<>(Mode.ETERNAL_SUMMER, 3),
new PortRankedChoice.Option<>(Mode.ETERNAL_FALL, 3),
new PortRankedChoice.Option<>(Mode.ETERNAL_SPRING, 3));
Mode mode = PortRankedChoice.choose(new Random(seed ^ 0x5E450A5E5EED21L),
policy.required(modes, option -> PortRandomPagePolicy.page("season", option.value()),
new PortRankedChoice.Option<>(Mode.NO_SEASONS, 2)));
return new Policy(mode, false);
}
}
@@ -26,9 +26,13 @@ public enum PortSkyStyle {
} }
public static PortSkyStyle resolve(List<Identifier> pages, long seed) { public static PortSkyStyle resolve(List<Identifier> pages, long seed) {
return resolve(pages, seed, PortRandomPagePolicy.UNRESTRICTED);
}
public static PortSkyStyle resolve(List<Identifier> pages, long seed, PortRandomPagePolicy policy) {
return pages.stream().map(PortSkyStyle::forPage).filter(java.util.Objects::nonNull) return pages.stream().map(PortSkyStyle::forPage).filter(java.util.Objects::nonNull)
.findFirst().orElseGet(() -> pages.stream().anyMatch(PortSkyStyle::isCelestial) .findFirst().orElseGet(() -> pages.stream().anyMatch(PortSkyStyle::isCelestial)
? OVERWORLD : random(seed)); ? OVERWORLD : random(seed, policy));
} }
/** Nether-style Ages use their fog clear color as the visible backdrop. */ /** Nether-style Ages use their fog clear color as the visible backdrop. */
@@ -50,11 +54,17 @@ public enum PortSkyStyle {
}; };
} }
private static PortSkyStyle random(long seed) { private static PortSkyStyle random(long seed, PortRandomPagePolicy policy) {
// Match the first draw in 1.21.1 AgeSkyProfile.random: its equally // Match the first draw in 1.21.1 AgeSkyProfile.random: its equally
// likely INHERITED and OVERWORLD slots currently share the native // likely INHERITED and OVERWORLD slots currently share the native
// Overworld presentation here. Do not add unported colors/bodies. // Overworld presentation here. Do not add unported colors/bodies.
int choice = new Random(seed ^ 0x534B5950524F464CL).nextInt(5); var styles = policy.required(java.util.stream.IntStream.range(0, 5).boxed()
.filter(slot -> slot != 0 || !policy.restricts("sky")).toList(),
slot -> Identifier.fromNamespaceAndPath("rivencraft", "sky/" + switch (slot) {
case 0 -> "inherited"; case 1 -> "overworld"; case 2 -> "nether";
case 3 -> "end"; default -> "static";
}), 0);
int choice = styles.get(new Random(seed ^ 0x534B5950524F464CL).nextInt(styles.size()));
return switch (choice) { return switch (choice) {
case 0, 1 -> OVERWORLD; case 0, 1 -> OVERWORLD;
case 2 -> NETHER; case 2 -> NETHER;
@@ -0,0 +1,20 @@
package net.dnorberg.rivencraft.age;
import java.util.List;
import net.dnorberg.rivencraft.shared.StaticSkyResolution;
import net.minecraft.resources.Identifier;
public final class PortStaticSkyResolution {
public static final Identifier PAGE = Identifier.fromNamespaceAndPath("rivencraft", "sky/static");
private PortStaticSkyResolution() {}
public static int compile(List<Identifier> pages) {
return StaticSkyResolution.requested(pages.stream().map(page -> {
int number = PortAgeColors.number(page);
if (number >= 0) return number;
if (page.equals(PAGE)) return StaticSkyResolution.STATIC;
return PortSkyStyle.forPage(page) != null
? StaticSkyResolution.OTHER_SKY : StaticSkyResolution.OTHER;
}).toList());
}
}
@@ -0,0 +1,100 @@
package net.dnorberg.rivencraft.age;
import java.util.Optional;
import net.dnorberg.rivencraft.writing.PortRegistryPages;
import net.minecraft.world.level.levelgen.placement.PlacedFeature;
import net.dnorberg.rivencraft.shared.DesertVegetation;
import net.minecraft.core.BlockPos;
import net.minecraft.core.Holder;
import net.minecraft.core.registries.Registries;
import net.minecraft.resources.Identifier;
import net.minecraft.resources.ResourceKey;
import net.minecraft.tags.BlockTags;
import net.minecraft.tags.TagKey;
import net.minecraft.util.RandomSource;
import net.minecraft.world.level.WorldGenLevel;
import net.minecraft.world.level.biome.Biome;
import net.minecraft.world.level.block.Blocks;
import net.minecraft.world.level.chunk.ChunkAccess;
import net.minecraft.world.level.chunk.ChunkGenerator;
import net.minecraft.world.level.levelgen.Heightmap;
import net.minecraft.world.level.levelgen.placement.BiomeFilter;
import net.minecraft.world.level.levelgen.placement.PlacementContext;
/** Routes only the three generic plant pages by the actual candidate biome. */
public final class PortSurfaceVegetation {
public static final TagKey<Biome> DESERTS = TagKey.create(Registries.BIOME,
Identifier.fromNamespaceAndPath("rivencraft", "desert_vegetation"));
private PortSurfaceVegetation() {}
public static boolean isDesert(Holder<Biome> biome) {
return biome.is(DESERTS) && (!biome.is(net.minecraft.tags.BiomeTags.IS_END) && !PortRegistryPages.isCaveBiome(biome));
}
public static void place(WorldGenLevel level, ChunkGenerator generator, ChunkAccess chunk,
String page, Identifier placedId, RandomSource random) {
DesertVegetation.Kind kind = switch (page) {
case "flowers" -> DesertVegetation.Kind.FLOWERS;
case "trees" -> DesertVegetation.Kind.TREES;
case "huge_trees" -> DesertVegetation.Kind.HUGE_TREES;
default -> throw new IllegalArgumentException("Not a generic vegetation page: " + page);
};
int x = chunk.getPos().getMinBlockX();
int z = chunk.getPos().getMinBlockZ();
// Separate streams keep ordinary non-desert placement independent of desert attempts.
RandomSource desertRandom = RandomSource.create(random.nextLong());
DesertVegetation.place(new DesertVegetation.World() {
public int surfaceY(int px, int pz) {
return level.getHeight(Heightmap.Types.MOTION_BLOCKING_NO_LEAVES, px, pz);
}
public int maxY() { return level.getMaxY(); }
public boolean desert(int px, int py, int pz) {
return isDesert(level.getBiome(new BlockPos(px, py, pz)));
}
public DesertVegetation.Ground ground(int px, int py, int pz) {
var state = level.getBlockState(new BlockPos(px, py, pz));
if (state.is(Blocks.SAND) || state.is(Blocks.RED_SAND)) return DesertVegetation.Ground.SAND;
// Modern dirt and grass-like soils are separate tags.
return (state.is(BlockTags.DIRT) || state.is(BlockTags.GRASS_BLOCKS))
&& level.getBlockState(new BlockPos(px, py - 1, pz)).isFaceSturdy(
level, new BlockPos(px, py - 1, pz), net.minecraft.core.Direction.UP)
? DesertVegetation.Ground.SOIL : DesertVegetation.Ground.OTHER;
}
public boolean air(int px, int py, int pz) {
return level.getBlockState(new BlockPos(px, py, pz)).isAir();
}
public void set(int px, int py, int pz, DesertVegetation.Plant plant) {
var block = switch (plant) {
case SAND -> Blocks.SAND;
case CACTUS -> Blocks.CACTUS;
case DEAD_BUSH -> Blocks.DEAD_BUSH;
};
level.setBlock(new BlockPos(px, py, pz), block.defaultBlockState(), 2);
}
}, kind, x, z, desertRandom::nextInt);
var vanilla = level.registryAccess().lookupOrThrow(Registries.PLACED_FEATURE)
.getOrThrow(ResourceKey.create(Registries.PLACED_FEATURE, placedId)).value();
var context = new PlacementContext(level, generator, Optional.empty());
placeOrdinary(vanilla, context, random, 0, new BlockPos(x, level.getMinY(), z));
}
private static void placeOrdinary(PlacedFeature feature, PlacementContext context,
RandomSource random, int index, BlockPos position) {
if (index == feature.placement().size()) {
Holder<Biome> biome = context.getLevel().getBiome(position);
if (!biome.is(net.minecraft.tags.BiomeTags.IS_END)
&& !PortRegistryPages.isCaveBiome(biome) && !isDesert(biome))
feature.feature().value().place(context.getLevel(), context.generator(), random, position);
return;
}
var modifier = feature.placement().get(index);
if (modifier instanceof BiomeFilter) {
placeOrdinary(feature, context, random, index + 1, position);
} else {
modifier.modify(context, random, position,
candidate -> placeOrdinary(feature, context, random, index + 1, candidate));
}
}
}
@@ -10,7 +10,7 @@ import net.minecraft.resources.Identifier;
/** Frozen terrain filters and ordered solid/surface features for an Age. */ /** Frozen terrain filters and ordered solid/surface features for an Age. */
public record PortTerrainFeaturePlan(List<Choice> choices, boolean skylands, int denseOres, public record PortTerrainFeaturePlan(List<Choice> choices, boolean skylands, int denseOres,
boolean starFissures, List<Identifier> structures, List<Identifier> carvers, boolean starFissures, List<Identifier> structures, List<Identifier> carvers,
boolean structureControl) { boolean structureControl, List<Identifier> ruins) {
public static final Identifier FLOATING_ISLANDS = Identifier.fromNamespaceAndPath( public static final Identifier FLOATING_ISLANDS = Identifier.fromNamespaceAndPath(
Rivencraft.MOD_ID, "feature/floating_islands"); Rivencraft.MOD_ID, "feature/floating_islands");
public static final Identifier TENDRILS = Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, "feature/tendrils"); public static final Identifier TENDRILS = Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, "feature/tendrils");
@@ -32,7 +32,8 @@ public record PortTerrainFeaturePlan(List<Choice> choices, boolean skylands, int
Codec.BOOL.optionalFieldOf("star_fissures", false).forGetter(PortTerrainFeaturePlan::starFissures), Codec.BOOL.optionalFieldOf("star_fissures", false).forGetter(PortTerrainFeaturePlan::starFissures),
Identifier.CODEC.listOf().optionalFieldOf("structures", List.of()).forGetter(PortTerrainFeaturePlan::structures), Identifier.CODEC.listOf().optionalFieldOf("structures", List.of()).forGetter(PortTerrainFeaturePlan::structures),
Identifier.CODEC.listOf().optionalFieldOf("carvers", List.of()).forGetter(PortTerrainFeaturePlan::carvers), Identifier.CODEC.listOf().optionalFieldOf("carvers", List.of()).forGetter(PortTerrainFeaturePlan::carvers),
Codec.BOOL.optionalFieldOf("structure_control", false).forGetter(PortTerrainFeaturePlan::structureControl) Codec.BOOL.optionalFieldOf("structure_control", false).forGetter(PortTerrainFeaturePlan::structureControl),
Identifier.CODEC.listOf().optionalFieldOf("ruins", List.of()).forGetter(PortTerrainFeaturePlan::ruins)
).apply(instance, PortTerrainFeaturePlan::new)); ).apply(instance, PortTerrainFeaturePlan::new));
public record Choice(Identifier page, Identifier material) { public record Choice(Identifier page, Identifier material) {
@@ -50,6 +51,9 @@ public record PortTerrainFeaturePlan(List<Choice> choices, boolean skylands, int
} }
public PortTerrainFeaturePlan { public PortTerrainFeaturePlan {
ruins = List.copyOf(ruins);
if (ruins.size() > 252 || ruins.stream().anyMatch(id -> !net.dnorberg.rivencraft.compat.RuinsTemplatePages.isSymbol(id)))
throw new IllegalArgumentException("Invalid Ruins template pages");
choices = List.copyOf(choices); choices = List.copyOf(choices);
structures = List.copyOf(structures); structures = List.copyOf(structures);
carvers = List.copyOf(carvers); carvers = List.copyOf(carvers);
@@ -57,7 +61,7 @@ public record PortTerrainFeaturePlan(List<Choice> choices, boolean skylands, int
PortCarverPages.validateCounts(carvers); PortCarverPages.validateCounts(carvers);
if (denseOres < 0 || denseOres > MAX_PER_FEATURE) if (denseOres < 0 || denseOres > MAX_PER_FEATURE)
throw new IllegalArgumentException("Dense Ores permits at most 32 occurrences"); throw new IllegalArgumentException("Dense Ores permits at most 32 occurrences");
if (choices.isEmpty() && !skylands && denseOres == 0 && !starFissures && structures.isEmpty() && carvers.isEmpty() && !structureControl) if (choices.isEmpty() && !skylands && denseOres == 0 && !starFissures && structures.isEmpty() && carvers.isEmpty() && !structureControl && ruins.isEmpty())
throw new IllegalArgumentException("Terrain feature plan must not be empty"); throw new IllegalArgumentException("Terrain feature plan must not be empty");
var counts = new HashMap<Identifier, Integer>(); var counts = new HashMap<Identifier, Integer>();
for (Choice choice : choices) { for (Choice choice : choices) {
@@ -66,6 +70,12 @@ public record PortTerrainFeaturePlan(List<Choice> choices, boolean skylands, int
} }
} }
public PortTerrainFeaturePlan(List<Choice> choices, boolean skylands, int denseOres,
boolean starFissures, List<Identifier> structures, List<Identifier> carvers,
boolean structureControl) {
this(choices, skylands, denseOres, starFissures, structures, carvers, structureControl, List.of());
}
public PortTerrainFeaturePlan(List<Choice> choices, boolean skylands, int denseOres, public PortTerrainFeaturePlan(List<Choice> choices, boolean skylands, int denseOres,
boolean starFissures, List<Identifier> structures, List<Identifier> carvers) { boolean starFissures, List<Identifier> structures, List<Identifier> carvers) {
this(choices, skylands, denseOres, starFissures, structures, carvers, false); this(choices, skylands, denseOres, starFissures, structures, carvers, false);
@@ -159,24 +159,120 @@ public final class RuntimeAgeBackend {
PortTerrainFeaturePlan terrainFeatures, PortWeatherMode weather, PortTerrainFeaturePlan terrainFeatures, PortWeatherMode weather,
PortLighting lighting, PortSkyStyle sky, PortAgeColors colors, PortDayCycle dayCycle, PortLighting lighting, PortSkyStyle sky, PortAgeColors colors, PortDayCycle dayCycle,
List<Identifier> librarySymbols) { List<Identifier> librarySymbols) {
return create(server, id, seed, biomePlan, terrain, rocks, vegetation, dungeons, lakes, terrainFeatures,
weather, lighting, sky, colors, dayCycle, librarySymbols, null);
}
public static ServerLevel create(MinecraftServer server, Identifier id, long seed,
PortBiomePlan biomePlan, PortAgeTerrain terrain, PortRockPlan rocks,
PortVegetationPlan vegetation, int dungeons, PortLakePlan lakes,
PortTerrainFeaturePlan terrainFeatures, PortWeatherMode weather,
PortLighting lighting, PortSkyStyle sky, PortAgeColors colors, PortDayCycle dayCycle,
List<Identifier> librarySymbols, String displayName) {
return create(server, id, seed, biomePlan, terrain, rocks, vegetation, dungeons, lakes, terrainFeatures,
weather, lighting, sky, colors, dayCycle, librarySymbols, displayName, PortRandomPagePolicy.UNRESTRICTED);
}
public static ServerLevel create(MinecraftServer server, Identifier id, long seed,
PortBiomePlan biomePlan, PortAgeTerrain terrain, PortRockPlan rocks,
PortVegetationPlan vegetation, int dungeons, PortLakePlan lakes,
PortTerrainFeaturePlan terrainFeatures, PortWeatherMode weather,
PortLighting lighting, PortSkyStyle sky, PortAgeColors colors, PortDayCycle dayCycle,
List<Identifier> librarySymbols, String displayName, PortRandomPagePolicy policy) {
checkServerThread(server); checkServerThread(server);
ageName(id); String name = ageName(id);
AgeLevelIndex index = index(server); AgeLevelIndex index = index(server);
if (index.contains(id)) throw new IllegalArgumentException("Age already exists: " + id); if (index.contains(id) || server.getLevel(dimensionKey(id)) != null)
PortLibraryWriting.get(server).put(id, librarySymbols); throw new IllegalArgumentException("Age already exists: " + id);
ServerLevel level = load(server, id, seed, biomePlan, terrain, rocks, vegetation, dungeons, lakes, Path directory = archivePaths(server, name).live();
terrainFeatures, lighting, sky, colors, dayCycle); if (Files.exists(directory, LinkOption.NOFOLLOW_LINKS))
((PortAgeLevel) level).configureWeather(weather); throw new IllegalArgumentException("Age storage already exists: " + id);
index.add(id, seed, biomePlan, terrain, rocks, vegetation, dungeons, lakes, terrainFeatures, lighting, sky, colors, dayCycle); PortLibraryWriting writing = PortLibraryWriting.get(server);
PortInstabilityData.get(server).create(level, librarySymbols, terrain, lighting, dayCycle); List<Identifier> priorWriting = writing.symbols(id);
// A newly bound book may be used immediately. Persist its Age identity PortInstabilityData instability = PortInstabilityData.get(server);
// before publishing the catalog so a later crash cannot leave that PortInstabilityData.Age priorInstability = instability.snapshot(id);
// book pointing at a world omitted from the on-disk index. PortSeasonPolicies seasons = PortSeasonPolicies.get(server);
server.overworld().getDataStorage().saveAndJoin(); PortSeasonPolicies.Policy priorSeason = seasons.snapshot(id);
ServerLevel level = null;
try {
seasons.put(id, PortSeasonPolicies.select(librarySymbols, seed, terrain,
net.dnorberg.rivencraft.compat.SereneSeasonsCompatibility.available(), policy));
writing.put(id, librarySymbols);
level = load(server, id, seed, biomePlan, terrain, rocks, vegetation, dungeons, lakes,
terrainFeatures, lighting, sky, colors, dayCycle);
((PortAgeLevel) level).configureWeather(weather);
int accelerated = PortAcceleratedTicks.pageCount(librarySymbols);
if (accelerated > 0) PortAcceleratedTicks.configure(level, accelerated);
index.add(id, seed, biomePlan, terrain, rocks, vegetation, dungeons, lakes, terrainFeatures, lighting, sky, colors, dayCycle);
instability.create(level, librarySymbols, terrain, lighting, dayCycle);
if (displayName != null) index.setDisplayName(id, displayName);
// Commit all initial metadata before announcing an enterable Age.
level.getDataStorage().saveAndJoin();
server.overworld().getDataStorage().saveAndJoin();
} catch (RuntimeException failure) {
boolean closed = !(failure instanceof FailedAgeCleanupException);
if (level != null) {
try { closeFailedCreation(server, level); }
catch (RuntimeException cleanup) { closed = false; failure.addSuppressed(cleanup); }
}
index.discardCreation(id);
writing.put(id, priorWriting);
instability.restore(id, priorInstability);
seasons.put(id, priorSeason);
try { server.overworld().getDataStorage().saveAndJoin(); }
catch (RuntimeException cleanup) { failure.addSuppressed(cleanup); }
// Only the exact, previously absent directory belongs to this attempt.
// If closing failed, leave its files in place rather than race a writer.
if (closed) {
try { removeFailedCreationDirectory(server, name, directory); }
catch (IOException | RuntimeException cleanup) { failure.addSuppressed(cleanup); }
}
throw failure;
}
net.dnorberg.rivencraft.compat.SereneSeasonsCompatibility.apply(level);
AgeCatalogSync.onCatalogChanged(server); AgeCatalogSync.onCatalogChanged(server);
return level; return level;
} }
private static final class FailedAgeCleanupException extends IllegalStateException {
FailedAgeCleanupException(RuntimeException cause) { super("Failed Age stores could not close; files retained", cause); }
}
private static void closeFailedCreation(MinecraftServer server, ServerLevel level) {
if (!level.players().isEmpty()) throw new IllegalStateException("Failed Age contains players: " + level.dimension().identifier());
RuntimeException error = null;
try { level.getChunkSource().deactivateTicketsOnClosing(); }
catch (RuntimeException failure) { error = failure; }
try { level.close(); }
catch (IOException | RuntimeException failure) {
if (error == null) error = new IllegalStateException("Could not close failed Age", failure);
else error.addSuppressed(failure);
} finally {
server.levels.remove(level.dimension(), level);
try { NeoForge.EVENT_BUS.post(new LevelEvent.Unload(level)); }
catch (RuntimeException failure) {
if (error == null) error = failure; else error.addSuppressed(failure);
}
}
if (error != null) throw error;
}
private static void removeFailedCreationDirectory(MinecraftServer server, String name, Path directory) throws IOException {
if (!archivePaths(server, name).live().equals(directory)) throw new IOException("Age directory changed during rollback");
if (!Files.exists(directory, LinkOption.NOFOLLOW_LINKS)) return;
Files.walkFileTree(directory, new java.nio.file.SimpleFileVisitor<Path>() {
@Override public java.nio.file.FileVisitResult visitFile(Path file, java.nio.file.attribute.BasicFileAttributes attributes) throws IOException {
Files.delete(file);
return java.nio.file.FileVisitResult.CONTINUE;
}
@Override public java.nio.file.FileVisitResult postVisitDirectory(Path dir, IOException error) throws IOException {
if (error != null) throw error;
Files.delete(dir);
return java.nio.file.FileVisitResult.CONTINUE;
}
});
}
/** Unloads an Age only when no player remains; save(true) flushes other entities. */ /** Unloads an Age only when no player remains; save(true) flushes other entities. */
public static void unload(MinecraftServer server, Identifier id) { public static void unload(MinecraftServer server, Identifier id) {
checkServerThread(server); checkServerThread(server);
@@ -278,6 +374,7 @@ public final class RuntimeAgeBackend {
} }
throw new IllegalStateException("Could not archive Age " + id, exception); throw new IllegalStateException("Could not archive Age " + id, exception);
} }
net.dnorberg.rivencraft.compat.SereneSeasonsCompatibility.retired(server, id);
AgeCatalogSync.onCatalogChanged(server); AgeCatalogSync.onCatalogChanged(server);
Rivencraft.LOGGER.info("Retired 26.3 prototype Age {} (archived at {})", id, paths.archive()); Rivencraft.LOGGER.info("Retired 26.3 prototype Age {} (archived at {})", id, paths.archive());
} }
@@ -309,6 +406,23 @@ public final class RuntimeAgeBackend {
return index(server).dayCycles(); return index(server).dayCycles();
} }
/** Snapshot only loaded Age settings; viewing a book never loads its destination. */
public static Map<Identifier, PortAgeDescription> loadedDescriptions(MinecraftServer server) {
checkServerThread(server);
AgeLevelIndex index = index(server);
var descriptions = new java.util.HashMap<Identifier, PortAgeDescription>();
var knownAges = index.entries().keySet();
for (var level : server.getAllLevels()) {
Identifier id = level.dimension().identifier();
if (!(level instanceof PortAgeLevel age) || !knownAges.contains(id)) continue;
PortBiomePlan biomes = index.biomePlan(id);
descriptions.put(id, new PortAgeDescription(index.terrain(id),
biomes == null ? PortBiomePlan.Distribution.NATIVE : biomes.distribution(),
index.lighting(id), age.weatherMode()));
}
return Map.copyOf(descriptions);
}
/** Includes retired IDs, which must never be silently reused by a new book. */ /** Includes retired IDs, which must never be silently reused by a new book. */
public static boolean isNameTaken(MinecraftServer server, Identifier id) { public static boolean isNameTaken(MinecraftServer server, Identifier id) {
checkServerThread(server); checkServerThread(server);
@@ -420,10 +534,12 @@ public final class RuntimeAgeBackend {
PortVegetationPlan vegetation, int dungeons, PortLakePlan lakes, PortVegetationPlan vegetation, int dungeons, PortLakePlan lakes,
PortTerrainFeaturePlan terrainFeatures, PortLighting lighting, PortSkyStyle sky, PortTerrainFeaturePlan terrainFeatures, PortLighting lighting, PortSkyStyle sky,
PortAgeColors colors, PortDayCycle dayCycle) { PortAgeColors colors, PortDayCycle dayCycle) {
net.dnorberg.rivencraft.compat.TerraBlenderBiomes.nether(server.registryAccess());
ResourceKey<Level> key = ResourceKey.create(Registries.DIMENSION, id); ResourceKey<Level> key = ResourceKey.create(Registries.DIMENSION, id);
if (server.getLevel(key) != null) throw new IllegalArgumentException("Level already loaded: " + id); if (server.getLevel(key) != null) throw new IllegalArgumentException("Level already loaded: " + id);
if (biomePlan != null && biomePlan.distribution() == PortBiomePlan.Distribution.NATIVE if (biomePlan != null && biomePlan.distribution() == PortBiomePlan.Distribution.NATIVE
&& !biomePlan.biomes().isEmpty() && terrain != PortAgeTerrain.CAVE) && !biomePlan.biomes().isEmpty() && terrain != PortAgeTerrain.CAVE
&& biomePlan.nativeKind() == net.dnorberg.rivencraft.shared.NativeBiomeKind.TERRAIN)
throw new IllegalArgumentException("Only Native Cave terrain may carry an explicit native biome pool"); throw new IllegalArgumentException("Only Native Cave terrain may carry an explicit native biome pool");
// Noise terrains reuse the Overworld biome source unless a // Noise terrains reuse the Overworld biome source unless a
@@ -462,15 +578,24 @@ public final class RuntimeAgeBackend {
generator = biomePlan != null && biomePlan.biomes().size() > 1 generator = biomePlan != null && biomePlan.biomes().size() > 1
? new PortFlatChunkGenerator(authoredBiomeSource(server, biomePlan, seed), settings) ? new PortFlatChunkGenerator(authoredBiomeSource(server, biomePlan, seed), settings)
: new FlatLevelSource(settings); : new FlatLevelSource(settings);
} else if ((biomePlan != null && biomePlan.distribution() != PortBiomePlan.Distribution.NATIVE) } else if ((biomePlan != null && (biomePlan.distribution() != PortBiomePlan.Distribution.NATIVE
|| biomePlan.nativeKind() != net.dnorberg.rivencraft.shared.NativeBiomeKind.TERRAIN))
|| terrain != PortAgeTerrain.STANDARD) { || terrain != PortAgeTerrain.STANDARD) {
if (!(generator instanceof NoiseBasedChunkGenerator noise)) // A Flat/skyblock Overworld has no noise generator to adapt. Native
throw new IllegalStateException("Overworld generator cannot accept authored noise settings"); // family pages must still work with an independently authored noise terrain.
NoiseBasedChunkGenerator noise = generator instanceof NoiseBasedChunkGenerator existingNoise ? existingNoise
: new NoiseBasedChunkGenerator(
net.minecraft.world.level.biome.MultiNoiseBiomeSource.createFromPreset(
server.registryAccess().lookupOrThrow(Registries.MULTI_NOISE_BIOME_SOURCE_PARAMETER_LIST)
.getOrThrow(ResourceKey.create(Registries.MULTI_NOISE_BIOME_SOURCE_PARAMETER_LIST,
Identifier.withDefaultNamespace("overworld")))),
server.registryAccess().lookupOrThrow(Registries.NOISE_SETTINGS).getOrThrow(NoiseGeneratorSettings.OVERWORLD));
var source = terrain == PortAgeTerrain.CAVE var source = terrain == PortAgeTerrain.CAVE
? new FixedBiomeSource(server.registryAccess().lookupOrThrow(Registries.BIOME) ? new FixedBiomeSource(server.registryAccess().lookupOrThrow(Registries.BIOME)
.getOrThrow(Biomes.LUSH_CAVES)) .getOrThrow(Biomes.LUSH_CAVES))
: generator.getBiomeSource(); : noise.getBiomeSource();
if (terrain == PortAgeTerrain.CAVE && biomePlan != null) { if (terrain == PortAgeTerrain.CAVE && biomePlan != null
&& biomePlan.nativeKind() == net.dnorberg.rivencraft.shared.NativeBiomeKind.TERRAIN) {
var biomes = server.registryAccess().lookupOrThrow(Registries.BIOME); var biomes = server.registryAccess().lookupOrThrow(Registries.BIOME);
for (Identifier biomeId : biomePlan.biomes()) { for (Identifier biomeId : biomePlan.biomes()) {
var holder = biomes.get(ResourceKey.create(Registries.BIOME, biomeId)) var holder = biomes.get(ResourceKey.create(Registries.BIOME, biomeId))
@@ -480,6 +605,7 @@ public final class RuntimeAgeBackend {
} }
} }
if (biomePlan != null && (biomePlan.distribution() != PortBiomePlan.Distribution.NATIVE if (biomePlan != null && (biomePlan.distribution() != PortBiomePlan.Distribution.NATIVE
|| biomePlan.nativeKind() != net.dnorberg.rivencraft.shared.NativeBiomeKind.TERRAIN
|| terrain == PortAgeTerrain.CAVE && !biomePlan.biomes().isEmpty())) { || terrain == PortAgeTerrain.CAVE && !biomePlan.biomes().isEmpty())) {
source = authoredBiomeSource(server, biomePlan, seed); source = authoredBiomeSource(server, biomePlan, seed);
} }
@@ -506,6 +632,7 @@ public final class RuntimeAgeBackend {
// Publish only after the constructor succeeds. If the load event fails, // Publish only after the constructor succeeds. If the load event fails,
// roll back the map and close the newly opened chunk/entity stores. // roll back the map and close the newly opened chunk/entity stores.
try { try {
net.dnorberg.rivencraft.compat.RuinsCompatibility.registerAge(id, terrainFeatures);
server.levels.put(key, level); server.levels.put(key, level);
level.getWorldBorder().setAbsoluteMaxSize(server.getAbsoluteMaxWorldSize()); level.getWorldBorder().setAbsoluteMaxSize(server.getAbsoluteMaxWorldSize());
server.getPlayerList().addWorldborderListener(level); server.getPlayerList().addWorldborderListener(level);
@@ -518,11 +645,10 @@ public final class RuntimeAgeBackend {
Rivencraft.LOGGER.info("Loaded 26.3 prototype Age {} with seed {}", id, seed); Rivencraft.LOGGER.info("Loaded 26.3 prototype Age {} with seed {}", id, seed);
return level; return level;
} catch (RuntimeException exception) { } catch (RuntimeException exception) {
server.levels.remove(key); try { closeFailedCreation(server, level); }
try { catch (RuntimeException cleanup) {
level.close(); exception.addSuppressed(cleanup);
} catch (IOException closeException) { throw new FailedAgeCleanupException(exception);
exception.addSuppressed(closeException);
} }
throw exception; throw exception;
} }
@@ -40,7 +40,8 @@ public final class CrystalPortalBlock extends BaseEntityBlock {
@Override protected RenderShape getRenderShape(BlockState state) { @Override protected RenderShape getRenderShape(BlockState state) {
// Keep the animated fallback until the optional destination view has // Keep the animated fallback until the optional destination view has
// actually been established, including after a world restart. // actually been established, including after a world restart.
return RenderShape.MODEL; return net.dnorberg.rivencraft.compat.ImmersiveBookPreviews.available() && state.getValue(LIVE_VIEW)
? RenderShape.INVISIBLE : RenderShape.MODEL;
} }
@Override public BlockEntity newBlockEntity(BlockPos pos, BlockState state) { @Override public BlockEntity newBlockEntity(BlockPos pos, BlockState state) {
return new CrystalPortalBlockEntity(pos, state); return new CrystalPortalBlockEntity(pos, state);
@@ -25,7 +25,10 @@ public final class BookReceptacleBlockEntity extends BlockEntity {
public ItemStack getBook() { return book; } public ItemStack getBook() { return book; }
public int skyColor() { return skyColor; } public int skyColor() { return skyColor; }
public void setBook(ItemStack value) { public void setBook(ItemStack value) {
if (level instanceof ServerLevel server)
net.dnorberg.rivencraft.compat.ImmersiveCrystalPortals.remove(server, worldPosition);
book = value.copyWithCount(1); book = value.copyWithCount(1);
restore = true;
skyColor = 0xffffff; skyColor = 0xffffff;
if (level instanceof ServerLevel source) { if (level instanceof ServerLevel source) {
var destination = book.get(Rivencraft.LINK_BOOK_TARGET.get()); var destination = book.get(Rivencraft.LINK_BOOK_TARGET.get());
@@ -53,7 +56,11 @@ public final class BookReceptacleBlockEntity extends BlockEntity {
} }
sync(); sync();
} }
public ItemStack takeBook() { ItemStack result = book; book = ItemStack.EMPTY; skyColor = 0xffffff; sync(); return result; } public ItemStack takeBook() {
if (level instanceof ServerLevel server)
net.dnorberg.rivencraft.compat.ImmersiveCrystalPortals.remove(server, worldPosition);
ItemStack result = book; book = ItemStack.EMPTY; skyColor = 0xffffff; sync(); return result;
}
private void sync() { private void sync() {
setChanged(); setChanged();
if (level != null && !level.isClientSide()) { if (level != null && !level.isClientSide()) {
@@ -73,6 +80,7 @@ public final class BookReceptacleBlockEntity extends BlockEntity {
boolean restoring = holder.restore; boolean restoring = holder.restore;
if (restoring && !plan.valid() && CrystalPortalNetwork.recoverSavedOwners(level, pos)) if (restoring && !plan.valid() && CrystalPortalNetwork.recoverSavedOwners(level, pos))
plan = CrystalPortalNetwork.plan(level, pos); plan = CrystalPortalNetwork.plan(level, pos);
if (restoring && plan.valid()) CrystalPortalNetwork.setLiveView(level, plan, false);
CrystalPortalNetwork.reconcile(level, pos, plan); CrystalPortalNetwork.reconcile(level, pos, plan);
holder.restore = false; holder.restore = false;
if (restoring) holder.sync(); if (restoring) holder.sync();
@@ -20,17 +20,23 @@ public final class AgeCatalogClient {
@SubscribeEvent @SubscribeEvent
public static void logout(net.neoforged.neoforge.client.event.ClientPlayerNetworkEvent.LoggingOut event) { public static void logout(net.neoforged.neoforge.client.event.ClientPlayerNetworkEvent.LoggingOut event) {
PortBookPreview.logout();
net.dnorberg.rivencraft.age.PortAgeColors.updateClient(java.util.Map.of()); net.dnorberg.rivencraft.age.PortAgeColors.updateClient(java.util.Map.of());
net.dnorberg.rivencraft.age.PortDayCycle.updateClient(java.util.Map.of()); net.dnorberg.rivencraft.age.PortDayCycle.updateClient(java.util.Map.of());
net.dnorberg.rivencraft.age.PortAgeDescription.updateClient(java.util.Map.of());
} }
@SubscribeEvent @SubscribeEvent
public static void register(RegisterClientPayloadHandlersEvent event) { public static void register(RegisterClientPayloadHandlersEvent event) {
event.register(net.dnorberg.rivencraft.network.BookPreviewPayload.TYPE, (payload, context) -> PortBookPreview.accept(payload));
event.register(net.dnorberg.rivencraft.network.WritingDeskCatalogPayload.TYPE, ClientWritingDeskCatalog::handle); event.register(net.dnorberg.rivencraft.network.WritingDeskCatalogPayload.TYPE, ClientWritingDeskCatalog::handle);
event.register(net.dnorberg.rivencraft.network.SereneAgeWhitelistPayload.TYPE, (payload, context) ->
net.dnorberg.rivencraft.compat.SereneSeasonsCompatibility.acceptClient(payload.dimensionId(), payload.enabled()));
event.register(AgeCatalogPayload.TYPE, (payload, context) -> { event.register(AgeCatalogPayload.TYPE, (payload, context) -> {
if (!(context.listener() instanceof ClientPacketListener listener)) return; if (!(context.listener() instanceof ClientPacketListener listener)) return;
net.dnorberg.rivencraft.age.PortAgeColors.updateClient(payload.colors()); net.dnorberg.rivencraft.age.PortAgeColors.updateClient(payload.colors());
net.dnorberg.rivencraft.age.PortDayCycle.updateClient(payload.dayCycles()); net.dnorberg.rivencraft.age.PortDayCycle.updateClient(payload.dayCycles());
net.dnorberg.rivencraft.age.PortAgeDescription.updateClient(payload.descriptions());
if (listener.getLevel() != null) { if (listener.getLevel() != null) {
listener.getLevel().environmentAttributes().invalidateTickCache(); listener.getLevel().environmentAttributes().invalidateTickCache();
listener.getLevel().updateSkyBrightness(); listener.getLevel().updateSkyBrightness();
@@ -0,0 +1,109 @@
package net.dnorberg.rivencraft.client;
import com.mojang.blaze3d.pipeline.RenderTarget;
import com.mojang.blaze3d.pipeline.TextureTarget;
import com.mojang.blaze3d.systems.RenderSystem;
import com.mojang.renderpearl.api.GpuFormat;
import com.mojang.renderpearl.api.textures.FilterMode;
import net.dnorberg.rivencraft.item.LinkBookTarget;
import net.minecraft.client.Minecraft;
import net.minecraft.client.gui.GuiGraphicsExtractor;
import net.minecraft.core.BlockPos;
import net.minecraft.core.registries.Registries;
import net.minecraft.resources.ResourceKey;
import net.minecraft.world.phys.Vec3;
import org.joml.Matrix4f;
import org.joml.Vector4f;
import qouteall.imm_ptl.core.ClientWorldLoader;
import qouteall.imm_ptl.core.render.GuiPortalRendering;
import qouteall.imm_ptl.core.render.context_management.WorldRenderInfo;
/** The portal engine renders before GUI drawing; the deferred GUI samples its target normally. */
public final class ImmersiveLiveBookPanel implements PortBookPreview.LivePanel {
// The engine retains queued tasks. Keep one reusable target alive across screen
// removal instead of deleting textures still referenced by a queued GUI frame.
private static RenderTarget target;
private static ImmersiveLiveBookPanel queued;
private LinkBookTarget destination;
private boolean closed;
private boolean exploring;
private Vec3 explorePosition;
private float yaw, pitch, playerYaw, playerPitch;
@Override public void exploring(boolean enabled) {
exploring = enabled;
if (enabled && destination != null) {
explorePosition = new Vec3(destination.x(), destination.y() + 1.62, destination.z());
yaw = destination.yaw(); pitch = destination.pitch();
var player = Minecraft.getInstance().player;
if (player != null) {
explorePosition = new Vec3(destination.x(), destination.y() + player.getEyeHeight(), destination.z());
playerYaw = player.getYRot(); playerPitch = player.getXRot();
}
}
}
@Override public void tick() {
var player = Minecraft.getInstance().player;
if (!exploring || destination == null || player == null) return;
yaw = destination.yaw() + net.minecraft.util.Mth.wrapDegrees(player.getYRot() - playerYaw);
pitch = Math.clamp(destination.pitch() + player.getXRot() - playerPitch, -89, 89);
}
@Override public void accept(LinkBookTarget value) { destination = value; }
@Override public boolean render(GuiGraphicsExtractor graphics, int x, int y, int width, int height, float time) {
if (closed || destination == null || !ClientWorldLoader.getIsInitialized()) return false;
var key = ResourceKey.create(Registries.DIMENSION, destination.dimension());
var world = ClientWorldLoader.getWorld(key);
if (world == null || !world.hasChunkAt(BlockPos.containing(destination.x(), destination.y(), destination.z()))) return false;
var minecraft = Minecraft.getInstance();
var main = minecraft.gameRenderer.mainRenderTarget();
if (target == null) target = new TextureTarget("Rivencraft live book", main.width, main.height,
GpuFormat.RGBA8_UNORM, main.getDepthTexture().getFormat());
Vec3 center = new Vec3(destination.x(), destination.y() + 2.5, destination.z());
double angle = time * 0.012;
Vec3 camera = center.add(Math.sin(angle) * 11, 5, Math.cos(angle) * 11);
Matrix4f transform;
if (exploring && explorePosition != null) {
camera = explorePosition;
transform = new Matrix4f().rotateX((float) Math.toRadians(pitch))
.rotateY((float) Math.toRadians(yaw + 180));
} else transform = new Matrix4f().rotateX((float) Math.toRadians(20)).rotateY((float) angle);
var info = new WorldRenderInfo.Builder().setWorld(world).setCameraPos(camera)
.setCameraTransformation(transform).setOverwriteCameraTransformation(true)
.setRenderDistance(Math.min(8, minecraft.options.getEffectiveRenderDistance()))
.setDoRenderHand(false).setEnableViewBobbing(false).setDoRenderSky(true).setHasFog(true).build();
// Overlay-to-screen transitions can extract this panel twice before the portal engine
// drains its queue. Its API accepts only one task per target until then.
// Reuse that pending view for subsequent draws instead of submitting twice.
if (queued == null) {
// Submit first: The portal engine may resize the target and invalidate its texture view.
// GPU clearing happens in beginRender(), before remote rendering.
GuiPortalRendering.submitNextFrameRendering(info, target);
queued = this;
}
graphics.blit(target.getColorTextureView(), RenderSystem.getSamplerCache().getClampToEdge(FilterMode.LINEAR),
x, y, x + width, y + height, 0, 1, 1, 0);
graphics.outline(x, y, width, height, 0xFF7B6AA8);
return true;
}
/** Called by the optional engine mixin on the render thread, never during GUI drawing. */
public static void beginRender() {
if (queued == null || target == null) return;
RenderSystem.getDevice().createCommandEncoder().clearColorAndDepthTextures(
target.getColorTexture(), new Vector4f(0, 0, 0, 1), target.getDepthTexture(), 0.0);
}
/** Remote render changes the shared camera; restore it before rain/audio use it. */
public static void endRender() {
if (queued == null) return;
queued = null;
var minecraft = Minecraft.getInstance();
if (minecraft.level != null && minecraft.getCameraEntity() != null) {
var camera = minecraft.gameRenderer.mainCamera();
camera.setLevel(minecraft.level);
camera.setEntity(minecraft.getCameraEntity());
camera.update(minecraft.getDeltaTracker());
}
}
@Override public void close() { exploring(false); closed = true; destination = null; }
}
@@ -4,6 +4,9 @@ import net.dnorberg.rivencraft.Rivencraft;
import net.dnorberg.rivencraft.item.LinkProperties; import net.dnorberg.rivencraft.item.LinkProperties;
import net.dnorberg.rivencraft.menu.LinkModifierMenu; import net.dnorberg.rivencraft.menu.LinkModifierMenu;
import net.dnorberg.rivencraft.network.SetLinkModifierTitlePayload; import net.dnorberg.rivencraft.network.SetLinkModifierTitlePayload;
import net.dnorberg.rivencraft.network.SetLinkModifierSeedPayload;
import com.mojang.blaze3d.platform.InputConstants;
import net.minecraft.client.input.MouseButtonEvent;
import net.minecraft.client.gui.GuiGraphicsExtractor; import net.minecraft.client.gui.GuiGraphicsExtractor;
import net.minecraft.client.gui.components.EditBox; import net.minecraft.client.gui.components.EditBox;
import net.minecraft.client.gui.screens.inventory.AbstractContainerScreen; import net.minecraft.client.gui.screens.inventory.AbstractContainerScreen;
@@ -28,8 +31,13 @@ public final class LinkModifierScreen extends AbstractContainerScreen<LinkModifi
LinkModifierMenu.TOGGLE_INTRA_ONLY, LinkModifierMenu.TOGGLE_MOMENTUM, LinkModifierMenu.TOGGLE_RELATIVE, LinkModifierMenu.TOGGLE_PLATFORM}; LinkModifierMenu.TOGGLE_INTRA_ONLY, LinkModifierMenu.TOGGLE_MOMENTUM, LinkModifierMenu.TOGGLE_RELATIVE, LinkModifierMenu.TOGGLE_PLATFORM};
private static final String[] NAMES = {"disarm", "intra_linking", "intra_linking_only", "maintain_momentum", "relative_link", "generate_platform"}; private static final String[] NAMES = {"disarm", "intra_linking", "intra_linking_only", "maintain_momentum", "relative_link", "generate_platform"};
private EditBox titleInput; private EditBox titleInput;
private EditBox seedInput;
private Identifier seedAge;
private long lastSeed = Long.MIN_VALUE;
private ItemStack lastBook = ItemStack.EMPTY; private ItemStack lastBook = ItemStack.EMPTY;
private boolean refreshing; private boolean refreshing;
private Button retireButton;
private Button confirmRetireButton;
private final Button[] options = new Button[6]; private final Button[] options = new Button[6];
public LinkModifierScreen(LinkModifierMenu menu, Inventory inventory, Component title) { public LinkModifierScreen(LinkModifierMenu menu, Inventory inventory, Component title) {
@@ -46,6 +54,11 @@ public final class LinkModifierScreen extends AbstractContainerScreen<LinkModifi
if (!refreshing) ClientPacketDistributor.sendToServer(new SetLinkModifierTitlePayload(menu.containerId, value)); if (!refreshing) ClientPacketDistributor.sendToServer(new SetLinkModifierTitlePayload(menu.containerId, value));
}); });
addRenderableWidget(titleInput); addRenderableWidget(titleInput);
seedInput = new EditBox(font, leftPos + 80, topPos + 15, 87, 14,
Component.translatable("screen.rivencraft.link_modifier.seed"));
seedInput.setMaxLength(21);
seedInput.setTooltip(Tooltip.create(Component.translatable("screen.rivencraft.link_modifier.seed_warning")));
addRenderableWidget(seedInput);
for (int index = 0; index < options.length; index++) { for (int index = 0; index < options.length; index++) {
final int option = index; final int option = index;
options[index] = addRenderableWidget(new Button(leftPos + 5 + (index / 3) * 20, options[index] = addRenderableWidget(new Button(leftPos + 5 + (index / 3) * 20,
@@ -63,8 +76,28 @@ public final class LinkModifierScreen extends AbstractContainerScreen<LinkModifi
}); });
options[index].setTooltip(Tooltip.create(label(index))); options[index].setTooltip(Tooltip.create(label(index)));
} }
retireButton = addRenderableWidget(new RetirementButton(120, LinkModifierMenu.RETIRE_AGE, "retire", false));
confirmRetireButton = addRenderableWidget(new RetirementButton(140, LinkModifierMenu.CONFIRM_RETIRE_AGE, "confirm", true));
refreshControls(); refreshControls();
} }
private final class RetirementButton extends Button {
private final boolean danger;
RetirementButton(int x, int action, String name, boolean danger) {
super(leftPos + x, topPos + 32, 18, 18,
Component.translatable("screen.rivencraft.link_modifier." + name), button -> {
if (minecraft != null && minecraft.gameMode != null)
minecraft.gameMode.handleInventoryButtonClick(menu.containerId, action);
}, DEFAULT_NARRATION);
this.danger = danger;
setTooltip(Tooltip.create(getMessage()));
}
@Override protected void extractContents(GuiGraphicsExtractor graphics, int mouseX, int mouseY, float partialTick) {
int x = getX(), y = getY();
graphics.fill(x, y, x + 18, y + 18, isHoveredOrFocused() ? 0xFFFFFFFF : 0xFFAAAAAA);
graphics.fill(x + 2, y + 2, x + 17, y + 17, danger ? 0xFFAA5555
: menu.awaitingRetirementConfirmation() ? 0xFFBBBBBB : 0xFF777777);
}
}
@Override protected void containerTick() { refreshControls(); } @Override protected void containerTick() { refreshControls(); }
private void refreshControls() { private void refreshControls() {
ItemStack book = menu.book(); ItemStack book = menu.book();
@@ -80,6 +113,28 @@ public final class LinkModifierScreen extends AbstractContainerScreen<LinkModifi
} }
} }
titleInput.setEditable(!book.isEmpty()); titleInput.setEditable(!book.isEmpty());
boolean canRetire = minecraft != null && minecraft.player != null && menu.canRetire(minecraft.player);
if (retireButton != null) {
retireButton.visible = canRetire;
retireButton.active = canRetire && !menu.awaitingRetirementConfirmation();
confirmRetireButton.visible = canRetire && menu.awaitingRetirementConfirmation();
confirmRetireButton.active = confirmRetireButton.visible;
}
Identifier age = book.get(Rivencraft.AGE_BOOK_ID.get());
if (!java.util.Objects.equals(seedAge, age)) {
seedInput.setFocused(false);
seedAge = age;
seedInput.setValue(Long.toString(menu.seed()));
lastSeed = menu.seed();
}
seedInput.visible = menu.hasSeed();
seedInput.setEditable(seedInput.visible);
if (!seedInput.visible) seedInput.setFocused(false);
else if (!seedInput.isFocused() && (lastSeed != menu.seed()
|| !seedInput.getValue().equals(Long.toString(menu.seed())))) {
lastSeed = menu.seed();
seedInput.setValue(Long.toString(lastSeed));
}
for (int i = 0; i < options.length; i++) if (options[i] != null) { for (int i = 0; i < options.length; i++) if (options[i] != null) {
options[i].active = available(i); options[i].active = available(i);
Component label = label(i); Component label = label(i);
@@ -97,7 +152,30 @@ public final class LinkModifierScreen extends AbstractContainerScreen<LinkModifi
return name.copy().append(selected(index, return name.copy().append(selected(index,
menu.book().getOrDefault(Rivencraft.LINK_PROPERTIES.get(), LinkProperties.NONE)) ? ": On" : ": Off"); menu.book().getOrDefault(Rivencraft.LINK_PROPERTIES.get(), LinkProperties.NONE)) ? ": On" : ": Off");
} }
private void submitSeed() {
if (seedInput.visible && seedAge != null && !seedInput.getValue().equals(Long.toString(menu.seed())))
ClientPacketDistributor.sendToServer(new SetLinkModifierSeedPayload(menu.containerId, seedAge, seedInput.getValue()));
}
@Override public boolean mouseClicked(MouseButtonEvent event, boolean doubleClick) {
if (seedInput.isFocused() && !seedInput.isMouseOver(event.x(), event.y())) {
submitSeed();
seedInput.setFocused(false);
}
return super.mouseClicked(event, doubleClick);
}
@Override public boolean keyPressed(KeyEvent event) { @Override public boolean keyPressed(KeyEvent event) {
if (seedInput != null && seedInput.isFocused()) {
if (event.key() == InputConstants.KEY_RETURN || event.key() == InputConstants.KEY_NUMPADENTER) {
submitSeed();
seedInput.setFocused(false);
setFocused(null);
return true;
}
if (!event.isEscape()) {
seedInput.keyPressed(event);
return true;
}
}
if (titleInput != null && titleInput.isFocused() && !event.isEscape()) { if (titleInput != null && titleInput.isFocused() && !event.isEscape()) {
titleInput.keyPressed(event); titleInput.keyPressed(event);
return true; // Character input must never activate inventory/hotbar shortcuts. return true; // Character input must never activate inventory/hotbar shortcuts.
@@ -0,0 +1,120 @@
package net.dnorberg.rivencraft.client;
import net.dnorberg.rivencraft.Rivencraft;
import net.minecraft.client.KeyMapping;
import net.minecraft.client.Minecraft;
import net.minecraft.client.gui.components.Button;
import net.minecraft.client.gui.components.Tooltip;
import net.minecraft.client.gui.screens.Screen;
import net.minecraft.network.chat.Component;
import net.minecraft.world.phys.Vec3;
import net.neoforged.api.distmarker.Dist;
import net.neoforged.bus.api.SubscribeEvent;
import net.neoforged.fml.common.EventBusSubscriber;
import net.neoforged.neoforge.client.event.ClientTickEvent;
import net.neoforged.neoforge.client.event.InputEvent;
import net.neoforged.neoforge.client.event.RenderGuiEvent;
import com.mojang.blaze3d.platform.InputConstants;
/** Matches 1.21.1: grabbed mouse look with the book drawn over the source world. */
@EventBusSubscriber(modid = Rivencraft.MOD_ID, value = Dist.CLIENT)
public final class PortBookExploration {
private static PortBookExploration current;
private final PortLegacyLinkPanel panel;
private Screen owner;
private Button eye;
private Vec3 sourcePosition;
private net.minecraft.client.multiplayer.ClientLevel sourceLevel;
private int guiWidth, guiHeight;
private boolean active;
PortBookExploration(PortLegacyLinkPanel panel) { this.panel = panel; }
void attach(Screen screen, java.util.function.Consumer<Button> add, int left, int top, boolean stand) {
owner = screen;
eye = Button.builder(Component.literal("👁"), button -> {
var minecraft = Minecraft.getInstance();
if (stand || !panel.canExplore() || minecraft.player == null) return;
sourcePosition = minecraft.player.position();
sourceLevel = minecraft.level;
guiWidth = minecraft.getWindow().getGuiScaledWidth();
guiHeight = minecraft.getWindow().getGuiScaledHeight();
active = true;
current = this;
eye.visible = false;
panel.exploring(true);
KeyMapping.releaseAll();
// Removing the screen grabs the mouse normally. removed() preserves this session.
minecraft.gui.setScreen(null);
}).bounds(left + 229, top + 145, 20, 20).build();
eye.active = !stand;
eye.setTooltip(Tooltip.create(Component.literal("Look around destination (right-click to return)")));
add.accept(eye);
}
void tick(boolean frontPage) {
if (eye != null) eye.visible = !active && frontPage && panel.canExplore();
}
boolean active() { return active; }
void stop() {
active = false;
if (current == this) current = null;
sourcePosition = null;
sourceLevel = null;
panel.exploring(false);
}
@SubscribeEvent
public static void beforeTick(ClientTickEvent.Pre event) {
if (current != null) KeyMapping.releaseAll();
}
@SubscribeEvent
public static void afterTick(ClientTickEvent.Post event) {
var overlay = current;
if (overlay == null) return;
var minecraft = Minecraft.getInstance();
if (minecraft.player == null || minecraft.level != overlay.sourceLevel || minecraft.gui.screen() != null) {
overlay.stop();
overlay.panel.close();
return;
}
minecraft.player.setPos(overlay.sourcePosition);
minecraft.player.setDeltaMovement(Vec3.ZERO);
overlay.panel.tick();
}
@SubscribeEvent
public static void drawBook(RenderGuiEvent.Post event) {
var overlay = current;
var minecraft = Minecraft.getInstance();
if (overlay == null || minecraft.gui.screen() != null) return;
int width = minecraft.getWindow().getGuiScaledWidth();
int height = minecraft.getWindow().getGuiScaledHeight();
if (width != overlay.guiWidth || height != overlay.guiHeight) {
overlay.guiWidth = width;
overlay.guiHeight = height;
overlay.owner.resize(width, height);
overlay.eye.visible = false;
}
overlay.owner.extractRenderState(event.getGuiGraphics(), -1, -1,
event.getPartialTick().getGameTimeDeltaPartialTick(false));
}
@SubscribeEvent
public static void mouseButton(InputEvent.MouseButton.Pre event) {
var overlay = current;
if (overlay == null || Minecraft.getInstance().gui.screen() != null) return;
// Neither mouse button may use the held book or attack in the source world.
event.setCanceled(true);
if (event.getButton() == InputConstants.MOUSE_BUTTON_RIGHT && event.getAction() == InputConstants.PRESS) {
overlay.stop();
KeyMapping.releaseAll();
// Unlike 1.21.1 setScreen, setScreenAndShow forces a render immediately.
// Resume through the regular GUI lifecycle without nesting a new frame.
Minecraft.getInstance().gui.setScreen(overlay.owner);
}
}
}
@@ -0,0 +1,84 @@
package net.dnorberg.rivencraft.client;
import java.util.UUID;
import net.dnorberg.rivencraft.compat.ImmersiveBookPreviews;
import net.dnorberg.rivencraft.network.*;
import net.minecraft.client.Minecraft;
import net.minecraft.client.gui.GuiGraphicsExtractor;
import net.minecraft.client.multiplayer.ClientLevel;
import net.minecraft.core.BlockPos;
import net.minecraft.world.InteractionHand;
import net.minecraft.world.item.ItemStack;
import net.neoforged.neoforge.client.network.ClientPacketDistributor;
/** One session per open book; stale replies cannot replace another book's preview. */
public final class PortBookPreview {
interface LivePanel {
void accept(net.dnorberg.rivencraft.item.LinkBookTarget destination);
boolean render(GuiGraphicsExtractor graphics, int x, int y, int width, int height, float time);
void close();
default void exploring(boolean enabled) {}
default void tick() {}
}
private static PortBookPreview active;
private final UUID session = UUID.randomUUID();
private final RequestBookPreviewPayload request;
private final LivePanel live;
private int ticks;
private boolean received;
private boolean closed;
private net.minecraft.resources.Identifier destination;
PortBookPreview(InteractionHand hand, ItemStack book, UseBookStandPayload stand) {
var minecraft = Minecraft.getInstance();
request = minecraft.level == null ? null : new RequestBookPreviewPayload(session,
hand == InteractionHand.OFF_HAND, stand != null, minecraft.level.dimension().identifier(),
stand == null ? BlockPos.ZERO : stand.pos(), book.copy());
boolean enabled = ImmersiveBookPreviews.bookViewsEnabled();
live = enabled ? new ImmersiveLiveBookPanel() : null;
if (active != null) active.close();
active = this;
sendRequest();
}
private void sendRequest() {
if (!closed && live != null && request != null && Minecraft.getInstance().getConnection() != null)
ClientPacketDistributor.sendToServer(request);
}
void tick() {
ticks++;
if (live != null) live.tick();
if (ticks % (received ? 200 : 40) == 0) sendRequest();
}
boolean render(GuiGraphicsExtractor graphics, int x, int y, int width, int height, float partialTick) {
if (closed || !received || live == null) return false;
return live.render(graphics, x, y, width, height, ticks + partialTick);
}
boolean canExplore() { return live != null && received && !closed; }
void exploring(boolean enabled) { if (live != null) live.exploring(enabled); }
public static void accept(BookPreviewPayload payload) {
if (active == null || active.closed || active.live == null || !active.session.equals(payload.session())
|| !payload.destination().valid()) return;
active.destination = payload.destination().dimension();
active.received = true;
active.live.accept(payload.destination());
}
void close() {
if (closed) return;
closed = true;
if (live != null) {
live.close();
if (Minecraft.getInstance().getConnection() != null)
ClientPacketDistributor.sendToServer(new ReleaseBookPreviewPayload(session));
}
if (active == this) active = null;
}
public static void logout() { if (active != null) active.close(); }
public static boolean shouldMute(ClientLevel level) {
var player = Minecraft.getInstance().player;
return active != null && !active.closed && active.destination != null
&& level.dimension().identifier().equals(active.destination)
&& (player == null || level != player.level());
}
}
@@ -15,7 +15,7 @@ import net.minecraft.world.InteractionHand;
import net.minecraft.world.item.ItemStack; import net.minecraft.world.item.ItemStack;
import net.neoforged.neoforge.client.network.ClientPacketDistributor; import net.neoforged.neoforge.client.network.ClientPacketDistributor;
/** Legacy book layout and authored glyph pages; destination rendering remains a port placeholder. */ /** Legacy book spreads, authored symbol pages and random-Age glyph descriptions. */
public final class PortDescriptiveBookScreen extends Screen { public final class PortDescriptiveBookScreen extends Screen {
private static final int WIDTH = 327; private static final int WIDTH = 327;
private static final int HEIGHT = 199; private static final int HEIGHT = 199;
@@ -23,8 +23,11 @@ public final class PortDescriptiveBookScreen extends Screen {
private final InteractionHand hand; private final InteractionHand hand;
private final ItemStack book;
private final boolean bound; private final boolean bound;
private final net.minecraft.resources.Identifier ageId;
private final PortLegacyLinkPanel linkPanel = new PortLegacyLinkPanel(); private final PortLegacyLinkPanel linkPanel = new PortLegacyLinkPanel();
private final PortBookExploration exploration = new PortBookExploration(linkPanel);
private final net.dnorberg.rivencraft.writing.DescriptiveBookPages pages; private final net.dnorberg.rivencraft.writing.DescriptiveBookPages pages;
private int pageIndex; private int pageIndex;
private net.dnorberg.rivencraft.network.UseBookStandPayload standSource; private net.dnorberg.rivencraft.network.UseBookStandPayload standSource;
@@ -33,8 +36,10 @@ public final class PortDescriptiveBookScreen extends Screen {
public PortDescriptiveBookScreen(InteractionHand hand, ItemStack book) { public PortDescriptiveBookScreen(InteractionHand hand, ItemStack book) {
super(book.getHoverName()); super(book.getHoverName());
this.hand = hand; this.hand = hand;
this.book = book.copy();
pages = net.dnorberg.rivencraft.writing.DescriptiveBookPages.from(book); pages = net.dnorberg.rivencraft.writing.DescriptiveBookPages.from(book);
bound = book.has(Rivencraft.AGE_BOOK_ID.get()); ageId = book.get(Rivencraft.AGE_BOOK_ID.get());
bound = ageId != null;
} }
public PortDescriptiveBookScreen(net.dnorberg.rivencraft.network.UseBookStandPayload source) { public PortDescriptiveBookScreen(net.dnorberg.rivencraft.network.UseBookStandPayload source) {
@@ -44,7 +49,12 @@ public final class PortDescriptiveBookScreen extends Screen {
@Override @Override
protected void init() { protected void init() {
if (bound || standSource != null) return; if (bound) {
linkPanel.open(hand, book, standSource);
exploration.attach(this, this::addRenderableWidget, (width - WIDTH) / 2, (height - HEIGHT) / 2, standSource != null);
return;
}
if (standSource != null) return;
int left = (width - WIDTH) / 2; int left = (width - WIDTH) / 2;
int top = (height - HEIGHT) / 2; int top = (height - HEIGHT) / 2;
titleInput = new EditBox(font, left + 40, top + 69, 110, 20, titleInput = new EditBox(font, left + 40, top + 69, 110, 20,
@@ -78,7 +88,9 @@ public final class PortDescriptiveBookScreen extends Screen {
int textY = PortLegacyBookArtwork.drawText(graphics, font, title, left + 40, top + 40, 110, TEXT_COLOR); int textY = PortLegacyBookArtwork.drawText(graphics, font, title, left + 40, top + 40, 110, TEXT_COLOR);
Component author = pages.author().isBlank() Component author = pages.author().isBlank()
? Component.translatable("screen.rivencraft.age.unknown_author") : Component.literal(pages.author()); ? Component.translatable("screen.rivencraft.age.unknown_author") : Component.literal(pages.author());
PortLegacyBookArtwork.drawText(graphics, font, author, left + 50, textY + 2, 100, TEXT_COLOR); int detailsY = PortLegacyBookArtwork.drawText(graphics, font, author,
left + 50, textY + 2, 100, TEXT_COLOR) + 4;
if (pages.symbols().isEmpty()) drawRandomDescription(graphics, left + 40, detailsY);
graphics.disableScissor(); graphics.disableScissor();
} else { } else {
graphics.text(font, title, left + 42, top + 29, TEXT_COLOR, false); graphics.text(font, title, left + 42, top + 29, TEXT_COLOR, false);
@@ -105,6 +117,32 @@ public final class PortDescriptiveBookScreen extends Screen {
super.extractRenderState(graphics, mouseX, mouseY, partialTick); super.extractRenderState(graphics, mouseX, mouseY, partialTick);
} }
private void drawRandomDescription(GuiGraphicsExtractor graphics, int x, int y) {
var description = net.dnorberg.rivencraft.age.PortAgeDescription.forClient(ageId);
if (description == null) return;
var cycle = net.dnorberg.rivencraft.age.PortDayCycle.forClient(ageId);
var lines = java.util.List.of(
Component.translatable("screen.rivencraft.age.generator",
Component.translatable("generator.rivencraft." + description.terrain().name().toLowerCase(java.util.Locale.ROOT))),
Component.translatable("screen.rivencraft.age.trait.biomes", trait("biome_distribution", description.distribution())),
Component.translatable("screen.rivencraft.age.trait.lighting", trait("lighting", description.lighting())),
Component.translatable("screen.rivencraft.age.trait.weather", trait("weather", description.weather())),
Component.translatable("screen.rivencraft.age.trait.day_length", cycle.period() == 0
? Component.translatable("trait.rivencraft.day_length.stopped")
: Component.literal(String.format(java.util.Locale.ROOT, "%.2fx", cycle.period()))),
Component.translatable("screen.rivencraft.age.trait.celestial_angle",
Component.literal(String.format(java.util.Locale.ROOT, "%.0f°", (float) cycle.bearing()))),
Component.translatable("screen.rivencraft.age.trait.celestial_phase",
Component.literal(String.format(java.util.Locale.ROOT, "%.0f%%", cycle.phaseTick() * 100F / 24000F))));
for (var line : lines)
y = PortSymbolPageTextures.drawGlyphText(graphics, line.getString(), x, y, 110) + 2;
}
private static Component trait(String group, Enum<?> value) {
return Component.translatable("trait.rivencraft." + group + "."
+ value.name().toLowerCase(java.util.Locale.ROOT));
}
@Override @Override
public boolean mouseClicked(MouseButtonEvent event, boolean doubleClick) { public boolean mouseClicked(MouseButtonEvent event, boolean doubleClick) {
if (event.button() == InputConstants.MOUSE_BUTTON_LEFT) { if (event.button() == InputConstants.MOUSE_BUTTON_LEFT) {
@@ -150,8 +188,11 @@ public final class PortDescriptiveBookScreen extends Screen {
@Override public void tick() { @Override public void tick() {
if (bound) linkPanel.tick(); if (bound) linkPanel.tick();
exploration.tick(pageIndex == 0);
} }
@Override public void removed() { if (!exploration.active()) { exploration.stop(); linkPanel.close(); } super.removed(); }
@Override @Override
public boolean isPauseScreen() { public boolean isPauseScreen() {
return false; return false;
@@ -14,6 +14,15 @@ final class PortLegacyLinkPanel {
private static final int CELL_SIZE = 3; private static final int CELL_SIZE = 3;
private static final int BORDER_COLOR = 0xFF7B6AA8; private static final int BORDER_COLOR = 0xFF7B6AA8;
private int ticks; private int ticks;
private PortBookPreview preview;
void open(net.minecraft.world.InteractionHand hand, net.minecraft.world.item.ItemStack book,
net.dnorberg.rivencraft.network.UseBookStandPayload stand) {
if (preview == null) preview = new PortBookPreview(hand, book, stand);
}
void close() { if (preview != null) { preview.close(); preview = null; } }
boolean canExplore() { return preview != null && preview.canExplore(); }
void exploring(boolean value) { if (preview != null) preview.exploring(value); }
private static final int LINK_COLOR = 0xFF006666; private static final int LINK_COLOR = 0xFF006666;
static boolean contains(double x, double y) { static boolean contains(double x, double y) {
@@ -26,9 +35,11 @@ final class PortLegacyLinkPanel {
void tick() { void tick() {
ticks++; ticks++;
if (preview != null) preview.tick();
} }
private void render(GuiGraphicsExtractor graphics, int left, int top, int width, int height, float partialTick) { private void render(GuiGraphicsExtractor graphics, int left, int top, int width, int height, float partialTick) {
if (preview != null && preview.render(graphics, left, top, width, height, partialTick)) return;
graphics.fill(left, top, left + width, top + height, 0xFF000011); graphics.fill(left, top, left + width, top + height, 0xFF000011);
float time = (ticks + partialTick) * 0.035F; float time = (ticks + partialTick) * 0.035F;
@@ -23,18 +23,21 @@ public final class PortLinkingBookScreen extends Screen {
private final InteractionHand hand; private final InteractionHand hand;
private final ItemStack book;
private final boolean bound; private final boolean bound;
private final net.dnorberg.rivencraft.item.LinkBookTarget target; private final net.dnorberg.rivencraft.item.LinkBookTarget target;
private final boolean returnLink; private final boolean returnLink;
private final Component destination; private final Component destination;
private int pageIndex; private int pageIndex;
private final PortLegacyLinkPanel linkPanel = new PortLegacyLinkPanel(); private final PortLegacyLinkPanel linkPanel = new PortLegacyLinkPanel();
private final PortBookExploration exploration = new PortBookExploration(linkPanel);
private net.dnorberg.rivencraft.network.UseBookStandPayload standSource; private net.dnorberg.rivencraft.network.UseBookStandPayload standSource;
private EditBox titleInput; private EditBox titleInput;
public PortLinkingBookScreen(InteractionHand hand, ItemStack book) { public PortLinkingBookScreen(InteractionHand hand, ItemStack book) {
super(book.getHoverName()); super(book.getHoverName());
this.hand = hand; this.hand = hand;
this.book = book.copy();
target = book.get(Rivencraft.LINK_BOOK_TARGET.get()); target = book.get(Rivencraft.LINK_BOOK_TARGET.get());
bound = target != null; bound = target != null;
destination = bound ? net.dnorberg.rivencraft.item.LinkingBookItem.destinationName(book, target) : Component.empty(); destination = bound ? net.dnorberg.rivencraft.item.LinkingBookItem.destinationName(book, target) : Component.empty();
@@ -51,7 +54,12 @@ public final class PortLinkingBookScreen extends Screen {
@Override @Override
protected void init() { protected void init() {
if (bound || standSource != null) return; if (bound) {
linkPanel.open(hand, book, standSource);
exploration.attach(this, this::addRenderableWidget, (width - WIDTH) / 2, (height - HEIGHT) / 2, standSource != null);
return;
}
if (standSource != null) return;
int left = (width - WIDTH) / 2; int left = (width - WIDTH) / 2;
int top = (height - HEIGHT) / 2; int top = (height - HEIGHT) / 2;
titleInput = new EditBox(font, left + 40, top + 69, 110, 20, titleInput = new EditBox(font, left + 40, top + 69, 110, 20,
@@ -145,8 +153,11 @@ public final class PortLinkingBookScreen extends Screen {
@Override public void tick() { @Override public void tick() {
if (bound) linkPanel.tick(); if (bound) linkPanel.tick();
exploration.tick(pageIndex == 0);
} }
@Override public void removed() { if (!exploration.active()) { exploration.stop(); linkPanel.close(); } super.removed(); }
@Override @Override
public boolean isPauseScreen() { public boolean isPauseScreen() {
return false; return false;
@@ -10,33 +10,43 @@ import com.mojang.renderpearl.api.buffers.GpuBuffer;
import com.mojang.renderpearl.api.buffers.GpuBufferSlice; import com.mojang.renderpearl.api.buffers.GpuBufferSlice;
import com.mojang.renderpearl.api.pipeline.PrimitiveTopology; import com.mojang.renderpearl.api.pipeline.PrimitiveTopology;
import java.util.Optional; import java.util.Optional;
import net.dnorberg.rivencraft.shared.StaticSkyResolution;
import java.util.OptionalDouble; import java.util.OptionalDouble;
import net.minecraft.client.renderer.RenderPipelines; import net.minecraft.client.renderer.RenderPipelines;
import net.minecraft.client.renderer.texture.DynamicTexture; import net.minecraft.client.renderer.texture.DynamicTexture;
import net.minecraft.util.RandomSource; import net.minecraft.util.RandomSource;
import org.joml.Matrix4f; import org.joml.Matrix4f;
/** Legacy's six 48x48 noise faces, uploaded once per animation frame rather than per cell. */ /** Six bounded authored-resolution noise faces, uploaded once per animation frame rather than per cell. */
public final class PortStaticSky implements AutoCloseable { public final class PortStaticSky implements AutoCloseable {
private static final int GRID = 48; private int grid;
private final DynamicTexture texture = new DynamicTexture("Rivencraft static sky", GRID * 6, GRID, false); private DynamicTexture texture;
private final GpuBuffer cube = buildCube(); private final GpuBuffer cube = buildCube();
private long uploadedFrame = Long.MIN_VALUE; private long uploadedFrame = Long.MIN_VALUE;
private int uploadedTint = -1; private int uploadedTint = -1;
public void render(RenderTarget target, GpuBufferSlice fog, long frame, int tint) { public void render(RenderTarget target, GpuBufferSlice fog, long frame, int tint, int resolution) {
int requested = StaticSkyResolution.clamp(resolution);
if (texture == null || grid != requested) {
var replacement = new DynamicTexture("Rivencraft static sky", requested * 6, requested, false);
if (texture != null) texture.close();
texture = replacement;
grid = requested;
uploadedFrame = Long.MIN_VALUE;
uploadedTint = -1;
}
if (tint < 0) tint = 0x929292; if (tint < 0) tint = 0x929292;
if (uploadedFrame != frame || uploadedTint != tint) { if (uploadedFrame != frame || uploadedTint != tint) {
RandomSource random = RandomSource.create(frame); RandomSource random = RandomSource.create(frame);
var image = texture.getPixels(); var image = texture.getPixels();
for (int face = 0; face < 6; face++) { for (int face = 0; face < 6; face++) {
for (int y = 0; y < GRID; y++) { for (int y = 0; y < grid; y++) {
for (int x = 0; x < GRID; x++) { for (int x = 0; x < grid; x++) {
int noise = 65 + random.nextInt(160); int noise = 65 + random.nextInt(160);
int red = (tint >> 16 & 255) * noise / 255; int red = (tint >> 16 & 255) * noise / 255;
int green = (tint >> 8 & 255) * noise / 255; int green = (tint >> 8 & 255) * noise / 255;
int blue = (tint & 255) * noise / 255; int blue = (tint & 255) * noise / 255;
image.setPixel(face * GRID + x, y, 0xff000000 | red << 16 | green << 8 | blue); image.setPixel(face * grid + x, y, 0xff000000 | red << 16 | green << 8 | blue);
} }
} }
} }
@@ -88,6 +98,6 @@ public final class PortStaticSky implements AutoCloseable {
@Override public void close() { @Override public void close() {
cube.close(); cube.close();
texture.close(); if (texture != null) texture.close();
} }
} }
@@ -183,6 +183,36 @@ public final class PortSymbolPageTextures {
return result; return result;
} }
/** Translated prose becomes Legacy word glyphs, with genuine base-25 numerals. */
public static int drawGlyphText(net.minecraft.client.gui.GuiGraphicsExtractor graphics,
String text, int x, int y, int maxWidth) {
var layout = net.dnorberg.rivencraft.writing.PortGlyphTextLayout.layout(text, maxWidth, 12);
for (var glyph : layout.glyphs()) {
int number = net.dnorberg.rivencraft.writing.PortGlyphTextLayout.number(glyph.word());
if (number >= 0) drawNumeral(graphics, number, x + glyph.x(), y + glyph.y(), 12);
else for (int component : glyphs(glyph.word()))
drawComponent(graphics, component, x + glyph.x(), y + glyph.y(), 12);
}
return y + layout.height();
}
public static void drawNumeral(net.minecraft.client.gui.GuiGraphicsExtractor graphics,
int number, int x, int y, int size) {
int[] digits = PortSymbolNumerals.digitsFor(number);
int digitSize = digits.length == 1 ? size : Math.max(8, size * 3 / 4);
for (int digit : digits) {
for (int component : PortSymbolNumerals.componentsForDigit(digit))
drawComponent(graphics, component, x, y + (size - digitSize) / 2, digitSize);
x += digitSize + 1;
}
}
private static void drawComponent(net.minecraft.client.gui.GuiGraphicsExtractor graphics,
int component, int x, int y, int size) {
graphics.blit(net.minecraft.client.renderer.RenderPipelines.GUI_TEXTURED, COMPONENTS, x, y,
(component % 8) * 64, (component / 8) * 64, size, size, 64, 64, 512, 512, 0xFF211A14);
}
private static Identifier texture(String path) { private static Identifier texture(String path) {
return Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, "textures/" + path + ".png"); return Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, "textures/" + path + ".png");
} }
@@ -0,0 +1,17 @@
package net.dnorberg.rivencraft.client;
import net.minecraft.client.multiplayer.ClientLevel;
import qouteall.imm_ptl.core.ClientWorldLoader;
/** Reborn's world map is briefly unavailable during vanilla dimension replacement. */
public final class RebornPredictionAcks {
private RebornPredictionAcks() {}
public static boolean handleDuringWorldReset(ClientLevel packetLevel, int sequence) {
if (ClientWorldLoader.getIsInitialized()) return false;
// The old remote worlds have been discarded. Preserve the vanilla ack for
// the packet listener's live world until Reborn rebuilds its multiworld map.
if (packetLevel != null) packetLevel.handleBlockChangedAck(sequence);
return true;
}
}
@@ -9,6 +9,8 @@ public interface StaticSkyState {
void rivencraft$bodies(java.util.List<Body> bodies); void rivencraft$bodies(java.util.List<Body> bodies);
long rivencraft$staticFrame(); long rivencraft$staticFrame();
void rivencraft$staticFrame(long frame); void rivencraft$staticFrame(long frame);
int rivencraft$staticResolution();
void rivencraft$staticResolution(int resolution);
int rivencraft$skyTint(); int rivencraft$skyTint();
void rivencraft$skyTint(int color); void rivencraft$skyTint(int color);
int rivencraft$orbitBearing(); int rivencraft$orbitBearing();
@@ -294,15 +294,7 @@ public final class WritingDeskScreen extends AbstractContainerScreen<WritingDesk
} }
private static void drawNumeral(GuiGraphicsExtractor graphics, int number, int x, int y, int size) { private static void drawNumeral(GuiGraphicsExtractor graphics, int number, int x, int y, int size) {
int[] digits = net.dnorberg.rivencraft.writing.PortSymbolNumerals.digitsFor(number); PortSymbolPageTextures.drawNumeral(graphics, number, x, y, size);
int digitSize = digits.length == 1 ? size : Math.max(8, size * 3 / 4);
Identifier components = Identifier.fromNamespaceAndPath("rivencraft", "textures/gui/symbolcomponents.png");
for (int digit : digits) {
for (int component : net.dnorberg.rivencraft.writing.PortSymbolNumerals.componentsForDigit(digit))
graphics.blit(RenderPipelines.GUI_TEXTURED, components, x, y + (size - digitSize) / 2,
(component % 8) * 64, (component / 8) * 64, digitSize, digitSize, 64, 64, 512, 512, 0xFF211A14);
x += digitSize + 1;
}
} }
private DisplayPage pageAtMouse(double mouseX, double mouseY) { private DisplayPage pageAtMouse(double mouseX, double mouseY) {
@@ -0,0 +1,47 @@
package net.dnorberg.rivencraft.compat;
import net.dnorberg.rivencraft.Rivencraft;
import net.dnorberg.rivencraft.PortConfig;
import net.dnorberg.rivencraft.network.RequestBookPreviewPayload;
import net.minecraft.server.level.ServerPlayer;
import net.neoforged.fml.ModList;
import net.neoforged.neoforge.common.NeoForge;
/** No optional API appears in common class signatures. */
public final class ImmersiveBookPreviews {
public static boolean reborn() { return ModList.get().isLoaded("immersive_portals_reborn"); }
public static boolean seamless() { return ModList.get().isLoaded("seamlessportals"); }
public static boolean available() { return reborn() || seamless(); }
public static String engineName() { return seamless() ? "Seamless" : "Reborn"; }
public static boolean bookViewsEnabled() {
return seamless() ? PortConfig.SEAMLESS_BOOK_PREVIEWS.get()
: reborn() && PortConfig.LIVE_BOOK_PREVIEWS.get();
}
public static boolean crystalViewsEnabled() {
return seamless() ? PortConfig.SEAMLESS_CRYSTAL_VIEWS.get()
: reborn() && PortConfig.CRYSTAL_LIVE_VIEWS.get();
}
public static void open(ServerPlayer player, RequestBookPreviewPayload payload) {
if (!available()) return;
try { ImmersivePreviewChunks.open(player, payload); }
catch (RuntimeException | LinkageError error) {
Rivencraft.LOGGER.warn("{} book preview unavailable; retaining animated panel", engineName(), error);
ImmersivePreviewChunks.close(player);
}
}
public static void release(ServerPlayer player, java.util.UUID session) {
if (available()) ImmersivePreviewChunks.release(player, session);
}
public static void register() {
if (!available()) return;
NeoForge.EVENT_BUS.addListener((net.neoforged.neoforge.event.tick.ServerTickEvent.Post event) -> ImmersivePreviewChunks.tick(event.getServer()));
NeoForge.EVENT_BUS.addListener((net.neoforged.neoforge.event.entity.player.PlayerEvent.PlayerLoggedOutEvent event) -> {
if (event.getEntity() instanceof ServerPlayer player) ImmersivePreviewChunks.logout(player);
});
NeoForge.EVENT_BUS.addListener((net.neoforged.neoforge.event.entity.player.PlayerEvent.PlayerChangedDimensionEvent event) -> {
if (event.getEntity() instanceof ServerPlayer player) ImmersivePreviewChunks.close(player);
});
NeoForge.EVENT_BUS.addListener((net.neoforged.neoforge.event.server.ServerStoppingEvent event) -> ImmersivePreviewChunks.stop());
}
private ImmersiveBookPreviews() {}
}
@@ -0,0 +1,29 @@
package net.dnorberg.rivencraft.compat;
import net.dnorberg.rivencraft.Rivencraft;
import net.dnorberg.rivencraft.portal.CrystalPortalNetwork;
import net.minecraft.core.BlockPos;
import net.minecraft.server.level.ServerLevel;
import net.minecraft.world.item.ItemStack;
/** Render-only optional integration. Crystal portal blocks retain all travel rules. */
public final class ImmersiveCrystalPortals {
public static void refresh(ServerLevel source, BlockPos owner, CrystalPortalNetwork.Plan plan, ItemStack book) {
boolean live = false;
if (ImmersiveBookPreviews.available()) {
try {
if (!book.isEmpty() && ImmersiveBookPreviews.crystalViewsEnabled())
live = ImmersiveCrystalView.refresh(source, owner, plan, book);
else ImmersiveCrystalView.remove(source, owner);
} catch (RuntimeException | LinkageError failure) {
Rivencraft.LOGGER.warn("Could not establish immersive crystal view at {}; retaining portal travel and fallback", owner, failure);
ImmersiveCrystalView.remove(source, owner);
}
}
CrystalPortalNetwork.setLiveView(source, plan, live);
}
public static void remove(ServerLevel source, BlockPos owner) {
if (ImmersiveBookPreviews.available()) ImmersiveCrystalView.remove(source, owner);
}
private ImmersiveCrystalPortals() {}
}
@@ -0,0 +1,131 @@
package net.dnorberg.rivencraft.compat;
import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import net.dnorberg.rivencraft.Rivencraft;
import net.dnorberg.rivencraft.item.LinkBookTarget;
import net.dnorberg.rivencraft.item.LinkProperties;
import net.dnorberg.rivencraft.portal.CrystalPortalNetwork;
import net.dnorberg.rivencraft.portal.CrystalPortalSurfaces;
import net.dnorberg.rivencraft.portal.PortalBookTravel;
import net.minecraft.core.BlockPos;
import net.minecraft.core.Direction;
import net.minecraft.server.level.ServerLevel;
import net.minecraft.world.entity.EntitySpawnReason;
import net.minecraft.world.item.ItemStack;
import net.minecraft.world.phys.AABB;
import net.minecraft.world.phys.Vec3;
import qouteall.imm_ptl.core.api.PortalAPI;
import qouteall.imm_ptl.core.portal.Portal;
import qouteall.imm_ptl.core.portal.shape.SpecialFlatPortalShape;
import qouteall.q_misc_util.my_util.DQuaternion;
import qouteall.q_misc_util.my_util.Mesh2D;
/** One native mesh per coplanar opening/side, not one repeated image per block. */
final class ImmersiveCrystalView {
private static final String PREFIX = "rivencraft:crystal:mc263:v1:";
private record View(CrystalPortalSurfaces.Surface surface, Direction normal,
LinkBookTarget target, boolean preserveFacing, boolean relative, String tag) {}
static boolean refresh(ServerLevel source, BlockPos owner, CrystalPortalNetwork.Plan plan, ItemStack book) {
List<View> wanted = views(source, owner, plan, book);
if (wanted.isEmpty()) { remove(source, owner); return false; }
if (!complete(source, owner, wanted)) {
remove(source, owner);
for (View view : wanted) spawn(source, view);
}
return complete(source, owner, wanted);
}
private static List<View> views(ServerLevel source, BlockPos owner, CrystalPortalNetwork.Plan plan, ItemStack book) {
List<View> views = new ArrayList<>();
boolean descriptive = book.is(Rivencraft.DESCRIPTIVE_BOOK.get());
boolean relative = book.getOrDefault(Rivencraft.LINK_PROPERTIES.get(), LinkProperties.NONE).has(LinkProperties.RELATIVE_LINK);
// Ordinary descriptive arrival searches once, not for each side of each opening.
LinkBookTarget shared = relative ? null : PortalBookTravel.destination(source, book, owner, 0, 0);
if (!relative && (shared == null || !shared.valid())) return List.of();
for (var surface : CrystalPortalSurfaces.group(source, plan)) {
LinkBookTarget target = relative
? PortalBookTravel.destination(source, book, BlockPos.containing(surface.bounds().getCenter()), 0, 0) : shared;
if (target == null || !target.valid()) return List.of();
int shape = surface.cells().stream().mapToLong(BlockPos::asLong).sorted().boxed().toList().hashCode();
for (Direction normal : List.of(surface.normal(), surface.normal().getOpposite())) {
String tag = ownerTag(owner) + normal.getSerializedName() + ":" + shape + ":" + target + ":" + descriptive + ":" + relative;
views.add(new View(surface, normal, target, descriptive, relative, tag));
}
}
return List.copyOf(views);
}
static void remove(ServerLevel source, BlockPos owner) {
for (Portal portal : existing(source, owner)) portal.discard();
}
private static List<Portal> existing(ServerLevel source, BlockPos owner) {
String prefix = ownerTag(owner);
return source.getEntitiesOfClass(Portal.class,
new AABB(owner).inflate(CrystalPortalNetwork.MAX_RADIUS + 2),
entity -> entity.portalTag != null && entity.portalTag.startsWith(prefix));
}
private static boolean complete(ServerLevel source, BlockPos owner, List<View> wanted) {
List<Portal> existing = existing(source, owner);
if (existing.size() != wanted.size()) return false;
var tags = new HashSet<String>();
for (Portal view : existing) {
if (view.getTeleportable() || view.isInteractable() || !view.isPortalValid()
|| !tags.add(view.portalTag)) return false;
}
return tags.equals(wanted.stream().map(View::tag).collect(java.util.stream.Collectors.toSet()));
}
private static void spawn(ServerLevel source, View view) {
Portal portal = Portal.ENTITY_TYPE.create(source, EntitySpawnReason.TRIGGERED);
if (portal == null) return;
var surface = view.surface();
var normal = view.normal();
var target = view.target();
PortalAPI.setPortalOrthodoxShape(portal, normal, surface.bounds());
// Inside the opening's block thickness, so crystal frame edges stay in front.
portal.setOriginPos(portal.getOriginPos().add(normal.getUnitVec3().scale(-0.125)));
Mesh2D mesh = new Mesh2D();
double halfU = 1 / portal.getWidth(), halfV = 1 / portal.getHeight();
for (BlockPos cell : surface.cells()) {
Vec3 face = Vec3.atCenterOf(cell).add(normal.getUnitVec3().scale(0.5));
Vec3 offset = face.subtract(portal.getOriginPos());
double u = 2 * offset.dot(portal.getAxisW()) / portal.getWidth();
double v = 2 * offset.dot(portal.getAxisH()) / portal.getHeight();
mesh.addQuad(u - halfU, v - halfV, u + halfU, v + halfV);
}
portal.setPortalShape(new SpecialFlatPortalShape(mesh));
// Descriptive Book travel retains the approaching entity's yaw/pitch.
// Linking Books rotate the approach normal onto their written facing.
DQuaternion rotation = view.preserveFacing() ? DQuaternion.identity : cameraRotation(normal, target);
Vec3 eye = new Vec3(target.x(), target.y() + 1.62, target.z());
// Anchor a standing player's eyes above the opening's floor rather than
// above the mesh center (which changes when the frame is made taller).
Vec3 anchor = surface.bounds().getCenter();
if (normal.getAxis().isHorizontal()) anchor = new Vec3(anchor.x, surface.bounds().minY + 1.62, anchor.z);
else anchor = anchor.add(0, 1.62, 0);
Vec3 destination = eye.subtract(rotation.rotate(anchor.subtract(portal.getOriginPos())));
PortalAPI.setPortalTransformation(portal,
net.minecraft.resources.ResourceKey.create(net.minecraft.core.registries.Registries.DIMENSION, target.dimension()),
destination, rotation, 1);
portal.setTeleportable(false);
portal.setInteractable(false);
portal.setCrossPortalCollisionEnabled(false);
portal.portalTag = view.tag();
PortalAPI.spawnServerEntity(portal);
}
private static DQuaternion cameraRotation(Direction normal, LinkBookTarget target) {
Vec3 sourceLook = normal.getOpposite().getUnitVec3();
Vec3 sourceUp = normal.getAxis() == Direction.Axis.Y ? new Vec3(0, 0, -1) : new Vec3(0, 1, 0);
Vec3 destinationLook = Vec3.directionFromRotation(target.pitch(), target.yaw());
Vec3 destinationUp = Vec3.directionFromRotation(target.pitch() - 90, target.yaw());
DQuaternion from = DQuaternion.fromFacingVecs(sourceLook.cross(sourceUp), sourceUp);
DQuaternion to = DQuaternion.fromFacingVecs(destinationLook.cross(destinationUp), destinationUp);
return to.hamiltonProduct(from.getConjugated()).getNormalized();
}
private static String ownerTag(BlockPos owner) { return PREFIX + owner.asLong() + ":"; }
private ImmersiveCrystalView() {}
}
@@ -0,0 +1,38 @@
package net.dnorberg.rivencraft.compat;
import net.dnorberg.rivencraft.Rivencraft;
import net.minecraft.server.MinecraftServer;
import net.neoforged.fml.ModList;
import net.neoforged.neoforge.event.server.ServerStartedEvent;
/** Optional 26.3 Immersive Portals forks; only the guarded adapter links their API classes. */
public final class ImmersivePortalsCompatibility {
private ImmersivePortalsCompatibility() {}
public static boolean available() { return ModList.get().isLoaded("seamlessportals") || ModList.get().isLoaded("immersive_portals_reborn"); }
public static boolean synchronize(MinecraftServer server) { return synchronize(server, null); }
/** Login/catalog packets must precede Rivencraft's acknowledgement round trip. */
public static boolean beforeCatalog(net.minecraft.server.level.ServerPlayer player) {
return synchronize(player.level().getServer(), player);
}
private static boolean synchronize(MinecraftServer server, net.minecraft.server.level.ServerPlayer player) {
if (!available()) return true;
if (!server.isSameThread()) throw new IllegalStateException("Portal catalog update outside server thread");
try {
ImmersivePortalsDimensionAdapter.synchronize(server);
if (player != null) ImmersivePortalsDimensionAdapter.sendTo(player);
return true;
} catch (RuntimeException | LinkageError failure) {
Rivencraft.LOGGER.error("Could not synchronize the optional Immersive Portals dimension IDs; "
+ "Rivencraft catalog acknowledgement/travel remains blocked until synchronization succeeds", failure);
return false;
}
}
public static void onServerStarted(ServerStartedEvent event) {
synchronize(event.getServer());
}
}
@@ -0,0 +1,32 @@
package net.dnorberg.rivencraft.compat;
import java.util.Set;
import net.minecraft.server.MinecraftServer;
import qouteall.q_misc_util.dimension.DimensionIntId;
/** Updates the shared 26.3 dimension catalog without delegating Age construction. */
final class ImmersivePortalsDimensionAdapter {
private ImmersivePortalsDimensionAdapter() {}
static void sendTo(net.minecraft.server.level.ServerPlayer player) {
// Seamless's createPacket returns a vanilla Packet; Reborn's returns
// a CustomPacketPayload. Their createFromServer factory is shared and
// retains each fork's native (two- or three-tag) wire format.
player.connection.send(new net.minecraft.network.protocol.common.ClientboundCustomPayloadPacket(
qouteall.q_misc_util.MiscNetworking.DimIdSyncPacket.createFromServer(
player.level().getServer())));
}
static void synchronize(MinecraftServer server) {
var live = Set.copyOf(server.levelKeys());
var record = DimensionIntId.getServerMap(server);
if (record.getDimIdSet().equals(live)) return;
// This is the same public synchronization entry point called by its
// dynamic-update listener. The two supported forks have
// different event wrappers, but share this method. It updates IDs and
// sends native type/sea-level metadata before Rivencraft's catalog.
DimensionIntId.onServerDimensionChanged(server);
if (!DimensionIntId.getServerMap(server).getDimIdSet().equals(live))
throw new IllegalStateException("The portal mod did not accept the current server dimensions");
}
}
@@ -0,0 +1,112 @@
package net.dnorberg.rivencraft.compat;
import java.util.IdentityHashMap;
import java.util.Map;
import java.util.UUID;
import net.dnorberg.rivencraft.network.RequestBookPreviewPayload;
import net.dnorberg.rivencraft.network.BookPreviewPayload;
import net.dnorberg.rivencraft.network.PortBookNetworking;
import net.dnorberg.rivencraft.Rivencraft;
import net.dnorberg.rivencraft.age.AgeCatalogSync;
import net.dnorberg.rivencraft.age.PortAgeTravel;
import net.dnorberg.rivencraft.item.*;
import net.minecraft.core.BlockPos;
import net.minecraft.core.registries.Registries;
import net.minecraft.resources.ResourceKey;
import net.minecraft.server.MinecraftServer;
import net.minecraft.server.level.ServerPlayer;
import net.minecraft.world.InteractionHand;
import net.minecraft.world.item.ItemStack;
import net.neoforged.neoforge.network.PacketDistributor;
import qouteall.imm_ptl.core.api.PortalAPI;
import qouteall.imm_ptl.core.chunk_loading.ChunkLoader;
import qouteall.imm_ptl.core.chunk_loading.ImmPtlChunkTracking;
/** Optional API class: one expiring stream per player, validated before any chunk load. */
final class ImmersivePreviewChunks {
private static final Map<ServerPlayer, Lease> LEASES = new IdentityHashMap<>();
private static final Map<ServerPlayer, Long> REQUESTS = new IdentityHashMap<>();
private static final int LIFETIME = 600;
private record Lease(UUID session, ChunkLoader loader, LinkBookTarget destination,
RequestBookPreviewPayload source, long expires) {}
static void open(ServerPlayer player, RequestBookPreviewPayload request) {
long now = player.level().getServer().getTickCount();
if (now - REQUESTS.getOrDefault(player, -100L) < 10) return;
REQUESTS.put(player, now);
ItemStack book = validated(player, request);
if (book.isEmpty()) { close(player); return; }
Lease previous = LEASES.get(player);
if (previous != null && previous.session().equals(request.session())
&& previous.source().offhand() == request.offhand()
&& previous.source().fromStand() == request.fromStand()
&& previous.source().sourceDimension().equals(request.sourceDimension())
&& previous.source().standPos().equals(request.standPos())
&& ItemStack.matches(previous.source().book(), request.book())) {
LEASES.put(player, new Lease(previous.session(), previous.loader(), previous.destination(), request, now + LIFETIME));
PacketDistributor.sendToPlayer(player, new BookPreviewPayload(request.session(), previous.destination()));
return;
}
close(player);
LinkBookTarget target = book.get(Rivencraft.LINK_BOOK_TARGET.get());
var properties = book.getOrDefault(Rivencraft.LINK_PROPERTIES.get(), LinkProperties.NONE);
var server = player.level().getServer();
if (book.is(Rivencraft.DESCRIPTIVE_BOOK.get())) {
var id = book.get(Rivencraft.AGE_BOOK_ID.get());
var level = id == null ? null : server.getLevel(ResourceKey.create(Registries.DIMENSION, id));
if (level == null || !AgeCatalogSync.ready(player, id)) return;
BlockPos landing = PortAgeTravel.resolveLanding(level, player, properties.forDescriptiveBook());
if (landing == null) return;
target = new LinkBookTarget(id, landing.getX() + 0.5, landing.getY(), landing.getZ() + 0.5,
player.getYRot(), player.getXRot());
} else if (book.is(Rivencraft.LINKING_BOOK.get()) && target != null) {
var level = server.getLevel(ResourceKey.create(Registries.DIMENSION, target.dimension()));
if (level == null || !AgeCatalogSync.ready(player, target.dimension())) return;
target = PortLinkDestinations.resolve(player.level(), level, player.blockPosition(), target, properties);
} else return;
if (!target.valid()) return;
var level = server.getLevel(ResourceKey.create(Registries.DIMENSION, target.dimension()));
var center = BlockPos.containing(target.x(), target.y(), target.z());
if (level == null || !level.isInWorldBounds(center) || !level.getWorldBorder().isWithinBounds(center)) return;
close(player);
// Match the root live renderer's eight-chunk orbit view. The portal engine schedules
// generation/streaming; no synchronous square of getChunk() calls here.
var loader = new ChunkLoader(level.dimension(), center.getX() >> 4, center.getZ() >> 4, 8);
PortalAPI.addChunkLoaderForPlayer(player, loader);
LEASES.put(player, new Lease(request.session(), loader, target, request, now + LIFETIME));
ImmPtlChunkTracking.immediatelyUpdateForPlayer(player);
PacketDistributor.sendToPlayer(player, new BookPreviewPayload(request.session(), target));
}
private static ItemStack validated(ServerPlayer player, RequestBookPreviewPayload request) {
if (!player.level().dimension().identifier().equals(request.sourceDimension()) || !player.isAlive()) return ItemStack.EMPTY;
if (request.fromStand()) return PortBookNetworking.validatedStandBook(player,
new net.dnorberg.rivencraft.network.UseBookStandPayload(request.sourceDimension(), request.standPos(), request.book()));
ItemStack held = player.getItemInHand(request.offhand() ? InteractionHand.OFF_HAND : InteractionHand.MAIN_HAND);
return ItemStack.matches(held, request.book()) ? held : ItemStack.EMPTY;
}
static void release(ServerPlayer player, UUID session) {
Lease lease = LEASES.get(player);
if (lease != null && lease.session().equals(session)) close(player);
}
static void close(ServerPlayer player) {
Lease lease = LEASES.remove(player);
if (lease != null) PortalAPI.removeChunkLoaderForPlayer(player, lease.loader());
}
static void tick(MinecraftServer server) {
if (server.getTickCount() % 20 != 0) return;
for (ServerPlayer player : java.util.List.copyOf(LEASES.keySet())) {
Lease lease = LEASES.get(player);
if (server.getTickCount() >= lease.expires()
|| server.getLevel(lease.loader().dimension()) == null
|| validated(player, lease.source()).isEmpty()) close(player);
}
}
static void logout(ServerPlayer player) { close(player); REQUESTS.remove(player); }
static void stop() {
for (ServerPlayer player : java.util.List.copyOf(LEASES.keySet())) close(player);
REQUESTS.clear();
}
private ImmersivePreviewChunks() {}
}
@@ -0,0 +1,84 @@
package net.dnorberg.rivencraft.compat;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.concurrent.ConcurrentHashMap;
import net.dnorberg.rivencraft.age.PortTerrainFeaturePlan;
import net.minecraft.resources.Identifier;
import net.neoforged.fml.ModList;
/** Small optional bridge between frozen Age pages and Ruins' dimension gate. */
public final class RuinsCompatibility {
private static final Set<Identifier> KNOWN_AGES = ConcurrentHashMap.newKeySet();
private static final Map<Identifier, Map<Identifier, Integer>> AUTHORED_TEMPLATES =
new ConcurrentHashMap<>();
private RuinsCompatibility() {}
public static void register() {
if (ModList.get().isLoaded("ruins")) RuinsEventAdapter.register();
net.neoforged.neoforge.common.NeoForge.EVENT_BUS.addListener(RuinsCompatibility::onLevelUnload);
net.neoforged.neoforge.common.NeoForge.EVENT_BUS.addListener(
(net.neoforged.neoforge.event.server.ServerAboutToStartEvent event) -> RuinsTemplatePages.refresh());
net.neoforged.neoforge.common.NeoForge.EVENT_BUS.addListener(
(net.neoforged.neoforge.event.server.ServerStoppedEvent event) -> onServerStopping());
}
public static void registerAge(Identifier id, PortTerrainFeaturePlan plan) {
if (!ModList.get().isLoaded("ruins")) return;
Map<Identifier, Integer> selected = templateCounts(plan == null ? List.of() : plan.ruins());
if (selected.isEmpty()) AUTHORED_TEMPLATES.remove(id);
else AUTHORED_TEMPLATES.put(id, selected);
KNOWN_AGES.add(id);
}
public static void onLevelUnload(net.neoforged.neoforge.event.level.LevelEvent.Unload event) {
if (event.getLevel() instanceof net.minecraft.server.level.ServerLevel level) {
var id = level.dimension().identifier();
KNOWN_AGES.remove(id);
AUTHORED_TEMPLATES.remove(id);
}
}
/** Called only by the optional Ruins FileHandler mixin. */
public static boolean allowsAge(Identifier dimension) {
return AUTHORED_TEMPLATES.containsKey(dimension);
}
public static boolean isKnownAge(Identifier dimension) {
return KNOWN_AGES.contains(dimension);
}
public static boolean permits(Identifier dimension, Identifier template) {
return templateCount(dimension, template) > 0;
}
public static int templateCount(Identifier dimension, Identifier template) {
return AUTHORED_TEMPLATES.getOrDefault(dimension, Map.of()).getOrDefault(template, 0);
}
/** Extra pages increase attempts, without making distinct template choices denser. */
public static int attemptsPerChunk(Identifier dimension, int configuredAttempts) {
return attemptsPerChunk(configuredAttempts, AUTHORED_TEMPLATES.get(dimension));
}
static int attemptsPerChunk(int configuredAttempts, Map<Identifier, Integer> counts) {
if (counts == null || counts.isEmpty()) return configuredAttempts;
int duplicates = counts.values().stream().mapToInt(count -> count - 1).sum();
return (int) Math.min(Math.max(configuredAttempts, 32L), (long) configuredAttempts + duplicates);
}
static Map<Identifier, Integer> templateCounts(List<Identifier> choices) {
Map<Identifier, Integer> counts = new java.util.HashMap<>();
for (Identifier choice : choices) {
if (RuinsTemplatePages.contains(choice)) counts.merge(choice, 1, Integer::sum);
}
return Map.copyOf(counts);
}
public static void onServerStopping() {
KNOWN_AGES.clear();
AUTHORED_TEMPLATES.clear();
}
}
@@ -0,0 +1,53 @@
package net.dnorberg.rivencraft.compat;
import atomicstryker.ruins.common.EventRuinTemplateSpawn;
import atomicstryker.ruins.common.RuinTemplate;
import java.util.Collection;
import java.util.Comparator;
import net.minecraft.server.level.ServerLevel;
import net.minecraft.util.RandomSource;
import net.neoforged.neoforge.common.NeoForge;
/** Loaded only when Ruins is present. Its pre-spawn event can veto exact templates. */
public final class RuinsEventAdapter {
private RuinsEventAdapter() {}
static void register() {
NeoForge.EVENT_BUS.addListener(RuinsEventAdapter::onTemplateSpawn);
}
private static void onTemplateSpawn(EventRuinTemplateSpawn event) {
if (!event.isPrePhase || event.testingRuin
|| !(event.getLevel() instanceof ServerLevel level)
|| !RuinsCompatibility.isKnownAge(level.dimension().identifier())) return;
var template = RuinsTemplatePages.featureId(event.template.getName());
if (!RuinsTemplatePages.contains(template)
|| !RuinsCompatibility.permits(level.dimension().identifier(), template)) event.setCancelled(true);
}
/** Preserve Ruins' weights and multiply each by its authored page count. */
public static Object chooseTemplate(net.minecraft.resources.Identifier dimension,
Collection<?> pool, RandomSource random) {
if (pool == null || pool.isEmpty()) return null;
var candidates = pool.stream().filter(RuinTemplate.class::isInstance)
.map(RuinTemplate.class::cast)
.filter(template -> RuinsCompatibility.permits(dimension,
RuinsTemplatePages.featureId(template.getName())))
.sorted(Comparator.comparing(RuinTemplate::getName)).toList();
double total = candidates.stream().mapToDouble(template -> authoredWeight(dimension, template)).sum();
if (total <= 0.0) return null;
double roll = random.nextDouble() * total;
for (RuinTemplate candidate : candidates) {
roll -= authoredWeight(dimension, candidate);
if (roll < 0.0) return candidate;
}
return candidates.getLast();
}
private static double authoredWeight(net.minecraft.resources.Identifier dimension,
RuinTemplate template) {
return Math.max(0.0, template.getWeight()) * RuinsCompatibility.templateCount(dimension,
RuinsTemplatePages.featureId(template.getName()));
}
}
@@ -0,0 +1,166 @@
package net.dnorberg.rivencraft.compat;
import java.io.IOException;
import java.io.InputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.HashMap;
import java.util.HashSet;
import java.util.HexFormat;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.Set;
import java.util.zip.ZipEntry;
import java.util.zip.ZipInputStream;
import net.dnorberg.rivencraft.Rivencraft;
import net.dnorberg.rivencraft.writing.PortSymbolPages;
import net.minecraft.resources.Identifier;
import net.neoforged.fml.ModList;
import net.neoforged.fml.loading.FMLPaths;
/** Discovers Ruins' template filenames without making its jar mandatory. */
public final class RuinsTemplatePages {
public static final Identifier CATEGORY = Identifier.fromNamespaceAndPath(
Rivencraft.MOD_ID, "ruins");
private static final String PREFIX = "ruins/";
private static volatile Map<Identifier, String> names = Map.of();
private static volatile boolean initialized;
private RuinsTemplatePages() {}
public static void refresh() {
if (!ModList.get().isLoaded("ruins")) {
names = Map.of();
initialized = true;
return;
}
Map<Identifier, String> discovered = new HashMap<>();
Map<String, String> sources = new HashMap<>();
Set<String> duplicateNames = new HashSet<>();
// Ruins itself reads <gameDir>/config/ruins_config, not NeoForge's
// overrideable CONFIGDIR; mirror its active folder exactly.
Path configured = FMLPaths.GAMEDIR.get().resolve("config/ruins_config");
if (Files.isDirectory(configured)) {
try (var paths = Files.walk(configured)) {
paths.filter(Files::isRegularFile)
.filter(path -> configured.relativize(path).getNameCount() == 2)
.filter(path -> isTemplate(path.getFileName().toString()))
.sorted().forEach(path -> add(discovered, sources, duplicateNames,
path.getFileName().toString(), configured.relativize(path).toString()));
} catch (IOException exception) {
Rivencraft.LOGGER.warn("Could not read Ruins templates from {}", configured, exception);
}
}
// Ruins extracts this archive on first launch. It also supplies the creative
// pages before extraction has completed on a fresh installation.
if (discovered.isEmpty() && !Files.isDirectory(configured)) {
try (InputStream stream = RuinsTemplatePages.class.getClassLoader()
.getResourceAsStream("assets/ruins_config.zip")) {
if (stream != null) {
try (ZipInputStream zip = new ZipInputStream(stream)) {
ZipEntry entry;
while ((entry = zip.getNextEntry()) != null) {
if (!entry.isDirectory()) {
String name = entry.getName();
name = name.substring(name.lastIndexOf('/') + 1);
if (isTemplate(name)) add(discovered, sources, duplicateNames,
name, entry.getName());
}
}
}
}
} catch (IOException exception) {
Rivencraft.LOGGER.warn("Could not read bundled Ruins templates", exception);
}
}
// Ruins' spawn event exposes only the basename. If two directories use
// that basename, Rivencraft cannot identify which structure was chosen.
// Disable the bridge instead of advertising pages with ambiguous effects.
if (!duplicateNames.isEmpty()) {
Rivencraft.LOGGER.error("Ruins compatibility disabled: duplicate template names {}. "
+ "Give every .tml file a unique basename.", duplicateNames);
names = Map.of();
initialized = true;
return;
}
names = Map.copyOf(discovered);
initialized = true;
}
public static List<String> templates() {
if (!initialized) refresh();
List<String> templates = new ArrayList<>(names.values());
templates.sort(Comparator.comparing(name -> name.toLowerCase(Locale.ROOT)));
return List.copyOf(templates);
}
public static boolean isSymbol(Identifier id) {
return id.getNamespace().equals(Rivencraft.MOD_ID) && id.getPath().startsWith(PREFIX);
}
public static boolean contains(Identifier id) {
if (!initialized) refresh();
return isSymbol(id) && names.containsKey(id);
}
public static Identifier symbolId(String templateName) {
if (templateName.isBlank()) throw new IllegalArgumentException("Ruins template has no usable name");
// Hex is reversible and collision-free even for case-sensitive or Unicode
// filenames; normalizing to lowercase would merge distinct templates.
String key = HexFormat.of().formatHex(templateName.getBytes(StandardCharsets.UTF_8));
return Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, PREFIX + "t_" + key);
}
public static Identifier featureId(String templateName) {
return symbolId(templateName);
}
public static String fallbackName(Identifier symbolId) {
String encoded = symbolId.getPath().substring(PREFIX.length());
if (!encoded.startsWith("t_")) return encoded + " Ruin";
String name;
try {
name = new String(HexFormat.of().parseHex(encoded.substring(2)), StandardCharsets.UTF_8);
} catch (IllegalArgumentException exception) {
name = encoded;
}
return stripExtension(name).replace('_', ' ') + " Ruin";
}
public static PortSymbolPages.Entry definition(String templateName) {
Identifier id = featureId(templateName);
return new PortSymbolPages.Entry(id, CATEGORY.toString(),
"symbol.rivencraft.ruins.template." + id.getPath().substring(PREFIX.length()),
"symbol.rivencraft.ruins.description", "", "feature");
}
public static PortSymbolPages.Entry find(Identifier id) {
if (!initialized) refresh();
String name = names.get(id);
return name == null ? null : definition(name);
}
private static boolean isTemplate(String name) {
return name.toLowerCase(Locale.ROOT).endsWith(".tml");
}
private static String stripExtension(String name) {
return isTemplate(name) ? name.substring(0, name.length() - 4) : name;
}
private static void add(Map<Identifier, String> templates, Map<String, String> sources,
Set<String> duplicateNames, String name, String source) {
String previousSource = sources.putIfAbsent(name, source);
if (previousSource != null && !previousSource.equals(source)) duplicateNames.add(name);
Identifier id = symbolId(name);
String previous = templates.putIfAbsent(id, name);
if (previous != null && !previous.equals(name)) {
Rivencraft.LOGGER.warn("Ruins templates {} and {} share page ID {}; using {}",
previous, name, id, previous);
}
}
}
@@ -0,0 +1,63 @@
package net.dnorberg.rivencraft.compat;
import java.util.ArrayList;
import java.util.List;
import net.dnorberg.rivencraft.age.PortSeasonPolicies.Mode;
import net.minecraft.resources.Identifier;
import net.minecraft.server.level.ServerLevel;
import sereneseasons.api.season.Season;
import sereneseasons.config.SeasonsConfig;
import sereneseasons.init.ModConfig;
import sereneseasons.season.SeasonHandler;
import sereneseasons.season.SeasonSavedData;
import sereneseasons.season.SeasonTime;
/** Isolates references to optional Serene Seasons and GlitchCore classes. */
final class SereneSeasonsAdapter {
private static final String WHITELIST_KEY = "dimension_settings.whitelisted_dimensions";
private SereneSeasonsAdapter() {
}
static boolean setServerWhitelist(Identifier dimensionId, boolean enabled) {
SeasonsConfig config = ModConfig.seasons;
if (config == null || config.whitelistedDimensions.contains(dimensionId.toString()) == enabled) return false;
List<String> dimensions = new ArrayList<>(config.whitelistedDimensions);
if (enabled) dimensions.add(dimensionId.toString());
else dimensions.removeIf(dimensionId.toString()::equals);
// GlitchCore rereads this config from disk before synchronizing new clients.
config.set(WHITELIST_KEY, dimensions);
config.write();
config.whitelistedDimensions = dimensions;
return true;
}
static void setClientWhitelist(Identifier dimensionId, boolean enabled) {
SeasonsConfig config = ModConfig.seasons;
if (config == null || config.whitelistedDimensions.contains(dimensionId.toString()) == enabled) return;
List<String> dimensions = new ArrayList<>(config.whitelistedDimensions);
if (enabled) dimensions.add(dimensionId.toString());
else dimensions.removeIf(dimensionId.toString()::equals);
config.whitelistedDimensions = dimensions;
}
static void holdSeason(ServerLevel level, Mode mode) {
SeasonSavedData data = SeasonHandler.getSeasonSavedData(level);
Season.SubSeason target = switch (mode) {
case ETERNAL_SPRING -> Season.SubSeason.MID_SPRING;
case ETERNAL_SUMMER -> Season.SubSeason.MID_SUMMER;
case ETERNAL_FALL -> Season.SubSeason.MID_AUTUMN;
case ETERNAL_WINTER -> Season.SubSeason.MID_WINTER;
default -> throw new IllegalArgumentException("Not an eternal season: " + mode);
};
int duration = SeasonTime.ZERO.getSubSeasonDuration();
int midpoint = target.ordinal() * duration + duration / 2;
// Reset well before the end of MID_* so the client never observes a
// different sub-season; avoid marking saved data dirty every tick.
int current = data.seasonCycleTicks;
if (current >= midpoint && current < midpoint + duration / 4) return;
data.seasonCycleTicks = midpoint;
data.setDirty();
SeasonHandler.sendSeasonUpdate(level);
}
}
@@ -0,0 +1,80 @@
package net.dnorberg.rivencraft.compat;
import net.dnorberg.rivencraft.Rivencraft;
import net.dnorberg.rivencraft.PortConfig;
import net.dnorberg.rivencraft.age.PortSeasonPolicies;
import net.dnorberg.rivencraft.age.PortSeasonPolicies.Mode;
import net.dnorberg.rivencraft.age.RuntimeAgeBackend;
import net.dnorberg.rivencraft.network.SereneAgeWhitelistPayload;
import net.minecraft.resources.Identifier;
import net.minecraft.server.MinecraftServer;
import net.minecraft.server.level.ServerLevel;
import net.minecraft.server.level.ServerPlayer;
import net.neoforged.fml.ModList;
import net.neoforged.neoforge.network.PacketDistributor;
import net.neoforged.neoforge.event.level.LevelEvent;
import net.neoforged.neoforge.event.entity.player.PlayerEvent;
import net.neoforged.neoforge.event.tick.LevelTickEvent;
/** Common optional boundary: only its guarded adapter loads Serene/GlitchCore APIs. */
public final class SereneSeasonsCompatibility {
private static final java.util.concurrent.atomic.AtomicBoolean WARNED = new java.util.concurrent.atomic.AtomicBoolean();
private SereneSeasonsCompatibility() {}
public static boolean available() { return ModList.get().isLoaded("sereneseasons"); }
private static boolean isAge(Identifier id) { return id.getNamespace().equals("rivencraft") && id.getPath().startsWith("age/"); }
private static Boolean enabled(ServerLevel level) {
var policy = PortSeasonPolicies.get(level.getServer()).forLevel(level);
if (policy.mode() != Mode.NO_SEASONS && !policy.authored() && !PortConfig.AUTO_WHITELIST_SERENE_AGES.get()) return null;
return policy.mode() != Mode.NO_SEASONS;
}
public static void apply(ServerLevel level) {
if (!available() || !isAge(level.dimension().identifier())) return;
try {
Boolean enabled = enabled(level);
if (enabled == null) return;
var id = level.dimension().identifier();
SereneSeasonsAdapter.setServerWhitelist(id, enabled);
if (enabled) {
var mode = PortSeasonPolicies.get(level.getServer()).forLevel(level).mode();
if (mode.eternal()) SereneSeasonsAdapter.holdSeason(level, mode);
}
for (var player : level.getServer().getPlayerList().getPlayers()) send(player, id, enabled);
} catch (RuntimeException | LinkageError e) { warn(e); }
}
public static void onLevelLoad(LevelEvent.Load event) {
if (event.getLevel() instanceof ServerLevel level && isAge(level.dimension().identifier())
&& RuntimeAgeBackend.savedAges(level.getServer()).containsKey(level.dimension().identifier())) apply(level);
}
public static void onLogin(PlayerEvent.PlayerLoggedInEvent event) {
if (!available() || !(event.getEntity() instanceof ServerPlayer player)) return;
for (var level : player.level().getServer().getAllLevels()) if (isAge(level.dimension().identifier())) {
Boolean enabled = enabled(level);
if (enabled != null) send(player, level.dimension().identifier(), enabled);
}
}
public static void onLevelTickPost(LevelTickEvent.Post event) {
if (!available() || !(event.getLevel() instanceof ServerLevel level) || !isAge(level.dimension().identifier())) return;
var policy = PortSeasonPolicies.get(level.getServer()).forLevel(level);
if (!policy.mode().eternal() || !policy.authored() && !PortConfig.AUTO_WHITELIST_SERENE_AGES.get()) return;
try { SereneSeasonsAdapter.holdSeason(level, policy.mode()); }
catch (RuntimeException | LinkageError e) { warn(e); }
}
public static void retired(MinecraftServer server, Identifier id) {
if (!available()) return;
try {
SereneSeasonsAdapter.setServerWhitelist(id, false);
for (var player : server.getPlayerList().getPlayers()) send(player, id, false);
} catch (RuntimeException | LinkageError e) { warn(e); }
}
private static void send(ServerPlayer player, Identifier id, boolean enabled) {
PacketDistributor.sendToPlayer(player, new SereneAgeWhitelistPayload(id, enabled));
}
public static void acceptClient(Identifier id, boolean enabled) {
if (!available() || !isAge(id)) return;
try { SereneSeasonsAdapter.setClientWhitelist(id, enabled); }
catch (RuntimeException | LinkageError e) { warn(e); }
}
private static void warn(Throwable e) {
if (WARNED.compareAndSet(false, true)) Rivencraft.LOGGER.warn("Could not apply optional Serene Seasons policy", e);
}
}
@@ -0,0 +1,59 @@
package net.dnorberg.rivencraft.compat;
import java.util.List;
import java.util.Map;
import java.util.WeakHashMap;
import java.util.concurrent.atomic.AtomicBoolean;
import net.dnorberg.rivencraft.Rivencraft;
import net.minecraft.core.Holder;
import net.minecraft.core.HolderLookup;
import net.minecraft.core.RegistryAccess;
import net.minecraft.core.registries.Registries;
import net.minecraft.resources.Identifier;
import net.minecraft.world.level.biome.Biome;
import net.neoforged.fml.ModList;
import net.neoforged.neoforge.event.TagsUpdatedEvent;
/** Optional API boundary with registry-scoped pools and cheap worldgen membership queries. */
public final class TerraBlenderBiomes {
private record Pools(List<Identifier> overworld, List<Identifier> nether) {}
private static final Pools EMPTY = new Pools(List.of(), List.of());
private static final Map<RegistryAccess, Pools> POOLS = new WeakHashMap<>();
private static final Map<Holder<Biome>, Boolean> NETHER_MEMBERSHIP = new WeakHashMap<>();
private static final AtomicBoolean WARNED = new AtomicBoolean();
private TerraBlenderBiomes() {}
public static List<Identifier> overworld(HolderLookup.Provider registries) { return prepare(registries).overworld(); }
public static List<Identifier> nether(HolderLookup.Provider registries) { return prepare(registries).nether(); }
public static synchronized boolean isNether(Holder<Biome> biome) {
return Boolean.TRUE.equals(NETHER_MEMBERSHIP.get(biome));
}
public static void onServerAboutToStart(net.neoforged.neoforge.event.server.ServerAboutToStartEvent event) {
// TerraBlender loads data-driven regions at normal priority in this event.
// Refresh after that, even if tags were seen before those regions existed.
synchronized (TerraBlenderBiomes.class) { POOLS.remove(event.getServer().registryAccess()); }
prepare(event.getServer().registryAccess());
}
public static void onTagsUpdated(TagsUpdatedEvent event) {
// Server/client registry objects have independent cache entries.
synchronized (TerraBlenderBiomes.class) { POOLS.remove(event.getRegistries()); }
prepare(event.getRegistries());
}
private static synchronized Pools prepare(HolderLookup.Provider provider) {
if (!ModList.get().isLoaded("terrablender") || !(provider instanceof RegistryAccess registries)) return EMPTY;
Pools cached = POOLS.get(registries);
if (cached != null) return cached;
Pools pools = EMPTY;
try {
pools = new Pools(TerraBlenderRegionAdapter.collect(registries, false),
TerraBlenderRegionAdapter.collect(registries, true));
} catch (RuntimeException | LinkageError exception) {
if (WARNED.compareAndSet(false, true)) Rivencraft.LOGGER.warn(
"TerraBlender biome regions could not be read; using registry tags and native biome pools", exception);
}
POOLS.put(registries, pools);
var nether = java.util.Set.copyOf(pools.nether());
registries.lookupOrThrow(Registries.BIOME).listElements().forEach(holder ->
NETHER_MEMBERSHIP.put(holder, nether.contains(holder.key().identifier())));
return pools;
}
}
@@ -0,0 +1,35 @@
package net.dnorberg.rivencraft.compat;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Set;
import net.minecraft.core.RegistryAccess;
import net.minecraft.core.registries.Registries;
import net.minecraft.resources.ResourceKey;
import net.minecraft.resources.Identifier;
import net.minecraft.world.level.biome.Biome;
import terrablender.api.Region;
import terrablender.api.RegionType;
import terrablender.api.Regions;
/** Loaded only after the optional TerraBlender mod is confirmed present. */
final class TerraBlenderRegionAdapter {
private TerraBlenderRegionAdapter() {}
static List<Identifier> collect(RegistryAccess registries, boolean nether) {
var biomes = registries.lookupOrThrow(Registries.BIOME);
RegionType type = nether ? RegionType.NETHER : RegionType.OVERWORLD;
Set<Identifier> ids = new LinkedHashSet<>();
for (Region region : Regions.get(type)) {
region.addBiomes(biomes, mapping -> {
ResourceKey<Biome> key = mapping.getSecond();
Identifier id = key.identifier();
// Vanilla's default region is always present. Only additions from
// other mods extend an Age's existing deterministic biome pool.
if (!id.getNamespace().equals("minecraft") && !id.equals(
net.dnorberg.rivencraft.writing.PortRegistryPages.DEFERRED_PLACEHOLDER) && biomes.containsKey(id)) ids.add(id);
});
}
return ids.stream().sorted().toList();
}
}
Loaded 100 of 185 files, more files were not shown because too many files have changed in this diff. Show more