第三轮：拿掉参考图

# Starting point for a Minecraft build generator. Copy into the workspace and fill in build(). # Everything that has to be right for the harness is already right here: bounds checked placement, # one seeded random source, and a byte reproducible export. from __future__ import annotations import argparse import random import sys from pathlib import Path from typing import Dict, Iterable, Optional, Tuple sys.path.insert(0, "/work/generator/MCIO") from mcio.nbt.nbt import File as NBTFile from mcio.nbt.tag import Compound, Int, String, Byte, Double, List as NBTList from mcio.schematic import load_schematic # noqa: E402 from mcio.sketch import LitematicCanvas, Material, parse_blockstate # noqa: E402 CONFIG = { "seed": 20260923, "size_xyz": (45, 40, 35), # width X, height Y, depth Z "minecraft_version": "1.21.1", "data_version": 3955, "output": "output.litematic", "name": "Amberstone Lodge", "author": "generator", "description": "Amberstone Lodge: four furnished levels, smithy, terrace and pines", } def canonical(state): """Normalize property ordering for lossless round-trip comparisons.""" base, _, props = state.partition('[') return base, tuple(sorted(props.rstrip(']').split(','))) Position = Tuple[int, int, int] class Build: """Hold a block volume and write it out as a Litematica schematic.""" def __init__(self, size_xyz: Tuple[int, int, int] = CONFIG["size_xyz"], seed: int = CONFIG["seed"]) -> None: """Create an empty volume with one seeded random source. Args: size_xyz (Tuple[int, int, int]): Volume size as width X, height Y, depth Z. seed (int): Seed for every random decision in this build. """ self.size_x, self.size_y, self.size_z = size_xyz self.rng = random.Random(seed) self.canvas = LitematicCanvas((self.size_y, self.size_z, self.size_x)) self.placed: Dict[Position, str] = {} def inside(self, x: int, y: int, z: int) -> bool: """Report whether a coordinate is inside the volume. Args: x (int): Width coordinate. y (int): Height coordinate. z (int): Depth coordinate. Returns: bool: True when every axis is within range. """ return 0 <= x < self.size_x and 0 <= y < self.size_y and 0 <= z < self.size_z def put(self, x: int, y: int, z: int, block: str | Material, **properties: str) -> None: """Place one block, in XYZ order, with an immediate bounds check. Args: x (int): Width coordinate. y (int): Height coordinate. z (int): Depth coordinate. block (str | Material): Namespaced block name, a full blockstate string, or a Material. **properties: Blockstate properties such as facing or half. Raises: AssertionError: When the coordinate is outside the volume, naming the coordinate. """ assert self.inside(x, y, z), f"out of bounds: (x={x}, y={y}, z={z}) in {self.size_x}x{self.size_y}x{self.size_z}" material = self.material(block, **properties) if isinstance(block, str) else block self.canvas.block((y, z, x), material) self.placed[(x, y, z)] = material.blockstate def material(self, name: str, **properties: str) -> Material: """Build a Material from a block name and its properties. Args: name (str): Namespaced block name, or a full blockstate string. **properties: Blockstate properties. Returns: Material: Material ready for placement. """ if "[" in name: return parse_blockstate(name) return self.canvas.material(name, **properties) def box(self, bounds: Tuple[int, int, int, int, int, int], block: str | Material, **properties: str) -> None: """Fill an inclusive box. Args: bounds (Tuple[int, int, int, int, int, int]): x0, y0, z0, x1, y1, z1, inclusive on both ends. block (str | Material): Block to place. **properties: Blockstate properties. """ x0, y0, z0, x1, y1, z1 = bounds for x in range(min(x0, x1), max(x0, x1) + 1): for y in range(min(y0, y1), max(y0, y1) + 1): for z in range(min(z0, z1), max(z0, z1) + 1): self.put(x, y, z, block, **properties) def shell(self, bounds: Tuple[int, int, int, int, int, int], block: str | Material, **properties: str) -> None: """Fill only the faces of a box, leaving the inside empty. Args: bounds (Tuple[int, int, int, int, int, int]): x0, y0, z0, x1, y1, z1, inclusive. block (str | Material): Block to place. **properties: Blockstate properties. """ x0, y0, z0, x1, y1, z1 = bounds for x in range(min(x0, x1), max(x0, x1) + 1): for y in range(min(y0, y1), max(y0, y1) + 1): for z in range(min(z0, z1), max(z0, z1) + 1): on_face = x in (x0, x1) or y in (y0, y1) or z in (z0, z1) if on_face: self.put(x, y, z, block, **properties) def texture(self, bounds: Tuple[int, int, int, int, int, int], palette: Iterable[str]) -> None: """Fill a box with a weighted mix of related blocks, so the surface is not flat. Args: bounds (Tuple[int, int, int, int, int, int]): x0, y0, z0, x1, y1, z1, inclusive. palette (Iterable[str]): Block names. Repeat a name to make it more common. """ choices = list(palette) x0, y0, z0, x1, y1, z1 = bounds for x in range(min(x0, x1), max(x0, x1) + 1): for y in range(min(y0, y1), max(y0, y1) + 1): for z in range(min(z0, z1), max(z0, z1) + 1): self.put(x, y, z, self.rng.choice(choices)) def get(self, x: int, y: int, z: int) -> Optional[str]: """Read back what was placed at a coordinate. Args: x (int): Width coordinate. y (int): Height coordinate. z (int): Depth coordinate. Returns: Optional[str]: Blockstate string, or None when the cell is empty. """ return self.placed.get((x, y, z)) def build(self) -> "Build": """Build the lodge, landscape, circulation and furnished room groups.""" self.decorations = [] self.windows = [] self.tile_entities = [] self.entities = [] stone = ['minecraft:stone_bricks'] * 6 + ['minecraft:andesite', 'minecraft:mossy_stone_bricks'] plaster = ['minecraft:calcite'] * 7 + ['minecraft:smooth_sandstone', 'minecraft:white_terracotta'] roof = ['minecraft:deepslate_tiles'] * 7 + ['minecraft:deepslate_bricks', 'minecraft:polished_deepslate'] wood = ['minecraft:spruce_planks'] * 8 + ['minecraft:dark_oak_planks'] self.box((0, 0, 0, 44, 1, 34), 'minecraft:dirt') self.box((0, 2, 0, 44, 2, 34), 'minecraft:grass_block') self.texture((6, 2, 5, 38, 3, 30), stone) for z in range(5): center = 18 + (z // 2) for x in range(center - 2, center + 3): self.put(x, 2, z, self.rng.choice(stone + ['minecraft:gravel'])) for x in range(16, 22): self.put(x, 3, 4, 'minecraft:stone_brick_stairs', facing='south') # Main and lower wing shells; shared walls are opened after roofs are built. for x0, x1, z0, z1, top, floors in [(8, 24, 10, 28, 25, [3, 10, 17, 24]), (24, 36, 12, 27, 17, [3, 10])]: for y in range(4, top + 1): pal = stone if y < 10 else plaster for x in range(x0, x1 + 1): for z in (z0, z1): self.put(x, y, z, self.rng.choice(pal)) for z in range(z0, z1 + 1): for x in (x0, x1): self.put(x, y, z, self.rng.choice(pal)) for f in floors: self.texture((x0, f, z0, x1, f, z1), wood) for x in range(x0, x1 + 1, 4): for z in (z0, z1): self.box((x, 4, z, x, top, z), 'minecraft:stripped_spruce_log', axis='y') for z in range(z0, z1 + 1, 4): for x in (x0, x1): self.box((x, 4, z, x, top, z), 'minecraft:stripped_dark_oak_log', axis='y') for y in floors[1:] + [top]: for z in (z0, z1): self.box((x0, y, z, x1, y, z), 'minecraft:dark_oak_log', axis='x') for x in (x0, x1): self.box((x, y, z0, x, y, z1), 'minecraft:dark_oak_log', axis='z') # Steep filled gables and two-block thick roofs eliminate diagonal sky leaks. for x0, x1, z0, z1, eave, rise in [(7, 25, 9, 29, 25, 12), (24, 37, 11, 28, 17, 7)]: mid = (x0 + x1) / 2 heights = {x: eave + int(rise * (1 - abs(x - mid) / ((x1 - x0) / 2))) for x in range(x0, x1 + 1)} for x, h in heights.items(): for z in range(z0, z1 + 1): # Lower roof terminates against main wall. if x <= 24 and eave == 17: continue low = min(h, heights.get(x - 1, h), heights.get(x + 1, h)) - 1 self.texture((x, low, z, x, h, z), roof) if x0 < x < x1: for z in (z0 + 1, z1 - 1): if eave == 17 and x <= 24: continue self.texture((x, eave, z, x, h - 2, z), plaster) if x % 4 == 0: self.box((x, eave, z, x, h - 2, z), 'minecraft:dark_oak_log', axis='y') for z in (z0, z1): self.put(x, h, z, 'minecraft:polished_deepslate') peak = max(heights.values()) for z in range(z0, z1 + 1): self.put(round(mid), peak + 1, z, 'minecraft:deepslate_tile_slab', type='bottom') # Clear internal doorways between the masses. for f in (3, 10): self.box((24, f + 1, 19, 24, f + 3, 21), 'minecraft:air') # Windows: full glass keeps the weather envelope sealed. for y in (5, 12, 19, 27): for x in (12, 20): if y == 27 and x == 20: continue self.window(x, y, 10, 'north') if y < 25: for x in (12, 20): self.window(x, y, 28, 'south') for y in (5, 12): self.window(30, y, 12, 'north') self.window(30, y, 27, 'south') self.window(36, y, 16, 'east') for y in (5, 12, 19): self.window(8, y, 18, 'west') for y, half in ((4, 'lower'), (5, 'upper')): self.put(16, y, 10, 'minecraft:spruce_door', half=half, facing='north', hinge='left', open='false', powered='false') self.box((15, 6, 9, 17, 6, 9), 'minecraft:spruce_log', axis='x') for x in (14, 18): self.put(x, 5, 9, 'minecraft:spruce_fence') self.put(x, 6, 9, 'minecraft:lantern', hanging='false') self.put(x, 4, 9, 'minecraft:stone_bricks') # Backed ladder shaft, with two clear blocks above every landing. self.box((11, 4, 27, 11, 28, 27), 'minecraft:spruce_planks') for y in range(4, 27): self.put(11, y, 26, 'minecraft:ladder', facing='north') # Furnish each room with an intentionally clear central circulation aisle. for floor in (3, 10, 17, 24): self.room(12 if floor == 24 else 9, floor, 13 if floor == 24 else 12) for floor in (3, 10): self.room(26, floor, 14) # Living and dining furniture. for x in range(16, 21): self.put(x, 11, 23, 'minecraft:spruce_stairs', facing='south') self.box((16, 11, 18, 19, 11, 19), 'minecraft:spruce_planks') for x in (16, 19): self.put(x, 12, 18, 'minecraft:yellow_carpet') self.put(17, 12, 19, 'minecraft:candle', candles='3', lit='true') # Bedroom dais, complete green bed, cabinets and patterned curtains. self.box((16, 18, 22, 21, 18, 25), 'minecraft:spruce_planks') for x in range(16, 22): self.put(x, 18, 21, 'minecraft:spruce_stairs', facing='south') self.put(18, 19, 23, 'minecraft:green_bed', facing='south', part='foot', occupied='false') self.put(18, 19, 24, 'minecraft:green_bed', facing='south', part='head', occupied='false') for x in (16, 21): self.put(x, 19, 24, 'minecraft:barrel', facing='up') self.put(x, 20, 24, 'minecraft:lantern', hanging='false') for x in (11, 14): self.put(x, 21, 11, 'minecraft:green_wall_banner', facing='south') self.tile_entities.append(Compound({'id': String('minecraft:banner'), 'x': Int(x), 'y': Int(21), 'z': Int(11), 'patterns': NBTList[Compound]([Compound({'pattern': String('minecraft:stripe_center'), 'color': String('yellow')}), Compound({'pattern': String('minecraft:stripe_bottom'), 'color': String('white')})])})) for x in (21, 22): self.put(x, 21, 27, 'minecraft:barrel', facing='north') self.box((21, 25, 20, 22, 27, 20), 'minecraft:bookshelf') self.put(18, 25, 20, 'minecraft:lectern', facing='north', has_book='false') # Blacksmith canopy and lit forge with solid chimney. for x in (26, 36): for z in (6, 10): self.box((x, 4, z, x, 8, z), 'minecraft:spruce_log', axis='y') self.put(x, 4, z, 'minecraft:stone_bricks') for z in range(5, 12): self.texture((25, 9 + (z - 5) // 3, z, 37, 9 + (z - 5) // 3, z), roof) self.texture((32, 4, 9, 34, 5, 11), stone) self.put(33, 4, 8, 'minecraft:stone_bricks') self.put(33, 5, 8, 'minecraft:blast_furnace', facing='north', lit='true') self.put(33, 5, 9, 'minecraft:magma_block') self.put(33, 6, 9, 'minecraft:campfire', lit='true', signal_fire='false', waterlogged='false', facing='north') self.texture((32, 7, 10, 34, 24, 11), stone) self.box((32, 25, 10, 34, 25, 11), 'minecraft:stone_brick_slab', type='bottom') self.put(29, 4, 8, 'minecraft:anvil', facing='east') self.put(27, 4, 10, 'minecraft:barrel', facing='north') self.put(28, 4, 10, 'minecraft:chest', facing='north', type='single') self.put(27, 5, 10, 'minecraft:lantern', hanging='false') # Terrace balustrades and stonework vines. for x in list(range(6, 14)) + list(range(23, 39)): if x in (26, 36): continue self.put(x, 4, 5, 'minecraft:stone_brick_wall') for y in range(4, 9): for z in range(21, 25): if self.rng.random() < .75: self.put(7, y, z, 'minecraft:vine', east='true') self.pine(3, 23, 15) self.pine(40, 28, 19) self.pine(40, 7, 12) for x, z in ((4, 7), (5, 13), (40, 17), (30, 32), (13, 32), (3, 30)): self.put(x, 3, z, 'minecraft:fern') return self def window(self, x, y, z, facing): """Insert framed sealed glazing and shutters on a facade.""" dx, dz = (1, 0) if facing in ('north', 'south') else (0, 1) ox, oz = {'north': (0, -1), 'south': (0, 1), 'east': (1, 0), 'west': (-1, 0)}[facing] for a in range(2): for b in range(3): p = (x + dx * a, y + b, z + dz * a) self.put(*p, 'minecraft:glass') self.windows.append(p) for a in (-1, 2): for b in range(3): self.put(x + dx * a, y + b, z + dz * a, 'minecraft:dark_oak_log', axis='y') self.put(x + dx * a + ox, y + b, z + dz * a + oz, 'minecraft:spruce_trapdoor', facing=facing, open='true', half='bottom') for a in range(-1, 3): self.put(x + dx * a, y - 1, z + dz * a, 'minecraft:spruce_planks') self.put(x + dx * a, y + 3, z + dz * a, 'minecraft:dark_oak_log', axis='x' if dx else 'z') def room(self, x, f, z): """Add storage, seats, textiles, light and wall display to one room.""" self.put(x, f + 1, z, 'minecraft:barrel', facing='south') self.put(x + 1, f + 1, z, 'minecraft:chest', facing='south', type='single') self.put(x, f + 2, z, 'minecraft:lantern', hanging='false') self.put(x + 3, f + 1, z, 'minecraft:bookshelf') self.put(x + 3, f + 2, z, 'minecraft:potted_spruce_sapling') self.put(x + 4, f + 1, z, 'minecraft:spruce_planks') self.put(x + 4, f + 2, z, 'minecraft:candle', candles='2', lit='true') self.put(x + 3, f + 1, z + 3, 'minecraft:spruce_stairs', facing='north') self.box((x + 4, f + 1, z + 3, x + 6, f + 1, z + 5), 'minecraft:green_carpet') self.put(x + 6, f + 1, z, 'minecraft:crafting_table') # Small backed utility ladder in each room also provides hanging tool storage. self.put(x + 6, f + 2, z, 'minecraft:spruce_planks') self.put(x + 6, f + 2, z + 1, 'minecraft:ladder', facing='south') self.entities.append(Compound({'id': String('minecraft:item_frame'), 'Pos': NBTList[Double]([Double(x + 3.5), Double(f + 1.5), Double(z + 1.03125)]), 'Facing': Byte(3), 'TileX': Int(x + 3), 'TileY': Int(f + 1), 'TileZ': Int(z + 1), 'Item': Compound({'id': String('minecraft:iron_axe'), 'count': Int(1)}), 'ItemRotation': Byte(0)})) def pine(self, x, z, height): """Place a trunk, stepped log boughs and layered persistent needles.""" self.box((x, 3, z, x, height + 3, z), 'minecraft:spruce_log', axis='y') for y in range(6, height + 3, 3): radius = max(1, 4 - (y - 6) // 4) for dx in range(-radius, radius + 1): for dz in range(-radius, radius + 1): if abs(dx) + abs(dz) > radius + 1 or (dx == 0 and dz == 0): continue if self.inside(x + dx, y, z + dz): self.put(x + dx, y, z + dz, 'minecraft:spruce_leaves', persistent='true', distance='1') if abs(dx) + abs(dz) <= radius: self.put(x + dx, y + 1, z + dz, 'minecraft:spruce_leaves', persistent='true', distance='1') for dx, dz in ((1, 0), (-1, 0), (0, 1), (0, -1)): self.put(x + dx, y, z + dz, 'minecraft:spruce_log', axis='x' if dx else 'z') for y in range(height + 1, height + 4): for dx, dz in ((1, 0), (-1, 0), (0, 1), (0, -1)): self.put(x + dx, y, z + dz, 'minecraft:spruce_leaves', persistent='true', distance='1') self.put(x, height + 4, z, 'minecraft:spruce_leaves', persistent='true', distance='1') def export(self, path: Path) -> Path: """Write the schematic so that two runs produce identical bytes. Args: path (Path): Destination .litematic path. Returns: Path: The path written. """ schematic = self.canvas.to_litematica( name=CONFIG["name"], author=CONFIG["author"], description=CONFIG["description"], minecraft_data_version=CONFIG["data_version"], ) # The metadata otherwise records the current wall clock, which changes the bytes on every run. schematic.metadata.time_created = 0 schematic.metadata.time_modified = 0 path.parent.mkdir(parents=True, exist_ok=True) nbt = schematic.write_to_nbt() region = next(iter(nbt["Regions"].values())) region["TileEntities"] = NBTList[Compound](self.tile_entities) region["Entities"] = NBTList[Compound](self.entities) NBTFile(nbt).save(path) return path def verify(self, path: Path) -> Dict[str, object]: """Reload the written file and confirm it matches what was placed. Args: path (Path): Schematic to reload. Returns: Dict[str, object]: Size, block count and palette size of the reloaded file. Raises: AssertionError: When a reloaded cell differs from what was placed. """ loaded = load_schematic(path) size_y, size_z, size_x = loaded.size_yzx assert (size_x, size_y, size_z) == (self.size_x, self.size_y, self.size_z), "size changed on reload" ids = loaded.read_flat(0, loaded.volume).reshape(loaded.size_yzx) for (x, y, z), state in self.placed.items(): assert canonical(loaded.palette[int(ids[y, z, x])]) == canonical(state), f"cell (x={x}, y={y}, z={z}) changed on reload" return { "size_xyz": [size_x, size_y, size_z], "placed_blocks": len(self.placed), "palette_states": len(loaded.palette), } def main() -> None: """Generate the build, export it, and verify the exported file.""" parser = argparse.ArgumentParser(description="Generate a Minecraft schematic.") parser.add_argument("--output", type=Path, default=Path(CONFIG["output"])) parser.add_argument("--seed", type=int, default=CONFIG["seed"]) args = parser.parse_args() build = Build(seed=args.seed).build() path = build.export(args.output) report = build.verify(path) print(f"wrote {path}: {report}") if __name__ == "__main__": main()

// Starting point for rendering a build. Copy into the workspace and edit VIEWS. // Lighting, camera framing and background are already tuned; run it as is to get a first look. import fs from 'node:fs'; import path from 'node:path'; import { createRequire } from 'node:module'; import { createRenderScene, renderLitematicWithMetadata } from '/work/generator/MCRender/src/headless/index.ts'; const RENDER_ROOT = '/work/generator/MCRender'; const requireRenderer = createRequire(path.join(RENDER_ROOT, 'package.json')); const { PNG } = requireRenderer('pngjs'); // vite-node passes script arguments after a bare "--", so drop it before reading them. const argv = process.argv.slice(2).filter(entry => entry !== '--'); const INPUT = argv[0] ?? 'output.litematic'; const OUT_DIR = argv[1] ?? 'previews'; const SIZE = Number(process.env.RENDER_SIZE ?? 512); // Tuned defaults. Ambient near 0.72 keeps shaded faces readable, and a light direction with a // dominant +Y term plus a small +X/+Z tilt separates roof, wall and ground planes. const LIGHT_DIRECTION = [0.08, 0.28, 0.15]; const AMBIENT = 0.72; const BACKGROUND = [47, 52, 59, 255]; const VIEWS = [ { name: 'front', azimuth: 210, elevation: 18, radius: 3.3 }, { name: 'rear', azimuth: 35, elevation: 22, radius: 3.3 }, { name: 'side', azimuth: 120, elevation: 14, radius: 3.3 }, { name: 'top', azimuth: 210, elevation: 62, radius: 3.4 }, ]; // Resolve every path while the working directory is still the caller's. const absoluteInput = path.resolve(INPUT); const absoluteOutDir = path.resolve(OUT_DIR); fs.mkdirSync(absoluteOutDir, { recursive: true }); // The renderer looks for its resource cache relative to the working directory, so move there first, // and only then create the scene. process.chdir(RENDER_ROOT); const scene = createRenderScene({ width: SIZE, height: SIZE }); for (const view of VIEWS) { const result = renderLitematicWithMetadata(absoluteInput, { width: SIZE, height: SIZE, fov_deg: 30, radius: view.radius, nRandomAzimuths: 0, azimuthInit: 0, elevationInit: 0, azimuthsDeltas: [view.azimuth], elevationsDeltas: [view.elevation], ambientIntensities: [AMBIENT], lightDirections: [LIGHT_DIRECTION], mirror: [false], layout: [[0]], limit: 512, seed: 0, opaque: false, }, scene); // Flatten onto an opaque background so shaded faces keep their contrast. for (let i = 0; i < result.png.data.length; i += 4) { const alpha = result.png.data[i + 3] / 255; for (let channel = 0; channel < 3; channel++) { result.png.data[i + channel] = Math.round(result.png.data[i + channel] * alpha + BACKGROUND[channel] * (1 - alpha)); } result.png.data[i + 3] = 255; } const target = path.join(absoluteOutDir, `${view.name}.png`); fs.writeFileSync(target, PNG.sync.write(result.png)); console.log(`wrote ${target} (${SIZE}x${SIZE}, azimuth ${view.azimuth}, elevation ${view.elevation})`); }

