dnorberg/rivencraft
Public Access
1
0 Fork 0
Code Issues 15 Pull Requests Actions 2 Packages Projects Releases 115 Wiki Activity

Clarify 1.21.1 release and 26.3 alpha installation

dnorberg committed 2026-10-29 14:37:00 -04:00
1 parent 7b2daeeb2b
commit 99e89870cb
2 files changed
+53 -46
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

Home.md
+20 -20
@@ -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).
Installation.md
+33 -26
@@ -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.