Skyseed

[0.17.0] - 2026-06-21

Changed

• Vein sizes moved from a generator multiplier into the theme JSONs. The v0.16.0 in-code vein scaling was reverted; the Rocky/Ancient ore tables now set sizes directly — iron, coal and copper are veins of 4–8 at normal throw heights. (The orthogonal vein growth from v0.16.0 stays.)
• Rocky & Ancient ore tables reworked to track the vanilla ore-by-depth curve (a simplified per-Y-band heuristic): thrown deep → deepslate diamond / redstone / gold / lapis (the richest haul); mid-air → an iron & copper peak with coal; high / peak → coal- and iron-heavy with none of the deep treasures — so a high island gives less than one thrown low. Copper is reliably common at mid heights, and deepslate copper now appears in the deep bands. Verified via RCON across deep/mid/high/peak throws.

Fixed

• The guide book shows its custom cover again. Making Patchouli optional had dropped the custom item texture; the book now points its Patchouli model at the restored skyseed:guide texture.

Guide

• Rocky and Ancient entries (and their Large variants) now name copper explicitly and spell out that deeper throws are richer — high islands yield coal and iron but not the deep treasures.

[0.16.0] - 2026-06-21

Changed

• Ore veins are bigger. The generator scales each sampled vein up (≈1.4–1.9×), with the common ores (higher presence chance) growing the most — so patches read as proper deposits.
• Veins grow compactly. Vein growth now strongly favours face-adjacent steps (up/down/N/S/E/W) over diagonals (~80/20), so ore looks like solid clusters rather than scattered diagonal specks. Diagonal steps still happen, just rarely.
• Copper is now a common ore on Rocky and Ancient islands (and their Large variants): presence chance and vein count bumped to roughly iron-level (≈0.7–0.85 per island), so it shows up reliably. Copper has existed since MC 1.17 and was already present, but only at ~50% per island.

[0.15.0] - 2026-06-21

Fixed

• Ponds no longer overflow off the island. A carved pool now gets a containment ring — every land column touching the water is walled up to the surface with the island's own fill/surface block (the "ring of dirt"), placed before decorations — so the water can't sheet over a low edge. Pools are also kept a little smaller (extent ≈ 0.62× the island radius, down from ≈0.87×) so the rim always has solid ground to wall against; where the pool genuinely sits against the very edge, a small waterfall is left as variety. (Verified: pond water now spans only its own depth, ~3–5 blocks, instead of cascading down the island.)

Added

• Water features carry sand, clay and gravel. Every pond/river/lake bed is dressed with sandy / gravelly / clay patches, and the shore gets sandy and gravelly edges — the materials you'd expect in and around water.

[0.14.0] - 2026-06-21

Added

• Four more structure islands (see SKYSTRUCTURESPLAN.md), all built on the jigsaw system:
  • Ruined Portal (skyseed:ruined_portal) — a scorched basalt scene with a broken obsidian / crying-obsidian frame and a minecraft:chests/ruined_portal chest (crying obsidian is otherwise unobtainable up here). Obsidian + gold ingot.
  • Desert Temple (skyseed:desert_temple) — a sealed sandstone chamber, four minecraft:chests/desert_pyramid chests over a buried 3×3 cache of TNT. Sand + sandstone + TNT.
  • Jungle Temple (skyseed:jungle_temple) — a mossy-cobblestone room with two minecraft:chests/jungle_temple chests and a lootable arrow dispenser. Jungle planks + mossy cobblestone + tripwire hook.
  • Witch Hut (skyseed:witch_hut) — a spruce hut with a witch and a cat (via the animals pack) and a water cauldron; no chest, the witch's drops are the reward. Oak planks + brown mushroom + cauldron.
  • Each ships theme, recipe, advancement, guide entry, icon, and item + #skyseed:skyseeds tag entry.

Changed