# Structural checks against the exported schematic and its entity data. import sys from pathlib import Path from collections import deque import pytest sys.path.insert(0, str(Path(__file__).resolve().parents[1])) from generate import Build, canonical from mcio.schematic import load_schematic from mcio.nbt.nbt import load ROOT = Path(__file__).resolve().parents[1] @pytest.fixture(scope='module') def data(): s = load_schematic(ROOT / 'output.litematic') ids = s.read_flat(0, s.volume).reshape(s.size_yzx) return {(x, y, z): s.palette[int(ids[y, z, x])] for y in range(40) for z in range(35) for x in range(45)} def base(s): return s.split('[')[0].split(':')[-1] def props(s): return dict(v.split('=') for v in s.partition('[')[2].rstrip(']').split(',') if '=' in v) def test_roundtrip_and_determinism(tmp_path, data): b = Build().build() b.verify(ROOT / 'output.litematic') a = b.export(tmp_path / 'a.litematic') c = Build().build().export(tmp_path / 'b.litematic') assert a.read_bytes() == c.read_bytes() == (ROOT / 'output.litematic').read_bytes() n = load(a) assert int(n['MinecraftDataVersion']) == 3955 assert len(n['Regions']) == 1 def test_doors_beds(data): for (x, y, z), s in data.items(): p = props(s) if base(s).endswith('_door'): other = data[x, y + (1 if p['half'] == 'lower' else -1), z] q = props(other) assert base(other) == base(s) assert q['half'] != p['half'] assert (q['facing'], q['hinge']) == (p['facing'], p['hinge']) if base(s).endswith('_bed'): dx, dz = {'south': (0, 1), 'north': (0, -1), 'east': (1, 0), 'west': (-1, 0)}[p['facing']] sign = 1 if p['part'] == 'foot' else -1 other = data[x + dx * sign, y, z + dz * sign] assert base(other) == base(s) assert props(other)['facing'] == p['facing'] assert props(other)['part'] != p['part'] def test_weather_envelope(data): # Flood exterior air from every boundary; glazing and closed doors seal the shell. air = {p for p, s in data.items() if base(s) == 'air'} seen = {p for p in air if p[0] in (0, 44) or p[1] in (0, 39) or p[2] in (0, 34)} queue = deque(seen) while queue: x, y, z = queue.popleft() for dx, dy, dz in ((1, 0, 0), (-1, 0, 0), (0, 1, 0), (0, -1, 0), (0, 0, 1), (0, 0, -1)): q = (x + dx, y + dy, z + dz) if q in air and q not in seen: seen.add(q) queue.append(q) leaked = [p for p in seen if (9 <= p[0] <= 23 and 11 <= p[2] <= 27 and 4 <= p[1] <= 25) or (25 <= p[0] <= 35 and 13 <= p[2] <= 26 and 4 <= p[1] <= 16)] assert not leaked, leaked[:15] def test_reachable_rooms_with_headroom(data): def clear(p): s = base(data.get(p, 'minecraft:stone')) return s in ('air', 'ladder') or s.endswith('_carpet') or s.endswith('_door') def stand(p): x, y, z = p return clear(p) and clear((x, y + 1, z)) and (not clear((x, y - 1, z)) or base(data.get(p, '')) == 'ladder') start = (16, 4, 9) seen = {start} queue = deque(seen) while queue: x, y, z = queue.popleft() candidates = [(x + dx, y + dy, z + dz) for dx, dz in ((1, 0), (-1, 0), (0, 1), (0, -1)) for dy in (-1, 0, 1)] if base(data[x, y, z]) == 'ladder': candidates += [(x, y + 1, z), (x, y - 1, z)] for q in candidates: if q not in seen and stand(q): # Steps need enough head clearance over their higher floor. if q[1] > y and not clear((x, y + 2, z)): continue seen.add(q) queue.append(q) for p in [(16, 4, 15), (16, 11, 15), (16, 18, 15), (16, 25, 18), (30, 4, 21), (30, 11, 21), (18, 19, 22)]: assert p in seen, p def test_windows_and_decorations(data): b = Build().build() for p in b.windows: assert base(data[p]) == 'glass', p for (x, y, z), s in data.items(): name = base(s) if name in ('lantern', 'candle', 'potted_spruce_sapling') or name.endswith('_carpet') or name.endswith('_bed'): assert base(data[x, y - 1, z]) not in ('air', 'ladder', 'vine'), (x, y, z, name) if name == 'ladder' or name.endswith('_wall_banner'): dx, dz = {'north': (0, 1), 'south': (0, -1), 'east': (-1, 0), 'west': (1, 0)}[props(s)['facing']] assert base(data[x + dx, y, z + dz]) not in ('air', 'ladder'), (x, y, z) for f, x, z in [(3, 9, 12), (10, 9, 12), (17, 9, 12), (24, 12, 13), (3, 26, 14), (10, 26, 14)]: assert base(data[x, f + 2, z]) == 'lantern' region = next(iter(load(ROOT / 'output.litematic')['Regions'].values())) assert len(region['Entities']) == 6 for e in region['Entities']: x, y, z = (int(e[k]) for k in ('TileX', 'TileY', 'TileZ')) assert base(data[x, y, z - 1]) == 'bookshelf' assert str(e['Item']['id']) == 'minecraft:iron_axe' assert len(region['TileEntities']) == 2 for e in region['TileEntities']: assert len(e['patterns']) == 2 def test_valid_vanilla_states(data): import json schema = json.loads(Path('/work/generator/MCRender/resources/1.21.1-blocks.json').read_text()) for s in set(data.values()): assert base(s) in schema allowed = schema[base(s)][0] for k, v in props(s).items(): assert k in allowed and v in allowed[k], s def test_forge_and_openings(data): assert props(data[33, 5, 8])['lit'] == 'true' assert props(data[33, 6, 9])['lit'] == 'true' assert base(data[33, 4, 8]) == 'stone_bricks' assert base(data[29, 4, 8]) == 'anvil' for y in (4, 5): for z in (9, 11): assert base(data[16, y, z]) == 'air' for f in (3, 10): for y in (f + 1, f + 2): for x in (23, 24, 25): assert base(data[x, y, 20]) == 'air'

# Starting point for a Minecraft build generator. Copy into the workspace and fill in build(). # Everything that has to be right for the harness is already right here: bounds checked placement, # one seeded random source, and a byte reproducible export. from __future__ import annotations import argparse import random import sys from pathlib import Path from typing import Dict, Iterable, Optional, Tuple sys.path.insert(0, "/work/generator/MCIO") from mcio.schematic import load_schematic # noqa: E402 from mcio.sketch import LitematicCanvas, Material, parse_blockstate # noqa: E402 CONFIG = { "seed": 20260923, "size_xyz": (45, 40, 35), # width X, height Y, depth Z "minecraft_version": "1.21.1", "data_version": 3955, "output": "output.litematic", "name": "Amberstone Lodge", "author": "generator", "description": "Four-storey timber lodge, cross-gabled smithy, terrace and pines. Front faces north (-Z).", } Position = Tuple[int, int, int] class Build: """Hold a block volume and write it out as a Litematica schematic.""" def __init__(self, size_xyz: Tuple[int, int, int] = CONFIG["size_xyz"], seed: int = CONFIG["seed"]) -> None: """Create an empty volume with one seeded random source. Args: size_xyz (Tuple[int, int, int]): Volume size as width X, height Y, depth Z. seed (int): Seed for every random decision in this build. """ self.size_x, self.size_y, self.size_z = size_xyz self.rng = random.Random(seed) self.canvas = LitematicCanvas((self.size_y, self.size_z, self.size_x)) self.placed: Dict[Position, str] = {} def inside(self, x: int, y: int, z: int) -> bool: """Report whether a coordinate is inside the volume. Args: x (int): Width coordinate. y (int): Height coordinate. z (int): Depth coordinate. Returns: bool: True when every axis is within range. """ return 0 <= x < self.size_x and 0 <= y < self.size_y and 0 <= z < self.size_z def put(self, x: int, y: int, z: int, block: str | Material, **properties: str) -> None: """Place one block, in XYZ order, with an immediate bounds check. Args: x (int): Width coordinate. y (int): Height coordinate. z (int): Depth coordinate. block (str | Material): Namespaced block name, a full blockstate string, or a Material. **properties: Blockstate properties such as facing or half. Raises: AssertionError: When the coordinate is outside the volume, naming the coordinate. """ assert self.inside(x, y, z), f"out of bounds: (x={x}, y={y}, z={z}) in {self.size_x}x{self.size_y}x{self.size_z}" material = self.material(block, **properties) if isinstance(block, str) else block self.canvas.block((y, z, x), material) self.placed[(x, y, z)] = material.blockstate def material(self, name: str, **properties: str) -> Material: """Build a Material from a block name and its properties. Args: name (str): Namespaced block name, or a full blockstate string. **properties: Blockstate properties. Returns: Material: Material ready for placement. """ if "[" in name: return parse_blockstate(name) return self.canvas.material(name, **dict(sorted(properties.items()))) def box(self, bounds: Tuple[int, int, int, int, int, int], block: str | Material, **properties: str) -> None: """Fill an inclusive box. Args: bounds (Tuple[int, int, int, int, int, int]): x0, y0, z0, x1, y1, z1, inclusive on both ends. block (str | Material): Block to place. **properties: Blockstate properties. """ x0, y0, z0, x1, y1, z1 = bounds for x in range(min(x0, x1), max(x0, x1) + 1): for y in range(min(y0, y1), max(y0, y1) + 1): for z in range(min(z0, z1), max(z0, z1) + 1): self.put(x, y, z, block, **properties) def shell(self, bounds: Tuple[int, int, int, int, int, int], block: str | Material, **properties: str) -> None: """Fill only the faces of a box, leaving the inside empty. Args: bounds (Tuple[int, int, int, int, int, int]): x0, y0, z0, x1, y1, z1, inclusive. block (str | Material): Block to place. **properties: Blockstate properties. """ x0, y0, z0, x1, y1, z1 = bounds for x in range(min(x0, x1), max(x0, x1) + 1): for y in range(min(y0, y1), max(y0, y1) + 1): for z in range(min(z0, z1), max(z0, z1) + 1): on_face = x in (x0, x1) or y in (y0, y1) or z in (z0, z1) if on_face: self.put(x, y, z, block, **properties) def texture(self, bounds: Tuple[int, int, int, int, int, int], palette: Iterable[str]) -> None: """Fill a box with a weighted mix of related blocks, so the surface is not flat. Args: bounds (Tuple[int, int, int, int, int, int]): x0, y0, z0, x1, y1, z1, inclusive. palette (Iterable[str]): Block names. Repeat a name to make it more common. """ choices = list(palette) x0, y0, z0, x1, y1, z1 = bounds for x in range(min(x0, x1), max(x0, x1) + 1): for y in range(min(y0, y1), max(y0, y1) + 1): for z in range(min(z0, z1), max(z0, z1) + 1): self.put(x, y, z, self.rng.choice(choices)) def get(self, x: int, y: int, z: int) -> Optional[str]: """Read back what was placed at a coordinate. Args: x (int): Width coordinate. y (int): Height coordinate. z (int): Depth coordinate. Returns: Optional[str]: Blockstate string, or None when the cell is empty. """ return self.placed.get((x, y, z)) def p(self, x, y, z, name, **props): """Place a vanilla block using a short name.""" self.put(x, y, z, 'minecraft:' + name, **props) def fill(self, bounds, name, **props): """Fill a box using a short block name.""" self.box(bounds, 'minecraft:' + name, **props) def mix(self, bounds, names): """Apply a seeded material mixture.""" self.texture(bounds, ['minecraft:' + name for name in names]) def door(self, x, y, z, facing='north'): """Place a complete closed door.""" for half, dy in [('lower', 0), ('upper', 1)]: self.p(x, y + dy, z, 'spruce_door', half=half, facing=facing, hinge='left', open='false', powered='false') def window(self, x, y, z, axis='x', width=3, height=3, outward=-1): """Insert glazing with timber casing and supported exterior shutters.""" for i in range(-1, width + 1): for j in range(-1, height + 1): px, pz = (x + i, z) if axis == 'x' else (x, z + i) edge = i in (-1, width) or j in (-1, height) self.p(px, y + j, pz, 'dark_oak_log' if edge else 'glass', **({'axis': 'y'} if edge else {})) if not edge: self.windows.append((px, y + j, pz)) for i in (-1, width): for j in range(height): px, pz = (x + i, z + outward) if axis == 'x' else (x + outward, z + i) self.p(px, y + j, pz, 'spruce_trapdoor', facing=('north' if outward == -1 else 'south') if axis == 'x' else ('west' if outward == -1 else 'east'), half='bottom', open='true', powered='false', waterlogged='false') def kit(self, x, f, z, back_z, item): """Furnish a room with storage, seating, a rug, display and task lights.""" self.p(x, f + 1, z, 'barrel', facing='south', open='false') self.p(x + 1, f + 1, z, 'chest', facing='south', type='single', waterlogged='false') self.p(x + 2, f + 1, z, 'crafting_table') self.p(x + 2, f + 2, z, 'potted_fern') self.p(x, f + 2, z, 'lantern', hanging='false', waterlogged='false') self.p(x + 3, f + 1, z, 'spruce_planks') self.p(x + 3, f + 2, z, 'candle', candles='3', lit='true', waterlogged='false') self.p(x + 3, f + 1, z - 2, 'spruce_stairs', facing='north', half='bottom', shape='straight', waterlogged='false') for dx in range(4): for dz in range(3): self.p(x + dx, f + 1, z - 5 + dz, 'green_carpet' if (dx + dz) % 3 else 'brown_carpet') # A short library ladder is useful even in rooms without a floor transition. self.fill((x + 5, f + 1, back_z - 1, x + 5, f + 3, back_z - 1), 'bookshelf') self.fill((x + 5, f + 1, back_z - 2, x + 5, f + 3, back_z - 2), 'ladder', facing='north', waterlogged='false') self.frames.append((x + 1, f + 3, back_z - 1, item)) def pine(self, x, z, height): """Build a pine with a tapered crown and horizontal log branches.""" self.fill((x, 1, z, x, height, z), 'spruce_log', axis='y') for y, radius in [(height - 9, 3), (height - 6, 3), (height - 3, 2), (height - 1, 1)]: for dy in (0, 1): r = max(1, radius - dy) for dx in range(-r, r + 1): for dz in range(-r, r + 1): if abs(dx) + abs(dz) <= r + 1 and (dx or dz): self.p(x + dx, y + dy, z + dz, 'spruce_leaves', persistent='true', distance='1', waterlogged='false') for dx, dz, axis in [(1, 0, 'x'), (-1, 0, 'x'), (0, 1, 'z'), (0, -1, 'z')]: self.p(x + dx, y, z + dz, 'spruce_log', axis=axis) self.p(x, height + 1, z, 'spruce_leaves', persistent='true', distance='1', waterlogged='false') def build(self) -> 'Build': """Build Amberstone Lodge with four connected furnished levels.""" self.windows, self.frames, self.banner_positions = [], [], [] stone = ['stone_bricks'] * 7 + ['andesite'] * 2 + ['mossy_stone_bricks'] plaster = ['smooth_sandstone'] * 8 + ['sandstone', 'white_terracotta'] timber = ['spruce_planks'] * 8 + ['dark_oak_planks', 'oak_planks'] roof = ['deepslate_tiles'] * 8 + ['deepslate_bricks', 'polished_deepslate'] self.mix((0, 0, 0, 44, 0, 34), ['grass_block'] * 12 + ['podzol', 'coarse_dirt']) # The terrace, foundation and entrance stair share an unbroken stone base. self.mix((7, 1, 9, 38, 3, 29), stone) self.mix((10, 1, 5, 28, 3, 9), stone) for y, z in [(1, 2), (2, 3), (3, 4)]: self.fill((14, 1, z, 18, y, z), 'stone_bricks') for x in range(14, 19): self.p(x, y, z, 'stone_brick_stairs', facing='south', half='bottom', shape='straight', waterlogged='false') for z in range(0, 5): for x in range(12 + z // 2, 19 + z // 2): if self.rng.random() > .16: self.p(x, 0, z, self.rng.choice(['gravel', 'cobblestone', 'andesite'])) for x in (10, 28): self.fill((x, 4, 5, x, 4, 8), 'stone_brick_wall', up='true', north='low', south='low', east='none', west='none', waterlogged='false') self.p(x, 5, 5, 'lantern', hanging='false', waterlogged='false') # Main wing shell, full floors, and the adjoining lower cross wing. for bounds in [(8, 4, 10, 24, 24, 28), (24, 4, 12, 37, 17, 28)]: x0, y0, z0, x1, y1, z1 = bounds for y in range(y0, y1 + 1): palette = stone if y < 10 else plaster self.mix((x0, y, z0, x1, y, z0), palette) self.mix((x0, y, z1, x1, y, z1), palette) self.mix((x0, y, z0, x0, y, z1), palette) self.mix((x1, y, z0, x1, y, z1), palette) for f in (3, 10, 17, 24): self.mix((9, f, 11, 23, f, 27), timber) for f in (3, 10): self.mix((25, f, 13, 36, f, 27), timber) for f in (10, 17, 24): self.fill((8, f, 10, 24, f, 10), 'dark_oak_log', axis='x') self.fill((8, f, 28, 24, f, 28), 'dark_oak_log', axis='x') self.fill((8, f, 10, 8, f, 28), 'dark_oak_log', axis='z') self.fill((24, f, 10, 24, f, 28), 'dark_oak_log', axis='z') for x in (8, 16, 24): for z in (10, 28): self.fill((x, 4, z, x, 24, z), 'dark_oak_log', axis='y') for z in (16, 22): self.fill((8, 10, z, 8, 24, z), 'dark_oak_log', axis='y') for x in (24, 30, 37): for z in (12, 28): self.fill((x, 10, z, x, 17, z), 'dark_oak_log', axis='y') for y in (10, 17): self.fill((24, y, 12, 37, y, 12), 'dark_oak_log', axis='x') self.fill((24, y, 28, 37, y, 28), 'dark_oak_log', axis='x') self.fill((37, y, 12, 37, y, 28), 'dark_oak_log', axis='z') # Gable infill, with a center king post and alternating diagonal braces. for x in range(8, 25): top = 38 - ((abs(x - 16) * 3 + 1) // 2) for z in (10, 28): self.mix((x, 25, z, x, top, z), plaster) if x == 16: self.fill((x, 25, z, x, top, z), 'dark_oak_log', axis='y') else: for y in (25 + abs(x - 16), 33 - abs(x - 16)): if 25 <= y <= top: self.p(x, y, z, 'dark_oak_log', axis='y') # Full-block roof underlay seals every riser of the steep tiled roof. for x in range(6, 27): y = 38 - ((abs(x - 16) * 3 + 1) // 2) self.mix((x, y, 9, x, y + 1, 29), roof) for z in (8, 30): self.fill((x, y, z, x, y + 1, z), 'polished_deepslate') if x != 16: self.fill((x, y + 2, 8, x, y + 2, 30), 'deepslate_tile_stairs', facing='east' if x < 16 else 'west', half='bottom', shape='straight', waterlogged='false') # Cross gable extends into the main roof, preventing a crack at the valley. for z in range(10, 31): y = 27 - abs(z - 20) self.mix((25, y, z, 39, y, z), roof) self.fill((25, y + 1, z, 39, y + 1, z), 'deepslate_tile_stairs', facing='south' if z < 20 else 'north', half='bottom', shape='straight', waterlogged='false') if 12 <= z <= 28: for x in (24, 37): self.mix((x, 18, z, x, y, z), plaster) if z == 20 or z in (14, 26): self.fill((x, 18, z, x, y, z), 'dark_oak_log', axis='y') self.p(40, y, z, 'polished_deepslate') # Preserve the main roof underlay where the cross roof intersects it. for x in range(6, 27): y = 38 - ((abs(x - 16) * 3 + 1) // 2) self.mix((x, y, 9, x, y + 1, 29), roof) # At valleys, a stair must never replace another roof's full support block. for (x, y, z), state in list(self.placed.items()): if 'deepslate_tile_stairs' in state and 'stairs' in (self.get(x, y - 1, z) or ''): self.p(x, y - 1, z, 'deepslate_tiles') # Reopen communicating doors after all overlapping wall and roof operations. for f in (3, 10): self.fill((24, f + 1, 18, 24, f + 3, 20), 'air') self.door(16, 4, 10) self.door(32, 4, 12) self.fill((15, 6, 9, 17, 6, 9), 'dark_oak_log', axis='x') self.fill((14, 7, 8, 18, 7, 9), 'deepslate_tile_slab', type='bottom', waterlogged='false') for x in (14, 18): self.p(x, 6, 9, 'lantern', hanging='true', waterlogged='false') # Windows are cut last, so no roof or trim can occupy the glass cells. for f in (3, 10, 17): for x in (11, 19): self.window(x, f + 2, 10, height=3) for z in (13, 23): self.window(8, f + 2, z, axis='z', width=2, height=3) for f in (3, 10, 17): self.window(18, f + 2, 28, width=3, height=3, outward=1) self.window(14, 28, 28, width=5, height=3, outward=1) self.window(27, 12, 28, width=3, height=3, outward=1) self.window(14, 28, 10, width=5, height=3) self.window(26, 12, 12, width=2, height=3) self.window(33, 12, 12, width=2, height=3) # Vertical circulation is a straight, backed ladder with open floor hatches. self.fill((22, 4, 27, 22, 27, 27), 'ladder', facing='north', waterlogged='false') for f in (3, 10, 17, 24): self.kit(10, f, 25, 28, ['iron_axe', 'bread', 'emerald', 'book'][(f - 3) // 7]) for f in (3, 10): self.kit(27, f, 25, 28, 'iron_ingot' if f == 3 else 'apple') # Entrance workshop benches and organized tool stores. self.fill((10, 4, 13, 13, 4, 13), 'barrel', facing='south', open='false') self.p(11, 5, 13, 'stonecutter', facing='south') self.p(13, 5, 13, 'lantern', hanging='false', waterlogged='false') self.p(20, 4, 14, 'smithing_table') self.p(21, 4, 14, 'anvil', facing='south') # Living floor: upholstered settle, large dining table, and sideboard. self.fill((11, 11, 13, 13, 11, 13), 'spruce_stairs', facing='south', half='bottom', shape='straight', waterlogged='false') self.fill((17, 11, 16, 20, 11, 18), 'spruce_planks') self.p(18, 12, 17, 'potted_poppy') self.p(20, 12, 17, 'candle', candles='2', lit='true', waterlogged='false') for x in (17, 19): for z, facing in ((15, 'south'), (19, 'north')): self.p(x, 11, z, 'spruce_stairs', facing=facing, half='bottom', shape='straight', waterlogged='false') self.fill((34, 11, 14, 35, 11, 16), 'smoker', facing='west', lit='false') self.p(34, 12, 15, 'lantern', hanging='false', waterlogged='false') # Bedroom: green bed on a raised dais, curtains, and wall-mounted cabinets. self.fill((10, 18, 13, 14, 18, 17), 'spruce_planks') self.fill((11, 18, 18, 13, 18, 18), 'spruce_stairs', facing='north', half='bottom', shape='straight', waterlogged='false') for part, z in [('foot', 14), ('head', 15)]: self.p(12, 19, z, 'green_bed', part=part, facing='south', occupied='false') self.p(10, 19, 15, 'barrel', facing='east', open='false') self.p(10, 20, 15, 'lantern', hanging='false', waterlogged='false') for x in (18, 22): self.p(x, 21, 11, 'green_wall_banner', facing='south') self.banner_positions.append((x, 21, 11)) self.fill((23, 20, 22, 23, 21, 24), 'barrel', facing='west', open='false') self.fill((23, 19, 22, 23, 19, 24), 'dark_oak_planks') self.fill((23, 18, 22, 23, 18, 24), 'dark_oak_planks') # Attic study: central writing desk and low shelves below the slopes. self.fill((14, 25, 14, 18, 25, 15), 'dark_oak_planks') self.p(14, 26, 14, 'lantern', hanging='false', waterlogged='false') self.p(18, 26, 14, 'potted_dead_bush') self.p(16, 26, 15, 'lectern', facing='south', has_book='false', powered='false') self.p(16, 25, 17, 'spruce_stairs', facing='north', half='bottom', shape='straight', waterlogged='false') self.fill((10, 25, 16, 10, 27, 18), 'bookshelf') self.fill((21, 25, 16, 21, 26, 18), 'bookshelf') # Open-sided smithy porch on the lower wing, linked directly to its door. self.mix((29, 1, 5, 39, 3, 11), stone) for x in (29, 39): for z in (5, 11): self.fill((x, 4, z, x, 8, z), 'spruce_log', axis='y') for z in range(4, 12): y = 8 + (z - 4) // 3 self.fill((28, y, z, 40, y, z), 'deepslate_tiles') self.fill((28, y + 1, z, 40, y + 1, z), 'deepslate_tile_slab', type='bottom', waterlogged='false') self.fill((29, 7, 5, 39, 7, 5), 'spruce_log', axis='x') self.mix((36, 4, 9, 38, 6, 11), ['bricks'] * 4 + ['granite', 'polished_granite']) self.p(37, 5, 8, 'blast_furnace', facing='north', lit='true') self.p(37, 4, 8, 'bricks') self.p(37, 6, 10, 'campfire', facing='north', lit='true', signal_fire='false', waterlogged='false') self.fill((36, 7, 9, 38, 19, 11), 'bricks') self.fill((37, 7, 10, 37, 20, 10), 'air') self.fill((36, 20, 9, 38, 20, 11), 'stone_bricks') self.p(37, 20, 10, 'iron_bars', north='true', south='true', east='true', west='true', waterlogged='false') self.p(34, 4, 7, 'anvil', facing='east') for x in (30, 31): self.p(x, 4, 10, 'barrel', facing='north', open='false') self.p(30, 5, 10, 'lantern', hanging='false', waterlogged='false') self.p(35, 4, 10, 'water_cauldron', level='3') self.p(29, 6, 5, 'lantern', hanging='true', waterlogged='false') # Wall greenery uses explicit attachments; planter flowers have soil support. for z in range(18, 22): for y in range(4, 8 - abs(z - 20)): self.p(7, y, z, 'vine', east='true', north='false', south='false', west='false', up='false') for x in (11, 12, 20, 21): self.p(x, 3, 8, 'moss_block') self.p(x, 4, 8, 'fern' if x % 2 else 'poppy') self.pine(3, 24, 19) self.pine(40, 30, 16) # Bedside and entrance routes are deliberately left open. return self def add_nbt(self, schematic): """Attach deterministic Java 1.21.1 banner patterns and item-frame entities.""" from mcio.nbt.tag import Compound, Int, Byte, Short, Float, Double, String, List as NBTList, IntArray root = schematic.write_to_nbt() region = root['Regions'][CONFIG['name']] tiles = [] for x, y, z in self.banner_positions: tiles.append(Compound({'id': String('minecraft:banner'), 'x': Int(x), 'y': Int(y), 'z': Int(z), 'patterns': NBTList[Compound]([Compound({'pattern': String('minecraft:stripe_left'), 'color': String('lime')}), Compound({'pattern': String('minecraft:stripe_center'), 'color': String('yellow')}), Compound({'pattern': String('minecraft:stripe_right'), 'color': String('lime')})])})) tiles.append(Compound({'id': String('minecraft:blast_furnace'), 'x': Int(37), 'y': Int(5), 'z': Int(8), 'BurnTime': Short(1600), 'CookTime': Short(0), 'CookTimeTotal': Short(100), 'Items': NBTList[Compound]([Compound({'Slot': Byte(0), 'id': String('minecraft:raw_iron'), 'count': Int(32)}), Compound({'Slot': Byte(1), 'id': String('minecraft:coal'), 'count': Int(32)})]), 'RecipesUsed': Compound({})})) entities = [] for index, (x, y, z, item) in enumerate(self.frames): entities.append(Compound({'id': String('minecraft:item_frame'), 'Pos': NBTList[Double]([Double(x + .5), Double(y + .5), Double(z + .96875)]), 'Motion': NBTList[Double]([Double(0), Double(0), Double(0)]), 'Rotation': NBTList[Float]([Float(180), Float(0)]), 'Facing': Byte(2), 'TileX': Int(x), 'TileY': Int(y), 'TileZ': Int(z), 'UUID': IntArray([20260923, 0, 0, index + 1]), 'Item': Compound({'id': String('minecraft:' + item), 'count': Int(1)}), 'ItemRotation': Byte(0), 'ItemDropChance': Float(1), 'Invisible': Byte(0), 'Fixed': Byte(0)})) region['TileEntities'] = NBTList[Compound](tiles) region['Entities'] = NBTList[Compound](entities) return root def export(self, path: Path) -> Path: """Write the schematic so that two runs produce identical bytes. Args: path (Path): Destination .litematic path. Returns: Path: The path written. """ schematic = self.canvas.to_litematica( name=CONFIG["name"], author=CONFIG["author"], description=CONFIG["description"], minecraft_data_version=CONFIG["data_version"], ) # The metadata otherwise records the current wall clock, which changes the bytes on every run. schematic.metadata.time_created = 0 schematic.metadata.time_modified = 0 path.parent.mkdir(parents=True, exist_ok=True) import gzip import io from mcio.nbt.nbt import File as NBTFile payload = io.BytesIO() NBTFile(self.add_nbt(schematic)).write(payload) path.write_bytes(gzip.compress(payload.getvalue(), mtime=0)) return path def verify(self, path: Path) -> Dict[str, object]: """Reload the written file and confirm it matches what was placed. Args: path (Path): Schematic to reload. Returns: Dict[str, object]: Size, block count and palette size of the reloaded file. Raises: AssertionError: When a reloaded cell differs from what was placed. """ loaded = load_schematic(path) size_y, size_z, size_x = loaded.size_yzx assert (size_x, size_y, size_z) == (self.size_x, self.size_y, self.size_z), "size changed on reload" ids = loaded.read_flat(0, loaded.volume).reshape(loaded.size_yzx) for (x, y, z), state in self.placed.items(): assert loaded.palette[int(ids[y, z, x])] == state, f"cell (x={x}, y={y}, z={z}) changed on reload" return { "size_xyz": [size_x, size_y, size_z], "placed_blocks": len(self.placed), "palette_states": len(loaded.palette), } def main() -> None: """Generate the build, export it, and verify the exported file.""" parser = argparse.ArgumentParser(description="Generate a Minecraft schematic.") parser.add_argument("--output", type=Path, default=Path(CONFIG["output"])) parser.add_argument("--seed", type=int, default=CONFIG["seed"]) args = parser.parse_args() build = Build(seed=args.seed).build() path = build.export(args.output) report = build.verify(path) print(f"wrote {path}: {report}") if __name__ == "__main__": main()

