From 99e89870cb65697e34f865a49a974c1ded8325b3 Mon Sep 17 00:00:00 2001 From: Dustin Norberg Date: Thu, 29 Oct 2026 14:37:00 -0400 Subject: [PATCH] Clarify 1.21.1 release and 26.3 alpha installation --- Home.md | 40 ++++++++++++++++----------------- Installation.md | 59 +++++++++++++++++++++++++++---------------------- 2 files changed, 53 insertions(+), 46 deletions(-) diff --git a/Home.md b/Home.md index 15c8ba4..68bf0bd 100644 --- a/Home.md +++ b/Home.md @@ -1,20 +1,20 @@ -# Rivencraft Wiki - -Rivencraft brings Mystcraft-inspired books, symbols, and player-authored Ages to Minecraft 1.21.1 on NeoForge. This wiki is the player-facing guide; the [source repository](https://git.paddedcell.org/dnorberg/rivencraft) contains the technical documentation and issue tracker. - -## Start here - -- [Install Rivencraft](Installation) — required mods, optional integrations, and world backups. -- [Getting Started](Getting-Started) — make a Link Panel, bind your first Descriptive Book, and return safely. -- [Books and Linking](Books-and-Linking) — Linking Books, Book Stands, portals, and Link Panel modifiers. -- [Writing Ages](Writing-Ages) — Symbol Pages, random Ages, page order, and instability. -- [Server and Operator Guide](Server-and-Operator-Guide) — settings, diagnostics, and dedicated servers. -- [Contributing to the Wiki](Contributing-to-the-Wiki) — help improve these guides. - -Rivencraft 1.0.0.2 is the first release candidate. Some pre-release saves may not remain compatible across updates; back up the entire world folder before updating. For the exact current feature set and limits, see the [implementation record](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/CURRENT_IMPLEMENTATION.md). - -## Community and credits - -Found a bug or a missing instruction? [Open an issue](https://git.paddedcell.org/dnorberg/rivencraft/issues). Contributions to this wiki are welcome. - -Rivencraft is an independent continuation inspired by **Mystcraft**, created by **XCompWiz**. Thank you to XCompWiz for the original mod and the worlds it inspired. See the [original Mystcraft](https://www.curseforge.com/minecraft/mc-mods/mystcraft) and [unfinished Mystcraft 2](https://www.curseforge.com/minecraft/mc-mods/mystcraft-2). Legacy-derived assets and sounds are credited in the repository’s [NOTICE](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/NOTICE) and [asset provenance](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/ASSET_PROVENANCE.md). +# Rivencraft Wiki + +Rivencraft brings Mystcraft-inspired books, symbols, and player-authored Ages to Minecraft 1.21.1 on NeoForge. A separate, incomplete Minecraft 26.3 alpha port is also available. This wiki's gameplay guides describe the **1.21.1 release**, not the alpha. See [Installation](Installation) for both tracks. The [source repository](https://git.paddedcell.org/dnorberg/rivencraft) contains the technical documentation and issue tracker. + +## Start here + +- [Install Rivencraft](Installation) — required mods, optional integrations, and world backups. +- [Getting Started](Getting-Started) — make a Link Panel, bind your first Descriptive Book, and return safely. +- [Books and Linking](Books-and-Linking) — Linking Books, Book Stands, portals, and Link Panel modifiers. +- [Writing Ages](Writing-Ages) — Symbol Pages, random Ages, page order, and instability. +- [Server and Operator Guide](Server-and-Operator-Guide) — settings, diagnostics, and dedicated servers. +- [Contributing to the Wiki](Contributing-to-the-Wiki) — help improve these guides. + +Rivencraft 1.0.1.1 is the current 1.21.1 release documented here. The [26.3 port status](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/MINECRAFT_26_3_PORT.md) explains what remains missing from its alpha. Back up the entire world folder before updating. For the 1.21.1 feature set and limits, see the [implementation record](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/CURRENT_IMPLEMENTATION.md). + +## Community and credits + +Found a bug or a missing instruction? [Open an issue](https://git.paddedcell.org/dnorberg/rivencraft/issues). Contributions to this wiki are welcome. + +Rivencraft is an independent continuation inspired by **Mystcraft**, created by **XCompWiz**. Thank you to XCompWiz for the original mod and the worlds it inspired. See the [original Mystcraft](https://www.curseforge.com/minecraft/mc-mods/mystcraft) and [unfinished Mystcraft 2](https://www.curseforge.com/minecraft/mc-mods/mystcraft-2). Legacy-derived assets and sounds are credited in the repository’s [NOTICE](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/NOTICE) and [asset provenance](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/ASSET_PROVENANCE.md). diff --git a/Installation.md b/Installation.md index 5cde0e2..bc7a982 100644 --- a/Installation.md +++ b/Installation.md @@ -1,26 +1,33 @@ -# Installation - -Rivencraft 1.0.0.2 targets **Minecraft 1.21.1**, **NeoForge 21.1.264 or newer in the 21.1 line**, and **Java 21**. - -## Required mods - -Install Rivencraft, **Dynamic Dimensions AR Edition 0.9.1**, and **Bad Packets 0.8.2** on both client and server. A singleplayer installation needs these same required mods. - -## Optional integrations - -| Mod | Rivencraft feature | -| --- | --- | -| JEI | Searchable Pages and guides for writing and crafting stations. | -| Create (includes Ponder) | Ponder destination snapshots and a portal-construction guide. | -| Immersive Portals | Live destination views in books and crystal portals. | -| TerraBlender | Eligible biomes from mods using its regions, such as Biomes O' Plenty. | -| Serene Seasons with GlitchCore | Independent seasons in Ages, including eternal-season Pages. | -| Ruins | Authorable Ruins-template Pages and generated ruins. | - -None of these optional mods is needed for core Age travel. **Ecliptic Seasons is not supported** for dynamic Ages in this version. The [compatibility review](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/MILESTONE_7_COMPATIBILITY_REVIEW.md) records development checks. - -## Before updating - -Stop the server and back up the **entire world folder**, not just an Age's dimension folder. Age definitions, books, and dimension data must be restored together. This is a release candidate, so old development saves are not guaranteed to work across every update. - -After installation, follow [Getting Started](Getting-Started). If a book opens but its Age will not load, see the [Age recovery guidance](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/AGES.md#administrator-recovery). +# Installation + +Choose the file that matches your Minecraft version. **The 26.3 alpha is not a replacement for the full 1.21.1 mod.** Do not install both Rivencraft JARs together. + +| Track | Minecraft / NeoForge | Java | Status | +| --- | --- | --- | --- | +| [1.0.1.1 release](https://git.paddedcell.org/dnorberg/rivencraft/releases) | 1.21.1 / 21.1.264 or newer in the 21.1 line | 21 | Full feature set documented in this wiki. | +| [1.0.1.3-alpha.1](https://git.paddedcell.org/dnorberg/rivencraft/releases/tag/V1.0.1.3-mc26.3-alpha.1) | 26.3 / 26.3.0.99 | 25 | Experimental port preview with prototype vanilla-terrain Ages. | + +## Required mods + +For **Minecraft 1.21.1**, install Rivencraft, **Dynamic Dimensions AR Edition 0.9.1**, and **Bad Packets 0.8.2** on both client and server. A singleplayer installation needs these same required mods. + +For the **Minecraft 26.3 alpha**, install only its matching Rivencraft JAR with NeoForge 26.3.0.99 and Java 25. The 26.3 port has a first-party prototype Age backend and does **not** use Dynamic Dimensions or Bad Packets. Do not add the 1.21.1 dependencies to a 26.3 instance. The 26.3 alpha currently supports basic named Linking Books and Descriptive Books, but not Page-authored generation, crafting stations, portals, modifiers, live previews, or the optional integrations below. Use a disposable world or back it up first. + +## Optional integrations (1.21.1 only) + +| Mod | Rivencraft feature | +| --- | --- | +| JEI | Searchable Pages and guides for writing and crafting stations. | +| Create (includes Ponder) | Ponder destination snapshots and a portal-construction guide. | +| Immersive Portals | Live destination views in books and crystal portals. | +| TerraBlender | Eligible biomes from mods using its regions, such as Biomes O' Plenty. | +| Serene Seasons with GlitchCore | Independent seasons in Ages, including eternal-season Pages. | +| Ruins | Authorable Ruins-template Pages and generated ruins. | + +None of these optional mods is needed for core Age travel on 1.21.1. **Ecliptic Seasons is not supported** for dynamic Ages in this version. The [compatibility review](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/MILESTONE_7_COMPATIBILITY_REVIEW.md) records development checks. Optional integration support is not yet ported to 26.3. + +## Before updating + +Stop the server and back up the **entire world folder**, not just an Age's dimension folder. Age definitions, books, and dimension data must be restored together. Do not migrate a 1.21.1 Rivencraft world to the 26.3 alpha; cross-version save migration is not supported. Alpha saves are not guaranteed to survive later port iterations. + +On 1.21.1, follow [Getting Started](Getting-Started). If a book opens but its Age will not load, see the [Age recovery guidance](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/AGES.md#administrator-recovery). Those gameplay instructions do not yet apply to the 26.3 alpha; consult its [release notes](https://git.paddedcell.org/dnorberg/rivencraft/releases/tag/V1.0.1.3-mc26.3-alpha.1) instead.