• Mobs spawned via the animals pack are now setPersistenceRequired — harmless for farm animals, but it keeps structure-island mobs (the Witch Hut's witch) from despawning. A shared StructureParts helper now holds the jigsaw anchor + loot-chest block-entity NBT used by the structure templates.

Known limitation

• Support-dependent "trap trigger" blocks (a desert temple's pressure plate, a jungle temple's tripwire) do not survive the jigsaw structure-placement path, so they're omitted for now: the desert's TNT is reframed as a minable cache and the jungle's dispenser is left lootable. Restoring live traps would need a post-placement fragile-block pass.

[0.13.0] - 2026-06-21

Added

• Dungeon Island (skyseed:dungeon) — the first structure island (see SKYSTRUCTURESPLAN.md). A small mossy cobblestone island carrying a sealed 5×5×5 cube: a vanilla mob spawner (zombie / skeleton / spider, the luck of the throw) and two loot chests on the vanilla minecraft:chests/simple_dungeon table. Sealed and dark so the spawner keeps running — break in, clear it, loot it (the music discs Cat and 13 are dungeon-only). Crafted from cobblestone around a piece of rotten flesh. Ships theme, recipe, advancement, guide entry and icon.
  • Structure islands reuse the existing jigsaw system — no new engine field needed. The spawner and the loot chests are block-entity NBT baked into the structure .nbt (the spawner's mob via three weighted pool variants), and the loot reuses the vanilla table by id.

[0.12.0] - 2026-06-21

Changed

• Patchouli is now optional. With Patchouli installed, the Skyfarer's Almanac is the rich illustrated book as before; without it, the guide is a plain vanilla written book carrying a short text edition. The mod loads and plays fully without Patchouli (verified by booting with it removed). The single Patchouli API call is isolated in a PatchouliCompat class that only loads when Patchouli is present; the dependency is optional in the mod metadata and compile-only in the build.
• The guide is granted and crafted via one helper, SkyseedGuide.book() (Patchouli book or written book), so the first-join grant and the craft recipe always match. Crafting is now a small code recipe (skyseed:guide) that turns any one #skyseed:skyseeds item into the Almanac.

Removed

• The custom skyseed:guide item — the guide is now a real written book (or the Patchouli book), not a bespoke item.

[0.11.0] - 2026-06-21

Changed

• Each Skyseed is now its own item (skyseed:<theme>_skyseed, e.g. skyseed:forest_skyseed) instead of a single skyseed:island_seed carrying a skyseed:theme data component. 28 distinct items, registered from ModItems.SEED_THEMES, each with its own model and lang name — so every seed shows up individually in JEI/REI, and add-on mods can register their own seed (pointed at their own theme). All seeds share the new #skyseed:skyseeds item tag; the thrown seed reads its item's fixed theme. The skyseed:theme data component and the generic item are removed.
• The guide book recipe is now "any single Skyseed → the Almanac" (shapeless, keyed off #skyseed:skyseeds), replacing the vanilla-book + seed recipe — a vanilla book was awkward to obtain in skyblock.

Fixed

• The guide book is granted only on first join, not every login. The "guide given" and "start-island placed" flags now live in the world SavedData keyed by player UUID, so they survive relogs reliably (the previous player-persistent-data flag did not).

Migration

• Breaking: old skyseed:island_seed items (and the skyseed:theme component) no longer exist. Generated islands are unaffected; any uncrafted seeds sitting in inventories/chests are lost. Re-craft from the (unchanged) recipes — each now yields its own distinct item.

[0.10.0] - 2026-06-21

Added

• Five Animal Islands — dedicated farm islands, each a fenced enclosure (jigsaw-placed) with a guaranteed pack of animals rolled inside:
  • Pasture (skyseed:pasture) — a fenced field with a cow / sheep / pig breeding pair (weighted, sometimes mixed), a hay bale and a water trough. Two unlock paths: wool OR raw beef, + planks + dirt.
  • Poultry (skyseed:poultry) — a walled coop of four chickens with a composter. Feather + egg + dirt.
  • Wool Farm (skyseed:wool_farm) — a roomy pen of five assorted-colour sheep. 2 wool + iron + dirt.
  • Stable (skyseed:stable) — a three-stall stable of horses / donkeys (rare mule) plus a loot chest with a chance of a saddle or horse armour. Leather + gold + planks.
  • Aquarium (skyseed:aquarium) — a glass tank of turtles, axolotls, a squid and tropical fish over a coral-and-sea-lantern floor. Turtle scute + prismarine shard + sand. Each ships theme, recipe, advancement, guide entry and icon. Verified via RCON: correct packs, babies, 4-colour sheep spreads, stable loot chest, and submerged aquarium life.
• animals theme field — a weighted list of packs; exactly one is rolled into the enclosure centre at generation time. Each entry spawns N adults + N babies, sheep are given a random wool colour, and aquatic animals are spawned submerged. The enclosure itself is the theme's jigsaw structure.

Changed

• levelStructurePad now lays the foundation in the theme's own surface/fill blocks (so the sand Aquarium gets a sand pad rather than a grass ring) instead of always grass over dirt.

[0.9.0] - 2026-06-21

Added

• Village Center Island (skyseed:village_center) — the premium, late-game village island, completing the villager progression (Hamlet → Trade Post → Village Center). A bell-topped cobblestone plaza with four themed trading halls branching off it (farm / smith / scholar / craft) and an iron golem on guard. Built by the jigsaw system with each plaza connector pointing at its own hall pool, so the layout is deterministic and all 13 vanilla professions are guaranteed — farmer, shepherd, fletcher, butcher, armorer, weaponsmith, toolsmith, librarian, cartographer, cleric, mason, leatherworker, fisherman. Crafted from 5 emeralds + an iron ingot + planks + cobblestone. Ships theme, recipe, advancement, guide, icon. Verified via RCON: 13 villagers, all 13 distinct professions claimed within ~10 s, 1 iron golem.

Changed

• JigsawConfig gained an optional iron_golems count (golems spawned at the structure centre once assembled).
• Structure foundation pads are now a disc, not a square. The village footprints are plus-shaped (corners empty), so a round pad covers them while staying inside a round island's rim — square corners could float past the edge on the larger pads. Also gives the Hamlet and Trade Post a tidier round clearing.

[0.8.0] - 2026-06-21

Added

• Trade Post Island (skyseed:trade_post) — the mid-tier village island. A lantern-lit cobblestone plaza with shops branching off its four sides, assembled by the jigsaw system: a central plaza piece carries outward connectors that pull buildings from a pool — real vanilla-village-style, multi-piece assembly (the payoff of the v0.7.0 jigsaw pivot). Each shop holds a job-site block and a bed, so its villager moves in and takes up that trade on its own — farmer, librarian, fisherman, fletcher, or toolsmith — and no two trade posts share a layout. Crafted from planks + cobblestone + 3 emeralds; ships with theme, recipe, advancement, guide entry, and icon.

Changed

• Villagers are now placed by scanning the assembled structure for beds (one villager per bed), so the same code serves the Hamlet's single cottage and the Trade Post's plaza of shops. They arrive unemployed and claim the nearby job sites themselves, exactly as in a natural village.

[0.7.0] - 2026-06-21

Changed

• Buildings now use the vanilla jigsaw system. Placement moved from "load one .nbt and stamp it" to real jigsaw assembly: a theme's jigsaw config points at a worldgen/template_pool, and the generator levels a pad and runs JigsawPlacement.generateJigsaw at the island centre — the same machinery vanilla villages use. This brings, for free:
  • Random rotation — cottages now face any direction.
  • Structure processors for organic variation — the Hamlet's hamlet_weathering processor mosses cobblestone and strips the odd oak log, so even same-style cottages differ.
  • A weighted pool of the three cottages, now a standard template pool, and the foundation for multi-building islands (Trade Post, Village Center) that branch pieces off jigsaw connectors. Cottage .nbt carry a "bottom" anchor jigsaw (emitted by the dev-time writer); drop in your own structure-block-authored .nbt and add it to the pool to extend it.

[0.6.0] - 2026-06-21

Added

• NBT structure templating. Buildings are now placed from .nbt structure templates (the standard structure-block format) loaded at generation time and stamped onto a levelled pad. A theme carries a weighted structures pool, so one of several buildings is chosen per island. This is the reusable foundation for the larger village islands (Trade Post, Village Center) and future structure islands — and you can drop in a structure-block-authored .nbt and add it to the pool.

Changed

• The Hamlet now varies. Its cottage is picked from three templates (oak, spruce, and a small cabin), so no two hamlets look quite alike — replacing the single hand-built cottage. The villager, bed, recipe, and raid handling are unchanged.

[0.5.2] - 2026-06-21

Changed

• The Almanac's Recipes chapter is pinned to the front of the book (a priority entry) so it's easy to find instead of buried among the island entries. Added a note that a small island is a 2x2 of four blocks and a large one a 3x3.

[0.5.1] - 2026-06-21

Changed

• Consistent seed recipes. Every small island now costs exactly 4 blocks in a 2×2 "stack" — the surface/feature on the top row, the base on the bottom: Desert = 2 sand over 2 sandstone, Rocky = 2 stone over 2 cobblestone, Forest = 2 planks over 2 dirt, Meadow = 2 flowers over 2 dirt, Frozen = 2 snow over 2 ice, Badlands = 2 red sand over 2 terracotta, Ancient = 2 deepslate over 2 cobbled deepslate, Lush = 2 azalea over 2 moss, Aquatic = 2 sand over 2 clay, Mushroom = red + brown mushroom over 2 dirt. (Previously these ranged from 2 to 4 blocks in mixed shapes.) Hamlet keeps its emerald gate as 2 planks over cobblestone + emerald. Large variants are unchanged (3×3, nine blocks).

[0.5.0] - 2026-06-21

Added

• Villager progression — the Hamlet Island. The first village island: a grassy isle with a hand-built oak cottage (bed, crafting table, torch, windows, door) and one resident villager. The villager arrives unemployed — place a job-site block (composter, lectern, cauldron, …) to give it a trade — and is dressed for the biome it grew over; its bed gives it a home to claim, restock and breed from. Crafted from planks + cobblestone + an emerald (mine a Rocky mountain for emeralds). Full pattern: theme, recipe, advancement, guide entry, icon.
• Curated structures. A theme can name a structure to stamp onto the island surface (the Hamlet's cottage is the first); a new plan step spawns villagers once the island lands.
• Raids disabled on Skyseed worlds (disableRaids gamerule) — illagers would only path into the void. Villager islands still trade, breed and spawn iron golems normally.

[0.4.1] - 2026-06-21

Changed

• The Almanac's Recipes entry now gives a sourcing hint for every seed — where to find what it takes, not just the ingredients. E.g. Ancient = deepslate from a Rocky island thrown deep; Lush = moss from an Ancient island plus azalea from a Forest; Aquatic = clay and sand from a Desert island; Frozen = snow from a snowy island or a Rocky snow-cap.

[0.4.0] - 2026-06-21

Added

• Rivers. A pond can now have "style": "river" — instead of a central pool it cuts a meandering channel across the island (radius = half-width). River biomes use it: a Forest Skyseed over a river grows a wood with a river running through it; an Aquatic Skyseed cuts a salmon-stocked channel.

Changed

• Water carving has variety. Ponds are no longer perfect circles — their edge is wobbled with a few angular harmonics, so each pool is a unique blob.
• Water features are properly contained. Every water column is only carved where the island body reaches below the pool floor, so water can never hang off the rim or take a slab of the island with it (fixes aquatic islands losing a side). Large Aquatic's lake radius trimmed 8→6 for extra margin.
• Small Aquatic ocean reef toned down. A small island no longer gets the full ten-piece reef (which looked silly at that scale) — just a couple of corals, sea pickles, seagrass, and a turtle. The Large Aquatic island keeps the full reef.

[0.3.7] - 2026-06-21

Changed

• Large Frozen no longer always has a frozen lake — it's biome-driven. The ice lake used to be an unconditional feature. Now it only forms over frozen biomes (frozen ocean/river, frozen & jagged peaks, ice spikes, snowy slopes), where the island also turns properly icy — packed/blue-ice surface and more ice spikes. Over snowy biomes (snowy plains/taiga/beach, grove) it's deep powder snow and spruce with no lake; elsewhere a snowy-leaning mix. Guide text updated.

[0.3.6] - 2026-06-21

Changed

• Forest & Large Forest stay a forest in every biome. The biome overrides used to replace the forest — beaches and deserts became treeless sand/dirt patches, oceans a near-empty lake, mushroom fields a mushroom island. They now keep grass and trees everywhere and only add the biome accent: a pond in watery biomes (ocean / river / swamp / mangrove), sandy ground on beaches and in deserts, mycelium patches with a couple of giant mushrooms over mushroom fields, and the local tree species elsewhere. Plains is a lighter wood rather than near-empty grass. Guide text updated to match.

[0.3.5] - 2026-06-21

Fixed

• Ponds now sit flush with the island surface instead of recessed in a pit. The water level used the island's un-domed base height, so on domed islands — the large variants especially — the pool sat 2–3 blocks below the surrounding ground. Water now fills to the island top at the pond's rim. Large pond depths trimmed to suit (Large Aquatic 7→5, Large Lush 5→4). Bonus: sugar-cane banks survive better now that the shore sits at the water's edge.