// Starting point for rendering a build. Copy into the workspace and edit VIEWS. // Lighting, camera framing and background are already tuned; run it as is to get a first look. import fs from 'node:fs'; import path from 'node:path'; import { createRequire } from 'node:module'; import { createRenderScene, renderLitematicWithMetadata } from '/work/generator/MCRender/src/headless/index.ts'; const RENDER_ROOT = '/work/generator/MCRender'; const requireRenderer = createRequire(path.join(RENDER_ROOT, 'package.json')); const { PNG } = requireRenderer('pngjs'); // vite-node passes script arguments after a bare "--", so drop it before reading them. const argv = process.argv.slice(2).filter(entry => entry !== '--'); const INPUT = argv[0] ?? 'output.litematic'; const OUT_DIR = argv[1] ?? 'previews'; const SIZE = Number(process.env.RENDER_SIZE ?? 512); // Tuned defaults. Ambient near 0.72 keeps shaded faces readable, and a light direction with a // dominant +Y term plus a small +X/+Z tilt separates roof, wall and ground planes. const LIGHT_DIRECTION = [0.08, 0.28, 0.15]; const AMBIENT = 0.72; const BACKGROUND = [47, 52, 59, 255]; const VIEWS = [ { name: 'front', azimuth: 210, elevation: 18, radius: 3.3 }, { name: 'rear', azimuth: 35, elevation: 22, radius: 3.3 }, { name: 'side', azimuth: 120, elevation: 14, radius: 3.3 }, { name: 'top', azimuth: 210, elevation: 62, radius: 3.4 }, ]; // Resolve every path while the working directory is still the caller's. const absoluteInput = path.resolve(INPUT); const absoluteOutDir = path.resolve(OUT_DIR); fs.mkdirSync(absoluteOutDir, { recursive: true }); // The renderer looks for its resource cache relative to the working directory, so move there first, // and only then create the scene. process.chdir(RENDER_ROOT); const scene = createRenderScene({ width: SIZE, height: SIZE }); for (const view of VIEWS) { const result = renderLitematicWithMetadata(absoluteInput, { width: SIZE, height: SIZE, fov_deg: 30, radius: view.radius, nRandomAzimuths: 0, azimuthInit: 0, elevationInit: 0, azimuthsDeltas: [view.azimuth], elevationsDeltas: [view.elevation], ambientIntensities: [AMBIENT], lightDirections: [LIGHT_DIRECTION], mirror: [false], layout: [[0]], limit: 512, seed: 0, opaque: false, }, scene); // Flatten onto an opaque background so shaded faces keep their contrast. for (let i = 0; i < result.png.data.length; i += 4) { const alpha = result.png.data[i + 3] / 255; for (let channel = 0; channel < 3; channel++) { result.png.data[i + channel] = Math.round(result.png.data[i + channel] * alpha + BACKGROUND[channel] * (1 - alpha)); } result.png.data[i + 3] = 255; } const target = path.join(absoluteOutDir, `${view.name}.png`); fs.writeFileSync(target, PNG.sync.write(result.png)); console.log(`wrote ${target} (${SIZE}x${SIZE}, azimuth ${view.azimuth}, elevation ${view.elevation})`); }

"""Check exported Amberstone geometry, circulation, supports and Java NBT.""" import tempfile import json import sys from collections import deque from pathlib import Path import pytest ROOT = Path(__file__).resolve().parents[1] sys.path.insert(0, str(ROOT)) from generate import Build, CONFIG from mcio.schematic import load_schematic from mcio.nbt.nbt import load as load_nbt DIRECTIONS = {'north': (0, 0, -1), 'south': (0, 0, 1), 'west': (-1, 0, 0), 'east': (1, 0, 0)} ROOMS = [(9, 23, 11, 27, f) for f in (3, 10, 17, 24)] + [(25, 36, 13, 27, f) for f in (3, 10)] TARGETS = [(16, f + 1, 22) for f in (3, 10, 17, 24)] + [(33, f + 1, 21) for f in (3, 10)] def parse(state): name, _, tail = state.partition('[') return name.removeprefix('minecraft:'), dict(p.split('=') for p in tail.rstrip(']').split(',') if p) @pytest.fixture(scope='module') def data(): loaded = load_schematic(ROOT / 'output.litematic') ids = loaded.read_flat(0, loaded.volume).reshape(loaded.size_yzx) palette = [parse(s) for s in loaded.palette] return {(x, y, z): palette[int(ids[y, z, x])] for y in range(40) for z in range(35) for x in range(45)} def add(p, delta): return tuple(a + b for a, b in zip(p, delta)) def name(data, p): return data.get(p, ('air', {}))[0] def partial(n): return n in ('air', 'ladder', 'vine', 'fern', 'poppy', 'lantern', 'candle', 'iron_bars', 'campfire', 'stonecutter', 'anvil', 'lectern', 'chest') or any(s in n for s in ('stairs', 'slab', 'wall', 'door', 'carpet', 'bed', 'potted_', 'fence')) def solid(data, p): return not partial(name(data, p)) def walkable(data, p): n = name(data, p) return n in ('air', 'ladder', 'vine') or n.endswith(('_carpet', '_banner', '_door')) and not n.endswith('trapdoor') def test_version_palette_region(data): root = load_nbt(ROOT / 'output.litematic') assert int(root['MinecraftDataVersion']) == 3955 assert len(root['Regions']) == 1 region = next(iter(root['Regions'].values())) assert tuple(int(region['Size'][k]) for k in 'xyz') == (45, 40, 35) registry = json.loads(Path('/work/generator/MCRender/resources/1.21.1-blocks.json').read_text()) for n, props in data.values(): assert n in registry, n for k, v in props.items(): assert k in registry[n][0] and v in registry[n][0][k], (n, k, v) assert any(p[1] >= 38 and n != 'air' for p, (n, _) in data.items()) def test_doors_beds_and_openings(data): doors = beds = 0 for p, (n, props) in data.items(): if n.endswith('_door'): doors += 1 dy = 1 if props['half'] == 'lower' else -1 other_n, other = data[add(p, (0, dy, 0))] assert n == other_n and props['half'] != other['half'] for k in ('facing', 'hinge', 'open'): assert props[k] == other[k] if dy == 1: assert solid(data, add(p, (0, -1, 0))) for d in (DIRECTIONS[props['facing']], tuple(-v for v in DIRECTIONS[props['facing']])): for h in (0, 1): assert walkable(data, add(add(p, d), (0, h, 0))), ('door blocked', p) if n.endswith('_bed'): beds += 1 d = DIRECTIONS[props['facing']] if props['part'] == 'head': d = tuple(-v for v in d) other_n, other = data[add(p, d)] assert other_n == n and other['facing'] == props['facing'] and other['part'] != props['part'] assert solid(data, add(p, (0, -1, 0))) assert name(data, add(p, (0, 1, 0))) == 'air' assert doors == 4 and beds == 2 build = Build().build() for p in build.windows: assert name(data, p) == 'glass', ('window overwritten', p) x, y, z = p outside, inside = ((x, y, z - 1), (x, y, z + 1)) if z in (10, 12, 28) else ((x - 1, y, z), (x + 1, y, z)) if z == 28: outside, inside = inside, outside assert name(data, outside) == 'air', ('window exterior blocked', p, name(data, outside)) assert name(data, inside) == 'air', ('window interior blocked', p, name(data, inside)) def test_two_block_headroom_routes(data): def valid(p): if p not in data or not walkable(data, p) or not walkable(data, add(p, (0, 1, 0))): return False below = name(data, add(p, (0, -1, 0))) return name(data, p) == 'ladder' or (below != 'air' and (solid(data, add(p, (0, -1, 0))) or below.endswith('_stairs'))) start = (16, 1, 1) assert valid(start) seen, queue = {start}, deque([start]) while queue: p = queue.popleft() candidates = [] for d in DIRECTIONS.values(): for dy in (-1, 0, 1): q = add(add(p, d), (0, dy, 0)) # Stepping up requires room above the source's head. if dy == 1 and not walkable(data, add(p, (0, 2, 0))): continue candidates.append(q) if name(data, p) == 'ladder': candidates += [add(p, (0, 1, 0)), add(p, (0, -1, 0))] for q in candidates: if q not in seen and valid(q): seen.add(q) queue.append(q) for target in TARGETS + [(16, 4, 11), (34, 4, 8), (13, 19, 16), (16, 25, 16)]: assert target in seen, ('unreachable room, forge, bed or study', target) for f in (3, 10, 17, 24): assert (22, f + 1, 27) in seen def test_envelope_exterior_flood(data): def permeable(p): n = name(data, p) # Closed doors form the intended weather boundary. Glazing is full glass. return partial(n) and not n.endswith('_door') queue = deque(p for p in data if (p[0] in (0, 44) or p[1] in (0, 39) or p[2] in (0, 34)) and permeable(p)) outside = set(queue) offsets = list(DIRECTIONS.values()) + [(0, 1, 0), (0, -1, 0)] while queue: p = queue.popleft() for d in offsets: q = add(p, d) if q in data and q not in outside and permeable(q): outside.add(q) queue.append(q) # Every interior air cell, including the gables, must resist exterior flood. cells = [] for p, (n, _) in data.items(): x, y, z = p main = 9 <= x <= 23 and 11 <= z <= 27 and 4 <= y < 38 - ((abs(x - 16) * 3 + 1) // 2) lower = 25 <= x <= 36 and 13 <= z <= 27 and 4 <= y < 27 - abs(z - 20) if n == 'air' and (main or lower): cells.append(p) leaks = [p for p in cells if p in outside] assert not leaks, ('interior exposed to exterior', leaks[:20]) assert len(cells) > 5000 def test_decoration_supports(data): for p, (n, props) in data.items(): if n in ('ladder',) or n.endswith('_wall_banner'): d = DIRECTIONS[props['facing']] assert solid(data, add(p, tuple(-v for v in d))), ('wall attachment', p, n) elif n == 'vine': attached = [k for k in DIRECTIONS if props.get(k) == 'true'] assert attached and all(solid(data, add(p, DIRECTIONS[k])) for k in attached) elif n.endswith('_trapdoor') and props['open'] == 'true': # Each shutter is mounted alongside glazing to a timber frame. d = DIRECTIONS[props['facing']] assert solid(data, add(p, tuple(-v for v in d))), ('shutter', p) elif n == 'lantern': dy = 1 if props['hanging'] == 'true' else -1 support = name(data, add(p, (0, dy, 0))) assert solid(data, add(p, (0, dy, 0))) or support.endswith(('_slab', '_wall')), ('lantern', p, support) elif n in ('candle', 'fern', 'poppy', 'anvil', 'stonecutter', 'lectern', 'campfire') or n.startswith('potted_') or n.endswith(('_carpet', '_stairs', '_chest')) or n == 'chest': # Roof stairs sit on full tile underlay; furniture stairs sit on floors. assert solid(data, add(p, (0, -1, 0))), ('floor decoration', p, n, name(data, add(p, (0, -1, 0)))) elif n == 'barrel': assert solid(data, add(p, (0, -1, 0))) or any(solid(data, add(p, d)) for d in DIRECTIONS.values()), ('cabinet', p) def test_furnishings_lights_and_nbt(data): root = load_nbt(ROOT / 'output.litematic') region = next(iter(root['Regions'].values())) frames = region['Entities'] assert len(frames) == len(ROOMS) for frame in frames: assert str(frame['id']) == 'minecraft:item_frame' p = tuple(int(frame[k]) for k in ('TileX', 'TileY', 'TileZ')) assert solid(data, add(p, (0, 0, 1))) assert name(data, p) == 'air' assert int(frame['Facing']) == 2 assert int(frame['Item']['count']) == 1 banners = [tile for tile in region['TileEntities'] if str(tile['id']) == 'minecraft:banner'] assert len(banners) == 2 for tile in banners: p = tuple(int(tile[k]) for k in ('x', 'y', 'z')) assert name(data, p) == 'green_wall_banner' assert [str(v['pattern']) for v in tile['patterns']] == ['minecraft:stripe_left', 'minecraft:stripe_center', 'minecraft:stripe_right'] for x0, x1, z0, z1, f in ROOMS: blocks = [(p, n, props) for p, (n, props) in data.items() if x0 <= p[0] <= x1 and z0 <= p[2] <= z1 and f < p[1] <= f + 5] names = {n for _, n, _ in blocks} for required in ('barrel', 'chest', 'bookshelf', 'ladder', 'spruce_stairs', 'green_carpet', 'potted_fern', 'candle', 'lantern'): assert required in names, (f, x0, required) lights = [p for p, n, props in blocks if n == 'lantern' or n == 'candle' and props['lit'] == 'true'] assert any(p[1] - f <= 3 for p in lights) forge = next(tile for tile in region['TileEntities'] if str(tile['id']) == 'minecraft:blast_furnace') assert int(forge['BurnTime']) > 0 assert [str(item['id']) for item in forge['Items']] == ['minecraft:raw_iron', 'minecraft:coal'] assert all(int(item['count']) > 0 for item in forge['Items']) assert data[(37, 5, 8)][1]['lit'] == 'true' assert name(data, (34, 4, 7)) == 'anvil' for x, z in ((3, 24), (40, 30)): assert sum(name(data, (x, y, z)) == 'spruce_log' for y in range(1, 20)) >= 15 assert any(name(data, (x + 1, y, z)) == 'spruce_log' for y in range(1, 20)) @pytest.fixture def tmp_path(): with tempfile.TemporaryDirectory(dir=ROOT / 'test', prefix='verification-') as directory: yield Path(directory) def test_reproducible_and_complete_roundtrip(tmp_path): build = Build().build() path = build.export(tmp_path / 'one.litematic') build.verify(path) other = Build().build().export(tmp_path / 'two.litematic') assert path.read_bytes() == other.read_bytes() == (ROOT / 'output.litematic').read_bytes()

