Port Binder and Ink Mixer interactions to 26.3 alpha

Port crystal growth, pages, ink vials and link crafting to 26.3
Add 26.3 descriptive book binding and travel
2026-10-30 15:55:43 -04:00 · 2026-10-29 15:07:46 -04:00 · 2026-10-29 14:32:50 -04:00
78 changed files with 2246 additions and 29 deletions
@@ -0,0 +1,37 @@
+# Rivencraft 1.0.1.3-alpha.1 — Minecraft 26.3
+
+Experimental **NeoForge 26.3** port preview. This is separate from the
+supported Minecraft 1.21.1 release and does **not** have feature parity. Use
+a disposable test world or make a backup first. Do not migrate a 1.21.1
+Rivencraft world to this alpha.
+
+## Changes since 1.0.1.2-alpha.1
+
+- An unbound Descriptive Book now opens a naming screen. Binding it creates a
+  distinct prototype Age with a random seed; duplicate names receive a
+  numbered suffix.
+- A bound Descriptive Book opens a book screen whose destination panel can be
+  clicked to enter its Age. The server validates the held book and waits for
+  the client's Age catalog acknowledgement before travel.
+- Retired Age IDs are excluded when assigning a new book's Age name, so an
+  archived world cannot be silently reused.
+
+## Still experimental
+
+These Ages use prototype vanilla terrain. Page-authored generation, crafting
+and workstations, most items and blocks, portals, Link modifiers, instability,
+live destination previews, and optional mod integrations are not ported. The
+book panel is a placeholder, not a rendered destination view. The
+[port status](MINECRAFT_26_3_PORT.md) and [open port issues](https://git.paddedcell.org/dnorberg/rivencraft/issues)
+track the remaining work. The stable 1.21.1 release remains available
+separately.
+
+## Verification
+
+- Clean 26.3 Gradle build passed.
+- Disposable dedicated-server smoke test passed: two distinct Age seeds and
+  their terrain persisted across restart.
+- The player verified Descriptive Book binding and travel in game on
+  2026-10-29.
+
+These checks are **not** the full port acceptance matrix or a stability claim.
@@ -83,6 +83,12 @@ Age must retain its identity, seed, chunks and access across save/restart.
   identify the derived files. Prefer the smallest backend Rivencraft needs
   over a general-purpose library fork.

+For gameplay systems, treat the 1.21.1 Rivencraft source and assets as the
+porting baseline. Carry across unchanged rules, probabilities, recipes, and
+textures directly; adapt only the Minecraft/NeoForge APIs that changed in
+26.3. Record deliberate behavior gaps (such as prototype Age generation)
+instead of silently replacing established mechanics with new ones.
+
 The release gate is a 26.3 integrated-client **and** dedicated-server matrix:
 create two Ages with distinct seeds, explore chunks, travel while another
 client remains online, reconnect, restart, revisit saved chunks, reseed for
@@ -374,6 +380,106 @@ prototype vanilla terrain, normal authoring and most content are absent, and
 worlds should be disposable or backed up. The 1.21.1 stable release remains
 independent; issues #96–#104 stay open until the full port and validation pass.

+The next development slice, `1.0.1.3-alpha.1`, adds a basic Descriptive Book
+screen and server-validated binding. Naming an unbound book creates a unique
+prototype Age with a random seed; clicking the bound book's placeholder panel
+uses the acknowledged-catalog travel gate. This is not authored Page binding
+or a live destination preview. The player confirmed the Descriptive Book
+binding and travel interaction in game on 2026-10-29.
+
+The following `1.0.1.4-alpha.1` development iteration registers a small
+Rivencraft creative tab for the two Books, Crystal Block, and Crystal Shard.
+It builds and passes the dedicated-server Age smoke test. The player confirmed
+the tab and four entries in game on 2026-10-29. No Page categories or
+unported items are advertised in the 26.3 tab.
+
+The next local `1.0.1.5-alpha.1` iteration selects Legacy's unwritten
+Linking Book sprite until a target is bound, then the bound sprite. It also
+restores the four-Crystal-Shard crafting recipe for a Crystal Block. Both
+changes passed the player's in-game visual/crafting check on 2026-10-29.
+
+The local `1.0.1.6-alpha.1` iteration ports Budding Crystal and the four
+blue crystal growth stages, reusing the 1.21.1 sprites and vanilla amethyst
+growth/harvest rules. Crystal clusters yield Shards, but natural crystal
+formation generation remains unported. Test growth with a Creative or
+command-placed Budding Crystal; the player passed the in-game check.
+
+The local `1.0.1.7-alpha.1` iteration adds one persistent Page item with
+unwritten and Link Panel variants. It reuses the existing Page/Link Panel
+artwork and exposes only the Link Panel variant in its own creative tab,
+matching the 1.21.1 separation of Link Pages from symbol pages. Blank Pages
+remain command-only bases; the Ink Mixer, Book Binder and symbol writing are
+not yet ported. The player passed the in-game visual and persistence check.
+
+The local `1.0.1.8-alpha.1` iteration ports the Ink Vial item, its animated
+sprite, and the black-dye/glass-bottle/water-bucket crafting recipe. Using
+it with paper in the other hand prepares a Link Panel at the current 1.21.1
+default cost of 2 ink from a 16-use vial. Ink remaining persists per vial;
+an empty vial yields a glass bottle. The Ink Mixer, configurable ink cost,
+and Book Binder remain unported. The player passed the in-game craft/use check.
+
+The local `1.0.1.9-alpha.1` iteration ports the special shapeless leather +
+Link Panel recipe for an unwritten Linking Book. The 26.3 recipe serializer
+rejects blank Pages and extra ingredients and preserves a panel's custom name
+without carrying its Page identity onto the Book. No Link Panel modifiers are
+ported yet. The player passed the in-game crafting check on 2026-10-29. The
+full Book Binder GUI and Age authoring remain the next larger port step.
+
+The local `1.0.1.10-alpha.1` iteration adds the first three Link Panel
+modifiers as a prerequisite to Binder authoring. All eight combinations of
+Disarm, Maintain Momentum, and Intra-Linking are testable in the Link Pages
+creative tab and persist as a synced component through leather crafting and
+book binding. The server uses the book's flags when linking: Intra-Linking
+allows same-dimension travel, Maintain Momentum rotates horizontal velocity
+to the destination yaw, and Disarm drops player inventory at the departure
+point only after a successful teleport. The Ink Mixer, additional Link Modifier
+flags, and Descriptive Book panel propagation are not yet ported. In-game
+testing of each modifier and their combinations passed in game. This local slice
+must not be committed, pushed or published without the player's explicit request.
+
+The next local `1.0.1.11-alpha.1` slice introduces the Book Binder block and
+its first server-authoritative binding workflow. Leather and a Link Panel
+produce a named, bound Descriptive Book for a random prototype Age; the output
+is persisted in the Binder until collected. The panel's Disarm and Maintain
+Momentum flags carry onto the book and apply after successful Age travel;
+Intra-Linking is inert for Descriptive Books. This is not yet symbol-page
+authoring or the full Legacy Binder interface. Build and dedicated-server
+smoke pass. The player passed basic Binder crafting and travel in game, but
+reported that typing E closed the GUI and asked us to reuse the 1.21.1 GUI
+more faithfully. No
+commit, push, or publication without an explicit request during alpha.
+
+The local `1.0.1.12-alpha.1` follow-up ports the existing Binder layout's
+top title field, flank slots, center Page strip, and pulsing red missing-panel
+cue. It persists the title on the block entity and consumes focused keyboard
+events before the container can treat E as inventory-close. Click the output
+once to bind and again to collect the result. The full authored-symbol strip
+and 1.21.1 grammar still await later port slices. The same slice adapts the
+existing 1.21.1 Ink Mixer block, persistent basin, additive probabilities,
+16-ink-per-panel exchange, virtual output, Legacy atlas and animated glyph to
+the 26.3 storage, menu and GUI APIs. The build and dedicated-server Age smoke
+pass. In-game Binder and Mixer verification is
+pending; do not commit, push, or publish without explicit authorization.
+
+The local `1.0.1.13-alpha.1` iteration moves the Binder's freshly assembled
+book directly to the cursor so one output click both binds and takes it. Its
+central strip now displays five Legacy page thumbnails, while only the Link
+Panel is currently writable. The Mixer recomputes its virtual output in the
+same server click as an input change to address an intermittent first-attempt
+delay. The user's second Mixer attempt succeeded but exposed a cost mismatch:
+the Mixer now spends one ink and one paper per Link Panel and resets its
+additive chances on output pickup. Build passes; in-game retest is
+pending. This alpha remains local until explicitly authorized for release.
+
+The local `1.0.1.14-alpha.1` visual follow-up uses the new Binder dev images
+as a reference: the page strip now grows only when a Link Panel is present or
+carried, its required-panel cue appears above the strip, and the first page
+can be clicked to place/take the panel. The stored page has a tooltip. The
+rest of the 1.21.1 strip (symbol pages and scrolling) depends on porting the
+symbol-page data and authoring pipeline, not just drawing more placeholders.
+The local `1.0.1.15-alpha.1` follow-up changes the missing-panel cue to the
+Link Panel's 16×16 item icon while preserving its red pulse and tooltip.
+
 ## Verification of this first slice

 The 1.21.1 `compileJava` and `build` tasks passed offline after the backend
@@ -3,12 +3,83 @@
 This is an **experimental alpha port** for issues #97–#104, not gameplay parity
 with the Minecraft 1.21.1 release. It registers basic items and a runtime Age
 prototype with persisted seeds. The operator-only `rivencraft_port age`
-commands create and inspect separate vanilla-terrain levels. Descriptive Book
-travel and named Linking Book binding/travel work as limited probes. Authored
-generation, most content, recipes, workstations, portal systems, modifiers and
+commands create and inspect separate vanilla-terrain levels. The current
+development slice can name an unbound Descriptive Book to create a prototype
+Age, then enter it from the book GUI; the player verified this interaction in game.
+Named Linking Book binding/travel works as a limited probe. Authored
+generation, most content, recipes, workstations, portal systems, most modifiers and
 the destination preview renderer remain unported. Use a test world and keep a
 backup; do not substitute this JAR for the 1.21.1 mod or import 1.21.1 saves.

+The creative tab contains the two Books, Crystal Block and Crystal Shard;
+the player verified these in game. Unbound Linking Books use the Legacy
+sprite, and four Crystal Shards craft into a Crystal Block; both were also
+verified in game. The current local iteration adds Budding Crystal and all
+four blue crystal growth stages with vanilla-style harvesting. Natural crystal
+formation generation is not yet ported; use Creative or commands to obtain a
+Budding Crystal for this test. The player verified the growth chain in game.
+The next local slice adds the Link Panel Page as a separate creative entry,
+using the existing item texture. Blank Pages remain unavailable in Creative;
+the player verified the Link Panel's appearance in game. Ink Vials now use
+the existing crafting recipe and animated sprite. With paper in the other
+hand, an Ink Vial prepares a Link Panel for two of its sixteen ink uses, as
+in the current 1.21.1 default. The player verified the Ink Vial interaction
+in game. Symbol writing remains unported.
+A prepared Link Panel can now be combined shapelessly with leather to craft
+an unwritten Linking Book, as in 1.21.1. This custom recipe rejects a blank
+Page and extra ingredients. The first Book Binder slice now assembles random-Age
+Descriptive Books from leather and a Link Panel. Authored pages remain later.
+
+The next local `1.0.1.10-alpha.1` slice exposes all eight combinations of
+plain, Disarm, Maintain Momentum, and Intra-Linking Link Panels in the Link
+Pages creative tab. Leather crafting preserves those flags on the Linking
+Book. Intra-Linking permits same-dimension travel; Maintain Momentum rotates
+horizontal speed to the destination yaw; Disarm leaves the player's inventory
+at the departure point after a successful teleport. These are development
+variants until the Ink Mixer is ported; other Link Panel modifiers are not
+implemented in 26.3. The player passed this modifier slice in game.
+
+The local `1.0.1.11-alpha.1` slice adds a craftable Book Binder with persistent
+leather, Link Panel, and output slots. Name an Age in its GUI and press Bind;
+the server creates a random prototype Age and places its completed Descriptive
+Book in the output. Disarm and Maintain Momentum carry from the panel into the
+book; Intra-Linking has no effect on Age creation. Symbol-page authoring and
+the Ink Mixer remain unported. This slice passes the build and dedicated-server
+smoke test. The player passed crafting and travel in game, but found that E
+closed the focused title field and the provisional layout did not match the
+existing 1.21.1 Binder GUI.
+
+The local `1.0.1.12-alpha.1` follow-up reuses the 1.21.1 Binder layout: title
+bar, cover and output at opposite sides, and a central Link Panel page strip.
+The title persists in the block, the missing-panel cue pulses red, and a
+focused title field consumes inventory/hotbar keys. Click the output once to
+bind, then click again to take the completed book. Authored symbol strips and
+the full 1.21.1 Binder grammar remain unported. This same slice also ports the
+1.21.1 Ink Mixer block, menu, animation, modifier additives, 16-ink-per-panel
+cost, and automatic vial exchange. The creative tab includes it and its
+vanilla-shaped recipe is available. This slice needs an in-game Binder visual/
+keyboard check and Ink Mixer interaction check.
+
+The local `1.0.1.13-alpha.1` iteration makes Binder assembly place the new
+Descriptive Book directly on the cursor with one click. It also renders the
+five-page strip from the 1.21.1 GUI and refreshes the Mixer's virtual result
+in the same server click that changes paper or ink. The Mixer now consumes
+one ink unit and one paper per Link Panel (16 panels per full vial); additive
+chances reset when a panel is taken. In-game retest of the first-update
+behavior and Binder visual/click flow is pending.
+
+The local `1.0.1.14-alpha.1` follow-up compares the current 26.3 Binder against
+the new dev-image sequence. The Binder no longer paints five permanently empty
+pages: the first strip page appears when a Link Panel is inserted or carried,
+and the missing-panel cue remains above it. Clicking that page inserts/removes
+the Link Panel using the same server-owned cursor flow as 1.21.1. Its tooltip
+also shows the stored panel. Multi-page symbol writing and strip scrolling
+cannot be exercised yet because symbol pages are still unported to 26.3.
+
+The local `1.0.1.15-alpha.1` Binder polish uses the Link Panel's actual 16×16
+item icon for the missing-panel cue instead of a full-size page sprite. The
+red pulse and tooltip remain confined to that icon.
+
 From the repository root:

 ```sh
@@ -63,18 +63,62 @@ tasks.named('processResources', ProcessResources).configure {
    // Reuse the existing sprite and base model without copying binary assets.
    from('../../src/main/resources') {
        include 'assets/rivencraft/textures/item/crystal_shard.png'
+        include 'assets/rivencraft/textures/item/page.png'
+        include 'assets/rivencraft/textures/item/page_link_panel.png'
+        include 'assets/rivencraft/models/item/page_link_panel.json'
+        include 'assets/rivencraft/textures/item/ink_vial.png'
+        include 'assets/rivencraft/textures/item/ink_vial.png.mcmeta'
+        include 'assets/rivencraft/models/item/ink_vial.json'
        include 'assets/rivencraft/models/item/crystal_shard.json'
        include 'assets/rivencraft/textures/item/descriptive_book.png'
        include 'assets/rivencraft/models/item/descriptive_book.json'
        include 'assets/rivencraft/textures/item/linking_book.png'
+        include 'assets/rivencraft/textures/item/linking_book_unwritten.png'
        include 'assets/rivencraft/models/item/linking_book_bound.json'
        include 'assets/rivencraft/textures/gui/bookui_cover.png'
        include 'assets/rivencraft/textures/gui/notebook_pages.png'
        include 'assets/rivencraft/textures/gui/bookui_pager.png'
        include 'assets/rivencraft/textures/block/crystal_block.png'
+        include 'assets/rivencraft/textures/block/book_binder.png'
+        include 'assets/rivencraft/textures/block/book_binder_press.png'
+        include 'assets/rivencraft/textures/gui/book_binder_legacy.png'
+        include 'assets/rivencraft/textures/gui/ink_mixer_legacy.png'
+        include 'assets/rivencraft/textures/block/inkwell_base.png'
+        include 'assets/rivencraft/textures/block/inkwell_cup.png'
+        include 'assets/rivencraft/textures/block/ink.png'
+        include 'assets/rivencraft/textures/block/ink_glass.png'
+        include 'assets/rivencraft/models/block/ink_mixer.json'
+        include 'assets/rivencraft/models/item/ink_mixer.json'
+        include 'assets/rivencraft/blockstates/ink_mixer.json'
+        include 'data/rivencraft/loot_table/blocks/ink_mixer.json'
+        include 'assets/rivencraft/models/block/book_binder.json'
+        include 'assets/rivencraft/models/item/book_binder.json'
+        include 'assets/rivencraft/blockstates/book_binder.json'
+        include 'data/rivencraft/loot_table/blocks/book_binder.json'
        include 'assets/rivencraft/models/block/crystal_block.json'
        include 'assets/rivencraft/blockstates/crystal_block.json'
+        include 'assets/rivencraft/blockstates/budding_crystal.json'
+        include 'assets/rivencraft/blockstates/small_crystal_bud.json'
+        include 'assets/rivencraft/blockstates/medium_crystal_bud.json'
+        include 'assets/rivencraft/blockstates/large_crystal_bud.json'
+        include 'assets/rivencraft/blockstates/crystal_cluster.json'
+        include 'assets/rivencraft/models/block/budding_crystal.json'
+        include 'assets/rivencraft/models/block/small_crystal_bud.json'
+        include 'assets/rivencraft/models/block/medium_crystal_bud.json'
+        include 'assets/rivencraft/models/block/large_crystal_bud.json'
+        include 'assets/rivencraft/models/block/crystal_cluster.json'
+        include 'assets/rivencraft/models/item/budding_crystal.json'
+        include 'assets/rivencraft/models/item/small_crystal_bud.json'
+        include 'assets/rivencraft/models/item/medium_crystal_bud.json'
+        include 'assets/rivencraft/models/item/large_crystal_bud.json'
+        include 'assets/rivencraft/models/item/crystal_cluster.json'
+        include 'assets/rivencraft/textures/block/small_crystal_bud.png'
+        include 'assets/rivencraft/textures/block/medium_crystal_bud.png'
+        include 'assets/rivencraft/textures/block/large_crystal_bud.png'
+        include 'assets/rivencraft/textures/block/crystal_cluster.png'
        include 'data/rivencraft/loot_table/blocks/crystal_block.json'
+        include 'data/minecraft/tags/block/mineable/pickaxe.json'
+        include 'data/minecraft/tags/item/cluster_max_harvestables.json'
    }
 }

@@ -7,4 +7,4 @@ neo_version=26.3.0.99
 mod_id=rivencraft
 mod_name=Rivencraft
 mod_license=LGPL-3.0-or-later
-mod_version=1.0.1.2-alpha.1
+mod_version=1.0.1.15-alpha.1
@@ -1,26 +1,46 @@
 package net.dnorberg.rivencraft;

 import com.mojang.logging.LogUtils;
+import com.mojang.serialization.Codec;
 import net.dnorberg.rivencraft.age.RuntimeAgeBackend;
 import net.dnorberg.rivencraft.age.PortAgeCommands;
 import net.dnorberg.rivencraft.age.AgeCatalogSync;
+import net.dnorberg.rivencraft.block.BuddingCrystalBlock;
+import net.dnorberg.rivencraft.block.PortBookBinderBlock;
+import net.dnorberg.rivencraft.block.InkMixerBlock;
+import net.dnorberg.rivencraft.block.entity.PortBookBinderBlockEntity;
+import net.dnorberg.rivencraft.block.entity.InkMixerBlockEntity;
+import net.dnorberg.rivencraft.menu.PortBookBinderMenu;
+import net.dnorberg.rivencraft.menu.InkMixerMenu;
 import net.dnorberg.rivencraft.item.DescriptiveBookItem;
 import net.dnorberg.rivencraft.item.LinkBookTarget;
+import net.dnorberg.rivencraft.item.LinkProperties;
+import net.dnorberg.rivencraft.item.InkVialItem;
 import net.dnorberg.rivencraft.item.LinkingBookItem;
+import net.dnorberg.rivencraft.item.PageItem;
 import net.dnorberg.rivencraft.network.PortBookNetworking;
+import net.dnorberg.rivencraft.registry.ModCreativeTabs;
+import net.dnorberg.rivencraft.writing.LinkingBookRecipe;
 import net.minecraft.core.component.DataComponentType;
 import net.minecraft.core.registries.Registries;
 import net.minecraft.resources.Identifier;
+import net.minecraft.network.codec.ByteBufCodecs;
 import net.minecraft.world.level.block.Block;
 import net.minecraft.world.level.block.Blocks;
+import net.minecraft.world.level.block.AmethystClusterBlock;
 import net.minecraft.world.level.block.state.BlockBehaviour;
+import net.minecraft.world.level.material.MapColor;
 import net.minecraft.world.item.BlockItem;
 import net.minecraft.world.item.Item;
+import net.minecraft.world.item.crafting.RecipeSerializer;
+import net.minecraft.world.inventory.MenuType;
+import net.minecraft.world.level.block.entity.BlockEntityType;
 import net.neoforged.bus.api.IEventBus;
 import net.neoforged.fml.common.Mod;
 import net.neoforged.neoforge.registries.DeferredBlock;
 import net.neoforged.neoforge.registries.DeferredItem;
 import net.neoforged.neoforge.registries.DeferredRegister;
+import net.neoforged.neoforge.common.extensions.IMenuTypeExtension;
 import java.util.function.Supplier;
 import net.neoforged.neoforge.common.NeoForge;
 import org.slf4j.Logger;
@@ -32,6 +52,12 @@ public final class Rivencraft {
    public static final Logger LOGGER = LogUtils.getLogger();
    private static final DeferredRegister.Blocks BLOCKS = DeferredRegister.createBlocks(MOD_ID);
    private static final DeferredRegister.Items ITEMS = DeferredRegister.createItems(MOD_ID);
+    private static final DeferredRegister<BlockEntityType<?>> BLOCK_ENTITY_TYPES =
+            DeferredRegister.create(Registries.BLOCK_ENTITY_TYPE, MOD_ID);
+    private static final DeferredRegister<MenuType<?>> MENUS =
+            DeferredRegister.create(Registries.MENU, MOD_ID);
+    private static final DeferredRegister<RecipeSerializer<?>> RECIPE_SERIALIZERS =
+            DeferredRegister.create(Registries.RECIPE_SERIALIZER, MOD_ID);
    private static final DeferredRegister.DataComponents COMPONENTS =
            DeferredRegister.createDataComponents(Registries.DATA_COMPONENT_TYPE, MOD_ID);

@@ -41,20 +67,77 @@ public final class Rivencraft {
    public static final Supplier<DataComponentType<LinkBookTarget>> LINK_BOOK_TARGET = COMPONENTS.registerComponentType(
            "link_book_target", builder -> builder.persistent(LinkBookTarget.CODEC)
                    .networkSynchronized(LinkBookTarget.STREAM_CODEC));
+    /** A present component distinguishes Link Panels from unwritten base Pages. */
+    public static final Supplier<DataComponentType<Boolean>> LINK_PANEL_PAGE = COMPONENTS.registerComponentType(
+            "link_panel_page", builder -> builder.persistent(Codec.BOOL)
+                    .networkSynchronized(ByteBufCodecs.BOOL));
+    public static final Supplier<DataComponentType<Integer>> INK_REMAINING = COMPONENTS.registerComponentType(
+            "ink_remaining", builder -> builder.persistent(Codec.INT)
+                    .networkSynchronized(ByteBufCodecs.VAR_INT));
+    public static final Supplier<DataComponentType<LinkProperties>> LINK_PROPERTIES = COMPONENTS.registerComponentType(
+            "link_properties", builder -> builder.persistent(LinkProperties.CODEC)
+                    .networkSynchronized(LinkProperties.STREAM_CODEC));

    public static final DeferredBlock<Block> CRYSTAL_BLOCK = BLOCKS.registerBlock("crystal_block",
            Block::new, () -> BlockBehaviour.Properties.ofFullCopy(Blocks.AMETHYST_BLOCK));
+    public static final DeferredBlock<PortBookBinderBlock> BOOK_BINDER = BLOCKS.registerBlock(
+            "book_binder", PortBookBinderBlock::new,
+            () -> BlockBehaviour.Properties.ofFullCopy(Blocks.CRAFTING_TABLE));
+    public static final DeferredItem<BlockItem> BOOK_BINDER_ITEM = ITEMS.registerSimpleBlockItem(BOOK_BINDER);
+    public static final DeferredBlock<InkMixerBlock> INK_MIXER = BLOCKS.registerBlock(
+            "ink_mixer", InkMixerBlock::new,
+            () -> BlockBehaviour.Properties.ofFullCopy(Blocks.CRAFTING_TABLE));
+    public static final DeferredItem<BlockItem> INK_MIXER_ITEM = ITEMS.registerSimpleBlockItem(INK_MIXER);
+    public static final Supplier<BlockEntityType<PortBookBinderBlockEntity>> BOOK_BINDER_BLOCK_ENTITY =
+            BLOCK_ENTITY_TYPES.register("book_binder", () ->
+                    new BlockEntityType<>(PortBookBinderBlockEntity::new, BOOK_BINDER.get()));
+    public static final Supplier<MenuType<PortBookBinderMenu>> BOOK_BINDER_MENU =
+            MENUS.register("book_binder", () -> IMenuTypeExtension.create(PortBookBinderMenu::new));
+    public static final Supplier<BlockEntityType<InkMixerBlockEntity>> INK_MIXER_BLOCK_ENTITY =
+            BLOCK_ENTITY_TYPES.register("ink_mixer", () ->
+                    new BlockEntityType<>(InkMixerBlockEntity::new, INK_MIXER.get()));
+    public static final Supplier<MenuType<InkMixerMenu>> INK_MIXER_MENU =
+            MENUS.register("ink_mixer", () -> IMenuTypeExtension.create(InkMixerMenu::new));
    public static final DeferredItem<BlockItem> CRYSTAL_BLOCK_ITEM = ITEMS.registerSimpleBlockItem(CRYSTAL_BLOCK);
+    public static final DeferredBlock<BuddingCrystalBlock> BUDDING_CRYSTAL = BLOCKS.registerBlock(
+            "budding_crystal", BuddingCrystalBlock::new,
+            () -> BlockBehaviour.Properties.ofFullCopy(Blocks.BUDDING_AMETHYST).mapColor(MapColor.COLOR_BLUE));
+    public static final DeferredItem<BlockItem> BUDDING_CRYSTAL_ITEM = ITEMS.registerSimpleBlockItem(BUDDING_CRYSTAL);
+    public static final DeferredBlock<AmethystClusterBlock> SMALL_CRYSTAL_BUD = BLOCKS.registerBlock(
+            "small_crystal_bud", properties -> new AmethystClusterBlock(3.0F, 4.0F, properties),
+            () -> BlockBehaviour.Properties.ofFullCopy(Blocks.SMALL_AMETHYST_BUD));
+    public static final DeferredItem<BlockItem> SMALL_CRYSTAL_BUD_ITEM = ITEMS.registerSimpleBlockItem(SMALL_CRYSTAL_BUD);
+    public static final DeferredBlock<AmethystClusterBlock> MEDIUM_CRYSTAL_BUD = BLOCKS.registerBlock(
+            "medium_crystal_bud", properties -> new AmethystClusterBlock(4.0F, 3.0F, properties),
+            () -> BlockBehaviour.Properties.ofFullCopy(Blocks.MEDIUM_AMETHYST_BUD));
+    public static final DeferredItem<BlockItem> MEDIUM_CRYSTAL_BUD_ITEM = ITEMS.registerSimpleBlockItem(MEDIUM_CRYSTAL_BUD);
+    public static final DeferredBlock<AmethystClusterBlock> LARGE_CRYSTAL_BUD = BLOCKS.registerBlock(
+            "large_crystal_bud", properties -> new AmethystClusterBlock(5.0F, 3.0F, properties),
+            () -> BlockBehaviour.Properties.ofFullCopy(Blocks.LARGE_AMETHYST_BUD));
+    public static final DeferredItem<BlockItem> LARGE_CRYSTAL_BUD_ITEM = ITEMS.registerSimpleBlockItem(LARGE_CRYSTAL_BUD);
+    public static final DeferredBlock<AmethystClusterBlock> CRYSTAL_CLUSTER = BLOCKS.registerBlock(
+            "crystal_cluster", properties -> new AmethystClusterBlock(7.0F, 3.0F, properties),
+            () -> BlockBehaviour.Properties.ofFullCopy(Blocks.AMETHYST_CLUSTER));
+    public static final DeferredItem<BlockItem> CRYSTAL_CLUSTER_ITEM = ITEMS.registerSimpleBlockItem(CRYSTAL_CLUSTER);
    public static final DeferredItem<Item> CRYSTAL_SHARD = ITEMS.registerSimpleItem("crystal_shard");
+    public static final DeferredItem<PageItem> PAGE = ITEMS.registerItem("page", PageItem::new);
+    public static final DeferredItem<InkVialItem> INK_VIAL = ITEMS.registerItem(
+            "ink_vial", InkVialItem::new, properties -> properties.stacksTo(16));
    public static final DeferredItem<DescriptiveBookItem> DESCRIPTIVE_BOOK = ITEMS.registerItem(
            "descriptive_book", DescriptiveBookItem::new, properties -> properties.stacksTo(1));
    public static final DeferredItem<LinkingBookItem> LINKING_BOOK = ITEMS.registerItem(
            "linking_book", LinkingBookItem::new, properties -> properties.stacksTo(1));
+    public static final Supplier<RecipeSerializer<LinkingBookRecipe>> LINKING_BOOK_RECIPE =
+            RECIPE_SERIALIZERS.register("linking_book", () -> LinkingBookRecipe.SERIALIZER);

    public Rivencraft(IEventBus modEventBus) {
        BLOCKS.register(modEventBus);
        ITEMS.register(modEventBus);
+        BLOCK_ENTITY_TYPES.register(modEventBus);
+        MENUS.register(modEventBus);
        COMPONENTS.register(modEventBus);
+        RECIPE_SERIALIZERS.register(modEventBus);
+        ModCreativeTabs.register(modEventBus);
        NeoForge.EVENT_BUS.addListener(RuntimeAgeBackend::onLevelLoad);
        NeoForge.EVENT_BUS.addListener(PortAgeCommands::register);
        NeoForge.EVENT_BUS.addListener(AgeCatalogSync::onLogin);
@@ -153,6 +153,13 @@ public final class RuntimeAgeBackend {
        return index(server).entries();
    }

+    /** Includes retired IDs, which must never be silently reused by a new book. */
+    public static boolean isNameTaken(MinecraftServer server, Identifier id) {
+        checkServerThread(server);
+        ageName(id);
+        return index(server).contains(id);
+    }
+
    private static AgeLevelIndex index(MinecraftServer server) {
        return server.overworld().getDataStorage().computeIfAbsent(AgeLevelIndex.TYPE);
    }
@@ -0,0 +1,45 @@
+package net.dnorberg.rivencraft.block;
+
+import net.dnorberg.rivencraft.Rivencraft;
+import net.minecraft.core.BlockPos;
+import net.minecraft.core.Direction;
+import net.minecraft.server.level.ServerLevel;
+import net.minecraft.util.RandomSource;
+import net.minecraft.world.level.block.AmethystBlock;
+import net.minecraft.world.level.block.AmethystClusterBlock;
+import net.minecraft.world.level.block.Block;
+import net.minecraft.world.level.block.BuddingAmethystBlock;
+import net.minecraft.world.level.block.state.BlockBehaviour;
+import net.minecraft.world.level.block.state.BlockState;
+import net.minecraft.world.level.material.Fluids;
+
+/** Vanilla amethyst growth, using Rivencraft's blue crystal stages. */
+public final class BuddingCrystalBlock extends AmethystBlock {
+    public BuddingCrystalBlock(BlockBehaviour.Properties properties) {
+        super(properties);
+    }
+
+    @Override
+    protected void randomTick(BlockState state, ServerLevel level, BlockPos pos, RandomSource random) {
+        if (random.nextInt(5) != 0) return;
+        Direction direction = Direction.values()[random.nextInt(Direction.values().length)];
+        BlockPos target = pos.relative(direction);
+        BlockState existing = level.getBlockState(target);
+        Block next = nextStage(existing, direction);
+        if (next == null) return;
+        level.setBlockAndUpdate(target, next.defaultBlockState()
+                .setValue(AmethystClusterBlock.FACING, direction)
+                .setValue(AmethystClusterBlock.WATERLOGGED,
+                        existing.getFluidState().getType() == Fluids.WATER));
+    }
+
+    public static Block nextStage(BlockState existing, Direction direction) {
+        if (BuddingAmethystBlock.canClusterGrowAtState(existing)) return Rivencraft.SMALL_CRYSTAL_BUD.get();
+        if (!existing.hasProperty(AmethystClusterBlock.FACING)
+                || existing.getValue(AmethystClusterBlock.FACING) != direction) return null;
+        if (existing.is(Rivencraft.SMALL_CRYSTAL_BUD)) return Rivencraft.MEDIUM_CRYSTAL_BUD.get();
+        if (existing.is(Rivencraft.MEDIUM_CRYSTAL_BUD)) return Rivencraft.LARGE_CRYSTAL_BUD.get();
+        if (existing.is(Rivencraft.LARGE_CRYSTAL_BUD)) return Rivencraft.CRYSTAL_CLUSTER.get();
+        return null;
+    }
+}
@@ -0,0 +1,47 @@
+package net.dnorberg.rivencraft.block;
+
+import net.dnorberg.rivencraft.block.entity.InkMixerBlockEntity;
+import net.dnorberg.rivencraft.menu.InkMixerMenu;
+import net.minecraft.core.BlockPos;
+import net.minecraft.network.chat.Component;
+import net.minecraft.server.level.ServerLevel;
+import net.minecraft.server.level.ServerPlayer;
+import net.minecraft.world.Containers;
+import net.minecraft.world.InteractionResult;
+import net.minecraft.world.SimpleMenuProvider;
+import net.minecraft.world.entity.player.Player;
+import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.level.Level;
+import net.minecraft.world.level.block.BaseEntityBlock;
+import net.minecraft.world.level.block.RenderShape;
+import net.minecraft.world.level.block.entity.BlockEntity;
+import net.minecraft.world.level.block.state.BlockState;
+import net.minecraft.world.phys.BlockHitResult;
+
+/** 26.3 API adaptation of the 1.21.1 Ink Mixer block. */
+public final class InkMixerBlock extends BaseEntityBlock {
+    public InkMixerBlock(Properties properties) { super(properties); }
+
+    @Override protected RenderShape getRenderShape(BlockState state) { return RenderShape.MODEL; }
+    @Override public BlockEntity newBlockEntity(BlockPos pos, BlockState state) {
+        return new InkMixerBlockEntity(pos, state);
+    }
+
+    @Override protected InteractionResult useWithoutItem(BlockState state, Level level, BlockPos pos,
+                                                          Player player, BlockHitResult hit) {
+        if (!level.isClientSide() && player instanceof ServerPlayer serverPlayer
+                && level.getBlockEntity(pos) instanceof InkMixerBlockEntity mixer) {
+            serverPlayer.openMenu(new SimpleMenuProvider(
+                    (id, inventory, ignored) -> new InkMixerMenu(id, inventory, mixer),
+                    Component.translatable("container.rivencraft.ink_mixer")),
+                    buffer -> buffer.writeBlockPos(pos));
+        }
+        return InteractionResult.SUCCESS;
+    }
+
+    @Override public void playerDestroy(ServerLevel level, ServerPlayer player, BlockPos pos,
+                                        BlockState state, BlockEntity entity, ItemStack tool) {
+        if (entity instanceof InkMixerBlockEntity mixer) Containers.dropContents(level, pos, mixer);
+        super.playerDestroy(level, player, pos, state, entity, tool);
+    }
+}
@@ -0,0 +1,63 @@
+package net.dnorberg.rivencraft.block;
+
+import net.dnorberg.rivencraft.block.entity.PortBookBinderBlockEntity;
+import net.dnorberg.rivencraft.menu.PortBookBinderMenu;
+import net.minecraft.core.BlockPos;
+import net.minecraft.core.Direction;
+import net.minecraft.network.chat.Component;
+import net.minecraft.server.level.ServerPlayer;
+import net.minecraft.server.level.ServerLevel;
+import net.minecraft.world.Containers;
+import net.minecraft.world.InteractionResult;
+import net.minecraft.world.SimpleMenuProvider;
+import net.minecraft.world.entity.player.Player;
+import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.item.context.BlockPlaceContext;
+import net.minecraft.world.level.Level;
+import net.minecraft.world.level.block.BaseEntityBlock;
+import net.minecraft.world.level.block.RenderShape;
+import net.minecraft.world.level.block.entity.BlockEntity;
+import net.minecraft.world.level.block.state.BlockState;
+import net.minecraft.world.level.block.state.StateDefinition;
+import net.minecraft.world.level.block.state.properties.BlockStateProperties;
+import net.minecraft.world.level.block.state.properties.EnumProperty;
+import net.minecraft.world.phys.BlockHitResult;
+
+public final class PortBookBinderBlock extends BaseEntityBlock {
+    public static final EnumProperty<Direction> FACING = BlockStateProperties.HORIZONTAL_FACING;
+
+    public PortBookBinderBlock(Properties properties) {
+        super(properties);
+        registerDefaultState(stateDefinition.any().setValue(FACING, Direction.NORTH));
+    }
+
+    @Override protected void createBlockStateDefinition(StateDefinition.Builder<net.minecraft.world.level.block.Block, BlockState> builder) {
+        builder.add(FACING);
+    }
+    @Override public BlockState getStateForPlacement(BlockPlaceContext context) {
+        return defaultBlockState().setValue(FACING, context.getHorizontalDirection().getOpposite());
+    }
+    @Override protected RenderShape getRenderShape(BlockState state) { return RenderShape.MODEL; }
+    @Override public BlockEntity newBlockEntity(BlockPos pos, BlockState state) {
+        return new PortBookBinderBlockEntity(pos, state);
+    }
+    @Override protected InteractionResult useWithoutItem(BlockState state, Level level, BlockPos pos,
+                                                         Player player, BlockHitResult hit) {
+        if (!level.isClientSide() && player instanceof ServerPlayer serverPlayer
+                && level.getBlockEntity(pos) instanceof PortBookBinderBlockEntity binder) {
+            serverPlayer.openMenu(new SimpleMenuProvider(
+                    (id, inventory, ignored) -> new PortBookBinderMenu(id, inventory, binder),
+                    Component.translatable("container.rivencraft.book_binder")),
+                    buffer -> {
+                        buffer.writeBlockPos(pos);
+                        buffer.writeUtf(binder.title(), 32);
+                    });
+        }
+        return InteractionResult.SUCCESS;
+    }
+    @Override public void playerDestroy(ServerLevel level, ServerPlayer player, BlockPos pos,
+                                        BlockState state, BlockEntity entity, ItemStack tool) {
+        if (entity instanceof PortBookBinderBlockEntity binder) Containers.dropContents(level, pos, binder);
+        super.playerDestroy(level, player, pos, state, entity, tool);
+    }
+}
@@ -0,0 +1,176 @@
+package net.dnorberg.rivencraft.block.entity;
+
+import java.util.Random;
+import net.dnorberg.rivencraft.item.LinkProperties;
+import net.dnorberg.rivencraft.item.InkVialItem;
+import net.dnorberg.rivencraft.item.PageItem;
+import net.dnorberg.rivencraft.writing.InkVialExchange;
+import net.dnorberg.rivencraft.writing.InkModifierIngredients;
+import net.dnorberg.rivencraft.Rivencraft;
+import net.minecraft.core.BlockPos;
+import net.minecraft.core.NonNullList;
+import net.minecraft.world.Container;
+import net.minecraft.world.ContainerHelper;
+import net.minecraft.world.entity.player.Player;
+import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.item.Items;
+import net.minecraft.world.level.Level;
+import net.minecraft.world.level.block.entity.BlockEntity;
+import net.minecraft.world.level.block.state.BlockState;
+import net.minecraft.world.level.storage.ValueInput;
+import net.minecraft.world.level.storage.ValueOutput;
+
+/** Server-owned Link Panel mixer with a persistent, Legacy-style additive mixture. */
+public final class InkMixerBlockEntity extends BlockEntity implements Container {
+    public static final int INK = 0;
+    public static final int PAPER = 1;
+    public static final int BOTTLES = 2;
+    public static final int SIZE = 3;
+
+    private NonNullList<ItemStack> items = NonNullList.withSize(SIZE, ItemStack.EMPTY);
+    private int inkRemaining;
+    private long nextModifierSeed = new Random().nextLong();
+    private final double[] modifierChances = new double[3];
+    private static final int[] FLAGS = {LinkProperties.DISARM,
+            LinkProperties.MAINTAIN_MOMENTUM, LinkProperties.INTRA_LINKING};
+    private static final String[] CHANCE_KEYS = {"DisarmChance", "MomentumChance", "IntraLinkingChance"};
+    private static final int[] OLD_CHANCE_INDEX = {0, 2, 3};
+
+    public InkMixerBlockEntity(BlockPos pos, BlockState state) {
+        super(Rivencraft.INK_MIXER_BLOCK_ENTITY.get(), pos, state);
+    }
+
+    public int inkRemaining() { return inkRemaining; }
+
+    public int modifierChancePermille(int index) {
+        return Math.clamp((int) Math.round(modifierChances[index] * 1000), 0, 1000);
+    }
+
+    /** Infuses a carried ingredient into the current ink pool; only the server calls this. */
+    public boolean addModifier(ItemStack carried, int amount) {
+        InkModifierIngredients.Ingredient ingredient = InkModifierIngredients.find(carried);
+        if (ingredient == null || inkRemaining == 0 || amount <= 0 || carried.getCount() < amount)
+            return false;
+        for (InkModifierIngredients.Effect effect : ingredient.effects())
+            for (int index = 0; index < FLAGS.length; index++)
+                if (FLAGS[index] == effect.flag())
+                    modifierChances[index] = 1.0 - (1.0 - modifierChances[index])
+                            * Math.pow(1.0 - effect.chance(), amount);
+        carried.shrink(amount);
+        setChanged();
+        return true;
+    }
+
+    public ItemStack previewLinkPanel() {
+        if (!canCreateLinkPanel()) return ItemStack.EMPTY;
+        ItemStack panel = PageItem.createLinkPanelPage();
+        LinkProperties properties = rollProperties(nextModifierSeed).properties();
+        if (properties.flags() != 0) panel.set(Rivencraft.LINK_PROPERTIES.get(), properties);
+        return panel;
+    }
+
+    private record Roll(LinkProperties properties, long nextSeed) {}
+
+    private Roll rollProperties(long seed) {
+        Random random = new Random(seed);
+        int selected = 0;
+        for (int index = 0; index < FLAGS.length; index++)
+            if (modifierChances[index] > 0 && random.nextDouble() < modifierChances[index])
+                selected |= FLAGS[index];
+        return new Roll(new LinkProperties(selected), random.nextLong());
+    }
+
+    @Override public int getContainerSize() { return SIZE; }
+    @Override public boolean isEmpty() { return items.stream().allMatch(ItemStack::isEmpty); }
+    @Override public ItemStack getItem(int slot) { return items.get(slot); }
+    @Override public ItemStack removeItem(int slot, int amount) {
+        ItemStack removed = ContainerHelper.removeItem(items, slot, amount);
+        if (!removed.isEmpty()) {
+            setChanged();
+            if (slot == BOTTLES) refillEmptyBasin();
+        }
+        return removed;
+    }
+    @Override public ItemStack removeItemNoUpdate(int slot) { return ContainerHelper.takeItem(items, slot); }
+    @Override public void setItem(int slot, ItemStack stack) {
+        items.set(slot, stack);
+        if (stack.getCount() > getMaxStackSize()) stack.setCount(getMaxStackSize());
+        setChanged();
+        if (slot == INK || slot == BOTTLES) refillEmptyBasin();
+    }
+    @Override public boolean canPlaceItem(int slot, ItemStack stack) {
+        return switch (slot) {
+            case INK -> stack.is(Rivencraft.INK_VIAL.get());
+            case PAPER -> stack.is(Items.PAPER);
+            default -> false;
+        };
+    }
+    @Override public boolean stillValid(Player player) {
+        return level != null && level.isLoaded(worldPosition) && level.getBlockEntity(worldPosition) == this
+                && player.distanceToSqr(worldPosition.getX() + 0.5, worldPosition.getY() + 0.5,
+                        worldPosition.getZ() + 0.5) <= 64.0;
+    }
+
+    /** No server tick: refill only when ink, bottle space, or consumption changes. */
+    private void refillEmptyBasin() {
+        if (level != null && !level.isClientSide() && inkRemaining == 0) {
+            int addedInk = InkVialExchange.exchange(items, INK, BOTTLES);
+            if (addedInk > 0) {
+                inkRemaining = addedInk;
+                setChanged();
+            }
+        }
+    }
+
+    public boolean canCreateLinkPanel() {
+        if (!items.get(PAPER).is(Items.PAPER)) return false;
+        return InkVialExchange.canPay(items, INK, BOTTLES, inkRemaining, 1);
+    }
+
+    /** Commit inputs only when a virtual output is actually taken. */
+    public boolean consumeLinkPanelMaterials() {
+        if (!canCreateLinkPanel()) return false;
+        int cost = 1;
+        if (inkRemaining < cost) {
+            inkRemaining += InkVialExchange.exchange(items, INK, BOTTLES);
+        }
+        inkRemaining -= cost;
+        items.get(PAPER).shrink(1);
+        if (items.get(PAPER).isEmpty()) items.set(PAPER, ItemStack.EMPTY);
+        nextModifierSeed = rollProperties(nextModifierSeed).nextSeed();
+        java.util.Arrays.fill(modifierChances, 0);
+        setChanged();
+        if (inkRemaining == 0) refillEmptyBasin();
+        return true;
+    }
+
+    @Override public void setLevel(Level level) {
+        super.setLevel(level);
+        refillEmptyBasin();
+    }
+    @Override public void clearContent() {
+        items = NonNullList.withSize(SIZE, ItemStack.EMPTY);
+        inkRemaining = 0;
+        java.util.Arrays.fill(modifierChances, 0);
+        setChanged();
+    }
+    @Override protected void loadAdditional(ValueInput input) {
+        super.loadAdditional(input);
+        items = NonNullList.withSize(SIZE, ItemStack.EMPTY);
+        ContainerHelper.loadAllItems(input, items);
+        inkRemaining = Math.clamp(input.getIntOr("InkRemaining", 0), 0, InkVialItem.CAPACITY);
+        nextModifierSeed = input.getLongOr("NextModifierSeed", nextModifierSeed);
+        for (int index = 0; index < modifierChances.length; index++) {
+            modifierChances[index] = Math.clamp(input.getDoubleOr(CHANCE_KEYS[index],
+                    input.getDoubleOr("ModifierChance" + OLD_CHANCE_INDEX[index], 0.0)), 0.0, 1.0);
+        }
+    }
+    @Override protected void saveAdditional(ValueOutput output) {
+        super.saveAdditional(output);
+        ContainerHelper.saveAllItems(output, items);
+        output.putInt("InkRemaining", inkRemaining);
+        output.putLong("NextModifierSeed", nextModifierSeed);
+        for (int index = 0; index < modifierChances.length; index++)
+            output.putDouble(CHANCE_KEYS[index], modifierChances[index]);
+    }
+}
@@ -0,0 +1,86 @@
+package net.dnorberg.rivencraft.block.entity;
+
+import net.dnorberg.rivencraft.Rivencraft;
+import net.dnorberg.rivencraft.item.PageItem;
+import net.minecraft.core.BlockPos;
+import net.minecraft.core.NonNullList;
+import net.minecraft.world.Container;
+import net.minecraft.world.ContainerHelper;
+import net.minecraft.world.entity.player.Player;
+import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.item.Items;
+import net.minecraft.world.level.block.entity.BlockEntity;
+import net.minecraft.world.level.block.state.BlockState;
+import net.minecraft.world.level.storage.ValueInput;
+import net.minecraft.world.level.storage.ValueOutput;
+
+/** Persistent, server-owned inputs and output for the first 26.3 Binder slice. */
+public final class PortBookBinderBlockEntity extends BlockEntity implements Container {
+    public static final int COVER = 0;
+    public static final int PANEL = 1;
+    public static final int OUTPUT = 2;
+    public static final int SIZE = 3;
+    private NonNullList<ItemStack> items = NonNullList.withSize(SIZE, ItemStack.EMPTY);
+    private String title = "";
+
+    public PortBookBinderBlockEntity(BlockPos pos, BlockState state) {
+        super(Rivencraft.BOOK_BINDER_BLOCK_ENTITY.get(), pos, state);
+    }
+
+    public String title() { return title; }
+
+    public void setTitle(String value) {
+        String normalized = value == null ? "" : value.strip();
+        if (normalized.length() > 32) return;
+        if (!title.equals(normalized)) {
+            title = normalized;
+            setChanged();
+        }
+    }
+
+    @Override public int getContainerSize() { return SIZE; }
+    @Override public boolean isEmpty() { return items.stream().allMatch(ItemStack::isEmpty); }
+    @Override public void clearContent() {
+        items.clear();
+        items = NonNullList.withSize(SIZE, ItemStack.EMPTY);
+        setChanged();
+    }
+    @Override public ItemStack getItem(int slot) { return items.get(slot); }
+    @Override public ItemStack removeItem(int slot, int amount) {
+        ItemStack removed = ContainerHelper.removeItem(items, slot, amount);
+        if (!removed.isEmpty()) setChanged();
+        return removed;
+    }
+    @Override public ItemStack removeItemNoUpdate(int slot) {
+        ItemStack removed = ContainerHelper.takeItem(items, slot);
+        if (!removed.isEmpty()) setChanged();
+        return removed;
+    }
+    @Override public void setItem(int slot, ItemStack stack) {
+        items.set(slot, stack);
+        setChanged();
+    }
+    @Override public boolean canPlaceItem(int slot, ItemStack stack) {
+        return switch (slot) {
+            case COVER -> stack.is(Items.LEATHER);
+            case PANEL -> PageItem.isLinkPanel(stack);
+            default -> false;
+        };
+    }
+    @Override public boolean stillValid(Player player) {
+        return level != null && level.getBlockEntity(worldPosition) == this
+                && player.distanceToSqr(worldPosition.getX() + 0.5, worldPosition.getY() + 0.5,
+                        worldPosition.getZ() + 0.5) <= 64.0;
+    }
+    @Override protected void saveAdditional(ValueOutput output) {
+        super.saveAdditional(output);
+        ContainerHelper.saveAllItems(output, items);
+        output.putString("Title", title);
+    }
+    @Override protected void loadAdditional(ValueInput input) {
+        super.loadAdditional(input);
+        items = NonNullList.withSize(SIZE, ItemStack.EMPTY);
+        ContainerHelper.loadAllItems(input, items);
+        title = input.getStringOr("Title", "");
+    }
+}
@@ -0,0 +1,167 @@
+package net.dnorberg.rivencraft.client;
+
+import com.mojang.blaze3d.platform.InputConstants;
+import net.dnorberg.rivencraft.Rivencraft;
+import net.dnorberg.rivencraft.item.InkVialItem;
+import net.dnorberg.rivencraft.menu.InkMixerMenu;
+import net.minecraft.client.gui.GuiGraphicsExtractor;
+import net.minecraft.client.input.MouseButtonEvent;
+import net.minecraft.client.gui.screens.inventory.AbstractContainerScreen;
+import net.minecraft.client.renderer.RenderPipelines;
+import net.minecraft.network.chat.Component;
+import net.minecraft.resources.Identifier;
+import net.minecraft.world.entity.player.Inventory;
+import net.minecraft.world.inventory.ContainerInput;
+import net.minecraft.world.item.ItemStack;
+
+/** 1.21.1 Legacy atlas and mixer animation adapted to the 26.3 GUI API. */
+public final class InkMixerScreen extends AbstractContainerScreen<InkMixerMenu> {
+    private static final Identifier BACKGROUND = Identifier.fromNamespaceAndPath(
+            Rivencraft.MOD_ID, "textures/gui/ink_mixer_legacy.png");
+    private static final int BASIN_X = 88;
+    private static final int BASIN_Y = 49;
+    private static final int BASIN_RADIUS = 30;
+    private static final int[] PROPERTY_COLORS = {0xFFE84848, 0xFF5555FF, 0xFF55EF55};
+    private final int[] lastChances = new int[3];
+    private boolean basinClickPendingRelease;
+    private long lastAdditionTime;
+
+    public InkMixerScreen(InkMixerMenu menu, Inventory inventory, Component title) {
+        super(menu, inventory, title, 176, 181);
+        inventoryLabelY = 87;
+    }
+
+    @Override public boolean isPauseScreen() { return false; }
+
+    @Override public void extractBackground(GuiGraphicsExtractor graphics, int mouseX, int mouseY, float partialTick) {
+        super.extractBackground(graphics, mouseX, mouseY, partialTick);
+        int left = (width - imageWidth) / 2;
+        int top = (height - imageHeight) / 2;
+        graphics.blit(RenderPipelines.GUI_TEXTURED, BACKGROUND, left + 54, top + 16,
+                179, 16, 66, 65, 256, 256);
+        if (menu.inkRemaining() > 0) {
+            graphics.fill(left + 54, top + 16, left + 120, top + 81, 0xFF101014);
+            renderPropertyGlyph(graphics);
+        }
+        graphics.blit(RenderPipelines.GUI_TEXTURED, BACKGROUND, left, top,
+                0, 0, imageWidth, imageHeight, 256, 256);
+    }
+
+    @Override protected void extractLabels(GuiGraphicsExtractor graphics, int mouseX, int mouseY) {
+        graphics.text(font, playerInventoryTitle, inventoryLabelX, inventoryLabelY, 0xFF404040, false);
+    }
+
+    @Override protected void extractTooltip(GuiGraphicsExtractor graphics, int mouseX, int mouseY) {
+        super.extractTooltip(graphics, mouseX, mouseY);
+        if (overBasin(mouseX, mouseY)) {
+            var lines = new java.util.ArrayList<Component>();
+            lines.add(Component.translatable("screen.rivencraft.ink_mixer.ink",
+                    menu.inkRemaining(), InkVialItem.CAPACITY));
+            lines.add(Component.translatable("screen.rivencraft.ink_mixer.additive_hint"));
+            for (int index = 0; index < 3; index++) {
+                int chance = menu.modifierChancePermille(index);
+                if (chance > 0) lines.add(Component.translatable("screen.rivencraft.ink_mixer.chance",
+                        switch (index) {
+                            case 0 -> Component.translatable("item.rivencraft.link_property.disarm");
+                            case 1 -> Component.translatable("item.rivencraft.link_property.maintain_momentum");
+                            default -> Component.translatable("item.rivencraft.link_property.intra_linking");
+                        }, chance / 10.0));
+            }
+            graphics.setComponentTooltipForNextFrame(font, lines, mouseX, mouseY, ItemStack.EMPTY, null);
+        }
+    }
+
+    @Override public boolean mouseClicked(MouseButtonEvent event, boolean doubleClick) {
+        if ((event.button() == InputConstants.MOUSE_BUTTON_LEFT
+                || event.button() == InputConstants.MOUSE_BUTTON_RIGHT)
+                && overBasin(event.x(), event.y()) && !menu.getCarried().isEmpty()) {
+            minecraft.gameMode.handleContainerInput(menu.containerId, InkMixerMenu.MODIFIER,
+                    event.button() == InputConstants.MOUSE_BUTTON_RIGHT ? 1 : 0,
+                    ContainerInput.PICKUP, minecraft.player);
+            basinClickPendingRelease = true;
+            return true;
+        }
+        return super.mouseClicked(event, doubleClick);
+    }
+
+    @Override public boolean mouseReleased(MouseButtonEvent event) {
+        if (basinClickPendingRelease) {
+            basinClickPendingRelease = false;
+            return true;
+        }
+        return super.mouseReleased(event);
+    }
+
+    private boolean overBasin(double mouseX, double mouseY) {
+        double x = mouseX - leftPos - BASIN_X;
+        double y = mouseY - topPos - BASIN_Y;
+        return x * x + y * y < BASIN_RADIUS * BASIN_RADIUS;
+    }
+
+    /** A GUI-scale projection of Legacy's colored, rotating D'ni ink effect. */
+    private void renderPropertyGlyph(GuiGraphicsExtractor graphics) {
+        long now = System.currentTimeMillis();
+        int[] active = new int[3];
+        int count = 0;
+        int strongest = 0;
+        for (int index = 0; index < lastChances.length; index++) {
+            int chance = menu.modifierChancePermille(index);
+            if (chance > lastChances[index]) lastAdditionTime = now;
+            lastChances[index] = chance;
+            if (chance > 0) {
+                active[count++] = index;
+                strongest = Math.max(strongest, chance);
+            }
+        }
+        if (count == 0) {
+            lastAdditionTime = 0;
+            return;
+        }
+
+        double cycle = now / 1800.0;
+        int first = active[(int) cycle % count];
+        int second = active[((int) cycle + 1) % count];
+        double blend = (1.0 - Math.cos((cycle % 1.0) * Math.PI)) / 2.0;
+        int rgb = blendRgb(PROPERTY_COLORS[first], PROPERTY_COLORS[second], blend);
+        double pulse = Math.max(0.0, 1.0 - (now - lastAdditionTime) / 700.0);
+        int alpha = Math.clamp((int) (70 + strongest * 0.14 + pulse * 45), 0, 255);
+        int color = alpha << 24 | rgb;
+        int centerX = leftPos + BASIN_X;
+        int centerY = topPos + BASIN_Y;
+        double turn = now / 1200.0;
+
+        for (int spoke = 0; spoke < 4; spoke++) {
+            for (int step = 0; step <= 30; step++) {
+                double progress = step / 30.0;
+                double angle = turn + spoke * Math.PI / 2.0 + progress * 0.9;
+                double radius = 3.0 + progress * (15.0 + pulse * 3.0);
+                plot(graphics, centerX + Math.cos(angle) * radius,
+                        centerY + Math.sin(angle) * radius, color);
+            }
+        }
+        for (int step = 0; step < 96; step++) {
+            double angle = step * Math.PI / 48.0 + turn * 0.3;
+            plot(graphics, centerX + Math.cos(angle) * 19.0,
+                    centerY + Math.sin(angle) * 19.0, color);
+            if (strongest >= 990 && step % 2 == 0) {
+                plot(graphics, centerX + Math.cos(angle) * 23.0,
+                        centerY + Math.sin(angle) * 23.0, color);
+            }
+        }
+    }
+
+    private static int blendRgb(int first, int second, double amount) {
+        int red = (int) (((first >> 16) & 0xFF) * (1.0 - amount)
+                + ((second >> 16) & 0xFF) * amount);
+        int green = (int) (((first >> 8) & 0xFF) * (1.0 - amount)
+                + ((second >> 8) & 0xFF) * amount);
+        int blue = (int) ((first & 0xFF) * (1.0 - amount) + (second & 0xFF) * amount);
+        return red << 16 | green << 8 | blue;
+    }
+
+    private static void plot(GuiGraphicsExtractor graphics, double x, double y, int color) {
+        int pixelX = (int) Math.round(x);
+        int pixelY = (int) Math.round(y);
+        graphics.fill(pixelX, pixelY, pixelX + 1, pixelY + 1, color);
+    }
+}
@@ -0,0 +1,18 @@
+package net.dnorberg.rivencraft.client;
+
+import net.dnorberg.rivencraft.Rivencraft;
+import net.neoforged.api.distmarker.Dist;
+import net.neoforged.bus.api.SubscribeEvent;
+import net.neoforged.fml.common.EventBusSubscriber;
+import net.neoforged.neoforge.client.event.RegisterMenuScreensEvent;
+
+@EventBusSubscriber(modid = Rivencraft.MOD_ID, value = Dist.CLIENT)
+public final class PortBookBinderClientEvents {
+    private PortBookBinderClientEvents() {}
+
+    @SubscribeEvent
+    public static void registerScreens(RegisterMenuScreensEvent event) {
+        event.register(Rivencraft.BOOK_BINDER_MENU.get(), PortBookBinderScreen::new);
+        event.register(Rivencraft.INK_MIXER_MENU.get(), InkMixerScreen::new);
+    }
+}
@@ -0,0 +1,170 @@
+package net.dnorberg.rivencraft.client;
+
+import com.mojang.blaze3d.platform.InputConstants;
+import net.dnorberg.rivencraft.Rivencraft;
+import net.dnorberg.rivencraft.item.PageItem;
+import net.dnorberg.rivencraft.menu.PortBookBinderMenu;
+import net.dnorberg.rivencraft.network.AssembleBinderPayload;
+import net.dnorberg.rivencraft.network.PortBookNetworking;
+import net.dnorberg.rivencraft.network.SetBinderTitlePayload;
+import net.minecraft.client.gui.GuiGraphicsExtractor;
+import net.minecraft.client.gui.components.EditBox;
+import net.minecraft.client.gui.screens.inventory.AbstractContainerScreen;
+import net.minecraft.client.input.KeyEvent;
+import net.minecraft.client.input.MouseButtonEvent;
+import net.minecraft.client.renderer.RenderPipelines;
+import net.minecraft.network.chat.Component;
+import net.minecraft.resources.Identifier;
+import net.minecraft.world.entity.player.Inventory;
+import net.minecraft.world.item.ItemStack;
+import net.neoforged.neoforge.client.network.ClientPacketDistributor;
+
+/** Legacy-sized Binder with a page strip and single-click book assembly. */
+public final class PortBookBinderScreen extends AbstractContainerScreen<PortBookBinderMenu> {
+    private static final Identifier BACKGROUND = Identifier.fromNamespaceAndPath(
+            "rivencraft", "textures/gui/book_binder_legacy.png");
+    private static final Identifier PAGE_ATLAS = Identifier.fromNamespaceAndPath(
+            "rivencraft", "textures/gui/notebook_pages.png");
+    private static final int PAGE_Y = 48;
+    private static final int PAGE_WIDTH = 26;
+    private static final int PAGE_HEIGHT = 34;
+    private static final int MISSING_PANEL_X = 27;
+    private static final int MISSING_PANEL_Y = 26;
+    private static final int MISSING_PANEL_SIZE = 16;
+    private static final ItemStack MISSING_PANEL_ICON = PageItem.createLinkPanelPage();
+    private EditBox titleInput;
+    private boolean stripClickPendingRelease;
+
+    public PortBookBinderScreen(PortBookBinderMenu menu, Inventory inventory, Component title) {
+        super(menu, inventory, title, 176, 181);
+        inventoryLabelY = 87;
+    }
+
+    @Override public boolean isPauseScreen() { return false; }
+
+    @Override protected void init() {
+        super.init();
+        int left = (width - imageWidth) / 2;
+        int top = (height - imageHeight) / 2;
+        titleInput = new EditBox(font, left + 9, top + 10, 112, 12, Component.literal("Age name"));
+        titleInput.setBordered(false);
+        titleInput.setTextColor(0xFFFFFFFF);
+        titleInput.setMaxLength(PortBookNetworking.MAX_BOOK_TITLE_LENGTH);
+        titleInput.setValue(menu.title());
+        titleInput.setHint(Component.literal("Name this Age"));
+        titleInput.setResponder(value -> ClientPacketDistributor.sendToServer(
+                new SetBinderTitlePayload(menu.containerId, value)));
+        addRenderableWidget(titleInput);
+        setInitialFocus(titleInput);
+    }
+
+    @Override public void extractBackground(GuiGraphicsExtractor graphics, int mouseX, int mouseY, float partialTick) {
+        super.extractBackground(graphics, mouseX, mouseY, partialTick);
+        int left = (width - imageWidth) / 2;
+        int top = (height - imageHeight) / 2;
+        graphics.blit(RenderPipelines.GUI_TEXTURED, BACKGROUND, left, top, 0, 0,
+                imageWidth, imageHeight, 256, 256);
+        graphics.fill(left + 7, top + 9, left + 123, top + 23, 0xFF000000);
+        // The strip grows only when a page is present or the player is carrying
+        // a page to insert, just as the 1.21.1 Binder does.
+        boolean panelPresent = !menu.getSlot(1).getItem().isEmpty();
+        if (panelPresent || PageItem.isLinkPanel(menu.getCarried())) {
+            int x = left + 16;
+            graphics.blit(RenderPipelines.GUI_TEXTURED, PAGE_ATLAS,
+                    x, top + PAGE_Y, 156, 0, PAGE_WIDTH, PAGE_HEIGHT, 256, 256);
+            if (!panelPresent)
+                graphics.fill(x, top + PAGE_Y, x + PAGE_WIDTH, top + PAGE_Y + PAGE_HEIGHT,
+                        0xAA000000);
+            else graphics.fill(x + 5, top + PAGE_Y + 6, x + 22, top + PAGE_Y + 17,
+                    0xFF000000);
+        }
+        if (titleInput == null || titleInput.getValue().isBlank()) {
+            graphics.fill(left + 7, top + 9, left + 123, top + 10, 0xFFFF3030);
+            graphics.fill(left + 7, top + 22, left + 123, top + 23, 0xFFFF3030);
+        }
+        if (!panelPresent) {
+            graphics.fakeItem(MISSING_PANEL_ICON, left + MISSING_PANEL_X, top + MISSING_PANEL_Y);
+            float phase = (System.currentTimeMillis() % 4000L) / 2000.0F;
+            float fade = phase > 1.0F ? 2.0F - phase : phase;
+            int alpha = 40 + (int) (125 * fade);
+            graphics.fill(left + MISSING_PANEL_X, top + MISSING_PANEL_Y,
+                    left + MISSING_PANEL_X + MISSING_PANEL_SIZE,
+                    top + MISSING_PANEL_Y + MISSING_PANEL_SIZE,
+                    (alpha << 24) | 0x00B02020);
+        }
+        if (menu.getSlot(2).getItem().isEmpty() && !menu.getSlot(0).getItem().isEmpty()
+                && !menu.getSlot(1).getItem().isEmpty() && titleInput != null
+                && !titleInput.getValue().isBlank()) {
+            graphics.fakeItem(new ItemStack(Rivencraft.DESCRIPTIVE_BOOK.get()), left + 152, top + 27);
+        }
+    }
+
+    @Override protected void extractLabels(GuiGraphicsExtractor graphics, int mouseX, int mouseY) {
+        graphics.text(font, playerInventoryTitle, inventoryLabelX, inventoryLabelY, 0xFF404040, false);
+    }
+
+    @Override protected void extractTooltip(GuiGraphicsExtractor graphics, int mouseX, int mouseY) {
+        super.extractTooltip(graphics, mouseX, mouseY);
+        int x = mouseX - leftPos;
+        int y = mouseY - topPos;
+        if (x >= MISSING_PANEL_X && x < MISSING_PANEL_X + MISSING_PANEL_SIZE
+                && y >= MISSING_PANEL_Y && y < MISSING_PANEL_Y + MISSING_PANEL_SIZE
+                && menu.getSlot(1).getItem().isEmpty()) {
+            graphics.setTooltipForNextFrame(font,
+                    Component.translatable("screen.rivencraft.book_binder.missing_panel"), mouseX, mouseY);
+        } else if (x >= 16 && x < 16 + PAGE_WIDTH && y >= PAGE_Y && y < PAGE_Y + PAGE_HEIGHT
+                && !menu.getSlot(1).getItem().isEmpty()) {
+            graphics.setTooltipForNextFrame(font, menu.getSlot(1).getItem(), mouseX, mouseY);
+        }
+    }
+
+    @Override public boolean mouseClicked(MouseButtonEvent event, boolean doubleClick) {
+        int left = (width - imageWidth) / 2;
+        int top = (height - imageHeight) / 2;
+        if ((event.button() == InputConstants.MOUSE_BUTTON_LEFT
+                || event.button() == InputConstants.MOUSE_BUTTON_RIGHT)
+                && event.x() >= left + 16 && event.x() < left + 16 + PAGE_WIDTH
+                && event.y() >= top + PAGE_Y && event.y() < top + PAGE_Y + PAGE_HEIGHT) {
+            boolean hasPanel = !menu.getSlot(1).getItem().isEmpty();
+            if (hasPanel && menu.getCarried().isEmpty()
+                    || !hasPanel && PageItem.isLinkPanel(menu.getCarried())) {
+                minecraft.gameMode.handleInventoryButtonClick(menu.containerId,
+                        PortBookBinderMenu.STRIP_CLICK_PANEL);
+                stripClickPendingRelease = true;
+                return true;
+            }
+        }
+        if (event.button() == InputConstants.MOUSE_BUTTON_LEFT
+                && event.x() >= left + 151 && event.x() < left + 170
+                && event.y() >= top + 26 && event.y() < top + 45
+                && menu.getSlot(2).getItem().isEmpty() && menu.getCarried().isEmpty()) {
+            String name = titleInput.getValue().strip();
+            if (!name.isEmpty()) ClientPacketDistributor.sendToServer(new AssembleBinderPayload(name));
+            return true;
+        }
+        return super.mouseClicked(event, doubleClick);
+    }
+
+    @Override public boolean mouseReleased(MouseButtonEvent event) {
+        if (stripClickPendingRelease) {
+            stripClickPendingRelease = false;
+            return true;
+        }
+        return super.mouseReleased(event);
+    }
+
+    @Override public boolean keyPressed(KeyEvent event) {
+        if (titleInput != null && titleInput.isFocused()) {
+            if (event.isEscape()) {
+                setFocused(null);
+                titleInput.setFocused(false);
+            } else {
+                titleInput.keyPressed(event);
+            }
+            // The character event inserts text. Never forward a focused key
+            // to the container's inventory/hotbar shortcuts.
+            return true;
+        }
+        return super.keyPressed(event);
+    }
+}
@@ -16,11 +16,14 @@ public final class PortBookInteractionHandler {

    @SubscribeEvent
    public static void onRightClickItem(PlayerInteractEvent.RightClickItem event) {
-        if (!event.getEntity().level().isClientSide()
-                || !event.getItemStack().is(Rivencraft.LINKING_BOOK.get())) return;
+        if (!event.getEntity().level().isClientSide()) return;
+        boolean linking = event.getItemStack().is(Rivencraft.LINKING_BOOK.get());
+        boolean descriptive = event.getItemStack().is(Rivencraft.DESCRIPTIVE_BOOK.get());
+        if (!linking && !descriptive) return;
        event.setCanceled(true);
        event.setCancellationResult(InteractionResult.SUCCESS);
-        Minecraft.getInstance().setScreenAndShow(new PortLinkingBookScreen(
-                event.getHand(), event.getItemStack().copy()));
+        Minecraft.getInstance().setScreenAndShow(linking
+                ? new PortLinkingBookScreen(event.getHand(), event.getItemStack().copy())
+                : new PortDescriptiveBookScreen(event.getHand(), event.getItemStack().copy()));
    }
 }
@@ -0,0 +1,116 @@
+package net.dnorberg.rivencraft.client;
+
+import com.mojang.blaze3d.platform.InputConstants;
+import net.dnorberg.rivencraft.Rivencraft;
+import net.dnorberg.rivencraft.network.BindDescriptiveBookPayload;
+import net.dnorberg.rivencraft.network.PortBookNetworking;
+import net.dnorberg.rivencraft.network.UseDescriptiveBookPayload;
+import net.minecraft.client.gui.GuiGraphicsExtractor;
+import net.minecraft.client.gui.components.Button;
+import net.minecraft.client.gui.components.EditBox;
+import net.minecraft.client.gui.screens.Screen;
+import net.minecraft.client.input.MouseButtonEvent;
+import net.minecraft.client.renderer.RenderPipelines;
+import net.minecraft.network.chat.Component;
+import net.minecraft.resources.Identifier;
+import net.minecraft.world.InteractionHand;
+import net.minecraft.world.item.ItemStack;
+import net.neoforged.neoforge.client.network.ClientPacketDistributor;
+
+/** Temporary 26.3 descriptive-book interaction; authored pages and live previews remain unported. */
+public final class PortDescriptiveBookScreen extends Screen {
+    private static final int WIDTH = 327;
+    private static final int HEIGHT = 199;
+    private static final int TEXT_COLOR = 0xFF3B281B;
+    private static final Identifier COVER = texture("bookui_cover.png");
+    private static final Identifier LEFT_PAGE = texture("notebook_pages.png");
+    private static final Identifier RIGHT_PANEL = texture("bookui_pager.png");
+
+    private final InteractionHand hand;
+    private final boolean bound;
+    private EditBox titleInput;
+
+    public PortDescriptiveBookScreen(InteractionHand hand, ItemStack book) {
+        super(book.getHoverName());
+        this.hand = hand;
+        bound = book.has(Rivencraft.AGE_BOOK_ID.get());
+    }
+
+    @Override
+    protected void init() {
+        if (bound) return;
+        int left = (width - WIDTH) / 2;
+        int top = (height - HEIGHT) / 2;
+        titleInput = new EditBox(font, left + 40, top + 69, 110, 20,
+                Component.literal("Age name"));
+        titleInput.setMaxLength(PortBookNetworking.MAX_BOOK_TITLE_LENGTH);
+        titleInput.setHint(Component.literal("Name this Age"));
+        addRenderableWidget(titleInput);
+        setInitialFocus(titleInput);
+        addRenderableWidget(Button.builder(Component.literal("Bind"), button -> bind())
+                .bounds(left + 40, top + 100, 53, 20).build());
+        addRenderableWidget(Button.builder(Component.literal("Cancel"), button -> onClose())
+                .bounds(left + 97, top + 100, 53, 20).build());
+    }
+
+    @Override
+    public void extractRenderState(GuiGraphicsExtractor graphics, int mouseX, int mouseY, float partialTick) {
+        int left = (width - WIDTH) / 2;
+        int top = (height - HEIGHT) / 2;
+        blit(graphics, COVER, left, top + 7, 34, 192, 152, 0);
+        blit(graphics, COVER, left + 34, top + 7, 103, 192, 49, 0);
+        blit(graphics, COVER, left + 137, top + 7, 4, 192, 45, 0);
+        blit(graphics, COVER, left + 141, top + 7, 186, 192, 0, 0);
+        blit(graphics, LEFT_PAGE, left + 7, top, 156, 195, 0, 0);
+        blit(graphics, RIGHT_PANEL, left + 163, top, 156, 195, 0, 0);
+        graphics.text(font, title, left + 42, top + 29, TEXT_COLOR, false);
+        if (bound) {
+            graphics.fill(left + 173, top + 20, left + 305, top + 103, 0xFF15141D);
+            graphics.text(font, Component.literal("Age preview unavailable"), left + 181, top + 47,
+                    0xFFE9DFCB, false);
+            graphics.text(font, Component.literal("Click to enter"), left + 205, top + 65,
+                    0xFFE9DFCB, false);
+        } else {
+            graphics.text(font, Component.literal("Bind a prototype Age"), left + 183, top + 39,
+                    TEXT_COLOR, false);
+        }
+        super.extractRenderState(graphics, mouseX, mouseY, partialTick);
+    }
+
+    @Override
+    public boolean mouseClicked(MouseButtonEvent event, boolean doubleClick) {
+        if (bound && event.button() == InputConstants.MOUSE_BUTTON_LEFT) {
+            int left = (width - WIDTH) / 2;
+            int top = (height - HEIGHT) / 2;
+            if (event.x() >= left + 173 && event.x() < left + 305
+                    && event.y() >= top + 20 && event.y() < top + 103) {
+                ClientPacketDistributor.sendToServer(new UseDescriptiveBookPayload(hand == InteractionHand.OFF_HAND));
+                onClose();
+                return true;
+            }
+        }
+        return super.mouseClicked(event, doubleClick);
+    }
+
+    @Override
+    public boolean isPauseScreen() {
+        return false;
+    }
+
+    private void bind() {
+        if (titleInput == null) return;
+        String name = titleInput.getValue().strip();
+        if (name.isEmpty()) return;
+        ClientPacketDistributor.sendToServer(new BindDescriptiveBookPayload(hand == InteractionHand.OFF_HAND, name));
+        onClose();
+    }
+
+    private static Identifier texture(String filename) {
+        return Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, "textures/gui/" + filename);
+    }
+
+    private static void blit(GuiGraphicsExtractor graphics, Identifier texture, int x, int y,
+                             int width, int height, int u, int v) {
+        graphics.blit(RenderPipelines.GUI_TEXTURED, texture, x, y, u, v, width, height, 256, 256);
+    }
+}
@@ -2,10 +2,8 @@ package net.dnorberg.rivencraft.item;

 import java.util.function.Consumer;
 import net.dnorberg.rivencraft.Rivencraft;
-import net.dnorberg.rivencraft.age.PortAgeTravel;
 import net.minecraft.network.chat.Component;
 import net.minecraft.resources.Identifier;
-import net.minecraft.server.level.ServerPlayer;
 import net.minecraft.world.InteractionHand;
 import net.minecraft.world.InteractionResult;
 import net.minecraft.world.entity.player.Player;
@@ -15,7 +13,7 @@ import net.minecraft.world.item.TooltipFlag;
 import net.minecraft.world.item.component.TooltipDisplay;
 import net.minecraft.world.level.Level;

-/** First 26.3 bound-book slice; authoring and the book GUI still need porting. */
+/** Descriptive Book shell for the 26.3 prototype Age backend. */
 public final class DescriptiveBookItem extends Item {
    public DescriptiveBookItem(Properties properties) {
        super(properties);
@@ -28,18 +26,8 @@ public final class DescriptiveBookItem extends Item {

    @Override
    public InteractionResult use(Level level, Player player, InteractionHand hand) {
-        ItemStack stack = player.getItemInHand(hand);
-        Identifier id = stack.get(Rivencraft.AGE_BOOK_ID.get());
-        if (id == null) {
-            if (player instanceof ServerPlayer serverPlayer) {
-                serverPlayer.sendOverlayMessage(Component.literal("Unbound Descriptive Book; use the port's Age book probe"));
-            }
-            return InteractionResult.SUCCESS;
-        }
-        if (player instanceof ServerPlayer serverPlayer) {
-            String failure = PortAgeTravel.enter(serverPlayer, id);
-            serverPlayer.sendOverlayMessage(Component.literal(failure == null ? "Entered " + id : failure));
-        }
+        // The client opens the GUI. Binding and travel are validated on the
+        // server through dedicated packets; item use cannot bypass them.
        return InteractionResult.SUCCESS;
    }

@@ -0,0 +1,76 @@
+package net.dnorberg.rivencraft.item;
+
+import java.util.function.Consumer;
+import net.dnorberg.rivencraft.Rivencraft;
+import net.minecraft.network.chat.Component;
+import net.minecraft.util.Prediction;
+import net.minecraft.world.InteractionHand;
+import net.minecraft.world.InteractionResult;
+import net.minecraft.world.entity.player.Player;
+import net.minecraft.world.item.Item;
+import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.item.Items;
+import net.minecraft.world.item.TooltipFlag;
+import net.minecraft.world.item.component.TooltipDisplay;
+import net.minecraft.world.level.Level;
+
+/** A stackable 16-use vial; using it with paper in the other hand prepares a Link Panel. */
+public final class InkVialItem extends Item {
+    public static final int CAPACITY = 16;
+    // Match the 1.21.1 default; port the configurable cost with the full configuration system.
+    public static final int LINK_PANEL_COST = 2;
+
+    public InkVialItem(Properties properties) {
+        super(properties);
+    }
+
+    public static int remaining(ItemStack vial) {
+        return vial.getOrDefault(Rivencraft.INK_REMAINING.get(), CAPACITY);
+    }
+
+    @Override
+    public InteractionResult use(Level level, Player player, InteractionHand hand) {
+        InteractionHand paperHand = hand == InteractionHand.MAIN_HAND
+                ? InteractionHand.OFF_HAND : InteractionHand.MAIN_HAND;
+        ItemStack vial = player.getItemInHand(hand);
+        ItemStack paper = player.getItemInHand(paperHand);
+        int ink = remaining(vial);
+        if (!vial.is(Rivencraft.INK_VIAL.get()) || !paper.is(Items.PAPER)
+                || ink < LINK_PANEL_COST || ink > CAPACITY) {
+            return InteractionResult.PASS;
+        }
+        if (level.isClientSide()) return InteractionResult.SUCCESS;
+
+        ItemStack panel = PageItem.createLinkPanelPage();
+        int newInk = ink - LINK_PANEL_COST;
+        ItemStack spentVial = newInk == 0
+                ? new ItemStack(Items.GLASS_BOTTLE)
+                : new ItemStack(Rivencraft.INK_VIAL.get());
+        if (newInk > 0) spentVial.set(Rivencraft.INK_REMAINING.get(), newInk);
+
+        if (paper.getCount() == 1) {
+            player.setItemInHand(paperHand, panel);
+        } else {
+            paper.shrink(1);
+            giveOrDrop(player, panel);
+        }
+        if (vial.getCount() == 1) {
+            player.setItemInHand(hand, spentVial);
+        } else {
+            vial.shrink(1);
+            giveOrDrop(player, spentVial);
+        }
+        return InteractionResult.SUCCESS;
+    }
+
+    @Override
+    public void appendHoverText(ItemStack stack, TooltipContext context, TooltipDisplay display,
+                                Consumer<Component> tooltip, TooltipFlag flag) {
+        tooltip.accept(Component.translatable("item.rivencraft.ink_vial.remaining", remaining(stack), CAPACITY));
+        tooltip.accept(Component.translatable("item.rivencraft.ink_vial.usage"));
+    }
+
+    private static void giveOrDrop(Player player, ItemStack stack) {
+        if (!player.getInventory().add(stack)) player.drop(stack, false, Prediction.SERVER_ONLY);
+    }
+}
@@ -0,0 +1,29 @@
+package net.dnorberg.rivencraft.item;
+
+import com.mojang.serialization.Codec;
+import io.netty.buffer.ByteBuf;
+import net.minecraft.network.codec.ByteBufCodecs;
+import net.minecraft.network.codec.StreamCodec;
+
+/** The three Ink Mixer modifiers currently supported by the 26.3 port. */
+public record LinkProperties(int flags) {
+    public static final int DISARM = 1;
+    public static final int MAINTAIN_MOMENTUM = 4;
+    public static final int INTRA_LINKING = 8;
+    public static final int SUPPORTED = DISARM | MAINTAIN_MOMENTUM | INTRA_LINKING;
+    public static final LinkProperties NONE = new LinkProperties(0);
+    public static final Codec<LinkProperties> CODEC = Codec.INT.xmap(LinkProperties::new, LinkProperties::flags);
+    public static final StreamCodec<ByteBuf, LinkProperties> STREAM_CODEC = StreamCodec.of(
+            (buffer, value) -> ByteBufCodecs.VAR_INT.encode(buffer, value.flags()),
+            buffer -> new LinkProperties(ByteBufCodecs.VAR_INT.decode(buffer)));
+
+    public LinkProperties {
+        if (flags < 0 || (flags & ~SUPPORTED) != 0) {
+            throw new IllegalArgumentException("Unsupported Link Panel flags: " + flags);
+        }
+    }
+
+    public boolean has(int flag) {
+        return (flags & flag) != 0;
+    }
+}
@@ -18,6 +18,8 @@ import net.minecraft.world.item.ItemStack;
 import net.minecraft.world.item.TooltipFlag;
 import net.minecraft.world.item.component.TooltipDisplay;
 import net.minecraft.world.level.Level;
+import net.minecraft.world.entity.item.ItemEntity;
+import net.minecraft.world.phys.Vec3;

 /** Handheld Linking Book; destination binding and travel are server-authoritative packets. */
 public final class LinkingBookItem extends Item {
@@ -37,10 +39,13 @@ public final class LinkingBookItem extends Item {
        return InteractionResult.SUCCESS;
    }

-    public static String travel(ServerPlayer player, LinkBookTarget destination) {
+    public static String travel(ServerPlayer player, ItemStack book) {
+        LinkBookTarget destination = book.get(Rivencraft.LINK_BOOK_TARGET.get());
+        LinkProperties properties = book.getOrDefault(Rivencraft.LINK_PROPERTIES.get(), LinkProperties.NONE);
        if (destination == null) return "Unbound Linking Book (26.3 port preview)";
        if (!destination.valid()) return "Invalid Linking Book destination";
-        if (player.level().dimension().identifier().equals(destination.dimension())) {
+        if (player.level().dimension().identifier().equals(destination.dimension())
+                && !properties.has(LinkProperties.INTRA_LINKING)) {
            return "Same-dimension linking requires an Intra-Linking page";
        }
        ServerLevel target = player.level().getServer().getLevel(
@@ -61,11 +66,41 @@ public final class LinkingBookItem extends Item {
                destination.z() - player.getZ()))) {
            return "Linked destination is obstructed";
        }
+        ServerLevel source = player.level();
+        Vec3 departure = player.position();
+        Vec3 incoming = player.getDeltaMovement();
        boolean moved = player.teleportTo(target, destination.x(), destination.y(), destination.z(),
                Set.of(), destination.yaw(), destination.pitch(), true);
+        if (moved) applySuccessfulLink(player, properties, source, departure, incoming, destination.yaw());
        return moved ? null : "Teleportation failed";
    }

+    /** Link Panel effects are shared by Linking and Descriptive Books. */
+    public static void applySuccessfulLink(ServerPlayer player, LinkProperties properties,
+                                           ServerLevel source, Vec3 departure, Vec3 incoming, float destinationYaw) {
+        if (properties.has(LinkProperties.MAINTAIN_MOMENTUM)) {
+            double speed = Math.hypot(incoming.x, incoming.z);
+            double yaw = Math.toRadians(destinationYaw);
+            player.setDeltaMovement(speed * Math.cos(yaw), incoming.y + 0.2,
+                    speed * Math.sin(yaw));
+        } else {
+            player.setDeltaMovement(Vec3.ZERO);
+        }
+        if (properties.has(LinkProperties.DISARM)) {
+            for (int slot = 0; slot < player.getInventory().getContainerSize(); slot++) {
+                ItemStack carried = player.getInventory().getItem(slot);
+                if (carried.isEmpty()) continue;
+                player.getInventory().setItem(slot, ItemStack.EMPTY);
+                ItemEntity dropped = new ItemEntity(source, departure.x, departure.y, departure.z,
+                        carried.copy());
+                dropped.setDefaultPickUpDelay();
+                source.addFreshEntity(dropped);
+            }
+            player.getInventory().setChanged();
+            player.containerMenu.broadcastChanges();
+        }
+    }
+
    @Override
    public void appendHoverText(ItemStack stack, TooltipContext context, TooltipDisplay display,
                                Consumer<Component> tooltip, TooltipFlag flag) {
@@ -73,5 +108,12 @@ public final class LinkingBookItem extends Item {
        tooltip.accept(Component.literal(target == null ? "Unbound (26.3 port preview)"
                : "Destination: " + target.dimension() + " (" + (int) target.x() + ", "
                + (int) target.y() + ", " + (int) target.z() + ")"));
+        LinkProperties properties = stack.getOrDefault(Rivencraft.LINK_PROPERTIES.get(), LinkProperties.NONE);
+        if (properties.has(LinkProperties.DISARM))
+            tooltip.accept(Component.translatable("item.rivencraft.link_property.disarm"));
+        if (properties.has(LinkProperties.MAINTAIN_MOMENTUM))
+            tooltip.accept(Component.translatable("item.rivencraft.link_property.maintain_momentum"));
+        if (properties.has(LinkProperties.INTRA_LINKING))
+            tooltip.accept(Component.translatable("item.rivencraft.link_property.intra_linking"));
    }
 }
@@ -0,0 +1,55 @@
+package net.dnorberg.rivencraft.item;
+
+import java.util.function.Consumer;
+import net.dnorberg.rivencraft.Rivencraft;
+import net.minecraft.core.component.DataComponents;
+import net.minecraft.network.chat.Component;
+import net.minecraft.world.item.Item;
+import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.item.TooltipFlag;
+import net.minecraft.world.item.component.TooltipDisplay;
+
+/** One Page item with a persistent Link Panel variant; symbol writing is not ported yet. */
+public final class PageItem extends Item {
+    public PageItem(Properties properties) {
+        super(properties);
+    }
+
+    public static ItemStack createLinkPanelPage() {
+        return createLinkPanelPage(0);
+    }
+
+    public static ItemStack createLinkPanelPage(int flags) {
+        ItemStack stack = new ItemStack(Rivencraft.PAGE.get());
+        stack.set(Rivencraft.LINK_PANEL_PAGE.get(), true);
+        if (flags != 0) stack.set(Rivencraft.LINK_PROPERTIES.get(), new LinkProperties(flags));
+        return stack;
+    }
+
+    public static boolean isLinkPanel(ItemStack stack) {
+        return stack.is(Rivencraft.PAGE.get()) && stack.getOrDefault(Rivencraft.LINK_PANEL_PAGE.get(), false);
+    }
+
+    @Override
+    public Component getName(ItemStack stack) {
+        Component customName = stack.get(DataComponents.CUSTOM_NAME);
+        if (customName != null) return customName;
+        return Component.translatable(isLinkPanel(stack)
+                ? "item.rivencraft.page.link_panel" : "item.rivencraft.page.blank");
+    }
+
+    @Override
+    public void appendHoverText(ItemStack stack, TooltipContext context, TooltipDisplay display,
+                                Consumer<Component> tooltip, TooltipFlag flag) {
+        LinkProperties properties = stack.getOrDefault(Rivencraft.LINK_PROPERTIES.get(), LinkProperties.NONE);
+        if (properties.has(LinkProperties.DISARM))
+            tooltip.accept(Component.translatable("item.rivencraft.link_property.disarm"));
+        if (properties.has(LinkProperties.MAINTAIN_MOMENTUM))
+            tooltip.accept(Component.translatable("item.rivencraft.link_property.maintain_momentum"));
+        if (properties.has(LinkProperties.INTRA_LINKING))
+            tooltip.accept(Component.translatable("item.rivencraft.link_property.intra_linking"));
+        tooltip.accept(Component.translatable(isLinkPanel(stack)
+                ? "item.rivencraft.page.link_panel.port_status"
+                : "item.rivencraft.page.blank.port_status"));
+    }
+}
@@ -0,0 +1,158 @@
+package net.dnorberg.rivencraft.menu;
+
+import net.dnorberg.rivencraft.Rivencraft;
+import net.dnorberg.rivencraft.block.entity.InkMixerBlockEntity;
+import net.minecraft.network.RegistryFriendlyByteBuf;
+import net.minecraft.world.Container;
+import net.minecraft.world.SimpleContainer;
+import net.minecraft.world.entity.player.Inventory;
+import net.minecraft.world.entity.player.Player;
+import net.minecraft.world.inventory.AbstractContainerMenu;
+import net.minecraft.world.inventory.ContainerInput;
+import net.minecraft.world.inventory.DataSlot;
+import net.minecraft.world.inventory.Slot;
+import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.item.Items;
+
+/** Server-owned virtual output; taking it spends paper and the configured ink cost once. */
+public final class InkMixerMenu extends AbstractContainerMenu {
+    public static final int MODIFIER = InkMixerBlockEntity.SIZE;
+    public static final int RESULT = MODIFIER + 1;
+    private static final int PLAYER_START = RESULT + 1;
+    private final InkMixerBlockEntity mixer;
+    private final Container inputs;
+    private final SimpleContainer result = new SimpleContainer(1);
+    private final boolean clientSide;
+    private int inkRemaining;
+    private final int[] modifierChances = new int[3];
+
+    public InkMixerMenu(int id, Inventory inventory, RegistryFriendlyByteBuf data) {
+        this(id, inventory, inventory.player.level().getBlockEntity(data.readBlockPos())
+                instanceof InkMixerBlockEntity found ? found : null);
+    }
+
+    public InkMixerMenu(int id, Inventory inventory, InkMixerBlockEntity mixer) {
+        super(Rivencraft.INK_MIXER_MENU.get(), id);
+        this.mixer = mixer;
+        inputs = mixer == null ? new SimpleContainer(InkMixerBlockEntity.SIZE) : mixer;
+        clientSide = inventory.player.level().isClientSide();
+        addDataSlot(new DataSlot() {
+            @Override public int get() { return clientSide ? inkRemaining : mixer.inkRemaining(); }
+            @Override public void set(int value) { inkRemaining = value; }
+        });
+        for (int index = 0; index < modifierChances.length; index++) {
+            final int chanceIndex = index;
+            addDataSlot(new DataSlot() {
+                @Override public int get() {
+                    return clientSide ? modifierChances[chanceIndex] : mixer.modifierChancePermille(chanceIndex);
+                }
+                @Override public void set(int value) { modifierChances[chanceIndex] = value; }
+            });
+        }
+        addSlot(new MixerSlot(InkMixerBlockEntity.INK, 8, 27));
+        addSlot(new MixerSlot(InkMixerBlockEntity.PAPER, 8, 48));
+        addSlot(new MixerSlot(InkMixerBlockEntity.BOTTLES, 152, 27));
+        addSlot(new ModifierSlot(79, 40));
+        addSlot(new ResultSlot(152, 48));
+        for (int row = 0; row < 3; row++)
+            for (int column = 0; column < 9; column++)
+                addSlot(new Slot(inventory, column + row * 9 + 9, 8 + column * 18, 99 + row * 18));
+        for (int column = 0; column < 9; column++)
+            addSlot(new Slot(inventory, column, 8 + column * 18, 157));
+        refreshResult();
+    }
+
+    public int inkRemaining() { return inkRemaining; }
+    public int modifierChancePermille(int index) { return modifierChances[index]; }
+
+    @Override public void clicked(int slotId, int button, ContainerInput clickType, Player player) {
+        if (slotId == MODIFIER) {
+            if (!clientSide && stillValid(player) && clickType == ContainerInput.PICKUP
+                    && (button == 0 || button == 1)) {
+                ItemStack carried = getCarried();
+                int amount = button == 1 ? 1 : carried.getCount();
+                if (mixer.addModifier(carried, amount)) {
+                    setCarried(carried);
+                    refreshResult();
+                    broadcastChanges();
+                }
+            }
+            return;
+        }
+        super.clicked(slotId, button, clickType, player);
+        // In 26.3, recompute the virtual result in the same packet that changes
+        // paper or ink. Waiting for a later menu update can require a second click.
+        if (!clientSide) refreshResult();
+    }
+
+    @Override public boolean stillValid(Player player) {
+        return mixer != null && mixer.stillValid(player);
+    }
+
+    @Override public void broadcastChanges() {
+        refreshResult();
+        super.broadcastChanges();
+    }
+
+    private void refreshResult() {
+        if (clientSide) return;
+        ItemStack preview = mixer == null ? ItemStack.EMPTY : mixer.previewLinkPanel();
+        if (!ItemStack.matches(result.getItem(0), preview)) result.setItem(0, preview);
+    }
+
+    @Override public ItemStack quickMoveStack(Player player, int index) {
+        if (!stillValid(player) || index < 0 || index >= slots.size()) return ItemStack.EMPTY;
+        if (index == RESULT) {
+            refreshResult();
+            if (!mixer.canCreateLinkPanel()) return ItemStack.EMPTY;
+            ItemStack output = result.getItem(0).copy();
+            ItemStack remainder = output.copy();
+            if (!moveItemStackTo(remainder, PLAYER_START, slots.size(), true) || !remainder.isEmpty())
+                return ItemStack.EMPTY;
+            if (!mixer.consumeLinkPanelMaterials()) return ItemStack.EMPTY;
+            refreshResult();
+            return output;
+        }
+        Slot slot = slots.get(index);
+        if (!slot.hasItem()) return ItemStack.EMPTY;
+        ItemStack source = slot.getItem();
+        ItemStack original = source.copy();
+        boolean moved;
+        if (index < MODIFIER) moved = moveItemStackTo(source, PLAYER_START, slots.size(), true);
+        else if (source.is(Rivencraft.INK_VIAL.get()))
+            moved = moveItemStackTo(source, InkMixerBlockEntity.INK, InkMixerBlockEntity.INK + 1, false);
+        else if (source.is(Items.PAPER))
+            moved = moveItemStackTo(source, InkMixerBlockEntity.PAPER, InkMixerBlockEntity.PAPER + 1, false);
+        else moved = false;
+        if (!moved) return ItemStack.EMPTY;
+        if (source.isEmpty()) slot.setByPlayer(ItemStack.EMPTY);
+        else slot.setChanged();
+        refreshResult();
+        return original;
+    }
+
+    private final class MixerSlot extends Slot {
+        MixerSlot(int index, int x, int y) { super(inputs, index, x, y); }
+        @Override public boolean mayPlace(ItemStack stack) { return inputs.canPlaceItem(getContainerSlot(), stack); }
+    }
+
+    private static final class ModifierSlot extends Slot {
+        ModifierSlot(int x, int y) { super(new SimpleContainer(1), 0, x, y); }
+        @Override public boolean mayPlace(ItemStack stack) { return false; }
+        @Override public boolean mayPickup(Player player) { return false; }
+    }
+
+    private final class ResultSlot extends Slot {
+        ResultSlot(int x, int y) { super(result, 0, x, y); }
+        @Override public boolean mayPlace(ItemStack stack) { return false; }
+        @Override public boolean mayPickup(Player player) {
+            return clientSide ? hasItem() : stillValid(player) && mixer.canCreateLinkPanel();
+        }
+        @Override public void onTake(Player player, ItemStack stack) {
+            if (!clientSide && mixer.consumeLinkPanelMaterials()) {
+                refreshResult();
+            }
+            super.onTake(player, stack);
+        }
+    }
+}
@@ -0,0 +1,129 @@
+package net.dnorberg.rivencraft.menu;
+
+import net.dnorberg.rivencraft.Rivencraft;
+import net.dnorberg.rivencraft.block.entity.PortBookBinderBlockEntity;
+import net.dnorberg.rivencraft.item.PageItem;
+import net.dnorberg.rivencraft.network.PortBookNetworking;
+import net.minecraft.core.component.DataComponents;
+import net.minecraft.network.RegistryFriendlyByteBuf;
+import net.minecraft.network.chat.Component;
+import net.minecraft.server.level.ServerPlayer;
+import net.minecraft.world.Container;
+import net.minecraft.world.SimpleContainer;
+import net.minecraft.world.entity.player.Inventory;
+import net.minecraft.world.entity.player.Player;
+import net.minecraft.world.inventory.AbstractContainerMenu;
+import net.minecraft.world.inventory.Slot;
+import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.item.Items;
+
+/** Binder inputs persist in the block; assembling places the finished book on the cursor. */
+public final class PortBookBinderMenu extends AbstractContainerMenu {
+    public static final int STRIP_CLICK_PANEL = 3000;
+    private final Container binder;
+    private final PortBookBinderBlockEntity blockEntity;
+    private final String initialTitle;
+
+    public PortBookBinderMenu(int id, Inventory inventory, RegistryFriendlyByteBuf data) {
+        this(id, inventory, inventory.player.level().getBlockEntity(data.readBlockPos())
+                instanceof PortBookBinderBlockEntity found ? found : null, data.readUtf(32));
+    }
+
+    public PortBookBinderMenu(int id, Inventory inventory, PortBookBinderBlockEntity blockEntity) {
+        this(id, inventory, blockEntity, blockEntity == null ? "" : blockEntity.title());
+    }
+
+    private PortBookBinderMenu(int id, Inventory inventory, PortBookBinderBlockEntity blockEntity, String title) {
+        super(Rivencraft.BOOK_BINDER_MENU.get(), id);
+        this.blockEntity = blockEntity;
+        initialTitle = title;
+        binder = blockEntity == null ? new SimpleContainer(PortBookBinderBlockEntity.SIZE) : blockEntity;
+        addSlot(new Slot(binder, PortBookBinderBlockEntity.COVER, 8, 27) {
+            @Override public boolean mayPlace(ItemStack stack) { return stack.is(Items.LEATHER); }
+        });
+        addSlot(new Slot(binder, PortBookBinderBlockEntity.PANEL, -1000, -1000) {
+            @Override public boolean mayPlace(ItemStack stack) { return PageItem.isLinkPanel(stack); }
+            @Override public int getMaxStackSize() { return 1; }
+        });
+        addSlot(new Slot(binder, PortBookBinderBlockEntity.OUTPUT, 152, 27) {
+            @Override public boolean mayPlace(ItemStack stack) { return false; }
+        });
+        addStandardInventorySlots(inventory, 8, 99);
+    }
+
+    @Override public boolean stillValid(Player player) {
+        return blockEntity != null && blockEntity.stillValid(player);
+    }
+
+    public String title() { return initialTitle; }
+
+    @Override public boolean clickMenuButton(Player player, int id) {
+        if (id != STRIP_CLICK_PANEL || !stillValid(player)) return false;
+        ItemStack carried = getCarried();
+        if (carried.isEmpty()) {
+            ItemStack panel = binder.removeItem(PortBookBinderBlockEntity.PANEL, 1);
+            if (panel.isEmpty()) return false;
+            setCarried(panel);
+        } else {
+            if (!PageItem.isLinkPanel(carried)
+                    || !binder.getItem(PortBookBinderBlockEntity.PANEL).isEmpty()) return false;
+            binder.setItem(PortBookBinderBlockEntity.PANEL, carried.copyWithCount(1));
+            ItemStack remainder = carried.copy();
+            remainder.shrink(1);
+            setCarried(remainder);
+        }
+        broadcastChanges();
+        return true;
+    }
+
+    public void setTitle(ServerPlayer player, String value) {
+        if (stillValid(player) && value != null && value.length() <= PortBookNetworking.MAX_BOOK_TITLE_LENGTH)
+            blockEntity.setTitle(value);
+    }
+
+    public void assemble(ServerPlayer player, String title) {
+        if (!stillValid(player) || title.isBlank() || title.length() > PortBookNetworking.MAX_BOOK_TITLE_LENGTH
+                || !binder.getItem(PortBookBinderBlockEntity.OUTPUT).isEmpty()
+                || !getCarried().isEmpty()) return;
+        ItemStack cover = binder.getItem(PortBookBinderBlockEntity.COVER);
+        ItemStack panel = binder.getItem(PortBookBinderBlockEntity.PANEL);
+        if (!cover.is(Items.LEATHER) || !PageItem.isLinkPanel(panel)) return;
+        blockEntity.setTitle(title);
+        ItemStack book = new ItemStack(Rivencraft.DESCRIPTIVE_BOOK.get());
+        var id = PortBookNetworking.createAge(player, title);
+        if (id == null) return;
+        book.set(Rivencraft.AGE_BOOK_ID.get(), id);
+        book.set(DataComponents.CUSTOM_NAME, Component.literal(title));
+        var modifiers = panel.get(Rivencraft.LINK_PROPERTIES.get());
+        if (modifiers != null) book.set(Rivencraft.LINK_PROPERTIES.get(), modifiers);
+        cover.shrink(1);
+        panel.shrink(1);
+        binder.setItem(PortBookBinderBlockEntity.COVER, cover);
+        binder.setItem(PortBookBinderBlockEntity.PANEL, panel);
+        setCarried(book);
+        broadcastChanges();
+    }
+
+    @Override public ItemStack quickMoveStack(Player player, int index) {
+        if (!stillValid(player) || index < 0 || index >= slots.size()) return ItemStack.EMPTY;
+        Slot slot = slots.get(index);
+        if (!slot.hasItem()) return ItemStack.EMPTY;
+        ItemStack stack = slot.getItem();
+        ItemStack original = stack.copy();
+        boolean moved;
+        if (index < PortBookBinderBlockEntity.SIZE) {
+            moved = moveItemStackTo(stack, PortBookBinderBlockEntity.SIZE, slots.size(), true);
+        } else if (stack.is(Items.LEATHER)) {
+            moved = moveItemStackTo(stack, PortBookBinderBlockEntity.COVER,
+                    PortBookBinderBlockEntity.COVER + 1, false);
+        } else if (PageItem.isLinkPanel(stack)) {
+            moved = moveItemStackTo(stack, PortBookBinderBlockEntity.PANEL,
+                    PortBookBinderBlockEntity.PANEL + 1, false);
+        } else return ItemStack.EMPTY;
+        if (!moved) return ItemStack.EMPTY;
+        if (stack.isEmpty()) slot.setByPlayer(ItemStack.EMPTY);
+        else slot.setChanged();
+        slot.onTake(player, stack);
+        return original;
+    }
+}
@@ -0,0 +1,17 @@
+package net.dnorberg.rivencraft.network;
+
+import net.dnorberg.rivencraft.Rivencraft;
+import net.minecraft.network.RegistryFriendlyByteBuf;
+import net.minecraft.network.codec.ByteBufCodecs;
+import net.minecraft.network.codec.StreamCodec;
+import net.minecraft.network.protocol.common.custom.CustomPacketPayload;
+import net.minecraft.resources.Identifier;
+
+public record AssembleBinderPayload(String title) implements CustomPacketPayload {
+    public static final Type<AssembleBinderPayload> TYPE = new Type<>(
+            Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, "assemble_binder"));
+    public static final StreamCodec<RegistryFriendlyByteBuf, AssembleBinderPayload> STREAM_CODEC =
+            StreamCodec.composite(ByteBufCodecs.stringUtf8(32), AssembleBinderPayload::title,
+                    AssembleBinderPayload::new);
+    @Override public Type<AssembleBinderPayload> type() { return TYPE; }
+}
@@ -0,0 +1,22 @@
+package net.dnorberg.rivencraft.network;
+
+import net.dnorberg.rivencraft.Rivencraft;
+import net.minecraft.network.RegistryFriendlyByteBuf;
+import net.minecraft.network.codec.ByteBufCodecs;
+import net.minecraft.network.codec.StreamCodec;
+import net.minecraft.network.protocol.common.custom.CustomPacketPayload;
+import net.minecraft.resources.Identifier;
+
+public record BindDescriptiveBookPayload(boolean offhand, String title) implements CustomPacketPayload {
+    public static final Type<BindDescriptiveBookPayload> TYPE = new Type<>(
+            Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, "bind_descriptive_book"));
+    public static final StreamCodec<RegistryFriendlyByteBuf, BindDescriptiveBookPayload> STREAM_CODEC =
+            StreamCodec.composite(ByteBufCodecs.BOOL, BindDescriptiveBookPayload::offhand,
+                    ByteBufCodecs.stringUtf8(32), BindDescriptiveBookPayload::title,
+                    BindDescriptiveBookPayload::new);
+
+    @Override
+    public Type<BindDescriptiveBookPayload> type() {
+        return TYPE;
+    }
+}
@@ -1,16 +1,24 @@
 package net.dnorberg.rivencraft.network;

 import net.dnorberg.rivencraft.Rivencraft;
+import net.dnorberg.rivencraft.age.PortAgeTravel;
+import net.dnorberg.rivencraft.age.RuntimeAgeBackend;
 import net.dnorberg.rivencraft.item.LinkBookTarget;
+import net.dnorberg.rivencraft.item.LinkProperties;
 import net.dnorberg.rivencraft.item.LinkingBookItem;
+import net.dnorberg.rivencraft.menu.PortBookBinderMenu;
 import net.minecraft.core.component.DataComponents;
 import net.minecraft.network.chat.Component;
+import net.minecraft.resources.Identifier;
 import net.minecraft.server.level.ServerPlayer;
 import net.minecraft.sounds.SoundEvents;
 import net.minecraft.sounds.SoundSource;
 import net.minecraft.world.InteractionHand;
 import net.minecraft.world.item.ItemStack;
+import net.minecraft.server.level.ServerLevel;
+import net.minecraft.world.phys.Vec3;
 import net.neoforged.neoforge.network.event.RegisterPayloadHandlersEvent;
+import java.util.Locale;

 /** Server-authoritative handheld Linking Book binding and travel. */
 public final class PortBookNetworking {
@@ -29,6 +37,29 @@ public final class PortBookNetworking {
                (payload, context) -> {
                    if (context.player() instanceof ServerPlayer player) use(player, payload);
                });
+        registrar.playToServer(BindDescriptiveBookPayload.TYPE, BindDescriptiveBookPayload.STREAM_CODEC,
+                (payload, context) -> {
+                    if (context.player() instanceof ServerPlayer player) bindAge(player, payload);
+                });
+        registrar.playToServer(UseDescriptiveBookPayload.TYPE, UseDescriptiveBookPayload.STREAM_CODEC,
+                (payload, context) -> {
+                    if (context.player() instanceof ServerPlayer player) enterAge(player, payload);
+                });
+        registrar.playToServer(AssembleBinderPayload.TYPE, AssembleBinderPayload.STREAM_CODEC,
+                (payload, context) -> {
+                    if (context.player() instanceof ServerPlayer player
+                            && player.containerMenu instanceof PortBookBinderMenu menu) {
+                        menu.assemble(player, payload.title().strip());
+                    }
+                });
+        registrar.playToServer(SetBinderTitlePayload.TYPE, SetBinderTitlePayload.STREAM_CODEC,
+                (payload, context) -> {
+                    if (context.player() instanceof ServerPlayer player
+                            && player.containerMenu instanceof PortBookBinderMenu menu
+                            && menu.containerId == payload.containerId()) {
+                        menu.setTitle(player, payload.title());
+                    }
+                });
    }

    private static void bind(ServerPlayer player, BindLinkingBookPayload payload) {
@@ -47,10 +78,63 @@ public final class PortBookNetworking {
    private static void use(ServerPlayer player, UseLinkingBookPayload payload) {
        ItemStack stack = player.getItemInHand(hand(payload.offhand()));
        if (!stack.is(Rivencraft.LINKING_BOOK.get())) return;
-        String failure = LinkingBookItem.travel(player, stack.get(Rivencraft.LINK_BOOK_TARGET.get()));
+        String failure = LinkingBookItem.travel(player, stack);
        if (failure != null) player.sendOverlayMessage(Component.literal(failure));
    }

+    private static void bindAge(ServerPlayer player, BindDescriptiveBookPayload payload) {
+        ItemStack stack = player.getItemInHand(hand(payload.offhand()));
+        if (!stack.is(Rivencraft.DESCRIPTIVE_BOOK.get()) || stack.has(Rivencraft.AGE_BOOK_ID.get())) return;
+        String title = payload.title().strip();
+        if (title.isEmpty() || title.length() > MAX_BOOK_TITLE_LENGTH) return;
+        Identifier id = createAge(player, title);
+        if (id == null) return;
+        stack.set(Rivencraft.AGE_BOOK_ID.get(), id);
+        stack.set(DataComponents.CUSTOM_NAME, Component.literal(title));
+        player.level().playSound(null, player.blockPosition(), SoundEvents.BOOK_PAGE_TURN,
+                SoundSource.PLAYERS, 1.0F, 1.0F);
+        player.sendOverlayMessage(Component.literal("Bound Descriptive Book: " + title));
+        player.containerMenu.broadcastChanges();
+    }
+
+    /** Shared name resolution and Age creation for handheld books and the Binder. */
+    public static Identifier createAge(ServerPlayer player, String title) {
+        if (title == null || title.isBlank() || title.length() > MAX_BOOK_TITLE_LENGTH) return null;
+        String base = title.toLowerCase(Locale.ROOT).replaceAll("[^a-z0-9._-]+", "_")
+                .replaceAll("^[_\\.-]+|[_\\.-]+$", "");
+        if (base.isEmpty()) base = "age";
+        var server = player.level().getServer();
+        String name = base;
+        int suffix = 2;
+        Identifier id = Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, "age/" + name);
+        while (RuntimeAgeBackend.isNameTaken(server, id)) {
+            name = base + "_" + suffix++;
+            id = Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, "age/" + name);
+        }
+        try {
+            RuntimeAgeBackend.create(server, id, player.getRandom().nextLong());
+        } catch (IllegalArgumentException | IllegalStateException exception) {
+            player.sendOverlayMessage(Component.literal("Age creation failed: " + exception.getMessage()));
+            return null;
+        }
+        return id;
+    }
+
+    private static void enterAge(ServerPlayer player, UseDescriptiveBookPayload payload) {
+        ItemStack stack = player.getItemInHand(hand(payload.offhand()));
+        if (!stack.is(Rivencraft.DESCRIPTIVE_BOOK.get())) return;
+        Identifier id = stack.get(Rivencraft.AGE_BOOK_ID.get());
+        if (id == null) return;
+        ServerLevel source = player.level();
+        Vec3 departure = player.position();
+        Vec3 incoming = player.getDeltaMovement();
+        String failure = PortAgeTravel.enter(player, id);
+        if (failure != null) player.sendOverlayMessage(Component.literal(failure));
+        else LinkingBookItem.applySuccessfulLink(player,
+                stack.getOrDefault(Rivencraft.LINK_PROPERTIES.get(), LinkProperties.NONE),
+                source, departure, incoming, player.getYRot());
+    }
+
    private static InteractionHand hand(boolean offhand) {
        return offhand ? InteractionHand.OFF_HAND : InteractionHand.MAIN_HAND;
    }
@@ -0,0 +1,18 @@
+package net.dnorberg.rivencraft.network;
+
+import net.dnorberg.rivencraft.Rivencraft;
+import net.minecraft.network.RegistryFriendlyByteBuf;
+import net.minecraft.network.codec.ByteBufCodecs;
+import net.minecraft.network.codec.StreamCodec;
+import net.minecraft.network.protocol.common.custom.CustomPacketPayload;
+import net.minecraft.resources.Identifier;
+
+public record SetBinderTitlePayload(int containerId, String title) implements CustomPacketPayload {
+    public static final Type<SetBinderTitlePayload> TYPE = new Type<>(
+            Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, "set_binder_title"));
+    public static final StreamCodec<RegistryFriendlyByteBuf, SetBinderTitlePayload> STREAM_CODEC =
+            StreamCodec.composite(ByteBufCodecs.VAR_INT, SetBinderTitlePayload::containerId,
+                    ByteBufCodecs.stringUtf8(32), SetBinderTitlePayload::title,
+                    SetBinderTitlePayload::new);
+    @Override public Type<SetBinderTitlePayload> type() { return TYPE; }
+}
@@ -0,0 +1,21 @@
+package net.dnorberg.rivencraft.network;
+
+import net.dnorberg.rivencraft.Rivencraft;
+import net.minecraft.network.RegistryFriendlyByteBuf;
+import net.minecraft.network.codec.ByteBufCodecs;
+import net.minecraft.network.codec.StreamCodec;
+import net.minecraft.network.protocol.common.custom.CustomPacketPayload;
+import net.minecraft.resources.Identifier;
+
+public record UseDescriptiveBookPayload(boolean offhand) implements CustomPacketPayload {
+    public static final Type<UseDescriptiveBookPayload> TYPE = new Type<>(
+            Identifier.fromNamespaceAndPath(Rivencraft.MOD_ID, "use_descriptive_book"));
+    public static final StreamCodec<RegistryFriendlyByteBuf, UseDescriptiveBookPayload> STREAM_CODEC =
+            StreamCodec.composite(ByteBufCodecs.BOOL, UseDescriptiveBookPayload::offhand,
+                    UseDescriptiveBookPayload::new);
+
+    @Override
+    public Type<UseDescriptiveBookPayload> type() {
+        return TYPE;
+    }
+}
@@ -0,0 +1,58 @@
+package net.dnorberg.rivencraft.registry;
+
+import net.dnorberg.rivencraft.Rivencraft;
+import net.dnorberg.rivencraft.item.PageItem;
+import net.dnorberg.rivencraft.item.LinkProperties;
+import net.minecraft.core.registries.Registries;
+import net.minecraft.network.chat.Component;
+import net.minecraft.world.item.CreativeModeTab;
+import net.neoforged.bus.api.IEventBus;
+import net.neoforged.neoforge.registries.DeferredRegister;
+
+/** Only items already ported to 26.3 appear here. */
+public final class ModCreativeTabs {
+    private static final DeferredRegister<CreativeModeTab> TABS =
+            DeferredRegister.create(Registries.CREATIVE_MODE_TAB, Rivencraft.MOD_ID);
+
+    static {
+        TABS.register("rivencraft", () -> CreativeModeTab.builder()
+                .title(Component.translatable("itemGroup.rivencraft"))
+                .icon(() -> Rivencraft.DESCRIPTIVE_BOOK.get().getDefaultInstance())
+                .displayItems((parameters, output) -> {
+                    output.accept(Rivencraft.DESCRIPTIVE_BOOK.get());
+                    output.accept(Rivencraft.LINKING_BOOK.get());
+                    output.accept(Rivencraft.CRYSTAL_BLOCK_ITEM.get());
+                    output.accept(Rivencraft.BUDDING_CRYSTAL_ITEM.get());
+                    output.accept(Rivencraft.SMALL_CRYSTAL_BUD_ITEM.get());
+                    output.accept(Rivencraft.MEDIUM_CRYSTAL_BUD_ITEM.get());
+                    output.accept(Rivencraft.LARGE_CRYSTAL_BUD_ITEM.get());
+                    output.accept(Rivencraft.CRYSTAL_CLUSTER_ITEM.get());
+                    output.accept(Rivencraft.CRYSTAL_SHARD.get());
+                    output.accept(Rivencraft.INK_VIAL.get());
+                    output.accept(Rivencraft.BOOK_BINDER_ITEM.get());
+                    output.accept(Rivencraft.INK_MIXER_ITEM.get());
+                })
+                .build());
+        TABS.register("rivencraft_link_pages", () -> CreativeModeTab.builder()
+                .title(Component.translatable("itemGroup.rivencraft.pages.link"))
+                .icon(PageItem::createLinkPanelPage)
+                .displayItems((parameters, output) -> {
+                    int[] flags = {LinkProperties.DISARM, LinkProperties.MAINTAIN_MOMENTUM,
+                            LinkProperties.INTRA_LINKING};
+                    for (int combination = 0; combination < 8; combination++) {
+                        int selected = 0;
+                        for (int bit = 0; bit < flags.length; bit++)
+                            if ((combination & (1 << bit)) != 0) selected |= flags[bit];
+                        output.accept(PageItem.createLinkPanelPage(selected));
+                    }
+                })
+                .build());
+    }
+
+    private ModCreativeTabs() {
+    }
+
+    public static void register(IEventBus modEventBus) {
+        TABS.register(modEventBus);
+    }
+}
@@ -0,0 +1,31 @@
+package net.dnorberg.rivencraft.writing;
+
+import java.util.List;
+import net.dnorberg.rivencraft.item.LinkProperties;
+import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.item.Items;
+
+/** Built-in Legacy ink additives, carried forward from the 1.21.1 mixer. */
+public final class InkModifierIngredients {
+    public record Effect(int flag, double chance) {}
+    public record Ingredient(ItemStack item, List<Effect> effects) {}
+
+    private static final List<Ingredient> BUILT_IN = List.of(
+            new Ingredient(new ItemStack(Items.GUNPOWDER), List.of(new Effect(LinkProperties.DISARM, 0.20))),
+            new Ingredient(new ItemStack(Items.MUSHROOM_STEW), List.of(new Effect(LinkProperties.DISARM, 0.05))),
+            new Ingredient(new ItemStack(Items.EXPERIENCE_BOTTLE), List.of(new Effect(LinkProperties.INTRA_LINKING, 0.15))),
+            new Ingredient(new ItemStack(Items.ENDER_PEARL), List.of(
+                    new Effect(LinkProperties.INTRA_LINKING, 0.15),
+                    new Effect(LinkProperties.DISARM, 0.15))),
+            new Ingredient(new ItemStack(Items.FEATHER), List.of(new Effect(LinkProperties.MAINTAIN_MOMENTUM, 0.15))),
+            new Ingredient(new ItemStack(Items.FIRE_CHARGE), List.of(new Effect(LinkProperties.DISARM, 0.25)))
+    );
+
+    private InkModifierIngredients() {}
+
+    public static List<Ingredient> builtIn() { return BUILT_IN; }
+
+    public static Ingredient find(ItemStack stack) {
+        return BUILT_IN.stream().filter(ingredient -> stack.is(ingredient.item().getItem())).findFirst().orElse(null);
+    }
+}
@@ -0,0 +1,43 @@
+package net.dnorberg.rivencraft.writing;
+
+import net.dnorberg.rivencraft.Rivencraft;
+import net.dnorberg.rivencraft.item.InkVialItem;
+import net.minecraft.core.NonNullList;
+import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.item.Items;
+
+/** Shared, server-side vial-to-meter exchange from the 1.21.1 Desk and Mixer. */
+public final class InkVialExchange {
+    private InkVialExchange() {}
+
+    public static boolean canPay(NonNullList<ItemStack> items, int inkSlot, int bottleSlot,
+                                 int storedInk, int cost) {
+        return storedInk >= cost || canExchange(items, inkSlot, bottleSlot)
+                && storedInk + vialInk(items.get(inkSlot)) >= cost;
+    }
+
+    /** Returns added ink; zero means no inputs were changed. */
+    public static int exchange(NonNullList<ItemStack> items, int inkSlot, int bottleSlot) {
+        if (!canExchange(items, inkSlot, bottleSlot)) return 0;
+        ItemStack vial = items.get(inkSlot);
+        int addedInk = vialInk(vial);
+        vial.shrink(1);
+        if (vial.isEmpty()) items.set(inkSlot, ItemStack.EMPTY);
+        ItemStack bottles = items.get(bottleSlot);
+        if (bottles.isEmpty()) items.set(bottleSlot, new ItemStack(Items.GLASS_BOTTLE));
+        else bottles.grow(1);
+        return addedInk;
+    }
+
+    private static boolean canExchange(NonNullList<ItemStack> items, int inkSlot, int bottleSlot) {
+        ItemStack vial = items.get(inkSlot);
+        ItemStack bottles = items.get(bottleSlot);
+        return vial.is(Rivencraft.INK_VIAL.get()) && vialInk(vial) > 0
+                && (bottles.isEmpty() || bottles.is(Items.GLASS_BOTTLE)
+                && bottles.getCount() < bottles.getMaxStackSize());
+    }
+
+    private static int vialInk(ItemStack vial) {
+        return Math.clamp(InkVialItem.remaining(vial), 0, InkVialItem.CAPACITY);
+    }
+}
@@ -0,0 +1,66 @@
+package net.dnorberg.rivencraft.writing;
+
+import com.mojang.serialization.MapCodec;
+import net.dnorberg.rivencraft.Rivencraft;
+import net.dnorberg.rivencraft.item.PageItem;
+import net.dnorberg.rivencraft.item.LinkProperties;
+import net.minecraft.core.component.DataComponents;
+import net.minecraft.network.RegistryFriendlyByteBuf;
+import net.minecraft.network.codec.StreamCodec;
+import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.item.Items;
+import net.minecraft.world.item.crafting.CraftingInput;
+import net.minecraft.world.item.crafting.CustomRecipe;
+import net.minecraft.world.item.crafting.RecipeSerializer;
+import net.minecraft.world.level.Level;
+
+/** Legacy's shapeless leather + Link Panel recipe; never accepts a blank Page. */
+public final class LinkingBookRecipe extends CustomRecipe {
+    private static final LinkingBookRecipe INSTANCE = new LinkingBookRecipe();
+    public static final MapCodec<LinkingBookRecipe> MAP_CODEC = MapCodec.unit(INSTANCE);
+    public static final StreamCodec<RegistryFriendlyByteBuf, LinkingBookRecipe> STREAM_CODEC = StreamCodec.unit(INSTANCE);
+    public static final RecipeSerializer<LinkingBookRecipe> SERIALIZER = new RecipeSerializer<>(MAP_CODEC, STREAM_CODEC);
+
+    private LinkingBookRecipe() {
+    }
+
+    private static ItemStack findPanel(CraftingInput input) {
+        if (input.ingredientCount() != 2) return ItemStack.EMPTY;
+        ItemStack panel = ItemStack.EMPTY;
+        boolean leather = false;
+        for (ItemStack stack : input.items()) {
+            if (stack.isEmpty()) continue;
+            if (PageItem.isLinkPanel(stack) && panel.isEmpty()) {
+                panel = stack;
+            } else if (stack.is(Items.LEATHER) && !leather) {
+                leather = true;
+            } else {
+                return ItemStack.EMPTY;
+            }
+        }
+        return leather ? panel : ItemStack.EMPTY;
+    }
+
+    @Override
+    public boolean matches(CraftingInput input, Level level) {
+        return !findPanel(input).isEmpty();
+    }
+
+    @Override
+    public ItemStack assemble(CraftingInput input) {
+        ItemStack panel = findPanel(input);
+        if (panel.isEmpty()) return ItemStack.EMPTY;
+        ItemStack book = new ItemStack(Rivencraft.LINKING_BOOK.get());
+        if (panel.has(DataComponents.CUSTOM_NAME)) {
+            book.set(DataComponents.CUSTOM_NAME, panel.get(DataComponents.CUSTOM_NAME));
+        }
+        LinkProperties properties = panel.get(Rivencraft.LINK_PROPERTIES.get());
+        if (properties != null) book.set(Rivencraft.LINK_PROPERTIES.get(), properties);
+        return book;
+    }
+
+    @Override
+    public RecipeSerializer<LinkingBookRecipe> getSerializer() {
+        return SERIALIZER;
+    }
+}
@@ -0,0 +1,6 @@
+{
+  "model": {
+    "type": "minecraft:model",
+    "model": "rivencraft:item/book_binder"
+  }
+}
@@ -0,0 +1 @@
+{"model":{"type":"minecraft:model","model":"rivencraft:item/budding_crystal"}}
@@ -0,0 +1 @@
+{"model":{"type":"minecraft:model","model":"rivencraft:item/crystal_cluster"}}
@@ -0,0 +1,6 @@
+{
+  "model": {
+    "type": "minecraft:model",
+    "model": "rivencraft:item/ink_mixer"
+  }
+}
@@ -0,0 +1 @@
+{"model":{"type":"minecraft:model","model":"rivencraft:item/ink_vial"}}
@@ -0,0 +1 @@
+{"model":{"type":"minecraft:model","model":"rivencraft:item/large_crystal_bud"}}
@@ -1,6 +1,15 @@
 {
  "model": {
-    "type": "minecraft:model",
-    "model": "rivencraft:item/linking_book_bound"
+    "type": "minecraft:condition",
+    "property": "minecraft:has_component",
+    "component": "rivencraft:link_book_target",
+    "on_true": {
+      "type": "minecraft:model",
+      "model": "rivencraft:item/linking_book_bound"
+    },
+    "on_false": {
+      "type": "minecraft:model",
+      "model": "rivencraft:item/linking_book_unwritten"
+    }
  }
 }
@@ -0,0 +1 @@
+{"model":{"type":"minecraft:model","model":"rivencraft:item/medium_crystal_bud"}}
@@ -0,0 +1,9 @@
+{
+  "model": {
+    "type": "minecraft:condition",
+    "property": "minecraft:has_component",
+    "component": "rivencraft:link_panel_page",
+    "on_true": {"type": "minecraft:model", "model": "rivencraft:item/page_link_panel"},
+    "on_false": {"type": "minecraft:model", "model": "rivencraft:item/page"}
+  }
+}
@@ -0,0 +1 @@
+{"model":{"type":"minecraft:model","model":"rivencraft:item/small_crystal_bud"}}
@@ -2,5 +2,31 @@
  "item.rivencraft.crystal_shard": "Crystal Shard",
  "item.rivencraft.descriptive_book": "Descriptive Book",
  "item.rivencraft.linking_book": "Linking Book",
-  "block.rivencraft.crystal_block": "Crystal Block"
+  "item.rivencraft.page": "Page",
+  "item.rivencraft.page.blank": "Blank Page",
+  "item.rivencraft.page.link_panel": "Link Panel Page",
+  "item.rivencraft.link_property.disarm": "Disarm",
+  "item.rivencraft.link_property.maintain_momentum": "Maintain Momentum",
+  "item.rivencraft.link_property.intra_linking": "Intra-Linking",
+  "item.rivencraft.ink_vial": "Ink Vial",
+  "item.rivencraft.ink_vial.remaining": "Ink: %s/%s",
+  "item.rivencraft.ink_vial.usage": "Use with paper in the other hand, or place in an Ink Mixer.",
+  "item.rivencraft.page.blank.port_status": "Base for future symbol writing; not yet usable in this port.",
+  "item.rivencraft.page.link_panel.port_status": "Use with leather in a Book Binder to make a Descriptive Book.",
+  "block.rivencraft.book_binder": "Book Binder",
+  "container.rivencraft.book_binder": "Book Binder",
+  "screen.rivencraft.book_binder.missing_panel": "Link Panel required",
+  "block.rivencraft.ink_mixer": "Ink Mixer",
+  "container.rivencraft.ink_mixer": "Ink Mixer",
+  "screen.rivencraft.ink_mixer.ink": "Ink: %s/%s",
+  "screen.rivencraft.ink_mixer.additive_hint": "Click with an additive to mix it in",
+  "screen.rivencraft.ink_mixer.chance": "%s: %s%%",
+  "block.rivencraft.crystal_block": "Crystal Block",
+  "block.rivencraft.budding_crystal": "Budding Crystal",
+  "block.rivencraft.small_crystal_bud": "Small Crystal Bud",
+  "block.rivencraft.medium_crystal_bud": "Medium Crystal Bud",
+  "block.rivencraft.large_crystal_bud": "Large Crystal Bud",
+  "block.rivencraft.crystal_cluster": "Crystal Cluster",
+  "itemGroup.rivencraft": "Rivencraft",
+  "itemGroup.rivencraft.pages.link": "Rivencraft Link Pages"
 }
@@ -0,0 +1,6 @@
+{
+  "parent": "minecraft:item/generated",
+  "textures": {
+    "layer0": "rivencraft:item/linking_book_unwritten"
+  }
+}
@@ -0,0 +1 @@
+{"parent":"minecraft:item/generated","textures":{"layer0":"rivencraft:item/page"}}
@@ -0,0 +1 @@
+{"type":"minecraft:block","random_sequence":"rivencraft:blocks/budding_crystal"}
@@ -0,0 +1,23 @@
+{
+  "type": "minecraft:block",
+  "pools": [{
+    "entries": [{
+      "type": "minecraft:alternatives",
+      "children": [
+        {"type": "minecraft:item", "condition": "minecraft:tool/can_silk_touch", "name": "rivencraft:crystal_cluster"},
+        {"type": "minecraft:alternatives", "children": [
+          {"type": "minecraft:item", "condition": {"type": "minecraft:match_tool", "predicate": {"items": "#minecraft:cluster_max_harvestables"}}, "modifier": [
+            {"type": "minecraft:set_count", "count": 4},
+            {"type": "minecraft:apply_bonus", "enchantment": "minecraft:fortune", "formula": "minecraft:ore_drops"}
+          ], "name": "rivencraft:crystal_shard"},
+          {"type": "minecraft:item", "modifier": [
+            {"type": "minecraft:set_count", "count": 2},
+            {"type": "minecraft:explosion_decay"}
+          ], "name": "rivencraft:crystal_shard"}
+        ]}
+      ]
+    }],
+    "rolls": 1
+  }],
+  "random_sequence": "rivencraft:blocks/crystal_cluster"
+}
@@ -0,0 +1 @@
+{"type":"minecraft:block","pools":[{"condition":"minecraft:tool/can_silk_touch","entries":[{"type":"minecraft:item","name":"rivencraft:large_crystal_bud"}],"rolls":1}],"random_sequence":"rivencraft:blocks/large_crystal_bud"}
@@ -0,0 +1 @@
+{"type":"minecraft:block","pools":[{"condition":"minecraft:tool/can_silk_touch","entries":[{"type":"minecraft:item","name":"rivencraft:medium_crystal_bud"}],"rolls":1}],"random_sequence":"rivencraft:blocks/medium_crystal_bud"}
@@ -0,0 +1 @@
+{"type":"minecraft:block","pools":[{"condition":"minecraft:tool/can_silk_touch","entries":[{"type":"minecraft:item","name":"rivencraft:small_crystal_bud"}],"rolls":1}],"random_sequence":"rivencraft:blocks/small_crystal_bud"}
@@ -0,0 +1,10 @@
+{
+  "type": "minecraft:crafting_shaped",
+  "category": "misc",
+  "pattern": ["III", "PPP", "P P"],
+  "key": {
+    "I": "minecraft:iron_ingot",
+    "P": "#minecraft:planks"
+  },
+  "result": {"id": "rivencraft:book_binder", "count": 1}
+}
@@ -0,0 +1,12 @@
+{
+  "type": "minecraft:crafting_shaped",
+  "category": "misc",
+  "pattern": ["SS", "SS"],
+  "key": {
+    "S": "rivencraft:crystal_shard"
+  },
+  "result": {
+    "id": "rivencraft:crystal_block",
+    "count": 1
+  }
+}
@@ -0,0 +1,11 @@
+{
+  "type": "minecraft:crafting_shaped",
+  "category": "misc",
+  "pattern": ["S S", "SVS", "PSP"],
+  "key": {
+    "S": "minecraft:stone",
+    "V": "minecraft:glass_bottle",
+    "P": "#minecraft:planks"
+  },
+  "result": {"id": "rivencraft:ink_mixer", "count": 1}
+}
@@ -0,0 +1,11 @@
+{
+  "type": "minecraft:crafting_shapeless",
+  "category": "misc",
+  "ingredients": [
+    "minecraft:black_dye",
+    "minecraft:black_dye",
+    "minecraft:glass_bottle",
+    "minecraft:water_bucket"
+  ],
+  "result": {"id": "rivencraft:ink_vial", "count": 1}
+}
@@ -0,0 +1 @@
+{"type":"rivencraft:linking_book"}
Author	SHA1	Message	Date
dnorberg	9ab8d3de4a	Port Binder and Ink Mixer interactions to 26.3 alpha Build / build (push) Canceled after 0s Details	2026-10-30 15:55:43 -04:00
dnorberg	56005ac512	Port crystal growth, pages, ink vials and link crafting to 26.3 Build / build (push) Canceled after 0s Details	2026-10-29 15:07:46 -04:00
dnorberg	9ff931afa9	Add 26.3 descriptive book binding and travel Build / build (push) Canceled after 0s Details	2026-10-29 14:32:50 -04:00
				`@@ -0,0 +1 @@`
				`{"model":{"type":"minecraft:model","model":"rivencraft:item/budding_crystal"}}`
				`@@ -0,0 +1 @@`
				`{"parent":"minecraft:item/generated","textures":{"layer0":"rivencraft:item/page"}}`
				`@@ -0,0 +1 @@`
				`{"type":"minecraft:block","random_sequence":"rivencraft:blocks/budding_crystal"}`
				`@@ -0,0 +1 @@`
				`{"type":"minecraft:block","pools":[{"condition":"minecraft:tool/can_silk_touch","entries":[{"type":"minecraft:item","name":"rivencraft:large_crystal_bud"}],"rolls":1}],"random_sequence":"rivencraft:blocks/large_crystal_bud"}`