# Starting point for a Minecraft build generator. Copy into the workspace and fill in build(). # Everything that has to be right for the harness is already right here: bounds checked placement, # one seeded random source, and a byte reproducible export. from __future__ import annotations import argparse import random import gzip import io import json import sys from pathlib import Path from typing import Dict, Iterable, Optional, Tuple sys.path.insert(0, "/work/generator/MCIO") from mcio.schematic import load_schematic # noqa: E402 from mcio.nbt.nbt import load as load_nbt from mcio.nbt.tag import Compound, Int, Short, Byte, String, Float, Double, IntArray, List as NBTList from mcio.sketch import LitematicCanvas, Material, parse_blockstate # noqa: E402 CONFIG = { "seed": 20260923, "size_xyz": (45, 40, 35), # width X, height Y, depth Z "minecraft_version": "1.21.1", "data_version": 3955, "output": "output.litematic", "name": "Amberstone Lodge", "author": "generator", "description": "Amberstone Lodge: four floors, forest terrace, smithy and furnished timber halls. Java 1.21.1.", } Position = Tuple[int, int, int] class Build: """Hold a block volume and write it out as a Litematica schematic.""" def __init__(self, size_xyz: Tuple[int, int, int] = CONFIG["size_xyz"], seed: int = CONFIG["seed"]) -> None: """Create an empty volume with one seeded random source. Args: size_xyz (Tuple[int, int, int]): Volume size as width X, height Y, depth Z. seed (int): Seed for every random decision in this build. """ self.size_x, self.size_y, self.size_z = size_xyz self.rng = random.Random(seed) self.canvas = LitematicCanvas((self.size_y, self.size_z, self.size_x)) self.placed: Dict[Position, str] = {} def inside(self, x: int, y: int, z: int) -> bool: """Report whether a coordinate is inside the volume. Args: x (int): Width coordinate. y (int): Height coordinate. z (int): Depth coordinate. Returns: bool: True when every axis is within range. """ return 0 <= x < self.size_x and 0 <= y < self.size_y and 0 <= z < self.size_z def put(self, x: int, y: int, z: int, block: str | Material, **properties: str) -> None: """Place one block, in XYZ order, with an immediate bounds check. Args: x (int): Width coordinate. y (int): Height coordinate. z (int): Depth coordinate. block (str | Material): Namespaced block name, a full blockstate string, or a Material. **properties: Blockstate properties such as facing or half. Raises: AssertionError: When the coordinate is outside the volume, naming the coordinate. """ assert self.inside(x, y, z), f"out of bounds: (x={x}, y={y}, z={z}) in {self.size_x}x{self.size_y}x{self.size_z}" material = self.material(block, **properties) if isinstance(block, str) else block self.canvas.block((y, z, x), material) self.placed[(x, y, z)] = material.blockstate def material(self, name: str, **properties: str) -> Material: """Build a Material from a block name and its properties. Args: name (str): Namespaced block name, or a full blockstate string. **properties: Blockstate properties. Returns: Material: Material ready for placement. """ if "[" in name: return parse_blockstate(name) return self.canvas.material(name, **dict(sorted(properties.items()))) def box(self, bounds: Tuple[int, int, int, int, int, int], block: str | Material, **properties: str) -> None: """Fill an inclusive box. Args: bounds (Tuple[int, int, int, int, int, int]): x0, y0, z0, x1, y1, z1, inclusive on both ends. block (str | Material): Block to place. **properties: Blockstate properties. """ x0, y0, z0, x1, y1, z1 = bounds for x in range(min(x0, x1), max(x0, x1) + 1): for y in range(min(y0, y1), max(y0, y1) + 1): for z in range(min(z0, z1), max(z0, z1) + 1): self.put(x, y, z, block, **properties) def shell(self, bounds: Tuple[int, int, int, int, int, int], block: str | Material, **properties: str) -> None: """Fill only the faces of a box, leaving the inside empty. Args: bounds (Tuple[int, int, int, int, int, int]): x0, y0, z0, x1, y1, z1, inclusive. block (str | Material): Block to place. **properties: Blockstate properties. """ x0, y0, z0, x1, y1, z1 = bounds for x in range(min(x0, x1), max(x0, x1) + 1): for y in range(min(y0, y1), max(y0, y1) + 1): for z in range(min(z0, z1), max(z0, z1) + 1): on_face = x in (x0, x1) or y in (y0, y1) or z in (z0, z1) if on_face: self.put(x, y, z, block, **properties) def texture(self, bounds: Tuple[int, int, int, int, int, int], palette: Iterable[str]) -> None: """Fill a box with a weighted mix of related blocks, so the surface is not flat. Args: bounds (Tuple[int, int, int, int, int, int]): x0, y0, z0, x1, y1, z1, inclusive. palette (Iterable[str]): Block names. Repeat a name to make it more common. """ choices = list(palette) x0, y0, z0, x1, y1, z1 = bounds for x in range(min(x0, x1), max(x0, x1) + 1): for y in range(min(y0, y1), max(y0, y1) + 1): for z in range(min(z0, z1), max(z0, z1) + 1): self.put(x, y, z, self.rng.choice(choices)) def get(self, x: int, y: int, z: int) -> Optional[str]: """Read back what was placed at a coordinate. Args: x (int): Width coordinate. y (int): Height coordinate. z (int): Depth coordinate. Returns: Optional[str]: Blockstate string, or None when the cell is empty. """ return self.placed.get((x, y, z)) def roof_height(self, x: int) -> int: """Return the tall wing's steep roof profile.""" import math return 38 - math.ceil(abs(x - 17) * 1.4) def block_entity(self, pos: Position, kind: str, **tags) -> None: """Register block entity data at local XYZ coordinates.""" x, y, z = pos self.block_entities.append(Compound(id=String('minecraft:' + kind), x=Int(x), y=Int(y), z=Int(z), **tags)) def frame(self, x: int, y: int, z: int, item: str, facing: str = 'south') -> None: """Attach a populated item frame to a wall.""" direction = {'north': (0, 0, -1, 2), 'south': (0, 0, 1, 3), 'west': (-1, 0, 0, 4), 'east': (1, 0, 0, 5)}[facing] dx, _, dz, code = direction self.entities.append(Compound(id=String('minecraft:item_frame'), Pos=NBTList[Double]([x + .5 - dx * .46875, y + .5, z + .5 - dz * .46875]), TileX=Int(x), TileY=Int(y), TileZ=Int(z), Facing=Byte(code), Item=Compound(id=String('minecraft:' + item), count=Int(1)), ItemRotation=Byte(0), ItemDropChance=Float(1), Invisible=Byte(0), UUID=IntArray([20260923, 17, 35, len(self.entities) + 1]))) def standing(self, x: int, y: int, z: int, block: str, **props) -> None: """Place supported floor or tabletop decoration.""" self.put(x, y, z, 'minecraft:' + block, **props) self.supports.append(((x, y, z), (x, y - 1, z))) def wall_lamp(self, x: int, y: int, z: int, facing: str) -> None: """Mount a lantern on a timber wall bracket.""" self.put(x, y, z, 'minecraft:spruce_planks') self.standing(x, y + 1, z, 'lantern', hanging='false') def door(self, x: int, y: int, z: int, facing: str = 'north') -> None: """Place a complete closed door.""" for half, dy in [('lower', 0), ('upper', 1)]: self.put(x, y + dy, z, 'minecraft:spruce_door', half=half, facing=facing, hinge='left', open='false', powered='false') self.openings.append(('door', (x, y, z), (x, y + 1, z))) def front_window(self, x: int, y: int, z: int, width: int = 3) -> None: """Inset framed glazing and attach open wooden shutters.""" self.box((x - 1, y - 1, z, x + width, y - 1, z), 'minecraft:stripped_spruce_log', axis='x') self.box((x - 1, y + 3, z, x + width, y + 3, z), 'minecraft:stripped_spruce_log', axis='x') for xx in [x - 1, x + width]: self.box((xx, y, z, xx, y + 2, z), 'minecraft:spruce_log', axis='y') for yy in range(y, y + 3): self.put(xx, yy, z - 1, 'minecraft:spruce_trapdoor', facing='south', half='bottom', open='true') self.supports.append(((xx, yy, z - 1), (xx, yy, z))) self.box((x, y, z, x + width - 1, y + 2, z), 'minecraft:glass') self.openings.append(('window', (x, y, z), (x + width - 1, y + 2, z))) def foliage(self, x: int, y: int, z: int) -> None: """Place leaves only where they do not overwrite architecture.""" if self.get(x, y, z) in (None, 'minecraft:air'): self.put(x, y, z, 'minecraft:spruce_leaves', persistent='true', distance='1') def pine(self, x: int, z: int, height: int) -> None: """Build a pine with radial stepped limbs and separate leaf tiers.""" self.box((x, 2, z, x, height, z), 'minecraft:spruce_log', axis='y') for y, radius in [(height - 10, 4), (height - 7, 3), (height - 4, 2), (height - 1, 1)]: for dx in range(-radius, radius + 1): for dz in range(-radius, radius + 1): if abs(dx) + abs(dz) <= radius + 1 and (dx or dz): self.foliage(x + dx, y, z + dz) if abs(dx) + abs(dz) <= radius: self.foliage(x + dx, y + 1, z + dz) for direction in [-1, 1]: for k in range(1, radius): for xx, zz, axis in [(x + k * direction, z, 'x'), (x, z + k * direction, 'z')]: if self.get(xx, y, zz) in (None, 'minecraft:air') or 'leaves' in self.get(xx, y, zz): self.put(xx, y, zz, 'minecraft:spruce_log', axis=axis) self.put(x, height + 1, z, 'minecraft:spruce_leaves', persistent='true', distance='1') self.trees.append((x, z, height)) def room_basics(self, floor: int, item: str) -> None: """Furnish each tall-wing room with usable storage and small details.""" y = floor + 1 self.standing(23, y, 12, 'barrel', facing='up') self.standing(23, y, 14, 'chest', facing='west', type='single') self.standing(22, y, 12, 'spruce_stairs', facing='east', half='bottom', shape='straight') self.put(20, y, 12, 'minecraft:spruce_planks') self.standing(20, y + 1, 12, 'potted_fern') self.put(21, y, 16, 'minecraft:spruce_planks') self.standing(21, y + 1, 16, 'yellow_candle', candles='3', lit='true') self.put(23, y, 18, 'minecraft:spruce_planks') self.standing(23, y + 1, 18, 'lantern', hanging='false') for yy in range(y, y + 3): self.put(23, yy, 27, 'minecraft:ladder', facing='north') self.supports.append(((23, yy, 27), (23, yy, 28))) for xx in range(15, 20): for zz in range(17, 21): self.standing(xx, y, zz, 'green_carpet' if (xx + zz) % 3 else 'brown_carpet') self.frame(21, y + 2, 11, item) self.rooms.append({'name': {'iron_pickaxe': 'Entrance and storage', 'bread': 'Living room', 'golden_apple': 'Bedroom', 'book': 'Attic study'}[item], 'floor': floor, 'target': (17, y, 21), 'bounds': (10, y, 11, 24, floor + 5, 27)}) def build(self) -> 'Build': """Build Amberstone Lodge, its interiors, terrace, forge and pines.""" stone = ['minecraft:stone_bricks'] * 7 + ['minecraft:mossy_stone_bricks', 'minecraft:andesite'] plaster = ['minecraft:smooth_sandstone'] * 10 + ['minecraft:cut_sandstone', 'minecraft:calcite'] timber = ['minecraft:spruce_planks'] * 8 + ['minecraft:dark_oak_planks', 'minecraft:stripped_spruce_wood'] roof = ['minecraft:deepslate_tiles'] * 8 + ['minecraft:deepslate_bricks', 'minecraft:polished_deepslate'] self.block_entities, self.entities = [], [] self.supports, self.openings, self.rooms, self.trees = [], [], [], [] # Mossy forest clearing with a shallow, irregular stone approach. self.box((0, 0, 0, 44, 0, 34), 'minecraft:stone') self.texture((0, 1, 0, 44, 1, 34), ['minecraft:grass_block'] * 15 + ['minecraft:podzol', 'minecraft:coarse_dirt']) for z in range(0, 7): center = 17 + (2 if z < 3 else 1) for x in range(center - 2, center + 3): if self.rng.random() < .90 or abs(x - center) < 2: self.put(x, 1, z, self.rng.choice(['minecraft:gravel', 'minecraft:cobblestone', 'minecraft:andesite'])) # Solid raised terrace, with a three-riser central approach. self.texture((7, 2, 7, 39, 3, 30), stone) self.texture((7, 4, 7, 39, 4, 30), ['minecraft:stone_bricks'] * 5 + ['minecraft:polished_andesite', 'minecraft:andesite']) for z, y in [(4, 2), (5, 3), (6, 4)]: self.box((15, 2, z, 19, y, z), 'minecraft:stone_bricks') self.box((15, y, z, 19, y, z), 'minecraft:stone_brick_stairs', facing='south', half='bottom', shape='straight') # The two touching structural shells share the wall at X=25. for x0, x1, z0, z1, top in [(9, 25, 10, 28, 25), (25, 37, 12, 28, 16)]: for y in range(5, top + 1): palette = stone if y < 10 else plaster self.texture((x0, y, z0, x1, y, z0), palette) self.texture((x0, y, z1, x1, y, z1), palette) self.texture((x0, y, z0, x0, y, z1), palette) self.texture((x1, y, z0, x1, y, z1), palette) # Tall wing floors and warm, exposed framing. for y in [4, 10, 16, 22]: self.texture((10, y, 11, 24, y, 27), timber) for z in [10, 28]: self.box((9, y, z, 25, y, z), 'minecraft:dark_oak_log', axis='x') for x in [9, 25]: self.box((x, y, 10, x, y, 28), 'minecraft:dark_oak_log', axis='z') for x in [9, 14, 20, 25]: for z in [10, 28]: self.box((x, 10, z, x, 25, z), 'minecraft:spruce_log', axis='y') for z in [16, 22]: self.box((9, 10, z, 9, 25, z), 'minecraft:spruce_log', axis='y') self.box((25, 17, z, 25, 25, z), 'minecraft:spruce_log', axis='y') self.texture((26, 10, 13, 36, 10, 27), timber) for y in [10, 16]: self.box((26, y, 12, 37, y, 12), 'minecraft:dark_oak_log', axis='x') self.box((26, y, 28, 37, y, 28), 'minecraft:dark_oak_log', axis='x') self.box((37, y, 12, 37, y, 28), 'minecraft:dark_oak_log', axis='z') for x in [30, 37]: for z in [12, 28]: self.box((x, 10, z, x, 16, z), 'minecraft:spruce_log', axis='y') # Fill gable triangles up to the roof underside; seal both sloping sides. for x in range(9, 26): h = self.roof_height(x) for z in [10, 28]: self.texture((x, 26, z, x, h - 1, z), plaster) if x == 17: self.box((x, 23, z, x, h - 1, z), 'minecraft:dark_oak_log', axis='y') for z in range(8, 31): self.texture((x, h - 1, z, x, h, z), roof) for x in [7, 8, 26, 27]: h = self.roof_height(x) self.texture((x, h - 1, 8, x, h, 30), roof) # Roof edge ribs make the steep profile legible from the approach. for x in range(7, 28): h = self.roof_height(x) for z in [8, 30]: self.box((x, h - 1, z, x, h, z), 'minecraft:polished_deepslate') if x != 17: self.put(x, h + 1, z, 'minecraft:deepslate_tile_stairs', facing='east' if x < 17 else 'west', half='bottom', shape='straight') self.box((17, 39, 8, 17, 39, 30), 'minecraft:deepslate_tile_slab', type='bottom') # Lower shed roof overlaps the tall roof and is completely filled beneath its edges. for x in range(25, 40): h = 26 - ((x - 25) * 7 // 10) for z in range(11, 30): self.texture((x, h - 1, z, x, h, z), roof) if x <= 37: for z in [12, 28]: if h > 18: self.texture((x, 17, z, x, h - 2, z), plaster) if x == 37 and h > 18: self.texture((x, 17, 12, x, h - 2, 28), plaster) for z in [11, 29]: self.put(x, h + 1, z, 'minecraft:deepslate_tile_stairs', facing='west', half='bottom', shape='straight') # Windows sit within framed panels, far below any overhangs. for y in [12, 18, 24]: for x in [11, 21]: self.front_window(x, y, 10, 2) self.front_window(16, 29, 10, 3) for y in [6, 12, 18, 24]: self.front_window(11, y, 28, 2) self.front_window(27, 18, 12, 3) # West side windows and masonry lintels. for y in [6, 12, 18]: for z in [14, 24]: self.box((9, y, z, 9, y + 2, z + 1), 'minecraft:glass') self.box((9, y - 1, z, 9, y - 1, z + 1), 'minecraft:stripped_spruce_log', axis='z') self.openings.append(('window', (9, y, z), (9, y + 2, z + 1))) for z in [17, 23]: self.box((37, 6, z, 37, 8, z + 1), 'minecraft:glass') self.box((37, 12, z, 37, 14, z + 1), 'minecraft:glass') for y in [6, 12]: self.openings.append(('window', (37, y, z), (37, y + 2, z + 1))) self.door(17, 5, 10) self.door(29, 5, 12) for floor in [4, 10]: self.door(25, floor + 1, 17, 'east') for x in [15, 19]: self.box((x, 5, 9, x, 7, 9), 'minecraft:stone_bricks') self.box((15, 8, 9, 19, 8, 9), 'minecraft:stone_bricks') self.box((16, 9, 9, 18, 9, 9), 'minecraft:stone_brick_slab', type='bottom') for x in [14, 20]: self.wall_lamp(x, 6, 9, 'north') # One repeated staircase: six risers, generous landings and headroom. for floor in [4, 10, 16]: for i in range(6): z, y = 19 + i, floor + i + 1 self.box((11, y + 1, z, 12, y + 3, z), 'minecraft:air') self.box((11, y - 1, z, 12, y, z), 'minecraft:spruce_planks') self.box((11, y, z, 12, y, z), 'minecraft:spruce_stairs', facing='south', half='bottom', shape='straight') self.box((11, floor + 7, 25, 12, floor + 9, 26), 'minecraft:air') # Entrance: storage, workbench, boot bench and route to the side workshop. for floor, item in [(4, 'iron_pickaxe'), (10, 'bread'), (16, 'golden_apple'), (22, 'book')]: self.room_basics(floor, item) self.put(10, 5, 12, 'minecraft:crafting_table') self.put(10, 5, 13, 'minecraft:barrel', facing='east') self.put(10, 6, 13, 'minecraft:barrel', facing='east') self.put(10, 5, 16, 'minecraft:stonecutter', facing='east') # Living room hearth, chairs and a low table. self.box((15, 11, 26, 19, 13, 27), 'minecraft:stone_bricks') self.put(17, 11, 26, 'minecraft:campfire', lit='true', facing='north', signal_fire='false') self.put(17, 12, 26, 'minecraft:iron_bars', north='false', south='false', east='true', west='true') self.put(15, 14, 26, 'minecraft:lantern', hanging='false') self.supports.append(((15, 14, 26), (15, 13, 26))) for x in [15, 16, 18, 19]: self.put(x, 11, 14, 'minecraft:spruce_stairs', facing='north', half='bottom', shape='straight') self.box((16, 11, 15, 18, 11, 15), 'minecraft:dark_oak_slab', type='bottom') # Bedroom platform, complete green bed, cabinets and striped curtains. self.box((15, 17, 12, 18, 17, 15), 'minecraft:spruce_planks') self.box((15, 17, 16, 18, 17, 16), 'minecraft:spruce_stairs', facing='north', half='bottom', shape='straight') for x in [16, 17]: self.put(x, 18, 14, 'minecraft:green_bed', facing='north', part='foot', occupied='false') self.put(x, 18, 13, 'minecraft:green_bed', facing='north', part='head', occupied='false') for x in [15, 18]: self.put(x, 18, 12, 'minecraft:dark_oak_planks') self.standing(x, 19, 12, 'lantern', hanging='false') self.box((14, 17, 26, 18, 19, 27), 'minecraft:bookshelf') for x in [21, 22, 23]: self.put(x, 20, 26, 'minecraft:barrel', facing='north') self.put(x, 20, 27, 'minecraft:spruce_planks') self.put(x, 20, 28, 'minecraft:spruce_log', axis='x') for x in [20, 23]: self.put(x, 20, 11, 'minecraft:white_wall_banner', facing='south') self.supports.append(((x, 20, 11), (x, 20, 10))) self.block_entity((x, 20, 11), 'banner', patterns=NBTList[Compound]([Compound(pattern=String('minecraft:stripe_left'), color=String('green')), Compound(pattern=String('minecraft:stripe_right'), color=String('green'))])) # Attic library: desk, map frame, books and candle-lit lectern. self.box((14, 23, 26, 21, 25, 27), 'minecraft:bookshelf') self.box((15, 23, 12, 18, 23, 12), 'minecraft:dark_oak_planks') self.standing(15, 24, 12, 'lantern', hanging='false') self.standing(18, 24, 12, 'potted_blue_orchid') self.put(16, 23, 14, 'minecraft:spruce_stairs', facing='south', half='bottom', shape='straight') self.put(18, 23, 15, 'minecraft:lectern', facing='south', has_book='true', powered='false') self.block_entity((18, 23, 15), 'lectern', Page=Int(0), Book=Compound(id=String('minecraft:written_book'), count=Int(1), components=Compound({'minecraft:written_book_content': Compound(title=String('Amberstone Almanac'), author=String('The Lodgekeeper'), generation=Int(0), pages=NBTList[Compound]([Compound(raw=String('{"text":"Amberstone Lodge\\nForge, forest, and a warm hearth.\\nEstablished 1684"}'))]), resolved=Byte(1))}))) # Side wing: smith's workshop below, dining room above. for floor, name in [(4, 'Workshop'), (10, 'Dining')]: y = floor + 1 self.rooms.append({'name': name, 'floor': floor, 'target': (29, y, 18), 'bounds': (26, y, 13, 36, floor + 5, 27)}) for x in [28, 30, 32]: self.standing(x, y, 26, 'barrel', facing='north') self.standing(35, y, 26, 'chest', facing='north', type='single') self.put(36, y, 14, 'minecraft:spruce_planks') self.standing(36, y + 1, 14, 'potted_fern') self.put(27, y, 14, 'minecraft:spruce_planks') self.standing(27, y + 1, 14, 'lantern', hanging='false') self.put(33, y, 24, 'minecraft:spruce_planks') self.standing(33, y + 1, 24, 'candle', candles='2', lit='true') for yy in range(y, y + 3): self.put(36, yy, 27, 'minecraft:ladder', facing='north') self.supports.append(((36, yy, 27), (36, yy, 28))) self.standing(28, y, 24, 'spruce_stairs', facing='north', half='bottom', shape='straight') for x in range(28, 32): for z in range(18, 22): self.standing(x, y, z, 'red_carpet' if z in [18, 21] else 'brown_carpet') self.frame(31, y + 2, 27, 'iron_axe' if floor == 4 else 'cooked_beef', 'north') self.box((33, 5, 15, 35, 5, 15), 'minecraft:smithing_table') self.standing(34, 5, 17, 'anvil', facing='north') self.box((32, 11, 19, 34, 11, 22), 'minecraft:dark_oak_planks') self.standing(33, 12, 20, 'lantern', hanging='false') self.standing(34, 12, 22, 'potted_poppy') for z in [19, 21]: self.standing(31, 11, z, 'spruce_stairs', facing='east', half='bottom', shape='straight') self.standing(35, 11, z, 'spruce_stairs', facing='west', half='bottom', shape='straight') # Covered smithy on the terrace; a long masonry stack penetrates the roof. for x in [27, 38]: self.box((x, 5, 7, x, 9, 7), 'minecraft:spruce_log', axis='y') self.box((x, 5, 11, x, 12, 11), 'minecraft:spruce_log', axis='y') for z in range(6, 13): h = 10 + (z - 6) // 2 self.texture((26, h, z, 39, h, z), roof) self.box((26, h - 1, z, 26, h - 1, z), 'minecraft:dark_oak_log', axis='z') self.box((39, h - 1, z, 39, h - 1, z), 'minecraft:dark_oak_log', axis='z') self.box((27, 9, 7, 38, 9, 7), 'minecraft:dark_oak_log', axis='x') self.texture((33, 5, 10, 36, 5, 11), stone) self.put(34, 6, 10, 'minecraft:campfire', lit='true', signal_fire='true', facing='north') self.box((33, 6, 11, 36, 7, 12), 'minecraft:bricks') self.texture((34, 8, 11, 35, 30, 12), ['minecraft:bricks'] * 8 + ['minecraft:granite', 'minecraft:polished_granite']) self.box((33, 8, 10, 36, 8, 12), 'minecraft:stone_bricks') self.box((33, 29, 10, 36, 29, 13), 'minecraft:stone_brick_slab', type='double') self.box((34, 31, 11, 35, 31, 12), 'minecraft:campfire', lit='true', signal_fire='true', facing='north') self.box((33, 33, 10, 36, 33, 13), 'minecraft:deepslate_tile_slab', type='bottom') for x in [33, 36]: for z in [10, 13]: self.box((x, 30, z, x, 32, z), 'minecraft:iron_bars', north='false', south='false', east='false', west='false') self.put(33, 6, 11, 'minecraft:blast_furnace', facing='north', lit='true') self.block_entity((33, 6, 11), 'blast_furnace', BurnTime=Short(16000), CookTime=Short(0), CookTimeTotal=Short(100), Items=NBTList[Compound]([Compound(Slot=Byte(0), id=String('minecraft:raw_iron'), count=Int(32)), Compound(Slot=Byte(1), id=String('minecraft:coal'), count=Int(32))])) self.standing(31, 5, 8, 'anvil', facing='east') self.standing(28, 5, 10, 'barrel', facing='up') self.standing(28, 6, 10, 'lantern', hanging='false') self.standing(37, 5, 10, 'chest', facing='north', type='single') self.put(36, 5, 8, 'minecraft:smithing_table') # Terrace edge piers, planters, ivy, and handmade conifers. for x, z in [(8, 8), (8, 29), (38, 29), (22, 7)]: self.box((x, 5, z, x, 5, z), 'minecraft:stone_bricks') self.standing(x, 6, z, 'lantern', hanging='false') for x, z in [(10, 8), (24, 8), (38, 20), (38, 26)]: self.put(x, 5, z, 'minecraft:barrel', facing='up') self.standing(x, 6, z, 'potted_azalea_bush') for z in range(18, 23): for y in range(5, 9 - (z % 3)): self.put(8, y, z, 'minecraft:vine', east='true', north='false', south='false', west='false', up='false') self.supports.append(((8, y, z), (9, y, z))) self.pine(4, 24, 21) self.pine(40, 5, 17) self.pine(6, 5, 16) for x, z in [(3, 13), (5, 16), (42, 22), (42, 29), (24, 32), (13, 32), (31, 32), (2, 7)]: self.standing(x, 2, z, 'fern') return self def export(self, path: Path) -> Path: """Write the schematic so that two runs produce identical bytes. Args: path (Path): Destination .litematic path. Returns: Path: The path written. """ schematic = self.canvas.to_litematica( name=CONFIG["name"], author=CONFIG["author"], description=CONFIG["description"], minecraft_data_version=CONFIG["data_version"], ) # The metadata otherwise records the current wall clock, which changes the bytes on every run. schematic.metadata.time_created = 0 schematic.metadata.time_modified = 0 path.parent.mkdir(parents=True, exist_ok=True) schematic.save(path) nbt = load_nbt(path) region = next(iter(nbt['Regions'].values())) region['TileEntities'] = NBTList[Compound](self.block_entities) region['Entities'] = NBTList[Compound](self.entities) stream = io.BytesIO() nbt.write(stream) path.write_bytes(gzip.compress(stream.getvalue(), mtime=0)) return path def verify(self, path: Path) -> Dict[str, object]: """Reload the written file and confirm it matches what was placed. Args: path (Path): Schematic to reload. Returns: Dict[str, object]: Size, block count and palette size of the reloaded file. Raises: AssertionError: When a reloaded cell differs from what was placed. """ loaded = load_schematic(path) size_y, size_z, size_x = loaded.size_yzx assert (size_x, size_y, size_z) == (self.size_x, self.size_y, self.size_z), "size changed on reload" ids = loaded.read_flat(0, loaded.volume).reshape(loaded.size_yzx) for (x, y, z), state in self.placed.items(): assert loaded.palette[int(ids[y, z, x])] == state, f"cell (x={x}, y={y}, z={z}) changed on reload" return { "size_xyz": [size_x, size_y, size_z], "placed_blocks": len(self.placed), "palette_states": len(loaded.palette), } def main() -> None: """Generate the build, export it, and verify the exported file.""" parser = argparse.ArgumentParser(description="Generate a Minecraft schematic.") parser.add_argument("--output", type=Path, default=Path(CONFIG["output"])) parser.add_argument("--seed", type=int, default=CONFIG["seed"]) args = parser.parse_args() build = Build(seed=args.seed).build() path = build.export(args.output) report = build.verify(path) manifest = dict(rooms=build.rooms, supports=build.supports, openings=build.openings, trees=build.trees) path.with_name('build_manifest.json').write_text(json.dumps(manifest, indent=2) + '\n') print(f"wrote {path}: {report}") if __name__ == "__main__": main()

# Export furnished room cutaways from the delivered schematic for visual inspection. from pathlib import Path import sys sys.path.insert(0, '/work/generator/MCIO') from mcio.schematic import load_schematic from mcio.sketch import LitematicCanvas, parse_blockstate VIEWS = { 'entrance_workshop': (9, 4, 10, 37, 8, 28), 'living_dining': (9, 10, 10, 37, 14, 28), 'bedroom': (9, 16, 10, 25, 20, 28), 'attic_study': (9, 22, 10, 25, 26, 28), } def main() -> None: """Crop each room group below its ceiling for overhead renders.""" source = load_schematic(Path('output.litematic')) ids = source.read_flat(0, source.volume).reshape(source.size_yzx) Path('previews').mkdir(exist_ok=True) for name, (x0, y0, z0, x1, y1, z1) in VIEWS.items(): canvas = LitematicCanvas((y1 - y0 + 1, z1 - z0 + 1, x1 - x0 + 1)) for y in range(y0, y1 + 1): for z in range(z0, z1 + 1): for x in range(x0, x1 + 1): state = source.palette[int(ids[y, z, x])] if state != 'minecraft:air': canvas.block((y - y0, z - z0, x - x0), parse_blockstate(state)) schematic = canvas.to_litematica(name=name, minecraft_data_version=3955) schematic.metadata.time_created = 0 schematic.metadata.time_modified = 0 schematic.save(Path('previews') / f'{name}.litematic') if __name__ == '__main__': main()

// Starting point for rendering a build. Copy into the workspace and edit VIEWS. // Lighting, camera framing and background are already tuned; run it as is to get a first look. import fs from 'node:fs'; import path from 'node:path'; import { createRequire } from 'node:module'; import { createRenderScene, renderLitematicWithMetadata } from '/work/generator/MCRender/src/headless/index.ts'; const RENDER_ROOT = '/work/generator/MCRender'; const requireRenderer = createRequire(path.join(RENDER_ROOT, 'package.json')); const { PNG } = requireRenderer('pngjs'); // vite-node passes script arguments after a bare "--", so drop it before reading them. const argv = process.argv.slice(2).filter(entry => entry !== '--'); const INPUT = argv[0] ?? 'output.litematic'; const OUT_DIR = argv[1] ?? 'previews'; const SIZE = Number(process.env.RENDER_SIZE ?? 512); // Tuned defaults. Ambient near 0.72 keeps shaded faces readable, and a light direction with a // dominant +Y term plus a small +X/+Z tilt separates roof, wall and ground planes. const LIGHT_DIRECTION = [0.08, 0.28, 0.15]; const AMBIENT = 0.72; const BACKGROUND = [47, 52, 59, 255]; const VIEWS = [ { name: 'front', azimuth: 210, elevation: 18, radius: 3.3 }, { name: 'rear', azimuth: 35, elevation: 22, radius: 3.3 }, { name: 'side', azimuth: 120, elevation: 14, radius: 3.3 }, { name: 'top', azimuth: 210, elevation: 62, radius: 3.4 }, ]; // Resolve every path while the working directory is still the caller's. const absoluteInput = path.resolve(INPUT); const absoluteOutDir = path.resolve(OUT_DIR); fs.mkdirSync(absoluteOutDir, { recursive: true }); // The renderer looks for its resource cache relative to the working directory, so move there first, // and only then create the scene. process.chdir(RENDER_ROOT); const scene = createRenderScene({ width: SIZE, height: SIZE }); for (const view of VIEWS) { const result = renderLitematicWithMetadata(absoluteInput, { width: SIZE, height: SIZE, fov_deg: 30, radius: view.radius, nRandomAzimuths: 0, azimuthInit: 0, elevationInit: 0, azimuthsDeltas: [view.azimuth], elevationsDeltas: [view.elevation], ambientIntensities: [AMBIENT], lightDirections: [LIGHT_DIRECTION], mirror: [false], layout: [[0]], limit: 512, seed: 0, opaque: false, }, scene); // Flatten onto an opaque background so shaded faces keep their contrast. for (let i = 0; i < result.png.data.length; i += 4) { const alpha = result.png.data[i + 3] / 255; for (let channel = 0; channel < 3; channel++) { result.png.data[i + channel] = Math.round(result.png.data[i + channel] * alpha + BACKGROUND[channel] * (1 - alpha)); } result.png.data[i + 3] = 255; } const target = path.join(absoluteOutDir, `${view.name}.png`); fs.writeFileSync(target, PNG.sync.write(result.png)); console.log(`wrote ${target} (${SIZE}x${SIZE}, azimuth ${view.azimuth}, elevation ${view.elevation})`); }

# Verify exported geometry, circulation, supports, furnishings and entity data. from collections import deque from pathlib import Path import hashlib import json import sys import subprocess import tempfile import pytest ROOT = Path(__file__).resolve().parents[1] sys.path.insert(0, str(ROOT)) from generate import Build, CONFIG, load_schematic, load_nbt DIRECTIONS = {'north': (0, 0, -1), 'south': (0, 0, 1), 'east': (1, 0, 0), 'west': (-1, 0, 0)} def parse(state): """Split a blockstate into a name and properties.""" name, _, props = state.partition('[') return name.removeprefix('minecraft:'), dict(p.split('=') for p in props.rstrip(']').split(',') if p) def add(a, b): """Add XYZ coordinates.""" return tuple(x + y for x, y in zip(a, b)) @pytest.fixture(scope='module') def model(): """Load the delivered schematic independently of the generator.""" path = ROOT / 'output.litematic' loaded = load_schematic(path) ids = loaded.read_flat(0, loaded.volume).reshape(loaded.size_yzx) palette = [parse(s) for s in loaded.palette] blocks = {(x, y, z): palette[int(ids[y, z, x])] for y in range(ids.shape[0]) for z in range(ids.shape[1]) for x in range(ids.shape[2])} return blocks, load_nbt(path), json.loads((ROOT / 'build_manifest.json').read_text()) def get(blocks, pos): """Read a cell, treating out-of-volume positions as air.""" return blocks.get(tuple(pos), ('air', {})) def solid(blocks, pos): """Identify full blocks valid as decoration backing.""" name, props = get(blocks, pos) forbidden = ('stairs', 'slab', 'door', 'trapdoor', 'carpet', 'bed', 'banner', 'candle', 'leaves') return name not in {'air', 'lantern', 'ladder', 'vine', 'fern', 'iron_bars', 'campfire', 'chest', 'anvil', 'lectern', 'stonecutter'} and not name.startswith('potted_') and not any(name.endswith(s) for s in forbidden) def test_single_region_version_bounds_and_materials(model): blocks, nbt, _ = model assert len(nbt['Regions']) == 1 assert int(nbt['MinecraftDataVersion']) == 3955 assert CONFIG['size_xyz'] == (45, 40, 35) names = {n for n, _ in blocks.values()} authority = json.loads(Path('/work/generator/MCRender/resources/1.21.1-blocks.json').read_text()) for name, props in set((n, tuple(p.items())) for n, p in blocks.values()): assert name in authority, name for key, value in props: assert key in authority[name][0] and value in authority[name][0][key], (name, key, value) for family in [{'stone_bricks', 'mossy_stone_bricks', 'andesite'}, {'smooth_sandstone', 'cut_sandstone', 'calcite'}, {'spruce_planks', 'dark_oak_planks', 'stripped_spruce_wood'}, {'deepslate_tiles', 'deepslate_bricks', 'polished_deepslate'}]: assert family <= names assert any(p[1] == 39 and n != 'air' for p, (n, _) in blocks.items()) def test_complete_doors_and_supported_beds(model): blocks, _, _ = model doors, beds = 0, 0 for pos, (name, props) in blocks.items(): if name.endswith('_door'): doors += 1 dy = 1 if props['half'] == 'lower' else -1 other, op = get(blocks, add(pos, (0, dy, 0))) assert other == name assert op['half'] != props['half'] assert all(op[k] == props[k] for k in ['facing', 'hinge', 'open']) if props['half'] == 'lower': assert solid(blocks, add(pos, (0, -1, 0))) if name.endswith('_bed'): beds += 1 d = DIRECTIONS[props['facing']] if props['part'] == 'head': d = tuple(-v for v in d) other, op = get(blocks, add(pos, d)) assert other == name and op['part'] != props['part'] and op['facing'] == props['facing'] assert solid(blocks, add(pos, (0, -1, 0))) assert doors == 8 and beds == 4 def test_window_and_door_openings_clear(model): blocks, _, manifest = model for kind, lo, hi in manifest['openings']: for x in range(lo[0], hi[0] + 1): for y in range(lo[1], hi[1] + 1): for z in range(lo[2], hi[2] + 1): p = x, y, z name, props = get(blocks, p) assert name == 'glass' if kind == 'window' else name.endswith('_door'), (kind, p, name) if x in [9, 37] and lo[0] == hi[0]: normals = [(1, 0, 0), (-1, 0, 0)] elif kind == 'door' and props['facing'] == 'east': normals = [(1, 0, 0), (-1, 0, 0)] else: normals = [(0, 0, 1), (0, 0, -1)] for normal in normals: adjacent, _ = get(blocks, add(p, normal)) assert adjacent in {'air', 'vine', 'spruce_leaves'}, (kind, p, normal, adjacent) def test_decorations_supported_and_preserved(model): blocks, _, manifest = model for pos, support in manifest['supports']: assert get(blocks, pos)[0] != 'air', pos assert solid(blocks, support), (pos, support, get(blocks, support)) for pos, (name, props) in blocks.items(): if name in {'lantern', 'fern', 'anvil', 'chest', 'campfire', 'lectern', 'stonecutter'} or name.startswith('potted_') or name.endswith('_carpet') or name.endswith('candle'): assert solid(blocks, add(pos, (0, -1, 0))), (pos, name, get(blocks, add(pos, (0, -1, 0)))) if name in {'ladder', 'white_wall_banner'}: d = DIRECTIONS[props['facing']] assert solid(blocks, add(pos, tuple(-v for v in d))), pos def passable(blocks, pos): """Treat doors as operable and shallow carpets as walkable.""" name, _ = get(blocks, pos) return name in {'air', 'ladder', 'vine', 'fern'} or name.endswith('_door') or name.endswith('_carpet') or name.endswith('_wall_banner') def test_all_rooms_reachable_with_two_block_headroom(model): blocks, _, manifest = model def walkable(p): below, _ = get(blocks, add(p, (0, -1, 0))) return 0 <= p[0] < 45 and 1 <= p[1] < 39 and 0 <= p[2] < 35 and passable(blocks, p) and passable(blocks, add(p, (0, 1, 0))) and (solid(blocks, add(p, (0, -1, 0))) or below.endswith('_stairs')) start = (17, 5, 9) assert walkable(start) seen = {start} queue = deque([start]) while queue: p = queue.popleft() for d in DIRECTIONS.values(): for dy in [-1, 0, 1]: q = add(add(p, d), (0, dy, 0)) if q in seen or not walkable(q): continue if dy: high = q if dy > 0 else p low = p if dy > 0 else q stair_name, stair_props = get(blocks, add(high, (0, -1, 0))) # Upward travel requires an actual correctly oriented stair, not jumping. if not stair_name.endswith('_stairs'): continue ascend = (high[0] - low[0], 0, high[2] - low[2]) if DIRECTIONS[stair_props['facing']] != ascend: continue if not passable(blocks, add(low, (0, 2, 0))): continue seen.add(q) queue.append(q) for room in manifest['rooms']: assert tuple(room['target']) in seen, (room['name'], room['target']) assert (17, 2, 3) in seen, 'Terrace stairs must connect to the approach' for floor in [4, 10, 16]: for i in range(6): for x in [11, 12]: stair = (x, floor + i + 1, 19 + i) assert get(blocks, stair)[0] == 'spruce_stairs' assert all(passable(blocks, add(stair, (0, dy, 0))) for dy in [1, 2]) def test_sealed_envelope_no_interior_air_connected_to_sky(model): blocks, _, manifest = model # Closed doors and glazing seal the shell; decorations must not hide leaks. def porous(p): name, _ = get(blocks, p) return name in {'air', 'vine', 'ladder', 'fern', 'lantern', 'iron_bars', 'campfire'} or name.startswith('potted_') or name.endswith(('_carpet', '_wall_banner', '_trapdoor', '_leaves', 'candle')) seen = set() queue = deque() for p, (name, _) in blocks.items(): if porous(p) and (p[0] in [0, 44] or p[1] in [0, 39] or p[2] in [0, 34]): seen.add(p) queue.append(p) vectors = list(DIRECTIONS.values()) + [(0, 1, 0), (0, -1, 0)] while queue: p = queue.popleft() for d in vectors: q = add(p, d) if q in blocks and q not in seen and porous(q): seen.add(q) queue.append(q) interior = [] for p, (name, _) in blocks.items(): x, y, z = p in_main = 10 <= x <= 24 and 11 <= z <= 27 and 5 <= y < Build().roof_height(x) - 1 in_side = 26 <= x <= 36 and 13 <= z <= 27 and 5 <= y < 25 - ((x - 25) * 7 // 10) if name == 'air' and (in_main or in_side): interior.append(p) leaks = set(interior) & seen assert not leaks, sorted(leaks)[:15] assert len(interior) > 5000 def test_furnished_rooms_and_lights(model): blocks, nbt, manifest = model region = next(iter(nbt['Regions'].values())) for room in manifest['rooms']: x0, y0, z0, x1, y1, z1 = room['bounds'] entries = [(p, n, props) for p, (n, props) in blocks.items() if x0 <= p[0] <= x1 and y0 <= p[1] <= y1 and z0 <= p[2] <= z1] names = {n for _, n, _ in entries} for expected in ['barrel', 'chest', 'ladder', 'lantern']: assert expected in names, (room['name'], expected) for suffix in ['_carpet', '_stairs', 'candle']: assert any(n.endswith(suffix) for n in names), (room['name'], suffix) assert any(n.startswith('potted_') for n in names) assert any(n == 'lantern' and p[1] <= room['floor'] + 3 for p, n, _ in entries) assert any(x0 <= int(e['TileX']) <= x1 and y0 <= int(e['TileY']) <= y1 and z0 <= int(e['TileZ']) <= z1 for e in region['Entities']) for x in [16, 17]: assert get(blocks, (x, 18, 13))[0] == 'green_bed' assert get(blocks, (x, 17, 13))[0] == 'spruce_planks' assert get(blocks, (14, 18, 26))[0] == 'bookshelf' assert all(get(blocks, (x, 20, 26))[0] == 'barrel' for x in [21, 22, 23]) def test_banner_item_frame_lectern_and_forge_nbt(model): blocks, nbt, _ = model region = next(iter(nbt['Regions'].values())) entities = region['Entities'] assert len(entities) == 6 codes = {2: 'north', 3: 'south', 4: 'west', 5: 'east'} for entity in entities: assert str(entity['id']) == 'minecraft:item_frame' assert entity['Item']['id'].startswith('minecraft:') and int(entity['Item']['count']) == 1 p = tuple(int(entity[k]) for k in ['TileX', 'TileY', 'TileZ']) direction = DIRECTIONS[codes[int(entity['Facing'])]] assert solid(blocks, add(p, tuple(-v for v in direction))) assert get(blocks, p)[0] == 'air' tiles = region['TileEntities'] banners = [t for t in tiles if str(t['id']) == 'minecraft:banner'] assert len(banners) == 2 for b in banners: assert {str(p['pattern']) for p in b['patterns']} == {'minecraft:stripe_left', 'minecraft:stripe_right'} assert all(str(p['color']) == 'green' for p in b['patterns']) assert get(blocks, tuple(int(b[k]) for k in ['x', 'y', 'z']))[0] == 'white_wall_banner' lectern = next(t for t in tiles if str(t['id']) == 'minecraft:lectern') assert lectern['Book']['components']['minecraft:written_book_content']['pages'] furnace = next(t for t in tiles if str(t['id']) == 'minecraft:blast_furnace') assert int(furnace['BurnTime']) > 0 and len(furnace['Items']) == 2 assert get(blocks, (33, 6, 11))[1]['lit'] == 'true' assert get(blocks, (34, 6, 10))[1]['lit'] == 'true' assert get(blocks, (31, 5, 8))[0] == 'anvil' assert all(get(blocks, (34, y, 11))[0] != 'air' for y in range(7, 32)) def test_roof_junction_and_hand_built_pines(model): blocks, _, manifest = model # Every roof layer overlaps the adjacent slope in height, with no slit. for x in range(25, 39): a = {y for y in range(15, 28) if 'deepslate' in get(blocks, (x, y, 20))[0]} b = {y for y in range(15, 28) if 'deepslate' in get(blocks, (x + 1, y, 20))[0]} assert a & b, x assert len(manifest['trees']) >= 2 for x, z, height in manifest['trees']: assert all(get(blocks, (x, y, z))[0] == 'spruce_log' for y in range(2, height + 1)) branches = [p for p, (n, props) in blocks.items() if n == 'spruce_log' and props.get('axis') in ['x', 'z'] and abs(p[0] - x) <= 4 and abs(p[2] - z) <= 4] assert len({p[1] for p in branches}) >= 3 def test_deterministic_regeneration_and_round_trip(): with tempfile.TemporaryDirectory(dir=ROOT / 'test') as folder: output = Path(folder) / 'output.litematic' build = Build().build() build.export(output) report = build.verify(output) assert report['size_xyz'] == [45, 40, 35] assert hashlib.sha256(output.read_bytes()).digest() == hashlib.sha256((ROOT / 'output.litematic').read_bytes()).digest() def test_generator_runs_without_arguments_in_clean_directory(): with tempfile.TemporaryDirectory(dir=ROOT / 'test') as folder: result = subprocess.run([sys.executable, str(ROOT / 'generate.py')], cwd=folder, capture_output=True, text=True) assert result.returncode == 0, result.stderr assert (Path(folder) / 'output.litematic').read_bytes() == (ROOT / 'output.litematic').read_bytes() assert (Path(folder) / 'build_manifest.json').is_file()

# Generate and verify the furnished Amberstone Lodge schematic for Minecraft Java 1.21.1. from __future__ import annotations import argparse import gzip import io import random import sys from pathlib import Path from typing import Dict, Iterable, Optional, Tuple sys.path.insert(0, "/work/generator/MCIO") from mcio.nbt.nbt import File as NBTFile from mcio.nbt.tag import Compound, Int, Short, Byte, Float, Double, String, IntArray, List as NBTList from mcio.schematic import load_schematic # noqa: E402 from mcio.sketch import LitematicCanvas, Material, parse_blockstate # noqa: E402 CONFIG = { "seed": 20260923, "size_xyz": (45, 40, 35), # width X, height Y, depth Z "minecraft_version": "1.21.1", "data_version": 3955, "output": "output.litematic", "name": "Amberstone Lodge", "author": "generator", "description": "Four-storey timber lodge, vaulted dining wing, working smithy, raised terrace and handmade pines. Java 1.21.1.", } STONE = ['minecraft:stone_bricks'] * 6 + ['minecraft:cobblestone'] * 2 + ['minecraft:mossy_stone_bricks'] PLASTER = ['minecraft:smooth_sandstone'] * 8 + ['minecraft:cut_sandstone'] * 2 + ['minecraft:sandstone'] TIMBER = ['minecraft:spruce_planks'] * 10 + ['minecraft:dark_oak_planks', 'minecraft:stripped_spruce_wood'] ROOF = ['minecraft:deepslate_tiles'] * 7 + ['minecraft:deepslate_bricks'] * 2 + ['minecraft:polished_deepslate'] DIRECTIONS = {'north': (0, -1), 'south': (0, 1), 'east': (1, 0), 'west': (-1, 0)} Position = Tuple[int, int, int] class Build: """Hold a block volume and write it out as a Litematica schematic.""" def __init__(self, size_xyz: Tuple[int, int, int] = CONFIG["size_xyz"], seed: int = CONFIG["seed"]) -> None: """Create an empty volume with one seeded random source. Args: size_xyz (Tuple[int, int, int]): Volume size as width X, height Y, depth Z. seed (int): Seed for every random decision in this build. """ self.size_x, self.size_y, self.size_z = size_xyz self.rng = random.Random(seed) self.canvas = LitematicCanvas((self.size_y, self.size_z, self.size_x)) self.placed: Dict[Position, str] = {} self.tiles = [] self.entities = [] self.windows = [] def inside(self, x: int, y: int, z: int) -> bool: """Report whether a coordinate is inside the volume. Args: x (int): Width coordinate. y (int): Height coordinate. z (int): Depth coordinate. Returns: bool: True when every axis is within range. """ return 0 <= x < self.size_x and 0 <= y < self.size_y and 0 <= z < self.size_z def put(self, x: int, y: int, z: int, block: str | Material, **properties: str) -> None: """Place one block, in XYZ order, with an immediate bounds check. Args: x (int): Width coordinate. y (int): Height coordinate. z (int): Depth coordinate. block (str | Material): Namespaced block name, a full blockstate string, or a Material. **properties: Blockstate properties such as facing or half. Raises: AssertionError: When the coordinate is outside the volume, naming the coordinate. """ assert self.inside(x, y, z), f"out of bounds: (x={x}, y={y}, z={z}) in {self.size_x}x{self.size_y}x{self.size_z}" material = self.material(block, **properties) if isinstance(block, str) else block self.canvas.block((y, z, x), material) self.placed[(x, y, z)] = material.blockstate def material(self, name: str, **properties: str) -> Material: """Build a Material from a block name and its properties. Args: name (str): Namespaced block name, or a full blockstate string. **properties: Blockstate properties. Returns: Material: Material ready for placement. """ if "[" in name: return parse_blockstate(name) return self.canvas.material(name, **dict(sorted(properties.items()))) def box(self, bounds: Tuple[int, int, int, int, int, int], block: str | Material, **properties: str) -> None: """Fill an inclusive box. Args: bounds (Tuple[int, int, int, int, int, int]): x0, y0, z0, x1, y1, z1, inclusive on both ends. block (str | Material): Block to place. **properties: Blockstate properties. """ x0, y0, z0, x1, y1, z1 = bounds for x in range(min(x0, x1), max(x0, x1) + 1): for y in range(min(y0, y1), max(y0, y1) + 1): for z in range(min(z0, z1), max(z0, z1) + 1): self.put(x, y, z, block, **properties) def shell(self, bounds: Tuple[int, int, int, int, int, int], block: str | Material, **properties: str) -> None: """Fill only the faces of a box, leaving the inside empty. Args: bounds (Tuple[int, int, int, int, int, int]): x0, y0, z0, x1, y1, z1, inclusive. block (str | Material): Block to place. **properties: Blockstate properties. """ x0, y0, z0, x1, y1, z1 = bounds for x in range(min(x0, x1), max(x0, x1) + 1): for y in range(min(y0, y1), max(y0, y1) + 1): for z in range(min(z0, z1), max(z0, z1) + 1): on_face = x in (x0, x1) or y in (y0, y1) or z in (z0, z1) if on_face: self.put(x, y, z, block, **properties) def texture(self, bounds: Tuple[int, int, int, int, int, int], palette: Iterable[str]) -> None: """Fill a box with a weighted mix of related blocks, so the surface is not flat. Args: bounds (Tuple[int, int, int, int, int, int]): x0, y0, z0, x1, y1, z1, inclusive. palette (Iterable[str]): Block names. Repeat a name to make it more common. """ choices = list(palette) x0, y0, z0, x1, y1, z1 = bounds for x in range(min(x0, x1), max(x0, x1) + 1): for y in range(min(y0, y1), max(y0, y1) + 1): for z in range(min(z0, z1), max(z0, z1) + 1): self.put(x, y, z, self.rng.choice(choices)) def get(self, x: int, y: int, z: int) -> Optional[str]: """Read back what was placed at a coordinate. Args: x (int): Width coordinate. y (int): Height coordinate. z (int): Depth coordinate. Returns: Optional[str]: Blockstate string, or None when the cell is empty. """ return self.placed.get((x, y, z)) def block_entity(self, pos: Position, kind: str, **data) -> None: """Attach block entity data to a local XYZ position. Args: pos (Position): Tile position. kind (str): Vanilla block entity identifier. **data: Typed NBT fields. """ x, y, z = pos self.tiles.append(Compound(dict(id=String('minecraft:' + kind), x=Int(x), y=Int(y), z=Int(z), **data))) def frame(self, pos: Position, facing: str, item: str) -> None: """Hang an item frame on the solid block behind its facing. Args: pos (Position): Air cell occupied by the frame. facing (str): Cardinal outward direction. item (str): Displayed vanilla item. """ x, y, z = pos dx, dz = DIRECTIONS[facing] yaw = {'north': 180., 'south': 0., 'west': 90., 'east': 270.}[facing] self.entities.append(Compound({ 'id': String('minecraft:item_frame'), 'Pos': NBTList[Double]([x + .5 - dx * .46875, y + .5, z + .5 - dz * .46875]), 'Motion': NBTList[Double]([0., 0., 0.]), 'Rotation': NBTList[Float]([yaw, 0.]), 'TileX': Int(x), 'TileY': Int(y), 'TileZ': Int(z), 'Facing': Byte({ 'north': 2, 'south': 3, 'west': 4, 'east': 5 }[facing]), 'Item': Compound({ 'id': String('minecraft:' + item), 'count': Int(1) }), 'ItemRotation': Byte(0), 'ItemDropChance': Float(1.), 'UUID': IntArray([self.rng.randint(-2147483648, 2147483647) for _ in range(4)]), })) def storage(self, x: int, y: int, z: int, kind: str = 'barrel', facing: str = 'north', item: str = 'bread') -> None: """Place usable storage with a small themed inventory. Args: x (int): X position. y (int): Y position. z (int): Z position. kind (str): Barrel or chest. facing (str): Front direction. item (str): Stored item. """ props = dict(facing=facing) if kind == 'barrel': props['open'] = 'false' else: props.update(type='single', waterlogged='false') self.put(x, y, z, 'minecraft:' + kind, **props) self.block_entity((x, y, z), kind, Items=NBTList[Compound]([Compound({'Slot': Byte(0), 'id': String('minecraft:' + item), 'count': Int(16)})])) def door(self, x: int, y: int, z: int, facing: str, hinge: str = 'left') -> None: """Install a matched, closed, two-block spruce door. Args: x (int): X position. y (int): Lower-half height. z (int): Z position. facing (str): Door facing. hinge (str): Hinge side. """ for half, dy in [('lower', 0), ('upper', 1)]: self.put(x, y + dy, z, 'minecraft:spruce_door', facing=facing, hinge=hinge, half=half, open='false', powered='false') def lamp(self, x: int, y: int, z: int, hanging: bool = False) -> None: """Place a lantern at a planned supported position. Args: x (int): X position. y (int): Y position. z (int): Z position. hanging (bool): Attach to the block above. """ self.put(x, y, z, 'minecraft:lantern', hanging=str(hanging).lower(), waterlogged='false') def window(self, axis: str, fixed: int, a: int, b: int, bottom: int, top: int, outward: str) -> None: """Glaze an opening with projecting timber casing and paired shutters. Args: axis (str): Vary X on a Z wall, or vary Z on an X wall. fixed (int): Fixed wall coordinate. a (int): First varying coordinate. b (int): Last varying coordinate. bottom (int): Bottom glass height. top (int): Top glass height. outward (str): Exterior-facing direction. """ dx, dz = DIRECTIONS[outward] for u in range(a - 1, b + 2): for y in range(bottom - 1, top + 2): x, z = (u, fixed) if axis == 'x' else (fixed, u) border = u in (a - 1, b + 1) or y in (bottom - 1, top + 1) if border: self.put(x, y, z, 'minecraft:stripped_spruce_log', axis='x' if y in (bottom - 1, top + 1) else 'y') if y == bottom - 1: self.put(x + dx, y, z + dz, 'minecraft:spruce_slab', type='top', waterlogged='false') else: self.put(x, y, z, 'minecraft:glass') self.windows.append((x, y, z, outward)) for u in (a - 1, b + 1): for y in range(bottom, top + 1): x, z = (u, fixed) if axis == 'x' else (fixed, u) self.put(x + dx, y, z + dz, 'minecraft:spruce_trapdoor', facing=outward, half='bottom', open='true', powered='false', waterlogged='false') def landscape(self) -> None: """Lay the terrain, irregular approach, and stepped masonry terrace.""" self.box((0, 0, 0, 44, 0, 34), 'minecraft:stone') self.texture((0, 1, 0, 44, 1, 34), ['minecraft:grass_block'] * 14 + ['minecraft:moss_block', 'minecraft:coarse_dirt']) for z in range(0, 7): center = 17 - z // 3 for x in range(center - 2, center + 3): if abs(x - center) < 2 or self.rng.random() < .72: self.put(x, 1, z, self.rng.choice(STONE + ['minecraft:gravel', 'minecraft:andesite'])) # A broad landing and a narrower return make the terrace edge less rectangular. self.texture((6, 2, 7, 38, 4, 13), STONE) self.texture((8, 2, 6, 36, 4, 6), STONE) for x in range(7, 39): self.put(x, 4, 7, 'minecraft:stone_bricks') for z, y in [(3, 2), (4, 3), (5, 4)]: self.texture((13, 1, z, 18, y - 1, z), STONE) self.box((13, y, z, 18, y, z), 'minecraft:stone_brick_stairs', facing='south', half='bottom', shape='straight', waterlogged='false') for x in (10, 21, 27, 37): self.box((x, 5, 6, x, 5, 6), 'minecraft:stone_brick_wall', up='true', north='none', south='none', east='none', west='none', waterlogged='false') self.lamp(x, 6, 6) for a, b in [(8, 11), (20, 25), (28, 35)]: for x in range(a, b + 1): self.put(x, 5, 6, 'minecraft:spruce_fence', east='true', west='true', north='false', south='false', waterlogged='false') # Lantern piers replace the fence at their coordinates. for x in (10, 21, 27): self.put(x, 5, 6, 'minecraft:stone_bricks') def architecture(self) -> None: """Assemble the connected stone base, timber floors, plaster walls, and roofs.""" for x0, z0, x1, z1, top in [(7, 10, 23, 28, 22), (23, 12, 37, 28, 16)]: self.texture((x0, 2, z0, x1, 4, z1), STONE) for y in range(5, top): pal = STONE if y <= 9 else PLASTER for x in range(x0, x1 + 1): for z in range(z0, z1 + 1): if x in (x0, x1) or z in (z0, z1): self.put(x, y, z, self.rng.choice(pal)) for y in [4, 10] + ([16, 22] if top == 22 else []): self.texture((x0, y, z0, x1, y, z1), TIMBER) # Continuous dark perimeter beams. for z in (z0, z1): self.box((x0, y, z, x1, y, z), 'minecraft:dark_oak_log', axis='x') for x in (x0, x1): self.box((x, y, z0, x, y, z1), 'minecraft:dark_oak_log', axis='z') for x in range(x0, x1 + 1, 4): for z in (z0, z1): self.box((x, 11, z, x, top - 1, z), 'minecraft:dark_oak_log', axis='y') for z in range(z0, z1 + 1, 4): for x in (x0, x1): self.box((x, 11, z, x, top - 1, z), 'minecraft:dark_oak_log', axis='y') for x, z in [(x0, z0), (x1, z0), (x0, z1), (x1, z1)]: self.box((x, 5, z, x, 9, z), 'minecraft:polished_andesite') # Tall roof has a two-block vertical rise per horizontal run. for x in range(6, 25): h = 38 - 2 * abs(x - 15) for z in range(8, 31): for y in range(h, min(h + 2, 40)): self.put(x, y, z, self.rng.choice(ROOF)) if x != 15: self.put(x, h + 1, z, 'minecraft:deepslate_tile_stairs', facing='east' if x < 15 else 'west', half='bottom', shape='straight', waterlogged='false') for z in (8, 30): self.box((x, h, z, x, min(h + 1, 39), z), 'minecraft:polished_deepslate') for z in (10, 28): if 7 <= x <= 23: for y in range(23, h): self.put(x, y, z, self.rng.choice(PLASTER)) if h > 23: self.put(x, h - 1, z, 'minecraft:dark_oak_log', axis='y') # The perpendicular lower roof intersects the tall roof and its side wall. for z in range(11, 30): h = 25 - abs(z - 20) for x in range(23, 39): self.put(x, h, z, self.rng.choice(ROOF)) self.put(x, h + 1, z, 'minecraft:deepslate_tile_stairs', facing='south' if z < 20 else 'north', half='bottom', shape='straight', waterlogged='false') for x in (23, 37): for y in range(16, h): self.put(x, y, z, self.rng.choice(PLASTER) if x == 37 else 'minecraft:spruce_planks') self.put(x, h, z, 'minecraft:dark_oak_log', axis='x') self.box((23, 26, 20, 38, 26, 20), 'minecraft:deepslate_tile_slab', type='bottom', waterlogged='false') for z in (10, 28): self.box((15, 23, z, 15, 37, z), 'minecraft:dark_oak_log', axis='y') self.box((10, 27, z, 20, 27, z), 'minecraft:dark_oak_log', axis='x') self.box((12, 31, z, 18, 31, z), 'minecraft:dark_oak_log', axis='x') for x in (11, 19): self.box((x, 23, z, x, 29, z), 'minecraft:dark_oak_log', axis='y') self.box((37, 16, 12, 37, 16, 28), 'minecraft:dark_oak_log', axis='z') self.box((37, 17, 20, 37, 24, 20), 'minecraft:dark_oak_log', axis='y') # Continuous flashings where the lower roof reaches the tall wing. for z in range(12, 29): h = 25 - abs(z - 20) self.put(24, h, z, 'minecraft:polished_deepslate') # Two storeys communicate through generous openings in the shared wall. for y in (5, 11): self.box((23, y, 18, 23, y + 2, 20), 'minecraft:air') self.box((23, y + 3, 17, 23, y + 3, 21), 'minecraft:dark_oak_log', axis='z') self.door(15, 5, 10, 'north') self.door(16, 5, 10, 'north', 'right') self.door(29, 5, 12, 'north') for x in (14, 17): self.box((x, 5, 9, x, 7, 9), 'minecraft:stripped_spruce_log', axis='y') self.box((14, 8, 9, 17, 8, 9), 'minecraft:dark_oak_log', axis='x') for x in (13,): self.put(x, 7, 9, 'minecraft:dark_oak_log', axis='z') self.lamp(x, 6, 9, True) self.box((13, 9, 8, 18, 9, 9), 'minecraft:deepslate_tile_slab', type='bottom', waterlogged='false') # Ground and upper windows retain a full clear block on both sides. for a, b in [(9, 11), (19, 21)]: self.window('x', 10, a, b, 6, 7, 'north') for bottom in (12, 18): for a, b in [(10, 12), (18, 20)]: self.window('x', 10, a, b, bottom, bottom + 2, 'north') self.window('x', 10, 13, 17, 25, 28, 'north') self.window('x', 28, 13, 17, 25, 28, 'south') for bottom in (6, 12, 18): self.window('z', 7, 14, 16, bottom, bottom + 1, 'west') self.window('x', 28, 9, 11, bottom, bottom + 1, 'south') self.window('x', 12, 26, 28, 12, 14, 'north') self.window('x', 28, 27, 29, 6, 7, 'south') self.window('x', 28, 27, 29, 12, 14, 'south') self.window('z', 37, 16, 18, 6, 7, 'east') self.window('z', 37, 16, 18, 12, 14, 'east') self.window('z', 37, 19, 21, 19, 21, 'east') for z in (12, 23): self.put(6, 8, z, 'minecraft:dark_oak_log', axis='x') self.lamp(6, 7, z, True) # Upright beam feet and exposed floor joists reinforce the timber silhouette. for y in (10, 16, 22): for x in (7, 11, 19, 23): self.put(x, y, 9, 'minecraft:dark_oak_log', axis='z') # Exterior vines have explicit faces against stone, and never cover glazing. for y, zs in [(5, (19, 20, 21)), (6, (19, 20)), (7, (20,)), (8, (20, 21))]: for z in zs: self.put(6, y, z, 'minecraft:vine', east='true', west='false', north='false', south='false', up='false') for y, xs in [(5, (31, 32, 33)), (6, (32, 33)), (7, (33,)), (8, (33, 34))]: for x in xs: self.put(x, y, 29, 'minecraft:vine', north='true', east='false', south='false', west='false', up='false') def circulation(self) -> None: """Connect four floors with a supported ladder and the lower floors with a wide stair.""" self.box((21, 5, 26, 21, 25, 26), 'minecraft:stripped_spruce_log', axis='y') for y in range(5, 24): self.put(21, y, 25, 'minecraft:ladder', facing='north', waterlogged='false') for y in (10, 16, 22): self.put(21, y + 1, 24, 'minecraft:spruce_fence', north='false', south='true', east='false', west='false', waterlogged='false') self.put(22, y + 1, 25, 'minecraft:spruce_fence', north='false', south='false', east='false', west='true', waterlogged='false') self.box((35, 5, 27, 35, 13, 27), 'minecraft:stripped_spruce_log', axis='y') for y in range(5, 12): self.put(35, y, 26, 'minecraft:ladder', facing='north', waterlogged='false') # Six treads rise from the hall to the living room, supported by a timber stringer. for index in range(6): y, z = 5 + index, 20 + index self.box((9, 5, z, 10, y, z), 'minecraft:spruce_planks') self.box((9, y, z, 10, y, z), 'minecraft:spruce_stairs', facing='south', half='bottom', shape='straight', waterlogged='false') self.box((9, y + 1, z, 10, y + 3, z), 'minecraft:air') # Railing follows the side of the opening, leaving a broad top landing. for z in range(23, 26): self.put(11, 11, z, 'minecraft:spruce_fence', north='true', south='true', east='false', west='false', waterlogged='false') def room_details(self, anchor: Position, facing: str, item: str, pot: str, carpet: str) -> None: """Furnish a wall alcove with storage, a seat, textiles, and small objects. Args: anchor (Position): First cabinet at floor air height. facing (str): Displayed item direction. item (str): Item frame content. pot (str): Potted plant block name. carpet (str): Carpet color. """ x, y, z = anchor self.storage(x, y, z, 'barrel', facing, item) self.storage(x + 2, y, z, 'chest', facing, item) self.put(x + 4, y, z, 'minecraft:spruce_planks') self.put(x + 4, y + 1, z, 'minecraft:potted_' + pot) self.put(x + 6, y, z, 'minecraft:spruce_planks') self.put(x + 6, y + 1, z, 'minecraft:candle', candles='3', lit='true', waterlogged='false') self.lamp(x, y + 1, z) self.put(x + 2, y + 2, z, 'minecraft:dark_oak_planks') dx, dz = DIRECTIONS[facing] self.frame((x + 2 + dx, y + 2, z + dz), facing, item) # Wall hung block has an actual timber hanger into the wall behind it. self.put(x + 2 - dx, y + 2, z - dz, 'minecraft:dark_oak_log', axis='z') for ox in range(3): self.put(x + 3 + ox, y, z + (-2 if facing == 'north' else 2), 'minecraft:' + carpet + '_carpet') self.put(x + 6, y, z + (-2 if facing == 'north' else 2), 'minecraft:spruce_stairs', facing='south' if facing == 'north' else 'north', half='bottom', shape='straight', waterlogged='false') def furnish(self) -> None: """Give each of the six room groups a distinct, fully supplied interior.""" # Entrance hall and storage: clear central passage from the double front door. self.room_details((13, 5, 27), 'north', 'iron_pickaxe', 'fern', 'gray') self.box((8, 5, 12, 8, 6, 12), 'minecraft:bookshelf') self.put(8, 5, 18, 'minecraft:crafting_table') self.lamp(8, 6, 18) self.box((14, 5, 14, 16, 5, 18), 'minecraft:brown_carpet') self.put(8, 5, 14, 'minecraft:spruce_stairs', facing='east', half='bottom', shape='straight', waterlogged='false') # Lower workshop with tool chest, grindstone, and repair counter. self.room_details((25, 5, 25), 'north', 'iron_ingot', 'dead_bush', 'brown') self.box((25, 5, 26, 31, 8, 26), 'minecraft:spruce_planks') self.put(25, 5, 14, 'minecraft:crafting_table') self.put(26, 5, 14, 'minecraft:smithing_table') self.put(27, 5, 14, 'minecraft:stonecutter', facing='north') self.put(33, 5, 15, 'minecraft:polished_andesite') self.put(33, 6, 15, 'minecraft:grindstone', face='floor', facing='north') self.put(31, 5, 17, 'minecraft:anvil', facing='east') self.box((29, 5, 20, 31, 5, 22), 'minecraft:gray_carpet') # Living room: fireplace, couches and a low central table. self.room_details((13, 11, 27), 'north', 'book', 'azalea_bush', 'orange') self.box((8, 11, 18, 8, 13, 20), 'minecraft:bookshelf') self.box((12, 11, 15, 16, 11, 19), 'minecraft:orange_carpet') for z in range(16, 19): self.put(11, 11, z, 'minecraft:spruce_stairs', facing='east', half='bottom', shape='straight', waterlogged='false') self.put(18, 11, z, 'minecraft:spruce_stairs', facing='west', half='bottom', shape='straight', waterlogged='false') for z in (16, 18): self.put(14, 11, z, 'minecraft:stripped_spruce_log', axis='y') self.box((14, 12, 16, 14, 12, 18), 'minecraft:spruce_slab', type='bottom', waterlogged='false') self.box((18, 11, 12, 21, 13, 13), 'minecraft:stone_bricks') self.put(19, 11, 12, 'minecraft:campfire', lit='true', signal_fire='false', facing='north', waterlogged='false') self.put(20, 11, 12, 'minecraft:campfire', lit='true', signal_fire='false', facing='north', waterlogged='false') self.box((18, 14, 12, 21, 14, 13), 'minecraft:polished_andesite') # Dining room: vaulted ceiling, long table and pantry. self.room_details((25, 11, 25), 'north', 'apple', 'dandelion', 'red') self.box((25, 11, 26, 31, 14, 26), 'minecraft:spruce_planks') self.box((27, 11, 16, 33, 11, 22), 'minecraft:red_carpet') for z in range(17, 22): self.put(30, 11, z, 'minecraft:stripped_spruce_log', axis='y') self.put(30, 12, z, 'minecraft:spruce_slab', type='top', waterlogged='false') self.put(30, 13, 19, 'minecraft:green_candle', candles='3', lit='true', waterlogged='false') for z in (17, 19, 21): self.put(28, 11, z, 'minecraft:spruce_stairs', facing='east', half='bottom', shape='straight', waterlogged='false') self.put(32, 11, z, 'minecraft:spruce_stairs', facing='west', half='bottom', shape='straight', waterlogged='false') self.box((25, 11, 14, 25, 12, 16), 'minecraft:bookshelf') for z in (15, 24): self.put(34, 13, z, 'minecraft:dark_oak_log', axis='y') self.box((34, 14, z, 34, 25 - abs(z - 20) - 1, z), 'minecraft:chain', axis='y', waterlogged='false') self.lamp(34, 12, z, True) # Bedroom: green double bed on a one-block dais with a real stair approach. self.room_details((13, 17, 27), 'north', 'emerald', 'blue_orchid', 'green') self.box((9, 17, 12, 13, 17, 15), 'minecraft:spruce_planks') for x in range(9, 14): self.put(x, 17, 16, 'minecraft:spruce_stairs', facing='north', half='bottom', shape='straight', waterlogged='false') self.box((9, 18, 12, 13, 19, 12), 'minecraft:dark_oak_planks') for x in (10, 11): self.put(x, 18, 13, 'minecraft:green_bed', facing='north', part='head', occupied='false') self.put(x, 18, 14, 'minecraft:green_bed', facing='north', part='foot', occupied='false') self.lamp(13, 18, 14) self.box((14, 17, 17, 18, 17, 20), 'minecraft:green_carpet') self.box((8, 17, 19, 8, 20, 22), 'minecraft:bookshelf') for x in (18, 20): self.storage(x, 20, 27, 'barrel', 'north', 'paper') self.put(x, 20, 28, 'minecraft:dark_oak_log', axis='z') # Paired curtains hang beside the bedroom's front-right window. for x in (17, 21): self.put(x, 20, 11, 'minecraft:green_wall_banner', facing='south') self.block_entity((x, 20, 11), 'banner', patterns=NBTList[Compound]([Compound({'pattern': String('minecraft:small_stripes'), 'color': String('white')}), Compound({'pattern': String('minecraft:border'), 'color': String('green')})])) # Attic study: books, writing desk and a lit reading nook below the rafters. self.room_details((10, 23, 26), 'north', 'map', 'red_tulip', 'cyan') self.box((10, 23, 27, 16, 24, 27), 'minecraft:spruce_planks') self.box((10, 23, 18, 10, 25, 22), 'minecraft:bookshelf') self.box((14, 23, 13, 17, 23, 13), 'minecraft:spruce_planks') self.put(14, 24, 13, 'minecraft:potted_fern') self.lamp(17, 24, 13) self.put(15, 23, 15, 'minecraft:spruce_stairs', facing='north', half='bottom', shape='straight', waterlogged='false') self.put(18, 23, 15, 'minecraft:lectern', facing='west', has_book='true', powered='false') self.block_entity((18, 23, 15), 'lectern', Book=Compound({'id': String('minecraft:written_book'), 'count': Int(1), 'components': Compound({'minecraft:written_book_content': Compound({'title': Compound({'raw': String('Amberstone field notes')}), 'author': String('The Lodge Keeper'), 'pages': NBTList[Compound]([Compound({'raw': String('{"text":"Amberstone Lodge\\n\\nThe forge burns below. Pine shadows cross the terrace.\\n\\nRoof survey: autumn, year 21."}')})]), 'resolved': Byte(1), 'generation': Int(0)})})}), Page=Int(0)) self.box((13, 23, 18, 17, 23, 22), 'minecraft:cyan_carpet') for z in (15, 23): # Short tie beams touch both roof slopes; pendants hang low enough to light the floor. self.box((10, 28, z, 20, 28, z), 'minecraft:dark_oak_log', axis='x') self.box((15, 26, z, 15, 27, z), 'minecraft:chain', axis='y', waterlogged='false') self.lamp(15, 25, z, True) def smithy(self) -> None: """Build the sheltered forge, lit hearth, chimney, anvil and supply bins.""" for x in (25, 37): self.box((x, 5, 7, x, 9, 7), 'minecraft:dark_oak_log', axis='y') self.put(x, 5, 7, 'minecraft:polished_andesite') self.box((x, 5, 11, x, 12, 11), 'minecraft:dark_oak_log', axis='y') self.box((25, 9, 7, 37, 9, 7), 'minecraft:dark_oak_log', axis='x') for z in range(6, 12): y = 9 + (z - 6) // 2 for x in range(24, 39): self.put(x, y, z, self.rng.choice(ROOF)) if z % 2 == 0: self.put(x, y, z, 'minecraft:deepslate_tile_stairs', facing='south', half='bottom', shape='straight', waterlogged='false') for x in (26, 31, 36): self.lamp(x, 8, 7, True) self.texture((33, 5, 9, 36, 5, 11), ['minecraft:deepslate_bricks', 'minecraft:polished_deepslate']) for x in (33, 36): self.texture((x, 6, 9, x, 8, 11), STONE) self.texture((33, 6, 11, 36, 8, 11), STONE) self.texture((33, 8, 9, 36, 8, 11), STONE) for x in (34, 35): self.put(x, 5, 9, 'minecraft:blast_furnace', facing='north', lit='true') self.block_entity((x, 5, 9), 'blast_furnace', BurnTime=Short(16000), CookTime=Short(0), CookTimeTotal=Short(100), Items=NBTList[Compound]([Compound({'Slot': Byte(0), 'id': String('minecraft:raw_iron'), 'count': Int(64)}), Compound({'Slot': Byte(1), 'id': String('minecraft:coal_block'), 'count': Int(64)})])) self.put(x, 6, 10, 'minecraft:campfire', lit='true', signal_fire='false', facing='north', waterlogged='false') self.texture((34, 9, 10, 35, 26, 11), ['minecraft:stone_bricks'] * 5 + ['minecraft:bricks', 'minecraft:cracked_stone_bricks']) for y in (14, 20, 25): self.box((34, y, 10, 35, y, 11), 'minecraft:polished_andesite') self.box((33, 27, 9, 36, 27, 12), 'minecraft:stone_brick_slab', type='bottom', waterlogged='false') self.put(31, 5, 8, 'minecraft:anvil', facing='east') self.storage(26, 5, 10, item='iron_ingot') self.storage(27, 5, 10, 'chest', item='coal') self.put(26, 6, 10, 'minecraft:potted_fern') self.put(28, 5, 10, 'minecraft:smithing_table') self.put(31, 5, 10, 'minecraft:water_cauldron', level='3') self.frame((32, 7, 11), 'north', 'iron_axe') # Forge sign uses the solid front wall as its backing. self.put(32, 7, 12, 'minecraft:dark_oak_planks') def pine(self, cx: int, cz: int, height: int, radius: int) -> None: """Grow a handmade pine with an exposed trunk and stepped, layered boughs. Args: cx (int): Trunk X coordinate. cz (int): Trunk Z coordinate. height (int): Height above terrain. radius (int): Maximum bough radius. """ self.box((cx, 2, cz, cx, height + 1, cz), 'minecraft:spruce_log', axis='y') for y in range(5, height + 1, 3): reach = max(1, round(radius * (height + 3 - y) / height)) for dx, dz in DIRECTIONS.values(): for step in range(1, reach + 1): py = y + (1 if step == reach and reach > 1 else 0) x, z = cx + dx * step, cz + dz * step if self.inside(x, py, z) and not self.get(x, py, z): self.put(x, py, z, 'minecraft:spruce_log', axis='x' if dx else 'z') for dy, r in [(0, reach), (1, reach), (2, max(0, reach - 1))]: for dx in range(-r, r + 1): for dz in range(-r, r + 1): x, z, py = cx + dx, cz + dz, y + dy if abs(dx) + abs(dz) > r + max(1, r // 2): continue if not self.inside(x, py, z) or self.get(x, py, z): continue leaf = 'minecraft:spruce_leaves' if self.rng.random() < .86 else 'minecraft:oak_leaves' self.put(x, py, z, leaf, persistent='true', distance='1', waterlogged='false') for dy in (1, 2): self.put(cx, height + 1 + dy, cz, 'minecraft:spruce_leaves', persistent='true', distance='1', waterlogged='false') def garden(self) -> None: """Add pines, planted beds, supported shrubs and scattered stones.""" self.pine(3, 25, 22, 4) self.pine(41, 28, 20, 4) self.pine(41, 5, 13, 3) for x, z in [(3, 17), (4, 19), (40, 17), (41, 19), (9, 32), (27, 32), (30, 3)]: self.put(x, 2, z, 'minecraft:mossy_cobblestone') self.put(x, 3, z, 'minecraft:azalea_leaves', persistent='true', distance='1', waterlogged='false') for x, z in [(8, 3), (10, 2), (22, 3), (26, 4), (33, 3), (4, 13), (3, 30), (13, 32), (21, 32), (34, 32), (42, 13)]: self.put(x, 2, z, 'minecraft:fern') for x, z in [(7, 4), (24, 3), (29, 4), (11, 32), (32, 32), (41, 15)]: self.put(x, 2, z, self.rng.choice(['minecraft:poppy', 'minecraft:dandelion', 'minecraft:azure_bluet'])) for x in (8, 22): self.put(x, 5, 8, 'minecraft:coarse_dirt') self.put(x, 6, 8, 'minecraft:flowering_azalea') self.put(x, 5, 7, 'minecraft:spruce_trapdoor', facing='north', open='true', half='bottom', powered='false', waterlogged='false') for x, z in [(5, 2), (35, 3), (39, 21), (6, 32)]: self.put(x, 2, z, 'minecraft:mossy_cobblestone') self.put(x + 1, 2, z, 'minecraft:andesite') def build(self) -> 'Build': """Construct Amberstone Lodge and all landscape and furnishing details. Returns: Build: The completed instance. """ self.landscape() self.architecture() self.circulation() self.furnish() self.smithy() self.garden() return self def export(self, path: Path) -> Path: """Write the schematic so that two runs produce identical bytes. Args: path (Path): Destination .litematic path. Returns: Path: The path written. """ schematic = self.canvas.to_litematica( name=CONFIG["name"], author=CONFIG["author"], description=CONFIG["description"], minecraft_data_version=CONFIG["data_version"], ) # The metadata otherwise records the current wall clock, which changes the bytes on every run. schematic.metadata.time_created = 0 schematic.metadata.time_modified = 0 path.parent.mkdir(parents=True, exist_ok=True) nbt = schematic.write_to_nbt() region = nbt['Regions'][CONFIG['name']] region['TileEntities'] = NBTList[Compound](self.tiles) region['Entities'] = NBTList[Compound](self.entities) # Standard compressed NBT with a fixed gzip timestamp preserves byte reproducibility. buffer = io.BytesIO() NBTFile(nbt).write(buffer) path.write_bytes(gzip.compress(buffer.getvalue(), mtime=0)) return path def verify(self, path: Path) -> Dict[str, object]: """Reload the written file and confirm it matches what was placed. Args: path (Path): Schematic to reload. Returns: Dict[str, object]: Size, block count and palette size of the reloaded file. Raises: AssertionError: When a reloaded cell differs from what was placed. """ loaded = load_schematic(path) size_y, size_z, size_x = loaded.size_yzx assert (size_x, size_y, size_z) == (self.size_x, self.size_y, self.size_z), "size changed on reload" ids = loaded.read_flat(0, loaded.volume).reshape(loaded.size_yzx) for (x, y, z), state in self.placed.items(): assert loaded.palette[int(ids[y, z, x])] == state, f"cell (x={x}, y={y}, z={z}) changed on reload" return { "size_xyz": [size_x, size_y, size_z], "non_air_blocks": sum(state != 'minecraft:air' for state in self.placed.values()), "block_entities": len(self.tiles), "item_frames": len(self.entities), "palette_states": len(loaded.palette), } def main() -> None: """Generate the build, export it, and verify the exported file.""" parser = argparse.ArgumentParser(description="Generate a Minecraft schematic.") parser.add_argument("--output", type=Path, default=Path(CONFIG["output"])) parser.add_argument("--seed", type=int, default=CONFIG["seed"]) args = parser.parse_args() build = Build(seed=args.seed).build() path = build.export(args.output) report = build.verify(path) print(f"wrote {path}: {report}") if __name__ == "__main__": main()

# Export compact floor cutaways from the delivered schematic for interior inspection. from pathlib import Path from generate import CONFIG, LitematicCanvas, load_schematic, parse_blockstate CUTS = { 'ground_cutaway': (6, 4, 6, 38, 9, 29), 'living_cutaway': (7, 10, 10, 37, 15, 28), 'bedroom_cutaway': (7, 16, 10, 23, 21, 28), 'attic_cutaway': (7, 22, 10, 23, 29, 28), } def main() -> None: """Copy block geometry into four open-topped floor previews.""" source = Path(__file__).resolve().parent / 'output.litematic' out = source.parent / 'previews' out.mkdir(exist_ok=True) loaded = load_schematic(source) ids = loaded.read_flat(0, loaded.volume).reshape(loaded.size_yzx) for name, (x0, y0, z0, x1, y1, z1) in CUTS.items(): canvas = LitematicCanvas((y1 - y0 + 1, z1 - z0 + 1, x1 - x0 + 1)) for x in range(x0, x1 + 1): for y in range(y0, y1 + 1): for z in range(z0, z1 + 1): state = loaded.palette[int(ids[y, z, x])] if state != 'minecraft:air': canvas.block((y - y0, z - z0, x - x0), parse_blockstate(state)) schematic = canvas.to_litematica(name=name, minecraft_data_version=CONFIG['data_version']) schematic.metadata.time_created = 0 schematic.metadata.time_modified = 0 schematic.save(out / (name + '.litematic')) print(f'wrote {out / name}.litematic') if __name__ == '__main__': main()

// Starting point for rendering a build. Copy into the workspace and edit VIEWS. // Lighting, camera framing and background are already tuned; run it as is to get a first look. import fs from 'node:fs'; import path from 'node:path'; import { createRequire } from 'node:module'; import { createRenderScene, renderLitematicWithMetadata } from '/work/generator/MCRender/src/headless/index.ts'; const RENDER_ROOT = '/work/generator/MCRender'; const requireRenderer = createRequire(path.join(RENDER_ROOT, 'package.json')); const { PNG } = requireRenderer('pngjs'); // vite-node passes script arguments after a bare "--", so drop it before reading them. const argv = process.argv.slice(2).filter(entry => entry !== '--'); const INPUT = argv[0] ?? 'output.litematic'; const OUT_DIR = argv[1] ?? 'previews'; const SIZE = Number(process.env.RENDER_SIZE ?? 896); // Tuned defaults. Ambient near 0.72 keeps shaded faces readable, and a light direction with a // dominant +Y term plus a small +X/+Z tilt separates roof, wall and ground planes. const LIGHT_DIRECTION = [0.08, 0.28, 0.15]; const AMBIENT = 0.72; const BACKGROUND = [47, 52, 59, 255]; const VIEWS = [ { name: 'front', azimuth: 210, elevation: 22, radius: 3.3 }, { name: 'rear', azimuth: 35, elevation: 25, radius: 3.3 }, { name: 'side', azimuth: 145, elevation: 22, radius: 3.3 }, { name: 'top', azimuth: 210, elevation: 62, radius: 3.4 }, { name: 'ground_cutaway', cutaway: true, azimuth: 210, elevation: 63, radius: 3.7 }, { name: 'living_cutaway', cutaway: true, azimuth: 210, elevation: 63, radius: 3.7 }, { name: 'bedroom_cutaway', cutaway: true, azimuth: 35, elevation: 58, radius: 3.7 }, { name: 'attic_cutaway', cutaway: true, azimuth: 210, elevation: 63, radius: 3.7 }, ]; // Resolve every path while the working directory is still the caller's. const absoluteInput = path.resolve(INPUT); const absoluteOutDir = path.resolve(OUT_DIR); fs.mkdirSync(absoluteOutDir, { recursive: true }); // The renderer looks for its resource cache relative to the working directory, so move there first, // and only then create the scene. process.chdir(RENDER_ROOT); const scene = createRenderScene({ width: SIZE, height: SIZE }); for (const view of VIEWS) { const viewInput = view.cutaway ? path.join(absoluteOutDir, `${view.name}.litematic`) : absoluteInput; if (!fs.existsSync(viewInput)) continue; const result = renderLitematicWithMetadata(viewInput, { width: SIZE, height: SIZE, fov_deg: 30, radius: view.radius, nRandomAzimuths: 0, azimuthInit: 0, elevationInit: 0, azimuthsDeltas: [view.azimuth], elevationsDeltas: [view.elevation], ambientIntensities: [AMBIENT], lightDirections: [LIGHT_DIRECTION], mirror: [false], layout: [[0]], limit: 512, seed: 0, opaque: false, }, scene); // Flatten onto an opaque background so shaded faces keep their contrast. for (let i = 0; i < result.png.data.length; i += 4) { const alpha = result.png.data[i + 3] / 255; for (let channel = 0; channel < 3; channel++) { result.png.data[i + channel] = Math.round(result.png.data[i + channel] * alpha + BACKGROUND[channel] * (1 - alpha)); } result.png.data[i + 3] = 255; } const target = path.join(absoluteOutDir, `${view.name}.png`); fs.writeFileSync(target, PNG.sync.write(result.png)); console.log(`wrote ${target} (${SIZE}x${SIZE}, azimuth ${view.azimuth}, elevation ${view.elevation})`); }

# Verify the delivered schematic's geometry, navigation, attachments, and saved Java 1.21.1 data. from collections import deque import json from pathlib import Path import sys import shutil import subprocess import tempfile import numpy as np import pytest WORKSPACE = Path(__file__).resolve().parents[1] sys.path.insert(0, str(WORKSPACE)) from generate import Build, CONFIG, DIRECTIONS, NBTFile, load_schematic SCHEMATIC = WORKSPACE / 'output.litematic' STATE_TABLE = Path('/work/generator/MCRender/resources/1.21.1-blocks.json') ROOMS = { 'entrance': (8, 5, 11, 22, 9, 27), 'workshop': (24, 5, 13, 36, 9, 27), 'living': (8, 11, 11, 22, 15, 27), 'dining': (24, 11, 13, 36, 15, 27), 'bedroom': (8, 17, 11, 22, 21, 27), 'study': (9, 23, 11, 21, 28, 27), } TARGETS = { 'entrance': (17, 5, 17), 'workshop': (30, 5, 21), 'living': (16, 11, 20), 'dining': (29, 11, 20), 'bedroom': (16, 17, 19), 'study': (16, 23, 20), 'bed_platform': (12, 18, 14), 'forge': (30, 5, 9), } AIR = {'air', 'cave_air', 'void_air'} PLANTS = {'fern', 'poppy', 'dandelion', 'azure_bluet', 'flowering_azalea', 'vine'} NON_FULL = ('_stairs', '_slab', '_wall', '_fence', '_door', '_trapdoor', '_bed', '_carpet', '_banner', '_leaves', '_candle') SMALL = {'lantern', 'chain', 'ladder', 'candle', 'campfire', 'anvil', 'grindstone', 'stonecutter', 'lectern', 'water_cauldron'} | PLANTS def parse(state): """Split a canonical block state into its vanilla name and property map.""" name, _, properties = state.partition('[') return name.removeprefix('minecraft:'), dict(part.split('=') for part in properties.rstrip(']').split(',') if part) def inside(pos, bounds): """Check an XYZ point against inclusive room bounds.""" x, y, z = pos x0, y0, z0, x1, y1, z1 = bounds return x0 <= x <= x1 and y0 <= y <= y1 and z0 <= z <= z1 class Model: """Read the actual delivered file into independently inspectable XYZ cells.""" def __init__(self): self.loaded = load_schematic(SCHEMATIC) self.ids = self.loaded.read_flat(0, self.loaded.volume).reshape(self.loaded.size_yzx) self.palette = [parse(state) for state in self.loaded.palette] self.nbt = NBTFile.load_regardless_of_gzipped(SCHEMATIC) self.region = next(iter(self.nbt['Regions'].values())) self.tiles = list(self.region['TileEntities']) self.entities = list(self.region['Entities']) self.blocks = {(x, y, z): self.palette[int(self.ids[y, z, x])] for y, z, x in np.ndindex(self.ids.shape) if self.ids[y, z, x]} def get(self, x, y, z): """Read a cell, treating coordinates outside the volume as air.""" return self.blocks.get((x, y, z), ('air', {})) def full(self, x, y, z): """Recognize full supporting cubes without treating decoration as structure.""" name, _ = self.get(x, y, z) return name not in AIR | SMALL and not name.startswith('potted_') and not name.endswith(NON_FULL) def top_support(self, x, y, z): """Accept a solid top, upper slab, or the top attachment of a fence or wall.""" name, props = self.get(x, y, z) return self.full(x, y, z) or (name.endswith('_slab') and props.get('type') in ('top', 'double')) or name.endswith(('_wall', '_fence')) def passable(self, x, y, z): """Allow walking through opened doors, thin textiles and ladder cells.""" name, _ = self.get(x, y, z) return name in AIR | {'ladder', 'vine'} or name.endswith(('_carpet', '_door', '_banner')) def foot_position(self, x, y, z): """Require two clear blocks and either a floor or a climbable ladder.""" if not (0 <= x < 45 and 1 <= y < 39 and 0 <= z < 35): return False if not self.passable(x, y, z) or not self.passable(x, y + 1, z): return False base, _ = self.get(x, y - 1, z) return self.full(x, y - 1, z) or base.endswith('_stairs') or self.get(x, y, z)[0] == 'ladder' def reachable(self, start): """Flood a two-block-tall player through level walks, directed stairs and ladders.""" assert self.foot_position(*start), f'Invalid start: {start}' seen, queue = {start}, deque([start]) while queue: x, y, z = queue.popleft() candidates = [] for direction, (dx, dz) in DIRECTIONS.items(): for dy in (-1, 0, 1): q = (x + dx, y + dy, z + dz) if not self.foot_position(*q): continue if dy == 1: base, props = self.get(q[0], q[1] - 1, q[2]) if not base.endswith('_stairs') or props.get('facing') != direction or not self.passable(x, y + 2, z): continue if dy == -1: base, props = self.get(x, y - 1, z) opposite = {v: k for k, v in DIRECTIONS.items()}[(-dx, -dz)] if not base.endswith('_stairs') or props.get('facing') != opposite: continue candidates.append(q) for dy in (-1, 1): q = (x, y + dy, z) if self.foot_position(*q) and ('ladder' in (self.get(x, y, z)[0], self.get(*q)[0])): candidates.append(q) for q in candidates: if q not in seen: seen.add(q) queue.append(q) return seen @pytest.fixture(scope='module') def model(): """Load the exported schematic once for the structural suite.""" return Model() def test_single_region_version_dimensions_and_valid_states(model): """Validate the format and every state against the installed 1.21.1 registry.""" assert SCHEMATIC.read_bytes()[:2] == bytes([0x1f, 0x8b]) assert int(model.nbt['MinecraftDataVersion']) == 3955 assert len(model.nbt['Regions']) == 1 assert tuple(model.loaded.size_yzx) == (40, 35, 45) assert max(y for x, y, z in model.blocks) == 39 assert int(model.nbt['Metadata']['TimeCreated']) == 0 registry = json.loads(STATE_TABLE.read_text()) for name, props in model.palette: assert name in registry, name allowed = registry[name][0] for key, value in props.items(): assert key in allowed and value in allowed[key], (name, key, value) assert len(model.blocks) > 10000 def test_repeatable_export_and_roundtrip(): """Compare two fresh exports byte for byte with the delivered artifact.""" with tempfile.TemporaryDirectory(dir=WORKSPACE / 'test') as directory: first, second = Path(directory) / 'first.litematic', Path(directory) / 'second.litematic' for destination in (first, second): build = Build().build() build.export(destination) build.verify(destination) assert first.read_bytes() == second.read_bytes() == SCHEMATIC.read_bytes() def test_doors_have_matched_halves_and_clear_approaches(model): """Check every half, hinge, facing, threshold and two-block doorway approach.""" doors = [(pos, name, props) for pos, (name, props) in model.blocks.items() if name.endswith('_door')] assert len(doors) == 6 for (x, y, z), name, props in doors: other_y = y + (1 if props['half'] == 'lower' else -1) other_name, other = model.get(x, other_y, z) assert other_name == name assert other['half'] != props['half'] assert all(other[key] == props[key] for key in ('facing', 'hinge', 'open', 'powered')) if props['half'] == 'lower': assert model.full(x, y - 1, z) assert model.full(x, y + 2, z) dx, dz = DIRECTIONS[props['facing']] for sign in (-1, 1): assert model.foot_position(x + sign * dx, y, z + sign * dz) def test_complete_green_beds_on_accessible_raised_platform(model): """Check both bed halves, orientation, platform support and access.""" beds = [(pos, name, props) for pos, (name, props) in model.blocks.items() if name.endswith('_bed')] assert len(beds) == 4 for (x, y, z), name, props in beds: assert name == 'green_bed' and y == 18 dx, dz = DIRECTIONS[props['facing']] sign = 1 if props['part'] == 'foot' else -1 other_name, other = model.get(x + sign * dx, y, z + sign * dz) assert other_name == name and other['facing'] == props['facing'] and other['part'] != props['part'] assert model.full(x, y - 1, z) assert model.passable(x, y + 1, z) def test_all_levels_and_furniture_reachable_without_jumps(model): """Traverse from the approach path through the front door into every room.""" reach = model.reachable((17, 2, 0)) assert (15, 5, 10) in reach for name, target in TARGETS.items(): assert target in reach, f'Unreachable room or platform: {name} {target}' for x, y, z in [(21, y, 25) for y in range(5, 24)]: assert (x, y, z) in reach, ('ladder segment', x, y, z) for pos, (name, props) in model.blocks.items(): if name == 'chest': x, y, z = pos dx, dz = DIRECTIONS[props['facing']] assert (x + dx, y, z + dz) in reach, ('chest access', pos) assert model.get(x, y + 1, z)[0] in AIR, ('chest lid', pos) def test_every_interior_air_pocket_is_sealed_from_outside(model): """Flood exterior air with doors shut and reject any leak into either mass.""" def airlike(p): name, _ = model.get(*p) return name in AIR | SMALL or name.startswith('potted_') or name.endswith(('_carpet', '_banner', '_leaves', '_candle')) outside = set() queue = deque() for y, z, x in np.ndindex(model.ids.shape): if x in (0, 44) or y in (0, 39) or z in (0, 34): p = (x, y, z) if airlike(p): outside.add(p) queue.append(p) while queue: x, y, z = queue.popleft() for dx, dy, dz in [(1, 0, 0), (-1, 0, 0), (0, 1, 0), (0, -1, 0), (0, 0, 1), (0, 0, -1)]: p = (x + dx, y + dy, z + dz) if 0 <= p[0] < 45 and 0 <= p[1] < 40 and 0 <= p[2] < 35 and p not in outside and airlike(p): outside.add(p) queue.append(p) interior = set() for x in range(8, 23): for z in range(11, 28): for y in range(5, 38 - 2 * abs(x - 15)): if airlike((x, y, z)): interior.add((x, y, z)) for x in range(24, 37): for z in range(13, 28): for y in range(5, 25 - abs(z - 20)): if airlike((x, y, z)): interior.add((x, y, z)) assert len(interior) > 5000 leaks = sorted(interior & outside) assert not leaks, f'{len(leaks)} exposed interior cells, first: {leaks[:15]}' def test_decorations_have_supports(model): """Check all small decorations, storage, climbing plants and frame attachments.""" errors = [] for (x, y, z), (name, props) in model.blocks.items(): supported = True if name in {'ladder'} or name.endswith('_wall_banner') or (name.endswith('_trapdoor') and props.get('open') == 'true'): dx, dz = DIRECTIONS[props['facing']] supported = model.full(x - dx, y, z - dz) elif name == 'vine': supported = any(props.get(d) == 'true' and model.full(x + dx, y, z + dz) for d, (dx, dz) in DIRECTIONS.items()) elif name == 'lantern' and props['hanging'] == 'true': yy = y + 1 while model.get(x, yy, z)[0] == 'chain': yy += 1 supported = model.full(x, yy, z) elif name == 'chain': yy = y + 1 while model.get(x, yy, z)[0] == 'chain': yy += 1 supported = model.full(x, yy, z) elif name in {'barrel', 'chest'}: supported = model.top_support(x, y - 1, z) or any(model.full(x + dx, y, z + dz) for dx, dz in DIRECTIONS.values()) elif name in (PLANTS - {'vine'}) | {'lantern', 'candle', 'anvil', 'grindstone', 'stonecutter', 'lectern', 'campfire', 'water_cauldron'} or name.startswith('potted_') or name.endswith(('_carpet', '_candle', '_bed')): supported = model.top_support(x, y - 1, z) if not supported: errors.append(((x, y, z), name)) assert not errors, errors for frame in model.entities: assert str(frame['id']) == 'minecraft:item_frame' direction = {2: 'north', 3: 'south', 4: 'west', 5: 'east'}[int(frame['Facing'])] dx, dz = DIRECTIONS[direction] x, y, z = [int(frame['Tile' + axis]) for axis in 'XYZ'] assert model.full(x - dx, y, z - dz), ('frame backing', x, y, z) assert model.get(x, y, z)[0] in AIR, ('frame collision', x, y, z) assert int(frame['Item']['count']) == 1 def test_windows_keep_glazing_and_open_sightlines(model): """Verify intended windows survived later furniture, roof and chimney placement.""" plan = Build().build().windows assert len(plan) > 100 for x, y, z, direction in plan: assert model.get(x, y, z)[0] == 'glass', ('lost glazing', x, y, z) dx, dz = DIRECTIONS[direction] for sign in (-1, 1): pos = (x + sign * dx, y, z + sign * dz) assert model.get(*pos)[0] in AIR, ('window obstructed', pos, model.get(*pos)) @pytest.mark.parametrize('room', ROOMS) def test_all_rooms_are_furnished_and_lit(model, room): """Require the complete furnishing vocabulary and a low light in each room.""" bounds = ROOMS[room] local = [(pos, name, props) for pos, (name, props) in model.blocks.items() if inside(pos, bounds)] names = {name for _, name, _ in local} for required in ('barrel', 'chest', 'ladder'): assert required in names, (room, required) for suffix in ('_carpet', '_stairs'): assert any(name.endswith(suffix) for name in names), (room, suffix) assert any(name.startswith('potted_') for name in names), (room, 'pot') assert any(name == 'candle' or name.endswith('_candle') for name in names), (room, 'candles') assert any(inside(tuple(int(e['Tile' + axis]) for axis in 'XYZ'), bounds) for e in model.entities), (room, 'item frame') assert any(y - bounds[1] <= 3 and (name == 'lantern' or (name in {'candle', 'campfire'} or name.endswith('_candle')) and props.get('lit') == 'true') for (x, y, z), name, props in local), (room, 'floor-level light') def test_saved_banner_book_inventory_and_working_forge(model): """Inspect NBT details that the renderer cannot display.""" for tile in model.tiles: x, y, z = [int(tile[axis]) for axis in 'xyz'] name, props = model.get(x, y, z) kind = str(tile['id']).removeprefix('minecraft:') assert kind == name or (kind == 'banner' and name.endswith('_banner')), (kind, name, x, y, z) curtains = [t for t in model.tiles if str(t['id']) == 'minecraft:banner'] assert len(curtains) == 2 atlas = json.loads((STATE_TABLE.parent / '1.21.1-uvmapping.json').read_text()) for tile in curtains: for pattern in tile['patterns']: asset = 'entity/banner/' + str(pattern['pattern']).removeprefix('minecraft:') assert asset in atlas, ('unknown banner pattern', asset) assert int(tile['y']) == 20 assert any(str(p['pattern']) == 'minecraft:small_stripes' and str(p['color']) == 'white' for p in tile['patterns']) lectern = next(t for t in model.tiles if str(t['id']) == 'minecraft:lectern') content = lectern['Book']['components']['minecraft:written_book_content'] assert json.loads(str(content['pages'][0]['raw']))['text'].startswith('Amberstone Lodge') assert len([t for t in model.tiles if 'Items' in t]) >= 16 furnaces = [t for t in model.tiles if str(t['id']) == 'minecraft:blast_furnace'] assert len(furnaces) == 2 for tile in furnaces: x, y, z = [int(tile[axis]) for axis in 'xyz'] assert model.get(x, y, z)[1]['lit'] == 'true' assert int(tile['BurnTime']) > 0 assert {int(i['Slot']) for i in tile['Items']} == {0, 1} assert model.get(31, 5, 8)[0] == 'anvil' assert model.get(34, 6, 10)[1]['lit'] == 'true' assert all(model.get(34, y, 10)[0] not in AIR for y in range(8, 28)) def test_handmade_pines_and_material_variation(model): """Check connected trunks, horizontal branches, layered leaves and varied surfaces.""" for x, z, height in [(3, 25, 22), (41, 28, 20), (41, 5, 13)]: assert all(model.get(x, y, z)[0] == 'spruce_log' for y in range(2, height + 2)) branches = [(pos, props) for pos, (name, props) in model.blocks.items() if name == 'spruce_log' and props['axis'] != 'y' and abs(pos[0] - x) <= 4 and abs(pos[2] - z) <= 4] assert len(branches) >= 12 leaf_levels = {py for (px, py, pz), (name, props) in model.blocks.items() if name.endswith('_leaves') and abs(px - x) <= 4 and abs(pz - z) <= 4} assert len(leaf_levels) >= 10 names = {name for name, _ in model.blocks.values()} assert {'stone_bricks', 'cobblestone', 'mossy_stone_bricks', 'smooth_sandstone', 'sandstone', 'cut_sandstone', 'deepslate_tiles', 'deepslate_bricks', 'polished_deepslate'} <= names def test_generator_runs_from_a_clean_directory_with_no_arguments(): """Run only the standalone generator in an empty directory and compare its output.""" with tempfile.TemporaryDirectory(dir=WORKSPACE / 'test') as directory: isolated = Path(directory) shutil.copyfile(WORKSPACE / 'generate.py', isolated / 'generate.py') result = subprocess.run([sys.executable, 'generate.py'], cwd=isolated, capture_output=True, text=True, check=True) assert 'wrote output.litematic' in result.stdout assert (isolated / 'output.litematic').read_bytes() == SCHEMATIC.read_bytes()