Codex effort 四档对比

# Generate Amberstone Lodge and reproducible cutaways with MCIO. from pathlib import Path import sys import json import random from collections import Counter import types sys.path.insert(0, '/work/generator/MCIO') from mcio.sketch import LitematicCanvas from mcio.schematic import load_schematic from mcio.nbt.tag import Compound, String, Int, Byte, Double, List, IntArray CONFIG = { 'seed': 73129, 'size': (41, 35, 45), 'data_version': 3955, 'tower': (25, 37, 10, 26), 'lower': (10, 25, 10, 26), 'floors': (3, 9, 15, 21), 'ladder': (35, 24), 'stone': ('stone_bricks', 'cobblestone', 'andesite'), 'plaster': ('sandstone', 'smooth_sandstone', 'end_stone_bricks'), 'roof': ('deepslate_tiles', 'deepslate_bricks', 'cobbled_deepslate'), 'wood': ('spruce_planks', 'dark_oak_planks', 'spruce_planks'), 'rooms': { 'entrance': (30, 4, 13), 'storage': (16, 4, 18), 'living': (17, 10, 16), 'hall': (30, 10, 16), 'bedroom': (30, 16, 18), 'study': (31, 22, 18) }, } REGISTRY = json.loads(Path('/work/generator/MCRender/resources/1.21.1-blocks.json').read_text()) class Lodge: """Hold deterministic blocks, furniture supports and export metadata.""" def __init__(self): self.blocks = {} self.rng = random.Random(CONFIG['seed']) self.tiles = [] self.entities = [] def put(self, x, y, z, name, **props): """Place a registry-normalized block at XYZ.""" if name == 'air': self.blocks.pop((x, y, z), None) return allowed, defaults = REGISTRY[name] state = dict(defaults) state.update({k: str(v) for k, v in props.items()}) assert all(k in allowed and v in allowed[k] for k, v in state.items()), (name, state) suffix = '[' + ','.join(f'{k}={v}' for k, v in sorted(state.items())) + ']' if state else '' self.blocks[x, y, z] = 'minecraft:' + name + suffix def box(self, x1, x2, y1, y2, z1, z2, material, **props): """Fill an inclusive box with a seeded palette.""" for x in range(x1, x2 + 1): for y in range(y1, y2 + 1): for z in range(z1, z2 + 1): self.put(x, y, z, self.rng.choice(material) if isinstance(material, tuple) else material, **props) def door(self, x, y, z): """Place a matching glazed oak door pair.""" for half, dy in [('lower', 0), ('upper', 1)]: self.put(x, y + dy, z, 'oak_door', half=half, facing='south', hinge='left') def pot(self, x, y, z): """Place a potted fern on a cabinet.""" self.put(x, y, z, 'potted_fern') def frame(self, x, y, z): """Attach a real item-frame entity to a north wall.""" self.entities.append(Compound({'id': String('minecraft:item_frame'), 'Pos': List[Double]([Double(x + .5), Double(y + .5), Double(z + 1.03125)]), 'Facing': Byte(3), 'TileX': Int(x), 'TileY': Int(y), 'TileZ': Int(z + 1), 'ItemRotation': Byte(0), 'Item': Compound({'id': String('minecraft:iron_axe'), 'count': Int(1)}), 'UUID': IntArray([73129, x, y, z])})) def export(self, path: Path, bounds=None): """Export one MCIO region, optionally cropped for an interior inspection.""" if bounds is None: bounds = (0, 44, 0, 40, 0, 34) x1, x2, y1, y2, z1, z2 = bounds canvas = LitematicCanvas((y2 - y1 + 1, z2 - z1 + 1, x2 - x1 + 1)) for (x, y, z), state in self.blocks.items(): if x1 <= x <= x2 and y1 <= y <= y2 and z1 <= z <= z2: canvas.block((y - y1, z - z1, x - x1), state) schem = canvas.to_litematica(name='Amberstone Lodge', author='Codex', minecraft_data_version=CONFIG['data_version']) schem.metadata.time_created = 0 schem.metadata.time_modified = 0 if bounds == (0, 44, 0, 40, 0, 34): original = schem.write_sub_region_to_nbt def region(this, name): tag = original(name) tag['TileEntities'] = List[Compound](self.tiles) tag['Entities'] = List[Compound](self.entities) return tag schem.write_sub_region_to_nbt = types.MethodType(region, schem) schem.save(path) def build(): """Construct terrain, connected timber shells, roofs, furnishings and trees.""" b = Lodge() # Irregular sod island and raised terrace. for x in range(2, 43): for z in range(2, 33): if ((x - 22) / 23)**2 + ((z - 18) / 18)**2 < 1: b.put(x, 0, z, 'dirt') b.put(x, 1, z, 'grass_block') b.box(7, 39, 1, 2, 8, 28, CONFIG['stone']) b.box(8, 38, 3, 3, 8, 28, ('stone_bricks', 'mossy_stone_bricks', 'andesite')) for z in range(0, 9): center = 30 + round(2 * __import__('math').sin(z * .7)) for x in range(center - 2, center + 3): b.put(x, 1, z, b.rng.choice(('dirt_path', 'gravel', 'coarse_dirt', 'cobblestone'))) for z, y in [(6, 1), (7, 2)]: b.box(28, 32, y, y, z, z, 'stone_brick_stairs', facing='south') # Two joined masses with common floor heights. for (x1, x2, z1, z2), top in [(CONFIG['lower'], 15), (CONFIG['tower'], 23)]: for y in range(4, top + 1): for x in range(x1, x2 + 1): for z in range(z1, z2 + 1): if x in (x1, x2) or z in (z1, z2): mat = CONFIG['stone'] if y < 9 else CONFIG['plaster'] b.put(x, y, z, b.rng.choice(mat)) if y in (9, 14, 15, 20, 21, 23): b.put(x, y, z, 'dark_oak_log', axis='x' if z in (z1, z2) else 'z') if (x in (x1, x2) and (z - z1) % 5 == 0) or (z in (z1, z2) and (x - x1) % 5 == 0): b.put(x, y, z, 'stripped_spruce_log') for fy in CONFIG['floors']: if fy <= top: b.box(x1 + 1, x2 - 1, fy, fy, z1 + 1, z2 - 1, CONFIG['wood']) # Open the shared wall on both occupied lower-wing levels. for fy in (3, 9): b.box(25, 25, fy + 1, fy + 4, 17, 20, 'air') b.box(25, 25, fy, fy, 17, 20, 'spruce_planks') # Tower gable: steep two-rise roof, closed front and rear triangles. for x in range(25, 38): top = 37 - 2 * abs(x - 31) for z in (10, 26): b.box(x, x, 24, top, z, z, CONFIG['plaster']) if x == 31: b.box(x, x, 24, top, z, z, 'stripped_spruce_log') for x in range(23, 40): h = 38 - 2 * abs(x - 31) b.box(x, x, h - 2, h, 8, 28, CONFIG['roof']) b.box(x, x, h, h, 8, 28, 'deepslate_tile_stairs', facing='east' if x < 31 else 'west') for z in (8, 28): b.put(x, h, z, 'polished_deepslate') b.box(31, 31, 39, 39, 9, 27, 'deepslate_tile_slab') # Lower transverse gable, overlaps tower shell to make a sealed valley. for z in range(8, 29): h = 23 - abs(z - 18) // 2 for x in range(8, 26): b.put(x, h, z, b.rng.choice(CONFIG['roof'])) b.put(x, h + 1, z, 'deepslate_tile_slab' if abs(z - 18) % 2 == 0 else 'deepslate_tile_stairs', **({} if abs(z - 18) % 2 == 0 else {'facing': 'south' if z < 18 else 'north'})) if 10 <= z <= 26: for x in (10,): b.box(x, x, 16, h - 1, z, z, CONFIG['plaster']) # Sealed ceiling above lower living room. b.box(11, 24, 16, 16, 11, 25, 'spruce_planks') # Windows: full glass keeps a watertight envelope, exterior shutters beside openings. for y in (5, 11, 17, 23, 29): xs = (13, 19, 28, 33) if y < 15 else ((28, 33) if y < 25 else (30,)) for x in xs: for z in (10, 26): b.box(x, x + 1, y, y + 2, z, z, 'glass') for sx in (x - 1, x + 2): b.box(sx, sx, y, y + 2, z + (-1 if z == 10 else 1), z + (-1 if z == 10 else 1), 'spruce_trapdoor', facing='south' if z == 10 else 'north', open='true') b.box(x, x + 1, y - 1, y - 1, z + (-1 if z == 10 else 1), z + (-1 if z == 10 else 1), 'spruce_stairs', facing='north' if z == 10 else 'south') # Side elevations use the same plaster panels, framed windows and sills. for wall_x, levels in ((10, (5, 11)), (37, (5, 11, 17))): for y in levels: for z in (14, 21): b.box(wall_x, wall_x, y, y + 2, z, z + 1, 'glass') outside = wall_x + (-1 if wall_x == 10 else 1) b.box(outside, outside, y - 1, y - 1, z, z + 1, 'spruce_stairs', facing='east' if wall_x == 10 else 'west') for sz in (z - 1, z + 2): b.box(outside, outside, y, y + 2, sz, sz, 'spruce_trapdoor', facing='east' if wall_x == 10 else 'west', open='true') b.door(30, 4, 10) b.put(30, 5, 9, 'air') # Keep the neighboring shutter out of the door approach. for x in (28, 32): b.put(x, 6, 9, 'spruce_fence') b.put(x, 5, 9, 'lantern', hanging='true') # Ladder hall: continuous back support and a two-cell clear landing at every floor. for y in range(4, 24): b.put(35, y, 25, 'spruce_planks') b.put(35, y, 24, 'ladder', facing='north') b.put(34, y, 24, 'air') for fy in CONFIG['floors']: b.put(34, fy, 24, 'spruce_planks') # Ground entrance, workshop and storage. for x in (12, 15, 18, 21): b.put(x, 4, 24, 'barrel', facing='north') b.put(x, 5, 24, 'chest', facing='north') b.box(12, 17, 4, 4, 12, 12, 'spruce_planks') for x in (12, 14, 16): b.put(x, 5, 12, 'crafting_table' if x == 14 else 'barrel') b.put(20, 4, 14, 'anvil') b.box(28, 32, 4, 4, 13, 17, 'red_carpet') b.box(36, 36, 4, 6, 13, 18, 'bookshelf') b.put(27, 4, 12, 'barrel') b.pot(27, 5, 12) b.frame(23, 6, 10) # Living and dining: upholstered seating, large oak table and kitchen cabinets. for x in range(13, 19): b.put(x, 10, 23, 'spruce_stairs', facing='south') b.box(14, 20, 10, 10, 15, 20, 'green_carpet') b.box(15, 18, 10, 10, 17, 18, 'dark_oak_planks') for x in (15, 18): b.put(x, 11, 17, 'candle', candles='3', lit='true') b.put(x, 10, 15, 'spruce_stairs', facing='north') for x in range(12, 23): b.put(x, 10, 12, 'barrel', facing='south') if x % 3 == 0: b.put(x, 13, 12, 'barrel', facing='south') b.put(x, 13, 11, 'spruce_planks') b.put(13, 11, 12, 'smoker', facing='south', lit='true') b.pot(20, 11, 12) b.box(27, 27, 10, 13, 17, 21, 'bookshelf') b.box(29, 32, 10, 10, 13, 20, 'red_carpet') b.put(36, 10, 12, 'barrel') b.pot(36, 11, 12) # Bedroom platform and matching green beds. b.box(27, 31, 16, 16, 20, 23, 'dark_oak_planks') b.box(28, 30, 16, 16, 19, 19, 'dark_oak_stairs', facing='south') for x in (28, 29): b.put(x, 17, 22, 'green_bed', facing='south', part='foot') b.put(x, 17, 23, 'green_bed', facing='south', part='head') b.box(27, 31, 19, 19, 25, 25, 'bookshelf') for x in (27, 31): b.put(x, 17, 23, 'barrel') b.put(x, 18, 23, 'lantern') b.put(x, 20, 25, 'barrel') b.box(28, 32, 16, 16, 14, 17, 'green_carpet') for x in (27, 30, 32, 35): b.put(x, 19, 11, 'white_wall_banner', facing='south') b.tiles.append(Compound({'id': String('minecraft:banner'), 'x': Int(x), 'y': Int(19), 'z': Int(11), 'patterns': List[Compound]([Compound({'pattern': String('minecraft:stripe_center'), 'color': String('green')})])})) b.box(28, 34, 16, 16, 12, 12, 'dark_oak_stairs', facing='north') b.put(36, 16, 19, 'barrel') b.pot(36, 17, 19) # Attic study. b.box(27, 27, 22, 25, 16, 22, 'bookshelf') b.box(29, 32, 22, 22, 20, 21, 'dark_oak_planks') b.put(30, 23, 20, 'lectern', facing='north', has_book='true') book = Compound({'id': String('minecraft:writable_book'), 'count': Int(1), 'components': Compound({'minecraft:writable_book_content': Compound({'pages': List[Compound]([Compound({'raw': String('Forge orders and winter provisions.')})])})})}) b.tiles.append(Compound({'id': String('minecraft:lectern'), 'x': Int(30), 'y': Int(23), 'z': Int(20), 'Book': book, 'Page': Int(0)})) b.put(32, 23, 20, 'candle', candles='3', lit='true') b.put(30, 22, 18, 'spruce_stairs', facing='north') for x in (28, 32, 36): b.put(x, 22, 12, 'barrel') b.put(x, 23, 12, 'chest', facing='south') b.box(29, 33, 22, 22, 14, 16, 'green_carpet') b.frame(31, 25, 10) # Supported ceiling lanterns on every occupied level. for fy in CONFIG['floors']: for x, z in ((29, 18), (33, 14)) + (((17, 21), (22, 15)) if fy < 15 else ()): ceiling = fy + 5 b.put(x, ceiling, z, 'spruce_planks') b.put(x, ceiling - 1, z, 'lantern', hanging='true') # Tie attic beams into exterior walls. if fy == 21: b.box(26, 36, ceiling, ceiling, z, z, 'dark_oak_log', axis='x') # Covered blacksmith lean-to on left side, independent from room windows. b.box(3, 9, 2, 2, 12, 23, CONFIG['stone']) for x in (3, 8): for z in (12, 23): b.box(x, x, 3, 8, z, z, 'spruce_log') for x in range(2, 11): h = 8 + (x - 2) // 3 b.box(x, x, h, h, 11, 24, 'deepslate_tile_slab') b.box(5, 7, 3, 4, 19, 21, 'stone_bricks') b.put(6, 5, 20, 'campfire', lit='true') b.put(6, 4, 19, 'blast_furnace', facing='north', lit='true') b.box(5, 7, 5, 7, 21, 22, CONFIG['stone']) b.box(5, 7, 8, 24, 21, 22, CONFIG['stone']) b.box(4, 8, 25, 25, 20, 23, 'stone_brick_slab') b.put(5, 3, 15, 'anvil') b.put(8, 3, 17, 'barrel') b.put(8, 4, 17, 'chest') b.put(4, 3, 13, 'lantern') # Climbing foliage on south/front masonry, attached to wall and planter. for x in (25, 26, 36, 37): for y in range(4, 14 if x < 30 else 9): if b.rng.random() < .78: b.put(x, y, 9, 'vine', south='true') # Two hand-built tiered pines, rear left away from the roof. for tx, tz, height in ((5, 29, 22), (17, 30, 29)): b.box(tx, tx, 2, height, tz, tz, 'spruce_log') for y in range(5, height, 4): radius = max(1, (height - y) // 6) for dx, dz in ((1, 0), (-1, 0), (0, 1), (0, -1)): for r in range(1, radius + 1): b.put(tx + dx * r, y, tz + dz * r, 'spruce_log', axis='x' if dx else 'z') for dy in (0, 1): for dx in range(-radius, radius + 1): for dz in range(-radius, radius + 1): if abs(dx) + abs(dz) <= radius + 1 - dy and (dx or dz) and (tx + dx, y + dy, tz + dz) not in b.blocks: b.put(tx + dx, y + dy, tz + dz, 'spruce_leaves', persistent='true', distance='1') b.box(tx, tx, height - 2, height + 1, tz, tz, 'spruce_leaves', persistent='true', distance='1') # Stone chimney breast and a guarded living-room hearth, away from side windows. b.box(36, 36, 4, 32, 17, 18, CONFIG['stone']) b.box(35, 37, 33, 33, 16, 19, 'stone_brick_slab') b.put(35, 9, 18, 'stone_bricks') b.put(35, 10, 18, 'campfire', lit='true') b.put(35, 10, 17, 'iron_bars', east='true', west='true') b.put(36, 17, 19, 'air') # Terrace edging and planted ground soften the rectangular foundation. for x in range(8, 39): if x not in range(27, 34): b.put(x, 4, 8, 'stone_brick_slab') b.put(x, 4, 28, 'stone_brick_slab') for z in range(9, 28): b.put(39, 3, z, 'stone_brick_slab') for x in range(3, 43): for z in (5, 6, 29, 31): if b.blocks.get((x, 1, z), '').startswith('minecraft:grass_block') and (x, 2, z) not in b.blocks and b.rng.random() < .35: b.put(x, 2, z, b.rng.choice(('short_grass', 'fern', 'poppy', 'dandelion'))) return b def verify_roundtrip(b, path: Path): """Compare every cell including air and all normalized state properties.""" loaded = load_schematic(path) assert loaded.size_yzx == CONFIG['size'] ids = loaded.read_flat(0, loaded.volume).reshape(loaded.size_yzx) actual = {} for y in range(ids.shape[0]): for z in range(ids.shape[1]): for x in range(ids.shape[2]): state = loaded.palette[int(ids[y, z, x])] if state != 'minecraft:air': actual[x, y, z] = state assert actual == b.blocks return {'dimensions_yzx': loaded.size_yzx, 'non_air_blocks': len(actual), 'unique_states': len(set(actual.values())), 'full_state_roundtrip': True, 'sha256': loaded.sha256, 'block_counts': dict(Counter(s.split('[')[0] for s in actual.values()))} def main(): """Run from any clean writable directory with the supplied MCIO installation.""" b = build() b.export(Path('output.litematic')) previews = Path('previews') previews.mkdir(exist_ok=True) for name, bounds in {'ground': (10, 37, 3, 7, 10, 26), 'living': (10, 37, 9, 13, 10, 26), 'bedroom': (25, 37, 15, 20, 10, 26), 'study': (25, 37, 21, 25, 10, 26)}.items(): b.export(previews / (name + '.litematic'), bounds) (previews / 'validation.json').write_text(json.dumps(verify_roundtrip(b, Path('output.litematic')), indent=2)) print((previews / 'validation.json').read_text()[:220]) if __name__ == '__main__': main()

# Verify the complete lodge's state, topology, supports and serialized content. from pathlib import Path import sys from collections import deque, Counter import tempfile import pytest sys.path.insert(0, str(Path(__file__).resolve().parents[1])) from generate_lodge import build, CONFIG, REGISTRY, verify_roundtrip from mcio.nbt import tag from mcio.litematica import LitematicaSchematic @pytest.fixture(scope='module') def lodge(): return build() def state(lodge, p): s = lodge.blocks.get(p, 'minecraft:air').removeprefix('minecraft:') name = s.split('[')[0] props = dict(v.split('=') for v in s.split('[')[1][:-1].split(',')) if '[' in s else {} return name, props def neighbors(p): x, y, z = p return [(x + 1, y, z), (x - 1, y, z), (x, y + 1, z), (x, y - 1, z), (x, y, z + 1), (x, y, z - 1)] def passable(lodge, p, doors=True): n, _ = state(lodge, p) return n == 'air' or n == 'ladder' or n.endswith('carpet') or (doors and n.endswith('_door')) or n in ('vine', 'white_wall_banner') def test_registry_and_extent(lodge): for p in lodge.blocks: x, y, z = p assert 0 <= x < 45 and 0 <= y < 41 and 0 <= z < 35 n, props = state(lodge, p) assert n in REGISTRY assert props.keys() == REGISTRY[n][1].keys() assert all(v in REGISTRY[n][0][k] for k, v in props.items()) assert max(y for x, y, z in lodge.blocks) == 39 def test_door_and_bed_pairs(lodge): counts = Counter() for (x, y, z) in lodge.blocks: n, p = state(lodge, (x, y, z)) if n.endswith('_door'): counts['doors'] += 1 other, op = state(lodge, (x, y + (1 if p['half'] == 'lower' else -1), z)) assert other == n and op['half'] != p['half'] assert all(op[k] == p[k] for k in ('facing', 'hinge', 'open', 'powered')) if n.endswith('_bed'): counts['beds'] += 1 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, op = state(lodge, (x + sign * dx, y, z + sign * dz)) assert other == n and op['facing'] == p['facing'] and op['part'] != p['part'] assert not passable(lodge, (x, y - 1, z)) assert counts['doors'] >= 2 and counts['beds'] == 4 def test_two_block_headroom_reachability(lodge): def stand(p): x, y, z = p return passable(lodge, p) and passable(lodge, (x, y + 1, z)) and (not passable(lodge, (x, y - 1, z)) or state(lodge, p)[0] == 'ladder' or state(lodge, (x, y - 1, z))[0] == 'ladder') start = (30, 2, 5) assert stand(start) seen = {start} q = deque([start]) while q: x, y, z = q.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 state(lodge, (x, y, z))[0] == 'ladder': candidates += [(x, y - 1, z), (x, y + 1, z)] for p in candidates: if p not in seen and 0 <= p[0] < 45 and 0 <= p[1] < 40 and 0 <= p[2] < 35 and stand(p): seen.add(p) q.append(p) assert (30, 4, 10) in seen for name, p in CONFIG['rooms'].items(): assert p in seen, (name, p) for fy in CONFIG['floors']: assert (35, fy + 1, 24) in seen def test_closed_envelope(lodge): # Flood from every exterior boundary with doors closed. Glass and roof count as sealed. def empty(p): return passable(lodge, p, doors=False) seen = set() q = deque() for x in range(45): for y in range(41): for z in range(35): if (x in (0, 44) or y in (0, 40) or z in (0, 34)) and empty((x, y, z)): seen.add((x, y, z)) q.append((x, y, z)) while q: for p in neighbors(q.popleft()): x, y, z = p if 0 <= x < 45 and 0 <= y < 41 and 0 <= z < 35 and p not in seen and empty(p): seen.add(p) q.append(p) for name, p in CONFIG['rooms'].items(): assert p not in seen, ('Exterior leak', name, p) # Every interior air column has a solid ceiling before the sky. for x in range(26, 37): for z in range(11, 26): assert any((x, y, z) in lodge.blocks for y in range(27, 40)) def test_supports_and_no_floating_components(lodge): # Every non-air block belongs to a face-connected component anchored in the terrain. seen = {p for p in lodge.blocks if p[1] == 0} q = deque(seen) while q: for p in neighbors(q.popleft()): if p in lodge.blocks and p not in seen: seen.add(p) q.append(p) assert not set(lodge.blocks) - seen, sorted(set(lodge.blocks) - seen)[:20] for (x, y, z) in lodge.blocks: n, p = state(lodge, (x, y, z)) if n in ('candle', 'potted_fern', 'anvil', 'chest', 'lectern') or n.endswith('_carpet') or n in ('fern', 'short_grass', 'poppy', 'dandelion'): assert (x, y - 1, z) in lodge.blocks, (n, (x, y, z)) if n == 'lantern': assert (x, y + (1 if p['hanging'] == 'true' else -1), z) in lodge.blocks if n == 'ladder': assert (x, y, z + 1) in lodge.blocks if n == 'white_wall_banner': assert (x, y, z - 1) in lodge.blocks for e in lodge.entities: assert (int(e['TileX']), int(e['TileY']), int(e['TileZ']) - 1) in lodge.blocks def test_each_room_is_lit(lodge): lights = [p for p in lodge.blocks if state(lodge, p)[0] == 'lantern' or state(lodge, p)[1].get('lit') == 'true'] for name, (x, y, z) in CONFIG['rooms'].items(): assert any(abs(x - lx) + abs(y - ly) + abs(z - lz) <= 10 and y <= ly < y + 5 for lx, ly, lz in lights), name def test_export_roundtrip_and_entities(lodge): # Temp directory is explicitly inside test/ and removed even on failure. with tempfile.TemporaryDirectory(dir=Path(__file__).parent) as tmp: path = Path(tmp) / 'lodge.litematic' lodge.export(path) result = verify_roundtrip(lodge, path) assert result['non_air_blocks'] == len(lodge.blocks) from mcio.nbt.nbt import File as NBTFile nbt = NBTFile.load_regardless_of_gzipped(path) assert len(nbt['Regions']) == 1 assert int(nbt['MinecraftDataVersion']) == 3955 region = next(iter(nbt['Regions'].values())) assert len(region['Entities']) == 2 assert len(region['TileEntities']) == 5 def test_window_clearance_and_textile_data(lodge): # Windows remain glass throughout each opening, never roof or chimney blocks. for y in (5, 11, 17, 23, 29): xs = (13, 19, 28, 33) if y < 15 else ((28, 33) if y < 25 else (30,)) for x in xs: for z in (10, 26): for xx in (x, x + 1): for yy in range(y, y + 3): assert state(lodge, (xx, yy, z))[0] == 'glass' banners = [t for t in lodge.tiles if str(t['id']) == 'minecraft:banner'] assert len(banners) == 4 for tile in banners: p = tuple(int(tile[k]) for k in ('x', 'y', 'z')) assert state(lodge, p)[0] == 'white_wall_banner' assert str(tile['patterns'][0]['pattern']) == 'minecraft:stripe_center' assert str(tile['patterns'][0]['color']) == 'green' lecterns = [t for t in lodge.tiles if str(t['id']) == 'minecraft:lectern'] assert len(lecterns) == 1 and int(lecterns[0]['Book']['count']) == 1

# Generate and validate the furnished Amberstone Lodge schematic. from pathlib import Path import sys import json import random from copy import deepcopy from collections import Counter import numpy as np sys.path.insert(0, '/work/generator/MCIO') from mcio.sketch import LitematicCanvas from mcio.schematic import load_schematic from mcio.nbt.tag import Compound, String, Int, Byte, Double, List from mcio.nbt.nbt import File as NBTFile CONFIG = { 'seed': 270923, 'size': (45, 40, 35), 'data_version': 3955, 'low': (10, 24, 9, 27), 'tower': (25, 37, 9, 27), 'floors': (3, 9, 15, 21), 'ladder': (35, 25), 'stone': ('stone_bricks', 'andesite', 'cobblestone'), 'plaster': ('sandstone', 'smooth_sandstone', 'end_stone_bricks'), 'roof': ('deepslate_tiles', 'deepslate_bricks', 'cobbled_deepslate'), 'wood': ('spruce_planks', 'spruce_planks', 'oak_planks'), 'rooms': { 'entrance': (31, 4, 12), 'workshop': (15, 4, 15), 'living': (18, 10, 15), 'dining': (30, 10, 19), 'bedroom': (31, 16, 17), 'study': (31, 22, 15) }, } REGISTRY = json.loads(Path('/work/generator/MCRender/resources/1.21.1-blocks.json').read_text()) DIRECTIONS = {'north': (0, 0, -1), 'south': (0, 0, 1), 'west': (-1, 0, 0), 'east': (1, 0, 0)} def state(name, **props): """Return a complete registry-validated block state.""" legal, defaults = REGISTRY[name] values = dict(defaults, **{k: str(v) for k, v in props.items()}) for key, value in values.items(): assert key in legal and value in legal[key], (name, key, value) return 'minecraft:' + name + ('[' + ','.join(f'{k}={v}' for k, v in sorted(values.items())) + ']' if values else '') class Lodge: """Store generated blocks, entity data and structural metadata.""" def __init__(self): self.blocks = {} self.tiles = [] self.entities = [] self.rng = random.Random(CONFIG['seed']) self.supports = [] def put(self, x, y, z, name, **props): """Place one block using XYZ coordinates.""" sx, sy, sz = CONFIG['size'] assert 0 <= x < sx and 0 <= y < sy and 0 <= z < sz, (x, y, z) if name == 'air': self.blocks.pop((x, y, z), None) else: self.blocks[x, y, z] = state(name, **props) def box(self, x1, x2, y1, y2, z1, z2, material): """Fill an inclusive box with one material or a seeded palette.""" for x in range(x1, x2 + 1): for y in range(y1, y2 + 1): for z in range(z1, z2 + 1): self.put(x, y, z, self.rng.choices(material, weights=[7, 2, 1])[0] if isinstance(material, tuple) else material) def decor(self, x, y, z, name, support=None, **props): """Place decoration and record its required support.""" self.put(x, y, z, name, **props) self.supports.append(((x, y, z), support or (x, y - 1, z))) def door(self, x, y, z): """Place a matching glazed wooden door pair.""" for half, dy in [('lower', 0), ('upper', 1)]: self.put(x, y + dy, z, 'spruce_door', half=half, facing='north', hinge='left') def tile(self, x, y, z, identifier, **extra): """Attach generated block entity data.""" self.tiles.append(Compound({'id': String('minecraft:' + identifier), 'x': Int(x), 'y': Int(y), 'z': Int(z), **extra})) def save(self, path: Path, bounds=None): """Export blocks through LitematicCanvas and add generated entity data.""" bounds = bounds or (0, 44, 0, 39, 0, 34) x1, x2, y1, y2, z1, z2 = bounds canvas = LitematicCanvas((y2 - y1 + 1, z2 - z1 + 1, x2 - x1 + 1)) for (x, y, z), material in self.blocks.items(): if x1 <= x <= x2 and y1 <= y <= y2 and z1 <= z <= z2: canvas.block((y - y1, z - z1, x - x1), material) schematic = canvas.to_litematica(name='Amberstone', author='Codex', minecraft_data_version=CONFIG['data_version']) nbt = schematic.write_to_nbt() tiles = [] entities = [] for source in self.tiles: x, y, z = (int(source[k]) for k in ('x', 'y', 'z')) if x1 <= x <= x2 and y1 <= y <= y2 and z1 <= z <= z2: tile = deepcopy(source) for key, value in zip(('x', 'y', 'z'), (x - x1, y - y1, z - z1)): tile[key] = Int(value) tiles.append(tile) for source in self.entities: x, y, z = (int(source[k]) for k in ('TileX', 'TileY', 'TileZ')) if x1 <= x <= x2 and y1 <= y <= y2 and z1 <= z <= z2: entity = deepcopy(source) for key, value in zip(('TileX', 'TileY', 'TileZ'), (x - x1, y - y1, z - z1)): entity[key] = Int(value) entity['Pos'] = List([Double(float(v) - offset) for v, offset in zip(source['Pos'], (x1, y1, z1))]) entities.append(entity) nbt['Regions']['Amberstone']['TileEntities'] = List(tiles) nbt['Regions']['Amberstone']['Entities'] = List(entities) NBTFile(nbt).save(path) def build(): """Construct the lodge, landscape, furnishings and circulation.""" b = Lodge() # Irregular meadow and raised masonry terrace. for x in range(45): for z in range(35): if 1 < x < 43 and 1 < z < 33 and not ((x < 5 or x > 40) and (z < 5 or z > 30)): b.put(x, 0, z, 'dirt') b.put(x, 1, z, 'grass_block') b.box(5, 40, 1, 2, 6, 30, CONFIG['stone']) b.box(5, 40, 3, 3, 6, 30, CONFIG['stone']) for x in range(7, 40): if not 29 <= x <= 33: b.put(x, 4, 6, 'stone_brick_wall', east='low', west='low') for z in range(7, 30): b.put(40, 4, z, 'stone_brick_wall', north='low', south='low') for z, y in [(3, 1), (4, 2), (5, 3)]: b.box(29, 33, 1, y, z, z, CONFIG['stone']) for x in range(29, 34): b.put(x, y, z, 'stone_brick_stairs', facing='south') for z in range(0, 6): for x in range(27 + z // 3, 34 + z // 3): if b.rng.random() < .83: b.put(x, 1, z, b.rng.choice(['coarse_dirt', 'gravel', 'dirt_path'])) # Two connected masses, with uninterrupted upper timber floors. for x1, x2, z1, z2, top in [(*CONFIG['low'], 14), (*CONFIG['tower'], 21)]: for y in range(4, top + 1): for x in range(x1, x2 + 1): for z in range(z1, z2 + 1): if x in (x1, x2) or z in (z1, z2): material = CONFIG['stone'] if y < 9 else CONFIG['plaster'] b.box(x, x, y, y, z, z, material) for y in CONFIG['floors']: if y <= top: b.box(x1, x2, y, y, z1, z2, CONFIG['wood'] if y > 3 else CONFIG['stone']) for x in (x1, x2): for z in (z1, z2): b.box(x, x, 4, top, z, z, 'stripped_spruce_log') for y in (9, 14, 21): if y <= top: for z in (z1, z2): b.box(x1, x2, y, y, z, z, 'dark_oak_log') for x in range(x1 + 4, x2, 4): for z in (z1, z2): b.box(x, x, 9, top, z, z, 'stripped_spruce_log') # Shared wall portals on both common floors. for y in (4, 10): b.box(24, 25, y, y + 3, 18, 22, 'air') # Tower gable sealed beneath the two-block rise roof. for x in range(25, 38): roof_y = 37 - 2 * abs(x - 31) for z in (9, 27): b.box(x, x, 22, roof_y - 1, z, z, CONFIG['plaster']) if x in (27, 31, 35): b.box(x, x, 22, roof_y - 1, z, z, 'stripped_spruce_log') for x in (25, 37): b.box(x, x, 22, 24, 10, 26, CONFIG['plaster']) for x in range(23, 40): h = 37 - 2 * abs(x - 31) for z in range(7, 30): b.box(x, x, h - 1, h, z, z, CONFIG['roof']) b.put(x, h + 1, z, 'deepslate_tile_stairs', facing='east' if x < 31 else 'west') for z in (8, 28): b.put(31, 39, z, 'spruce_fence') # Low roof meets the tower wall; no detached roof seam. for x in range(8, 25): h = 20 - abs(x - 17) // 2 for z in range(7, 30): b.box(x, x, h, h, z, z, CONFIG['roof']) b.put(x, h + 1, z, 'deepslate_tile_slab') if 10 <= x <= 24: for z in (9, 27): b.box(x, x, 15, h - 1, z, z, CONFIG['plaster']) # Modest low attic filled with beams, closed to occupied rooms. b.box(10, 24, 14, 14, 9, 27, 'spruce_planks') # Framed windows and shutters, clear of roofs and chimneys. for y, xs in [(5, (13, 19, 28, 34)), (11, (13, 19, 28, 34)), (17, (28, 34)), (24, (30,))]: for x in xs: for z in (9, 27): wx = x - 1 if z == 27 and x == 34 else x b.box(wx, wx + 1, y, y + 1, z, z, 'glass') outside = z - 1 if z == 9 else z + 1 for sx in (wx - 1, wx + 2): for sy in (y, y + 1): b.decor(sx, sy, outside, 'spruce_trapdoor', support=(sx, sy, z), facing='south' if z == 9 else 'north', open='true') for sx in (wx, wx + 1): b.put(sx, y - 1, outside, 'spruce_stairs', facing='south' if z == 9 else 'north', half='top') for x in (10, 37): for y in (5, 11): for z in (14, 23): b.box(x, x, y, y + 1, z, z + 1, 'glass') b.door(31, 4, 9) b.put(31, 6, 9, 'glass') for x in (29, 33): b.put(x, 6, 8, 'spruce_fence') b.decor(x, 5, 8, 'lantern', support=(x, 6, 8), hanging='true') # Ground entrance, storage, workshop and potted climbing greenery. for x in (12, 13, 17, 18, 22): b.put(x, 4, 26, 'barrel', facing='north') b.put(x, 4, 25, 'chest', facing='north') b.put(12, 4, 12, 'crafting_table') b.put(13, 4, 12, 'smithing_table') b.put(15, 4, 12, 'anvil') b.put(17, 4, 12, 'grindstone', face='floor') b.box(29, 33, 4, 4, 12, 16, 'red_carpet') b.box(36, 36, 4, 7, 17, 20, 'bookshelf') b.put(34, 4, 11, 'barrel') b.decor(34, 5, 11, 'potted_fern') # Living floor, green cushioned sofa, dining table and fireplace. for z in range(12, 17): b.put(12, 10, z, 'spruce_stairs', facing='west') b.box(14, 20, 10, 10, 14, 18, 'green_carpet') for x in (16, 19): b.put(x, 10, 16, 'dark_oak_fence') b.put(x, 11, 16, 'spruce_slab', type='top') b.decor(x, 12, 16, 'white_candle', lit='true', candles='2') b.box(27, 32, 10, 10, 13, 17, 'red_carpet') b.box(29, 31, 10, 10, 14, 16, 'spruce_planks') for x in range(29, 32): b.put(x, 11, 14, 'spruce_slab', type='bottom') b.put(x, 11, 15, 'spruce_slab', type='top') b.put(x, 11, 16, 'spruce_slab', type='bottom') b.decor(30, 12, 15, 'white_candle', lit='true', candles='3') for x in (28, 32): for z in (14, 16): b.put(x, 10, z, 'spruce_stairs', facing='west' if x == 28 else 'east') for x in range(12, 22): b.put(x, 10, 26, 'barrel', facing='north') b.put(15, 11, 26, 'smoker', facing='north', lit='true') b.decor(18, 11, 26, 'potted_poppy') b.box(26, 27, 10, 20, 24, 26, CONFIG['stone']) b.put(27, 10, 23, 'campfire', lit='true') b.put(27, 11, 23, 'iron_bars', east='true', west='true') # Bedroom raised double green bed, cabinets and striped curtains. b.box(27, 30, 16, 16, 11, 14, 'spruce_planks') for x in (28, 29): for z, part in [(12, 'head'), (13, 'foot')]: b.put(x, 17, z, 'green_bed', part=part, facing='north') for x in range(27, 31): b.put(x, 16, 15, 'spruce_stairs', facing='north') for x in (27, 30): b.put(x, 17, 11, 'barrel', facing='south') b.decor(x, 18, 11, 'lantern') b.box(28, 29, 19, 19, 10, 10, 'bookshelf') for x in (27, 30): b.put(x, 19, 10, 'barrel', facing='south') b.box(28, 32, 16, 16, 18, 21, 'green_carpet') for x in (33, 36): b.decor(x, 19, 10, 'white_wall_banner', support=(x, 19, 9), facing='south') b.tile(x, 19, 10, 'banner', patterns=List([Compound({'pattern': String('minecraft:stripe_small'), 'color': String('green')})])) b.put(33, 16, 11, 'spruce_stairs', facing='north') b.put(34, 16, 11, 'spruce_slab', type='top') b.put(35, 16, 11, 'spruce_stairs', facing='north') b.decor(34, 17, 11, 'potted_blue_orchid') b.box(36, 36, 16, 18, 18, 21, 'bookshelf') # Attic study, library, reading chair and open-book lectern. b.box(28, 28, 22, 24, 18, 23, 'bookshelf') b.box(34, 34, 22, 24, 12, 20, 'bookshelf') b.box(30, 32, 22, 22, 18, 21, 'green_carpet') b.put(31, 22, 13, 'lectern', facing='south', has_book='true') b.tile(31, 22, 13, 'lectern', Book=Compound({'id': String('minecraft:written_book'), 'count': Int(1), 'components': Compound({'minecraft:written_book_content': Compound({'title': String('Amberstone Journal'), 'author': String('The Keeper'), 'pages': List([Compound({'raw': String('{"text":"Winter stores are full. Keep the forge lit."}')})])})})}), Page=Int(0)) for x in (30, 32): b.put(x, 22, 13, 'barrel', facing='south') b.decor(x, 23, 13, 'white_candle', lit='true', candles='2') b.put(31, 22, 16, 'spruce_stairs', facing='south') b.put(30, 22, 25, 'chest', facing='north') b.put(31, 22, 25, 'barrel') b.put(32, 22, 25, 'barrel') b.decor(32, 23, 25, 'potted_fern') # Additional storage, reading nooks and exposed timber for inhabited rooms. for floor in (3, 9, 15): for z in (17, 22): b.box(37, 37, floor + 1, floor + 5, z, z, 'stripped_spruce_log') for x in (11, 16, 22): b.box(x, x, 10, 13, 26, 26, 'barrel') b.put(x, 11, 25, 'spruce_trapdoor', half='top') b.box(20, 22, 4, 4, 12, 13, 'spruce_planks') b.decor(21, 5, 12, 'lantern') b.put(22, 5, 13, 'chest', facing='south') b.box(11, 11, 4, 6, 20, 22, 'barrel') for x in (28, 32): b.put(x, 16, 24, 'barrel', facing='north') b.decor(x, 17, 24, 'potted_fern' if x == 28 else 'white_candle', **({} if x == 28 else {'lit': 'true', 'candles': '3'})) # Low front roof dormer with a sealed cap and small glazed face. b.box(15, 19, 17, 19, 8, 11, CONFIG['plaster']) b.box(16, 18, 18, 19, 8, 8, 'glass') b.box(16, 18, 18, 19, 9, 11, 'air') for x in (15, 19): b.box(x, x, 17, 20, 8, 8, 'stripped_spruce_log') b.box(14, 20, 20, 20, 7, 12, 'deepslate_tiles') for x in range(14, 21): b.put(x, 21, 7, 'deepslate_tile_stairs', facing='south') # Closed ladder spine: all landings have a clear two-block approach. for y in range(4, 24): b.put(35, y, 25, 'ladder', facing='north') b.put(35, y, 26, 'spruce_planks') b.put(35, y, 24, 'air') for floor in CONFIG['floors'][1:]: b.put(35, floor, 24, 'spruce_planks') # Supported ceiling lights cover every room group. for floor, points in [(3, [(17, 19), (30, 20)]), (9, [(18, 21), (32, 20)]), (15, [(31, 20)]), (21, [(31, 20)])]: for x, z in points: ceiling = floor + 5 b.put(x, ceiling, z, 'spruce_planks') b.decor(x, ceiling - 1, z, 'lantern', support=(x, ceiling, z), hanging='true') b.box(31, 31, 26, 26, 9, 27, 'dark_oak_log') # Blacksmith lean-to, stone chimney, permanent lit campfire forge. for x in (4, 9): for z in (11, 22): b.box(x, x, 2, 8, z, z, 'spruce_log') for x in range(3, 11): for z in range(10, 24): b.put(x, 9 + (x - 3) // 4, z, 'deepslate_tile_slab', type='top') b.box(5, 7, 3, 4, 13, 16, CONFIG['stone']) b.box(5, 7, 5, 21, 16, 18, CONFIG['stone']) b.box(4, 8, 22, 22, 15, 19, 'stone_brick_slab') b.put(6, 5, 15, 'campfire', lit='true') b.put(5, 5, 15, 'blast_furnace', facing='north', lit='true') b.put(7, 5, 15, 'blast_furnace', facing='north', lit='true') b.put(6, 4, 20, 'anvil') b.put(8, 4, 21, 'barrel') b.put(8, 5, 21, 'chest') # Item frames: entities attached to workshop and study cabinetry. for x, y, z, item in [(12, 4, 25, 'iron_ingot'), (30, 22, 25, 'book')]: b.entities.append(Compound({'id': String('minecraft:item_frame'), 'Pos': List([Double(x + .5), Double(y + .5), Double(z - .03125)]), 'Facing': Byte(2), 'TileX': Int(x), 'TileY': Int(y), 'TileZ': Int(z - 1), 'ItemRotation': Byte(0), 'Item': Compound({'id': String('minecraft:' + item), 'count': Int(1)})})) # Wall-clinging ivy with explicit backing faces. for x in (25, 26, 36): for y in range(4, 14): if (x, y, 8) not in b.blocks: b.decor(x, y, 8, 'vine', support=(x, y, 9), south='true') # Two custom stepped conifers behind the low wing. for cx, cz, height in [(5, 28, 19), (16, 32, 26)]: b.box(cx, cx, 2, height, cz, cz, 'spruce_log') for y in range(6, height, 3): radius = min(2, max(1, (height - y) // 5)) for dx, dz in [(1, 0), (-1, 0), (0, 1), (0, -1)]: for step in range(1, radius + 1): b.put(cx + dx * step, y, cz + dz * step, 'spruce_log', axis='x' if dx else 'z') 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): b.put(cx + dx, y + 1, cz + dz, 'spruce_leaves', persistent='true', distance='1') if abs(dx) + abs(dz) < radius: b.put(cx + dx, y + 2, cz + dz, 'spruce_leaves', persistent='true', distance='1') b.put(cx, height + 1, cz, 'spruce_leaves', persistent='true', distance='1') for x, z in [(7, 4), (12, 5), (22, 4), (38, 4), (42, 15), (3, 25), (40, 32)]: b.put(x, 2, z, 'moss_block') b.decor(x, 3, z, 'fern' if x % 2 else 'poppy') return b def verify_roundtrip(b, path: Path): """Compare every loaded air and non-air block state with the generated volume.""" loaded = load_schematic(path) assert loaded.size_yzx == (40, 35, 45) actual = np.array(loaded.palette, dtype=object)[loaded.read_flat(0, loaded.volume)].reshape(loaded.size_yzx) intended = np.full(loaded.size_yzx, 'minecraft:air', dtype=object) for (x, y, z), value in b.blocks.items(): intended[y, z, x] = value assert np.array_equal(actual, intended) return {'dimensions_xyz': CONFIG['size'], 'non_air_blocks': len(b.blocks), 'palette_states': len(loaded.palette), 'full_volume_states_compared': loaded.volume, 'mismatches': 0, 'counts': dict(Counter(v.split('[')[0] for v in b.blocks.values()))} def main(): """Write the final schematic, cutaways and verification evidence in the current directory.""" b = build() b.save(Path('output.litematic')) Path('previews').mkdir(exist_ok=True) for name, bounds in {'ground': (9, 38, 3, 7, 8, 28), 'living': (9, 38, 9, 13, 8, 28), 'bedroom': (24, 38, 15, 20, 8, 28), 'study': (27, 35, 21, 25, 9, 27)}.items(): b.save(Path('previews') / f'{name}.litematic', bounds) Path('previews/validation.json').write_text(json.dumps(verify_roundtrip(b, Path('output.litematic')), indent=2) + '\n') print('Generated', len(b.blocks), 'blocks; full state round trip passed.') if __name__ == '__main__': main()

# Validate generated structure, circulation, attachment and exported states. from pathlib import Path import sys from collections import deque from tempfile import TemporaryDirectory import pytest sys.path.insert(0, str(Path(__file__).resolve().parents[1])) from generate import build, CONFIG, REGISTRY, DIRECTIONS, verify_roundtrip, NBTFile @pytest.fixture(scope='module') def lodge(): """Create the deterministic in-memory build.""" return build() def split(value): """Separate a material into name and properties.""" name, _, props = value.partition('[') return name.removeprefix('minecraft:'), dict(p.split('=') for p in props.rstrip(']').split(',') if p) def name(b, p): """Return the short material name at a coordinate.""" return split(b.blocks.get(p, 'minecraft:air'))[0] def pairing(b): """Check all doors and beds in both directions.""" for (x, y, z), value in b.blocks.items(): n, props = split(value) if n.endswith('_door'): other = dict(props, half='upper' if props['half'] == 'lower' else 'lower') q = (x, y + (1 if props['half'] == 'lower' else -1), z) assert split(b.blocks.get(q, '')) == (n, other) if n.endswith('_bed'): dx, _, dz = DIRECTIONS[props['facing']] sign = 1 if props['part'] == 'foot' else -1 q = (x + sign * dx, y, z + sign * dz) other = dict(props, part='head' if props['part'] == 'foot' else 'foot') assert split(b.blocks.get(q, '')) == (n, other) def passable(b, p): """Model a player's clearance, allowing doors to be opened on foot.""" n = name(b, p) return n in ('air', 'ladder', 'vine') or n.endswith(('_carpet', '_door', '_wall_banner')) def reachable(b): """Flood walkable two-block-tall positions with supported ladder transitions.""" def valid(p): x, y, z = p return 0 <= x < 45 and 1 <= y < 39 and 0 <= z < 35 and passable(b, p) and passable(b, (x, y + 1, z)) and (not passable(b, (x, y - 1, z)) or name(b, p) == 'ladder' or name(b, (x, y - 1, z)) == 'ladder') start = (31, 4, 8) seen = {start} todo = deque([start]) while todo: x, y, z = todo.popleft() candidates = [(x + dx, y, z + dz) for dx, _, dz in DIRECTIONS.values()] if name(b, (x, y, z)) == 'ladder' or name(b, (x, y - 1, z)) == 'ladder': candidates.extend([(x, y + 1, z), (x, y - 1, z)]) for p in candidates: if p not in seen and valid(p): seen.add(p) todo.append(p) return seen def enclosed(b): """Flood interior air through six faces, treating shut doors and glazing as envelope.""" def air(p): n = name(b, p) return n == 'air' or n in ('ladder', 'vine') or n.endswith(('_carpet', '_wall_banner')) todo = deque(CONFIG['rooms'].values()) seen = set(todo) while todo: x, y, z = todo.popleft() assert 0 < x < 44 and 0 < y < 39 and 0 < z < 34, ('Envelope leak', x, y, z) 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 not in seen and air(q): seen.add(q) todo.append(q) return seen def test_registry_and_determinism(lodge): assert lodge.blocks == build().blocks for value in set(lodge.blocks.values()): n, props = split(value) legal, defaults = REGISTRY[n] assert set(props) == set(defaults) assert all(v in legal[k] for k, v in props.items()) def test_doors_and_beds(lodge): pairing(lodge) assert sum('_bed[' in s for s in lodge.blocks.values()) == 4 def test_reachability_and_headroom(lodge): reached = reachable(lodge) for room, p in CONFIG['rooms'].items(): assert p in reached, room for floor in CONFIG['floors']: assert (35, floor + 1, 25) in reached def test_enclosure(lodge): assert len(enclosed(lodge)) > 3000 def test_no_floating_decoration(lodge): for p, support in lodge.supports: assert p in lodge.blocks and support in lodge.blocks, (p, support) # Every non-air block must be face-connected to the terrain or building. seen = {(2, 0, 5)} todo = deque(seen) while todo: x, y, z = todo.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 lodge.blocks and q not in seen: seen.add(q) todo.append(q) assert not (set(lodge.blocks) - seen), sorted(set(lodge.blocks) - seen)[:20] for entity in lodge.entities: x, y, z = (int(entity[k]) for k in ('TileX', 'TileY', 'TileZ')) assert (x, y, z + 1) in lodge.blocks for (x, y, z), v in lodge.blocks.items(): n, p = split(v) if n == 'ladder': assert (x, y, z + 1) in lodge.blocks if n.endswith('_bed'): assert (x, y - 1, z) in lodge.blocks def test_room_lighting(lodge): for room, (x, y, z) in CONFIG['rooms'].items(): lights = [p for p, v in lodge.blocks.items() if y <= p[1] < y + 5 and ('lantern' in v or 'lit=true' in v)] assert any(abs(x - p[0]) + abs(z - p[2]) <= 12 for p in lights), room def test_full_export(lodge): with TemporaryDirectory(dir=Path(__file__).parent) as directory: output = Path(directory) / 'output.litematic' lodge.save(output) evidence = verify_roundtrip(lodge, output) assert evidence['mismatches'] == 0 nbt = NBTFile.load_regardless_of_gzipped(filename=output) assert int(nbt['MinecraftDataVersion']) == 3955 assert len(nbt['Regions']) == 1 region = nbt['Regions']['Amberstone'] assert len(region['Entities']) == 2 assert len(region['TileEntities']) == 3 assert str(region['TileEntities'][0]['patterns'][0]['pattern']) == 'minecraft:stripe_small' def test_validators_reject_damage(): b = build() b.blocks.pop((31, 5, 9)) with pytest.raises(AssertionError): pairing(b) b = build() b.blocks.pop((28, 17, 12)) with pytest.raises(AssertionError): pairing(b) b = build() b.blocks.pop((37, 18, 16)) with pytest.raises(AssertionError): enclosed(b) b = build() for y in range(10, 16): b.blocks.pop((35, y, 25)) assert CONFIG['rooms']['bedroom'] not in reachable(b) def test_windows_not_obstructed(lodge): for (x, y, z), value in lodge.blocks.items(): if split(value)[0] != 'glass' or y > 18: continue if z in (9, 27): interior = (x, y, z + (1 if z == 9 else -1)) elif x in (10, 37): interior = (x + (1 if x == 10 else -1), y, z) else: continue assert passable(lodge, interior), (x, y, z, interior, name(lodge, interior))

"""Generate and validate Amberstone Lodge using the offline MCIO installation.""" from __future__ import annotations import argparse from collections import Counter, deque import json import gzip from copy import deepcopy from pathlib import Path import random import sys import numpy as np sys.path.insert(0, '/work/generator/MCIO') from mcio.sketch import LitematicCanvas, parse_blockstate from mcio.schematic import load_schematic from mcio.nbt.nbt import File as NBTFile from mcio.nbt.tag import Compound, String, Int, Byte, Short, Double, Float, List, IntArray CONFIG = { 'seed': 73129, 'size_xyz': (47, 41, 37), 'data_version': 3955, 'registry': '/work/generator/MCRender/resources/1.21.1-blocks.json', 'wings': { 'low': (9, 25, 10, 27), 'tower': (25, 39, 11, 28) }, 'floors': (3, 9, 15, 21), 'roof': { 'center_x': 32, 'tower_eave': 24, 'tower_slope': 1.65, 'low_center_z': 18, 'low_eave': 16, 'low_slope': .65 }, 'palettes': { 'stone': ('stone_bricks', 'cobblestone', 'andesite'), 'plaster': ('sandstone', 'smooth_sandstone', 'yellow_terracotta'), 'roof': ('deepslate_tiles', 'deepslate_bricks', 'cobbled_deepslate'), 'floor': ('spruce_planks',) * 10 + ('oak_planks',), 'path': ('coarse_dirt', 'gravel', 'rooted_dirt'), }, 'rooms': { 'entrance': { 'bounds': (26, 38, 12, 27), 'floor': 3, 'target': (31, 4, 16) }, 'workshop': { 'bounds': (10, 24, 11, 26), 'floor': 3, 'target': (18, 4, 17) }, 'living_dining': { 'bounds': (10, 24, 11, 26), 'floor': 9, 'target': (20, 10, 18) }, 'tower_lounge': { 'bounds': (26, 38, 12, 27), 'floor': 9, 'target': (32, 10, 18) }, 'bedroom': { 'bounds': (26, 38, 12, 27), 'floor': 15, 'target': (32, 16, 18) }, 'attic_study': { 'bounds': (26, 38, 12, 27), 'floor': 21, 'target': (32, 22, 18) }, }, 'trees': ((4, 28, 24), (17, 33, 29)), 'front_door': (30, 4, 11), 'cutaways': { 'ground': (3, 7, 8, 40, 9, 29), 'living': (9, 13, 8, 40, 9, 29), 'bedroom': (15, 19, 25, 39, 11, 28), 'attic': (21, 26, 25, 39, 11, 28), 'bedroom_window': (15, 19, 25, 39, 11, 20) }, } DIRECTIONS = {'north': (0, 0, -1), 'south': (0, 0, 1), 'east': (1, 0, 0), 'west': (-1, 0, 0)} AIR = 'minecraft:air' def unpack(state): """Split a canonical block state into its name and properties.""" name = state.split('[')[0].removeprefix('minecraft:') props = dict(p.split('=') for p in state.split('[')[1][:-1].split(',')) if '[' in state else {} return name, props class Lodge: """Keep the generated voxel model, entity data and architectural audit together.""" def __init__(self, seed=CONFIG['seed']): self.rng = random.Random(seed) self.registry = json.loads(Path(CONFIG['registry']).read_text()) self.blocks = {} self.tiles = [] self.entities = [] self.windows = set() self.lights = [] def state(self, name, **props): """Resolve all defaults and reject states absent from the 1.21.1 registry.""" name = name.removeprefix('minecraft:') allowed, defaults = self.registry[name] values = {**defaults, **{k: str(v).lower() for k, v in props.items()}} for key, value in values.items(): if key not in allowed or value not in allowed[key]: raise ValueError((name, key, value)) return 'minecraft:' + name + ('[' + ','.join(f'{k}={v}' for k, v in sorted(values.items())) + ']' if values else '') def put(self, x, y, z, name, **props): """Place one block using readable XYZ architectural coordinates.""" sx, sy, sz = CONFIG['size_xyz'] if not (0 <= x < sx and 0 <= y < sy and 0 <= z < sz): raise ValueError((x, y, z, name)) if name == 'air': self.blocks.pop((x, y, z), None) else: self.blocks[x, y, z] = self.state(name, **props) def get(self, x, y, z): """Read a block, including implicit air.""" return self.blocks.get((x, y, z), AIR) def box(self, x1, x2, y1, y2, z1, z2, name, **props): """Fill an inclusive box with one state or a configured material palette.""" for y in range(y1, y2 + 1): for z in range(z1, z2 + 1): for x in range(x1, x2 + 1): material = self.rng.choice(CONFIG['palettes'][name]) if name in CONFIG['palettes'] else name self.put(x, y, z, material, **props) def beam(self, x1, x2, y1, y2, z1, z2, axis='y'): """Build a continuous timber member.""" self.box(x1, x2, y1, y2, z1, z2, 'stripped_spruce_log', axis=axis) def lamp(self, x, y, z, hanging=False): """Place a supported lantern and remember its light source.""" self.put(x, y, z, 'lantern', hanging=hanging) self.lights.append((x, y, z)) def door(self, x, y, z, facing='north', hinge='left', kind='spruce_door'): """Create the two matching halves of a closed wooden door.""" for half, dy in [('lower', 0), ('upper', 1)]: self.put(x, y + dy, z, kind, facing=facing, hinge=hinge, half=half) def tile(self, x, y, z, kind, **data): """Attach generated vanilla block entity data to its block.""" self.tiles.append(Compound({'id': String('minecraft:' + kind), 'x': Int(x), 'y': Int(y), 'z': Int(z), **data})) def frame(self, x, y, z, item='iron_pickaxe'): """Hang an item frame on the south face of the adjacent northern wall.""" index = len(self.entities) self.entities.append(Compound({ 'id': String('minecraft:item_frame'), 'TileX': Int(x), 'TileY': Int(y), 'TileZ': Int(z), 'Facing': Byte(3), 'Pos': List[Double]([x + .5, y + .5, z + .03125]), 'Rotation': List[Float]([0., 0.]), 'Motion': List[Double]([0., 0., 0.]), 'UUID': IntArray([CONFIG['seed'], 123, 456, index + 1]), 'ItemRotation': Byte(0), 'ItemDropChance': Float(1), 'Item': Compound({ 'id': String('minecraft:' + item), 'count': Int(1) }), })) def window(self, x, y, z, width, height=3, side='front'): """Inset a glass opening with timber lintel, sill and exterior shutters.""" for a in range(-1, width + 1): for b in range(-1, height + 1): px, pz = (x + a, z) if side in ('front', 'back') else (x, z + a) material = 'glass' if 0 <= a < width and 0 <= b < height else 'stripped_oak_log' self.put(px, y + b, pz, material) if material == 'glass': self.windows.add((px, y + b, pz)) facing = {'front': 'north', 'back': 'south', 'right': 'east', 'left': 'west'}[side] dx, _, dz = DIRECTIONS[facing] for a in (-1, width): for b in range(height): px, pz = (x + a, z) if side in ('front', 'back') else (x, z + a) self.put(px + dx, y + b, pz + dz, 'spruce_trapdoor', facing=facing, open=True) def terrain(self): """Raise the stone terrace over an irregular planted woodland plinth.""" for x in range(47): for z in range(37): if ((x - 23) / 25)**2 + ((z - 19) / 21)**2 < 1.08: self.put(x, 0, z, 'dirt') self.put(x, 1, z, self.rng.choice(('grass_block', 'grass_block', 'moss_block'))) self.box(5, 42, 1, 2, 7, 31, 'stone') self.box(6, 41, 3, 3, 7, 31, 'stone') for x in range(6, 42): if not 28 <= x <= 33: self.put(x, 4, 7, 'stone_brick_wall', east='low', west='low', up=(x % 5 == 0)) self.put(x, 4, 31, 'stone_brick_wall', east='low', west='low', up=(x % 5 == 0)) for z in range(8, 31): self.put(42, 3, z, 'stone_brick_slab') for z, y in ((4, 1), (5, 2), (6, 3)): self.box(28, 33, 1, y - 1, z, z, 'stone') self.box(28, 33, y, y, z, z, 'stone_brick_stairs', facing='south') for z in range(5): center = 30 + round(1.4 * np.sin(z)) for x in range(center - 3, center + 4): if self.rng.random() > .14: self.put(x, 1, z, self.rng.choice(CONFIG['palettes']['path'])) for x in range(3, 45): for z in (3, 5, 33, 35): if self.get(x, 1, z) != AIR and self.rng.random() < .35 and not (27 <= x <= 35 and z <= 5): self.put(x, 2, z, self.rng.choice(('fern', 'short_grass', 'dandelion', 'poppy'))) def shell(self): """Construct stone basements, timber plaster walls and continuous floors.""" for wing, (x1, x2, z1, z2) in CONFIG['wings'].items(): top = 15 if wing == 'low' else 24 for y in range(4, top + 1): for x in range(x1, x2 + 1): for z in range(z1, z2 + 1): if x in (x1, x2) or z in (z1, z2): palette = 'stone' if y < 9 else 'plaster' self.put(x, y, z, self.rng.choice(CONFIG['palettes'][palette])) for y in CONFIG['floors']: if y <= top: self.box(x1, x2, y, y, z1, z2, 'floor' if y > 3 else 'stone') for y in (9, 15, 21): if y <= top: self.beam(x1, x2, y, y, z1, z1, 'x') self.beam(x1, x2, y, y, z2, z2, 'x') self.beam(x1, x1, y, y, z1, z2, 'z') self.beam(x2, x2, y, y, z1, z2, 'z') for x in range(x1, x2 + 1, 4 if wing == 'low' else 7): for z in (z1, z2): self.beam(x, x, 4, top, z, z) for z in range(z1, z2 + 1, 5): for x in (x1, x2): self.beam(x, x, 4, top, z, z) # Shared-wall portals are carved after both shells exist. for y in (4, 10): self.box(25, 25, y, y + 3, 17, 20, 'air') for x, hinge in ((30, 'left'), (31, 'right')): self.door(x, 4, 11, hinge=hinge, kind='oak_door') for x in (28, 33): self.box(x, x, 4, 6, 11, 11, 'glass') self.beam(28, 33, 7, 7, 10, 10, 'x') for x in (27, 34): self.put(x, 6, 10, 'spruce_fence') self.put(x, 7, 10, 'spruce_slab', type='top') self.lamp(x, 5, 10, True) for x in (12, 19): self.window(x, 11, 10, 3) self.window(x, 5, 10, 2, 2) self.window(x, 11, 27, 3, side='back') for y in (11, 17, 23, 29): self.window(30 if y != 29 else 31, y, 11, 4 if y != 29 else 2, 3) for y in (5, 11, 17, 23): self.window(39, y if y < 23 else 22, 16, 3, 3 if y < 23 else 2, side='right') self.window(30, y, 28, 3, 3, side='back') self.window(9, 11, 16, 3, side='left') def roof(self): """Seal overlapping dark roofs with stepped full-block backing and stair edges.""" cfg = CONFIG['roof'] profile = lambda x: cfg['tower_eave'] + round(cfg['tower_slope'] * (8 - abs(x - cfg['center_x']))) for x in range(25, 40): h = profile(x) for z in (11, 28): for y in range(25, h): # Preserve the windows installed before gable infill. if self.get(x, y, z) == AIR: self.put(x, y, z, self.rng.choice(CONFIG['palettes']['plaster'])) if x in (25, 28, 32, 36, 39): for y in range(25, h): if (x, y, z) not in self.windows: self.put(x, y, z, 'stripped_spruce_log') for x in range(23, 42): h = profile(max(24, min(40, x))) next_outer = profile(max(24, min(40, x - 1 if x < 32 else x + 1))) for z in range(9, 31): self.box(x, x, min(h, next_outer), h, z, z, 'roof') if x != 32: self.put(x, h + 1, z, 'deepslate_tile_stairs', facing='east' if x < 32 else 'west') else: self.put(x, h + 1, z, 'deepslate_tile_slab', type='top') for z in (9, 30): self.put(32, 39, z, 'spruce_fence') self.put(32, 40, z, 'spruce_fence') for z in range(8, 30): h = cfg['low_eave'] + round(cfg['low_slope'] * (10 - abs(z - cfg['low_center_z']))) # Full roof skin extends into the tower's shared wall, sealing the junction. for x in range(7, 25): self.put(x, h, z, self.rng.choice(CONFIG['palettes']['roof'])) self.put(x, h + 1, z, 'deepslate_tile_stairs', facing='south' if z < 18 else 'north') if 10 <= z <= 27: for y in range(16, h): self.put(9, y, z, 'spruce_planks') # Front eyebrow dormer on lower roof, with a sealed glass face. self.box(15, 21, 18, 21, 11, 14, 'spruce_planks') self.box(16, 20, 19, 20, 11, 11, 'glass') self.box(14, 22, 22, 22, 10, 15, 'deepslate_tiles') for x in range(14, 23): self.put(x, 22, 10, 'deepslate_tile_stairs', facing='south') # Gable collars and corbels are outside all glazed openings. for x in (26, 38): self.put(x, 23, 10, 'spruce_stairs', facing='south', half='top') def circulation(self): """Cut a three-wide main stair and backed tower ladder with clear landings.""" for i in range(6): x, y = 15 + i, 4 + i self.box(x, x, 4, y - 1, 23, 25, 'spruce_planks') self.box(x, x, y + 1, y + 3, 23, 25, 'air') self.box(x, x, y, y, 23, 25, 'spruce_stairs', facing='east') for y in range(4, 24): self.put(37, y, 27, 'ladder', facing='north') # This ladder pierces floors only at its backed climb cell. for y in (10, 16, 22): self.box(36, 36, y, y + 1, 26, 27, 'air') def forge(self): """Furnish the sheltered smithy with a live coal hearth and flue.""" self.box(1, 8, 2, 3, 13, 24, 'stone') for x in (2, 8): for z in (13, 24): self.beam(x, x, 4, 8 if x == 2 else 9, z, z) for x in range(1, 9): h = 9 + x // 5 for z in range(12, 26): self.put(x, h, z, 'deepslate_tile_slab', type='top') self.box(5, 8, 4, 6, 20, 23, 'stone') self.box(6, 7, 5, 5, 20, 22, 'air') self.put(6, 4, 22, 'campfire', lit=True, signal_fire=True) self.put(7, 4, 21, 'magma_block') self.put(6, 5, 20, 'iron_bars') self.box(5, 7, 6, 24, 21, 23, 'stone') self.box(6, 6, 5, 26, 22, 22, 'air') for x in range(5, 8): for z in range(21, 24): if (x, z) != (6, 22): self.put(x, 25, z, 'stone_brick_wall', up=True) self.put(x, 26, z, 'stone_brick_slab') self.put(8, 4, 18, 'blast_furnace', facing='west', lit=True) self.put(8, 4, 17, 'furnace', facing='west', lit=True) for z, kind, cook_total in ((18, 'blast_furnace', 100), (17, 'furnace', 200)): self.tile(8, 4, z, kind, BurnTime=Short(1600), CookTime=Short(0), CookTimeTotal=Short(cook_total), Items=List[Compound]([ Compound({ 'Slot': Byte(0), 'id': String('minecraft:raw_iron'), 'count': Int(32) }), Compound({ 'Slot': Byte(1), 'id': String('minecraft:coal'), 'count': Int(16) }), ])) self.put(4, 4, 17, 'anvil', facing='north') self.put(3, 4, 22, 'barrel', facing='up') self.put(3, 4, 23, 'chest', facing='east') self.put(7, 4, 14, 'grindstone', face='floor', facing='west') self.put(2, 4, 14, 'smithing_table') self.put(3, 9, 14, 'spruce_planks') self.lamp(3, 8, 14, True) def carpet(self, x1, x2, y, z1, z2, color): """Lay a rug with a contrasting woven border.""" for x in range(x1, x2 + 1): for z in range(z1, z2 + 1): self.put(x, y, z, ('brown' if x in (x1, x2) or z in (z1, z2) else color) + '_carpet') def table(self, x, y, z, width=3, depth=2): """Build a substantial plank table with upside-down stair edges.""" self.box(x, x + width - 1, y, y, z, z + depth - 1, 'spruce_planks') for xx in range(x, x + width): self.put(xx, y, z, 'spruce_stairs', half='top', facing='south') self.put(xx, y, z + depth - 1, 'spruce_stairs', half='top', facing='north') def interiors(self): """Furnish six usable room groups across the four occupied levels.""" # Basement workshop and stockroom. for x in (10, 11, 12, 22, 23): self.put(x, 4, 26, 'barrel', facing='north') self.put(x, 5, 26, 'barrel', facing='north') for x, block in ((11, 'crafting_table'), (12, 'smithing_table'), (13, 'stonecutter')): self.put(x, 4, 12, block) for z in (16, 19, 22): self.put(10, 4, z, 'chest', facing='east') self.frame(16, 6, 11) self.frame(22, 6, 11, 'iron_ingot') # Hall: paneled storage, pots and glazed oak doors. self.carpet(29, 33, 4, 14, 21, 'red') self.box(38, 38, 4, 5, 20, 23, 'barrel', facing='west') self.box(26, 26, 4, 6, 23, 25, 'bookshelf') self.put(34, 4, 13, 'barrel', facing='up') self.put(34, 5, 13, 'potted_fern') self.put(34, 4, 24, 'spruce_stairs', facing='south') self.put(35, 4, 24, 'spruce_stairs', facing='south') self.box(26, 27, 4, 8, 13, 14, 'stone') self.put(27, 4, 15, 'terracotta') self.box(27, 27, 5, 7, 15, 15, 'oak_leaves', persistent=True, distance=1) self.box(28, 28, 5, 7, 14, 14, 'vine', west=True) # Dining floor: long table, stair chairs, hearth and kitchen storage. self.carpet(12, 18, 10, 14, 20, 'green') self.table(14, 10, 16, 3, 3) for x in (14, 16): self.put(x, 10, 14, 'spruce_stairs', facing='south') self.put(x, 10, 20, 'spruce_stairs', facing='north') self.put(15, 11, 17, 'white_candle', candles=3, lit=True) self.put(16, 11, 17, 'flower_pot') self.box(10, 10, 10, 10, 22, 25, 'barrel', facing='east') self.box(10, 10, 12, 13, 22, 25, 'barrel', facing='east') self.put(11, 10, 26, 'smoker', facing='north', lit=True) self.put(12, 10, 26, 'cauldron') self.put(13, 10, 26, 'crafting_table') self.put(10, 11, 22, 'potted_blue_orchid') # Tower lounge: masonry hearth and bookshelves. self.carpet(29, 34, 10, 15, 20, 'red') self.box(26, 27, 10, 14, 23, 25, 'stone') self.put(27, 10, 23, 'campfire', lit=True) self.put(28, 10, 23, 'iron_bars') for z in range(20, 25): self.put(38, 10, z, 'bookshelf') self.put(38, 11, z, 'bookshelf') for z in (15, 16, 17): self.put(35, 10, z, 'spruce_stairs', facing='west') self.table(30, 10, 23) self.put(31, 11, 23, 'white_candle', candles=2, lit=True) self.put(32, 11, 23, 'potted_fern') # Bedroom: raised green double bed with framed footboard. self.box(28, 32, 16, 16, 21, 25, 'dark_oak_planks') self.box(29, 31, 16, 16, 20, 20, 'spruce_stairs', facing='south') for x in (29, 30): self.put(x, 17, 23, 'green_bed', facing='south', part='foot') self.put(x, 17, 24, 'green_bed', facing='south', part='head') self.put(x, 17, 22, 'dark_oak_trapdoor', facing='north', open=True) for x in (28, 31): self.put(x, 17, 24, 'barrel', facing='up') self.lamp(x, 18, 24) self.box(28, 32, 19, 19, 25, 25, 'bookshelf') self.box(28, 32, 20, 20, 25, 25, 'spruce_slab', type='top') self.box(28, 28, 17, 20, 25, 25, 'spruce_planks') self.box(32, 32, 17, 20, 25, 25, 'spruce_planks') self.box(38, 38, 16, 18, 21, 24, 'barrel', facing='west') self.carpet(29, 33, 16, 14, 18, 'green') self.box(30, 33, 16, 16, 12, 12, 'dark_oak_stairs', facing='south') self.put(34, 16, 12, 'barrel', facing='up') self.put(34, 17, 12, 'potted_blue_orchid') for x in (29, 34): self.put(x, 19, 12, 'white_wall_banner', facing='south') self.tile(x, 19, 12, 'banner', patterns=List[Compound]([ Compound({ 'color': String('green'), 'pattern': String('minecraft:stripe_left') }), Compound({ 'color': String('green'), 'pattern': String('minecraft:stripe_right') }), ])) # Attic study: open-book lectern, cupboards, candle desk and reading seat. self.carpet(29, 34, 22, 15, 21, 'green') for z in range(19, 26): self.box(26, 26, 22, 24, z, z, 'bookshelf' if z % 3 else 'barrel', **({} if z % 3 else {'facing': 'east'})) self.box(38, 38, 22, 24, 20, 24, 'barrel', facing='west') self.table(30, 22, 23, 4, 2) self.put(30, 23, 23, 'lectern', facing='north', has_book=True) self.tile(30, 23, 23, 'lectern', Book=Compound({'id': String('minecraft:written_book'), 'count': Int(1), 'components': Compound({'minecraft:written_book_content': Compound({'title': String('Amberstone Ledger'), 'author': String('Lodge keeper'), 'generation': Int(0), 'pages': List[String]([json.dumps({'text': 'Amberstone Lodge\n\nPine timber, iron tools, warm hearths.\n\nAutumn inventory: full.'})]), 'resolved': Byte(1)})})}), Page=Int(0)) self.put(33, 23, 23, 'white_candle', candles=3, lit=True) self.put(32, 22, 21, 'spruce_stairs', facing='south') self.put(27, 22, 13, 'chest', facing='south') self.put(28, 22, 13, 'barrel', facing='up') self.put(28, 23, 13, 'potted_fern') self.frame(35, 24, 12, 'clock') # Ceiling lights and cross beams give every room its own light sources. for y in (8, 14): for x in (13, 21): self.beam(x, x, y, y, 11, 26, 'z') for z in (13, 20): self.lamp(x, y - 1, z, True) for ceiling in (8, 14, 20, 27): for x in (28, 35): self.beam(x, x, ceiling, ceiling, 12, 27, 'z') for z in (15, 22): self.lamp(x, ceiling - 1, z, True) # Rerun stair and ladder cuts after overhead beams have been installed. self.circulation() def landscape(self): """Build layered custom pines and supported climbing greenery.""" for x, z, height in CONFIG['trees']: self.box(x, x, 2, height, z, z, 'spruce_log') for level in range(6, height, 4): radius = max(1, round(4 * (height - level) / height)) for dx, _, dz in DIRECTIONS.values(): for k in range(1, radius + 1): self.put(x + dx * k, level, z + dz * k, 'spruce_log', axis='x' if dx else 'z') for dy in (0, 1): for dx in range(-radius, radius + 1): for dz in range(-radius, radius + 1): if abs(dx) + abs(dz) <= radius + 1 - dy and (dx or dz) and self.get(x + dx, level + dy, z + dz) == AIR: self.put(x + dx, level + dy, z + dz, 'spruce_leaves', persistent=True, distance=1) for y in range(height, height + 3): self.put(x, y, z, 'spruce_leaves', persistent=True, distance=1) for x in (26, 27, 36, 37): for y in range(4, 17 if x < 28 else 11): if self.get(x, y, 10) == AIR and self.get(x, y, 11) != AIR and (x, y, 11) not in self.windows: self.put(x, y, 10, 'vine', south=True) for x in (26, 35): self.put(x, 4, 9, 'moss_block') self.put(x, 5, 9, 'azalea') for x in (11, 22): self.put(x, 10, 9, 'spruce_trapdoor', facing='south', half='top') self.put(x, 11, 9, 'potted_fern') def build(self): """Generate the complete architecture and furnishing in a stable order.""" self.terrain() self.shell() self.roof() self.forge() self.interiors() self.landscape() return self def export(self, path: Path, subset=None, include_entities=True): """Serialize blocks through LitematicCanvas and generated vanilla entity records.""" sx, sy, sz = CONFIG['size_xyz'] canvas = LitematicCanvas((sy, sz, sx)) materials = {} blocks = self.blocks if subset is None else subset for (x, y, z), state in blocks.items(): if state not in materials: materials[state] = parse_blockstate(state) canvas.block((y, z, x), materials[state]) schematic = canvas.to_litematica(name='Amberstone Lodge', author='Amberstone', description='Furnished four-level timber lodge, seed 73129', minecraft_data_version=CONFIG['data_version']) schematic.metadata.time_created = schematic.metadata.time_modified = 0 nbt = schematic.write_to_nbt() region = nbt['Regions']['Amberstone Lodge'] if include_entities: region['TileEntities'] = List[Compound](self.tiles) region['Entities'] = List[Compound](self.entities) NBTFile(nbt, gzipped=False).save(path) path.write_bytes(gzip.compress(path.read_bytes(), mtime=0)) def cutaways(self, directory: Path): """Export cropped floor slices with front walls removed for inspection.""" for name, (base, top, x1, x2, z1, z2) in CONFIG['cutaways'].items(): reverse = name == 'bedroom_window' blocks = {p: s for p, s in self.blocks.items() if base <= p[1] <= top and x1 <= p[0] <= x2 and z1 <= p[2] <= z2 and not (p[1] > base + 1 and ((p[2] >= z2 if reverse else p[2] <= z1 + 1) or p[0] <= x1))} # Compact the inspection copy so the renderer frames the room, not the original volume. canvas = LitematicCanvas((top - base + 1, z2 - z1 + 1, x2 - x1 + 1)) for (x, y, z), state in blocks.items(): canvas.block((y - base, z - z1, x - x1), state) schematic = canvas.to_litematica(name=f'{name} inspection', minecraft_data_version=CONFIG['data_version']) nbt = schematic.write_to_nbt() tiles = [] for original in self.tiles: p = tuple(int(original[k]) for k in ('x', 'y', 'z')) if p in blocks: tile = deepcopy(original) for key, origin in zip(('x', 'y', 'z'), (x1, base, z1)): tile[key] = Int(int(tile[key]) - origin) tiles.append(tile) nbt['Regions'][f'{name} inspection']['TileEntities'] = List[Compound](tiles) NBTFile(nbt).save(directory / f'{name}.litematic') def round_trip(lodge, path: Path): """Compare every exported voxel, including air and all block properties.""" loaded = load_schematic(path) sx, sy, sz = CONFIG['size_xyz'] assert loaded.size_yzx == (sy, sz, sx) expected = np.full((sy, sz, sx), AIR, dtype=object) for (x, y, z), state in lodge.blocks.items(): expected[y, z, x] = state actual = np.array(loaded.palette, dtype=object)[loaded.read_flat(0, loaded.volume)].reshape(loaded.size_yzx) assert np.array_equal(expected, actual), 'Full-state voxel round trip failed' assert int(np.count_nonzero(actual != AIR)) == len(lodge.blocks) return {'dimensions_xyz': [sx, sy, sz], 'volume_compared': loaded.volume, 'non_air_blocks': len(lodge.blocks), 'unique_states': len(loaded.palette), 'full_state_round_trip': True, 'sha256': loaded.sha256, 'block_counts': dict(sorted(Counter(unpack(s)[0] for s in lodge.blocks.values()).items()))} def main(): """Regenerate the deliverable and reproducible inspection assets.""" parser = argparse.ArgumentParser() parser.add_argument('--output-dir', type=Path, default=Path(__file__).resolve().parent) parser.add_argument('--seed', type=int, default=CONFIG['seed']) args = parser.parse_args() args.output_dir.mkdir(parents=True, exist_ok=True) preview = args.output_dir / 'previews' preview.mkdir(exist_ok=True) lodge = Lodge(args.seed).build() path = args.output_dir / 'output.litematic' lodge.export(path) evidence = round_trip(lodge, path) lodge.cutaways(preview) (preview / 'validation.json').write_text(json.dumps(evidence, indent=2) + '\n') print(json.dumps({k: v for k, v in evidence.items() if k != 'block_counts'}, indent=2)) if __name__ == '__main__': main()

"""Check the actual exported voxel model, entity records and architectural invariants.""" from collections import Counter, deque from pathlib import Path import json import sys import tempfile import numpy as np import pytest sys.path.insert(0, str(Path(__file__).resolve().parents[1])) from generate_lodge import AIR, CONFIG, DIRECTIONS, Lodge, NBTFile, round_trip, unpack, load_schematic @pytest.fixture(scope='module') def generated(): """Generate into a temporary directory under test and reload the saved model.""" with tempfile.TemporaryDirectory(dir=Path(__file__).parent) as directory: path = Path(directory) / 'lodge.litematic' intended = Lodge().build() intended.export(path) loaded = load_schematic(path) ids = loaded.read_flat(0, loaded.volume).reshape(loaded.size_yzx) actual = Lodge() actual.blocks = {(int(x), int(y), int(z)): loaded.palette[int(ids[y, z, x])] for y, z, x in np.argwhere(ids != loaded.palette.index(AIR))} yield intended, actual, path def test_registry_and_full_state_round_trip(generated): """Require canonical legal states, one region, version and equality of all cells.""" intended, actual, path = generated evidence = round_trip(intended, path) assert evidence['volume_compared'] == 47 * 41 * 37 assert intended.blocks == actual.blocks for state in set(actual.blocks.values()): name, props = unpack(state) assert actual.state(name, **props) == state nbt = NBTFile.load_regardless_of_gzipped(path) assert int(nbt['MinecraftDataVersion']) == 3955 assert len(nbt['Regions']) == 1 assert int(nbt['Metadata']['TotalBlocks']) == len(actual.blocks) def test_delivered_file_matches_generator(generated): """Check the contract artifact, rather than only a newly generated copy.""" path = Path(__file__).resolve().parents[1] / 'output.litematic' round_trip(generated[0], path) def test_fixed_seed_is_reproducible(generated): """Require repeatable blocks and entity data from the documented seed.""" again = Lodge().build() assert again.blocks == generated[0].blocks assert again.tiles == generated[0].tiles assert again.entities == generated[0].entities with tempfile.TemporaryDirectory(dir=Path(__file__).parent) as directory: copy = Path(directory) / 'again.litematic' again.export(copy) assert copy.read_bytes() == generated[2].read_bytes() def check_pairs(model): """Validate both halves of every door and every bed, plus their bases.""" doors = beds = 0 for (x, y, z), state in model.blocks.items(): name, props = unpack(state) if name.endswith('_door'): doors += 1 dy = 1 if props['half'] == 'lower' else -1 other_name, other = unpack(model.get(x, y + dy, z)) assert other_name == name, (x, y, z, 'missing door half') assert other['half'] != props['half'] assert {k: v for k, v in other.items() if k != 'half'} == {k: v for k, v in props.items() if k != 'half'} if props['half'] == 'lower': assert model.get(x, y - 1, z) != AIR if name.endswith('_bed'): beds += 1 dx, _, dz = DIRECTIONS[props['facing']] sign = 1 if props['part'] == 'foot' else -1 other_name, other = unpack(model.get(x + sign * dx, y, z + sign * dz)) assert other_name == name, (x, y, z, 'missing bed half') assert other['part'] != props['part'] assert other['facing'] == props['facing'] assert other['occupied'] == props['occupied'] assert model.get(x, y - 1, z) != AIR assert doors >= 4 and beds >= 4 def test_doors_and_beds(generated): """Check all paired blocks in the reloaded file.""" check_pairs(generated[1]) def test_pair_check_detects_damage(generated): """Ensure pairing validation fails for missing halves and mismatched facings.""" model = Lodge() model.blocks = generated[1].blocks.copy() model.put(30, 5, 11, 'air') with pytest.raises(AssertionError): check_pairs(model) model.blocks = generated[1].blocks.copy() model.put(29, 17, 24, 'green_bed', facing='north', part='head') with pytest.raises(AssertionError): check_pairs(model) def passable(state, doors=True): """Classify cells for conservative two-block walking clearance.""" name, _ = unpack(state) return (name in ('air', 'ladder', 'vine') or name.endswith('_carpet') or name.endswith('_banner') or (doors and name.endswith('_door'))) def walkable(model, p): """Require clear feet and head plus a floor or a backed ladder.""" x, y, z = p sx, sy, sz = CONFIG['size_xyz'] if not (0 <= x < sx and 1 <= y < sy - 1 and 0 <= z < sz): return False feet = model.get(x, y, z) if not passable(feet) or not passable(model.get(x, y + 1, z)): return False floor_name = unpack(model.get(x, y - 1, z))[0] return unpack(feet)[0] == 'ladder' or (floor_name != 'air' and not passable(model.get(x, y - 1, z)) and not any(t in floor_name for t in ('lantern', 'fence', 'wall', 'candle', 'pot', 'leaves', 'bars'))) def reachable(model, start=(30, 4, 10)): """Flood the walk graph with oriented stair steps, ladder climbs and two-cell clearance.""" assert walkable(model, start) seen = {start} todo = deque([start]) while todo: x, y, z = p = todo.popleft() for facing, (dx, _, dz) in DIRECTIONS.items(): for dy in (0, 1, -1): q = x + dx, y + dy, z + dz if q in seen or not walkable(model, q): continue if dy: upper = q if dy > 0 else p lower = p if dy > 0 else q stair, props = unpack(model.get(upper[0], upper[1] - 1, upper[2])) travel = (upper[0] - lower[0], 0, upper[2] - lower[2]) if not stair.endswith('_stairs') or props['half'] != 'bottom' or DIRECTIONS[props['facing']] != travel: continue # Ceiling above the lower step must also clear the ascent. if not passable(model.get(lower[0], upper[1] + 1, lower[2])): continue seen.add(q) todo.append(q) if unpack(model.get(x, y, z))[0] == 'ladder': for dy in (-1, 1): q = x, y + dy, z if q not in seen and walkable(model, q) and unpack(model.get(*q))[0] == 'ladder': seen.add(q) todo.append(q) return seen def test_every_room_reachable_with_headroom(generated): """Require routes through the front doors to every furnished room group.""" model = generated[1] seen = reachable(model) for name, room in CONFIG['rooms'].items(): assert tuple(room['target']) in seen, (name, room['target']) x1, x2, z1, z2 = room['bounds'] floor = room['floor'] connected = [p for p in seen if x1 <= p[0] <= x2 and z1 <= p[2] <= z2 and p[1] == floor + 1] assert len(connected) >= 45, (name, len(connected)) assert (29, 17, 21) in seen, 'Bed platform inaccessible' assert (30, 22, 22) in seen, 'Study desk inaccessible' assert (4, 4, 16) in seen, 'Smithy inaccessible' # Ground-to-living stairs work without relying on the tower ladder. copy = Lodge() copy.blocks = model.blocks.copy() for y in range(4, 24): copy.put(37, y, 27, 'air') assert tuple(CONFIG['rooms']['living_dining']['target']) in reachable(copy) def exterior_air(model): """Flood open exterior cells while treating closed doors and glazing as the envelope.""" sx, sy, sz = CONFIG['size_xyz'] def permeable(p): state = model.get(*p) name = unpack(state)[0] return passable(state, doors=False) or any(t in name for t in ('stairs', 'slab', 'trapdoor', 'lantern', 'candle', 'pot', 'fence', 'wall')) start = (0, sy - 1, 0) seen = {start} todo = deque([start]) while todo: x, y, z = todo.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] < sx and 0 <= p[1] < sy and 0 <= p[2] < sz and p not in seen and permeable(p): seen.add(p) todo.append(p) return seen def test_enclosure_and_roof_join(generated): """Require every interior air cell to be isolated from a six-neighbor sky flood.""" model = generated[1] outside = exterior_air(model) for name, room in CONFIG['rooms'].items(): assert tuple(room['target']) not in outside, name x1, x2, z1, z2 = room['bounds'] for x in range(x1, x2 + 1): for z in range(z1, z2 + 1): for y in range(room['floor'] + 1, room['floor'] + 5): if passable(model.get(x, y, z), doors=False): assert (x, y, z) not in outside, (name, x, y, z) def test_enclosure_check_detects_hole(generated): """Prove that a single missing wall block leaks to the exterior flood.""" model = Lodge() model.blocks = generated[1].blocks.copy() model.put(39, 18, 19, 'air') assert tuple(CONFIG['rooms']['bedroom']['target']) in exterior_air(model) def test_decoration_support_and_window_clearance(generated): """Check directional attachment for every fragile decoration and entity.""" intended, model, path = generated failures = [] for (x, y, z), state in model.blocks.items(): name, props = unpack(state) support = None if name == 'lantern': support = (x, y + (1 if props['hanging'] == 'true' else -1), z) elif name == 'ladder' or name.endswith('_wall_banner'): dx, _, dz = DIRECTIONS[props['facing']] support = (x - dx, y, z - dz) elif name == 'vine': candidates = [(x + dx, y, z + dz) for facing, (dx, _, dz) in DIRECTIONS.items() if props.get(facing) == 'true'] assert any(model.get(*p) != AIR and p not in intended.windows for p in candidates), (x, y, z, 'vine') elif name.endswith('_carpet') or name.endswith('_candle') or name.startswith('potted_') or name in ('flower_pot', 'fern', 'short_grass', 'poppy', 'dandelion', 'azalea', 'anvil', 'chest'): support = (x, y - 1, z) if support and model.get(*support) == AIR: failures.append(((x, y, z), name, support)) assert not failures, failures for p in intended.windows: assert unpack(model.get(*p))[0] == 'glass', ('window overwritten', p) nbt = NBTFile.load_regardless_of_gzipped(path) region = nbt['Regions']['Amberstone Lodge'] assert len(region['Entities']) == 3 assert list(region['Entities']) == intended.entities assert list(region['TileEntities']) == intended.tiles for entity in region['Entities']: p = (int(entity['TileX']), int(entity['TileY']), int(entity['TileZ'])) assert model.get(*p) == AIR assert model.get(p[0], p[1], p[2] - 1) != AIR for entity in region['TileEntities']: p = tuple(int(entity[k]) for k in ('x', 'y', 'z')) assert model.get(*p) != AIR banners = [e for e in region['TileEntities'] if str(e['id']) == 'minecraft:banner'] assert len(banners) == 2 and all(len(e['patterns']) == 2 for e in banners) assert any(str(e['id']) == 'minecraft:lectern' and 'Book' in e for e in region['TileEntities']) def test_no_disconnected_blocks(generated): """Require every block to connect through face neighbors to the terrain.""" blocks = generated[1].blocks start = next(p for p in blocks if p[1] == 0) seen = {start} todo = deque([start]) while todo: x, y, z = todo.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 p in blocks and p not in seen: seen.add(p) todo.append(p) assert not (set(blocks) - seen), list(set(blocks) - seen)[:20] def test_lights_furnishings_and_pines(generated): """Require nearby light in every room and the specified functional furnishings.""" model = generated[1] counts = Counter(unpack(s)[0] for s in model.blocks.values()) for block in ('barrel', 'chest', 'bookshelf', 'green_bed', 'white_wall_banner', 'lectern', 'anvil', 'ladder', 'potted_fern', 'white_candle'): assert counts[block] > 0 lights = [p for p, s in model.blocks.items() if unpack(s)[0] == 'lantern' or unpack(s)[1].get('lit') == 'true'] for name, room in CONFIG['rooms'].items(): x, y, z = room['target'] assert any(abs(x - a) + abs(y - b) + abs(z - c) <= 10 for a, b, c in lights), name assert any(unpack(s)[0] == 'campfire' and unpack(s)[1]['lit'] == 'true' for p, s in model.blocks.items() if p[0] < 9) for x, z, height in CONFIG['trees']: assert all(unpack(model.get(x, y, z))[0] == 'spruce_log' for y in range(2, height)) assert sum(1 for (a, b, c), s in model.blocks.items() if abs(x - a) <= 4 and abs(z - c) <= 4 and unpack(s)[0] == 'spruce_leaves') > 70 def test_forge_flue_and_fuel(generated): """Check the permanent fire, open smoke route and active furnace inventories.""" model = generated[1] assert unpack(model.get(6, 4, 22)) == ('campfire', {'facing': 'north', 'lit': 'true', 'signal_fire': 'true', 'waterlogged': 'false'}) assert all(model.get(6, y, 22) == AIR for y in range(5, CONFIG['size_xyz'][1])) nbt = NBTFile.load_regardless_of_gzipped(generated[2]) furnaces = [e for e in nbt['Regions']['Amberstone Lodge']['TileEntities'] if str(e['id']) in ('minecraft:furnace', 'minecraft:blast_furnace')] assert len(furnaces) == 2 for furnace in furnaces: assert int(furnace['BurnTime']) > 0 assert {int(i['Slot']): str(i['id']) for i in furnace['Items']} == {0: 'minecraft:raw_iron', 1: 'minecraft:coal'}

# Generate and verify a furnished Amberstone Lodge for vanilla Java 1.21.1. from __future__ import annotations import argparse from collections import Counter import gzip import io import json from pathlib import Path import random import sys import uuid import numpy as np CONFIG = { 'seed': 731942, 'size_xyz': (47, 43, 37), 'data_version': 3955, 'name': 'Amberstone Lodge', 'library': Path('/work/generator/MCIO'), 'registry': Path('/work/generator/MCRender/resources/1.21.1-blocks.json'), 'epoch_ms': 1750000000000, 'palettes': { 'stone': ('stone_bricks', 'stone_bricks', 'stone_bricks', 'cobblestone', 'mossy_stone_bricks'), 'plaster': ('smooth_sandstone', 'smooth_sandstone', 'smooth_sandstone', 'sandstone', 'end_stone_bricks'), 'roof': ('deepslate_tiles', 'deepslate_tiles', 'deepslate_tiles', 'deepslate_bricks', 'cobbled_deepslate'), 'wood': ('spruce_planks', 'spruce_planks', 'spruce_planks', 'spruce_planks', 'spruce_planks', 'oak_planks', 'dark_oak_planks'), 'path': ('gravel', 'coarse_dirt', 'dirt_path', 'cobblestone', 'mossy_cobblestone'), 'terrain': ('grass_block', 'grass_block', 'grass_block', 'coarse_dirt', 'moss_block'), }, 'layout': { 'low': (10, 27, 10, 26), 'tower': (27, 39, 9, 27), 'floors': (3, 10, 16, 22), 'tower_roof': { 25: 18, 26: 19, 27: 20, 28: 23, 29: 26, 30: 29, 31: 32, 32: 35, 33: 37, 34: 35, 35: 32, 36: 29, 37: 26, 38: 23, 39: 20, 40: 19, 41: 18 }, 'front_door': (24, 4, 10), 'dormer': (27, 31, 23, 30, 14, 20), 'stairs': ((3, 10), (10, 16), (16, 22)), 'trees': ((6, 29, 23, 4), (18, 31, 28, 4), (42, 31, 17, 3)), 'rooms': { 'entrance': { 'target': (25, 4, 13), 'bounds': (21, 27, 4, 9, 11, 22) }, 'workshop': { 'target': (16, 4, 17), 'bounds': (11, 20, 4, 9, 11, 25) }, 'store_hall': { 'target': (33, 4, 17), 'bounds': (28, 38, 4, 9, 10, 26) }, 'living': { 'target': (17, 11, 18), 'bounds': (11, 26, 11, 16, 11, 25) }, 'dining': { 'target': (33, 11, 18), 'bounds': (28, 38, 11, 15, 10, 26) }, 'bedroom': { 'target': (33, 17, 18), 'bounds': (28, 38, 17, 21, 10, 26) }, 'attic_study': { 'target': (33, 23, 18), 'bounds': (29, 37, 23, 28, 10, 26) }, 'dormer_nook': { 'target': (29, 24, 17), 'bounds': (28, 30, 24, 29, 15, 19) }, }, 'cutaways': { 'ground': (9, 40, 3, 9, 9, 27), 'living': (9, 40, 10, 15, 9, 27), 'bedroom': (27, 39, 16, 21, 9, 27), 'attic': (27, 37, 22, 28, 9, 27), 'bedroom_detail': (27, 39, 16, 21, 9, 21), 'forge_detail': (1, 10, 3, 7, 10, 23), }, }, } sys.path.insert(0, str(CONFIG['library'])) from mcio.sketch import LitematicCanvas from mcio.schematic import load_schematic from mcio.nbt.nbt import File as NBTFile from mcio.nbt.tag import Byte, Compound, Double, Float, Int, IntArray, List as NBTList, Long, Short, String DIRECTIONS = {'north': (0, 0, -1), 'south': (0, 0, 1), 'east': (1, 0, 0), 'west': (-1, 0, 0)} AIR = 'minecraft:air' def split_state(state: str) -> tuple[str, dict[str, str]]: """Split a canonical block state into its name and property map. Args: state: Namespaced state string. Returns: Block name and properties. """ if '[' not in state: return state.removeprefix('minecraft:'), {} name, properties = state[:-1].split('[') return name.removeprefix('minecraft:'), dict(p.split('=') for p in properties.split(',')) class Lodge: """Hold deterministic XYZ placements, entity data, and design metadata.""" def __init__(self, seed: int = CONFIG['seed']): self.seed = seed self.rng = random.Random(seed) self.registry = json.loads(CONFIG['registry'].read_text()) self.blocks = {} self.tile_entities = {} self.entities = [] self.windows = set() self.window_outsides = {} self.banners = [] self.stair_routes = [] def state(self, name: str, **properties: str) -> str: """Validate properties and fill every vanilla default. Args: name: Vanilla block ID without namespace. properties: Explicit state overrides. Returns: Complete, sorted state string. """ name = name.removeprefix('minecraft:') allowed, defaults = self.registry[name] result = defaults.copy() for key, value in properties.items(): if key not in allowed or str(value) not in allowed[key]: raise ValueError((name, key, value)) result[key] = str(value) return 'minecraft:' + name + ('[' + ','.join(f'{k}={v}' for k, v in sorted(result.items())) + ']' if result else '') def put(self, x: int, y: int, z: int, name: str, **properties: str) -> None: """Place one validated block, using XYZ coordinates. Args: x, y, z: Local block coordinates. name: Block ID. properties: State overrides. """ sx, sy, sz = CONFIG['size_xyz'] if not (0 <= x < sx and 0 <= y < sy and 0 <= z < sz): raise ValueError(('out of bounds', x, y, z)) pos = x, y, z state = self.state(name, **properties) if state == AIR: self.blocks.pop(pos, None) else: self.blocks[pos] = state def get(self, x: int, y: int, z: int) -> str: """Return a block state, treating unplaced cells as air. Args: x, y, z: Local coordinates. Returns: Canonical state. """ return self.blocks.get((x, y, z), AIR) def box(self, bounds: tuple, name: str, **properties: str) -> None: """Fill inclusive bounds with one material or a configured palette. Args: bounds: x0, x1, y0, y1, z0, z1. name: Material or palette prefixed by @. properties: State overrides. """ x0, x1, y0, y1, z0, z1 = bounds for y in range(y0, y1 + 1): for z in range(z0, z1 + 1): for x in range(x0, x1 + 1): block = self.rng.choice(CONFIG['palettes'][name[1:]]) if name.startswith('@') else name self.put(x, y, z, block, **properties) def timber(self, bounds: tuple, axis: str = 'y') -> None: """Place stripped spruce framing. Args: bounds: Inclusive XYZ box. axis: Timber grain direction. """ self.box(bounds, 'stripped_spruce_log', axis=axis) def door(self, x: int, y: int, z: int, facing: str, hinge: str = 'left', wood: str = 'spruce') -> None: """Place complete door halves. Args: x, y, z: Bottom half. facing: Outward direction. hinge: Door hinge side. wood: Vanilla door family. """ for dy, half in enumerate(('lower', 'upper')): self.put(x, y + dy, z, wood + '_door', facing=facing, hinge=hinge, half=half, open='false') def tile(self, x: int, y: int, z: int, kind: str, **tags) -> None: """Attach a generated vanilla block entity to a canvas placement. Args: x, y, z: Block entity coordinates. kind: Block entity ID. tags: Typed NBT payload. """ self.tile_entities[x, y, z] = Compound({'id': String('minecraft:' + kind), 'x': Int(x), 'y': Int(y), 'z': Int(z), **tags}) def frame(self, x: int, y: int, z: int, facing: str, item: str) -> None: """Create a fixed vanilla item frame with deterministic UUID. Args: x, y, z: Air block occupied by the frame. facing: Face normal. item: Displayed item ID. """ dx, _, dz = DIRECTIONS[facing] ident = uuid.uuid5(uuid.NAMESPACE_URL, f'amberstone:{self.seed}:{x},{y},{z}') ids = [int.from_bytes(ident.bytes[i:i + 4], 'big', signed=True) for i in range(0, 16, 4)] self.entities.append(Compound({ 'id': String('minecraft:item_frame'), 'UUID': IntArray(ids), 'Pos': NBTList[Double]([x + .5 - dx * .46875, y + .5, z + .5 - dz * .46875]), 'Motion': NBTList[Double]([0, 0, 0]), 'Rotation': NBTList[Float]([0, 0]), 'TileX': Int(x), 'TileY': Int(y), 'TileZ': Int(z), 'Facing': Byte({ 'north': 2, 'south': 3, 'west': 4, 'east': 5 }[facing]), 'Fixed': Byte(1), 'Invisible': Byte(0), 'ItemRotation': Byte(0), 'Item': Compound({ 'id': String('minecraft:' + item), 'count': Int(1) }), })) def lantern(self, x: int, y: int, z: int, hanging: bool = False) -> None: """Place a lantern whose support is supplied by its caller. Args: x, y, z: Lantern position. hanging: Whether mounted to the ceiling. """ self.put(x, y, z, 'lantern', hanging=str(hanging).lower()) def window(self, axis: str, plane: int, start: int, width: int, bottom: int, height: int, outside: int) -> None: """Insert framed glass windows with sill and open shutters. Args: axis: z for front/rear walls, x for side walls. plane: Wall coordinate. start: First horizontal window coordinate. width, bottom, height: Opening dimensions. outside: Direction from wall, -1 or +1. """ facing = ('north' if outside < 0 else 'south') if axis == 'z' else ('west' if outside < 0 else 'east') for t in range(start - 1, start + width + 1): for y in (bottom - 1, bottom + height): x, z = (t, plane) if axis == 'z' else (plane, t) self.put(x, y, z, 'stripped_dark_oak_log', axis='x' if axis == 'z' else 'z') for t in (start - 1, start + width): for y in range(bottom, bottom + height): x, z = (t, plane) if axis == 'z' else (plane, t) self.put(x, y, z, 'stripped_spruce_log') ox, oz = (x, z + outside) if axis == 'z' else (x + outside, z) self.put(ox, y, oz, 'spruce_trapdoor', facing=facing, open='true') for t in range(start, start + width): for y in range(bottom, bottom + height): x, z = (t, plane) if axis == 'z' else (plane, t) self.put(x, y, z, 'light_gray_stained_glass') self.windows.add((x, y, z)) self.window_outsides[x, y, z] = (x, y, z + outside) if axis == 'z' else (x + outside, y, z) x, z = (t, plane + outside) if axis == 'z' else (plane + outside, t) self.put(x, bottom - 1, z, 'spruce_stairs', facing=facing, half='top') def landscape(self) -> None: """Build an irregular terrain island, terrace, and curving approach.""" for x in range(1, 46): for z in range(1, 36): edge = ((x - 23) / 24)**6 + ((z - 18) / 19)**6 if edge < 1.28 and not (x < 4 and z < 6): self.put(x, 0, z, 'dirt') self.put(x, 1, z, self.rng.choice(CONFIG['palettes']['terrain'])) self.box((7, 41, 1, 2, 6, 29), '@stone') self.box((8, 40, 3, 3, 7, 28), '@stone') for x in range(8, 41): if x not in range(22, 28): self.put(x, 3, 6, 'stone_brick_slab') for z in range(7, 30): self.put(41, 3, z, 'stone_brick_slab') for z, y in ((3, 1), (4, 2), (5, 3)): self.box((22, 27, 1, y - 1, z, z), '@stone') for x in range(22, 28): self.put(x, y, z, 'stone_brick_stairs', facing='south') for z in range(0, 7): center = 24 - (6 - z) // 2 for x in range(center - 3, center + 4): if z < 3 or not 22 <= x <= 27: if self.rng.random() < .87: self.put(x, 0, z, 'dirt') self.put(x, 1, z, self.rng.choice(CONFIG['palettes']['path'])) for x in range(9, 41): for z in (7, 28): if x % 4 == 1: self.put(x, 3, z, 'chiseled_stone_bricks') for x, z in ((9, 7), (38, 7), (40, 28), (8, 28)): self.put(x, 4, z, 'cobblestone_wall') self.lantern(x, 5, z) def shell(self) -> None: """Build both sealed wings, timber grids, floors, and joined roofs.""" low = CONFIG['layout']['low'] tower = CONFIG['layout']['tower'] for x0, x1, z0, z1 in (low, tower): self.box((x0, x1, 3, 3, z0, z1), '@stone') 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.box((x, x, 4, 9, z, z), '@stone') self.box((x, x, 11, 17 if (x0, x1) == low[:2] else 19, z, z), '@plaster') self.box((x0, x1, 10, 10, z0, z1), '@wood') for y in (9, 10, 16): self.timber((x0, x1, y, y, z0, z0), 'x') self.timber((x0, x1, y, y, z1, z1), 'x') self.timber((x0, x0, y, y, z0, z1), 'z') self.timber((x1, x1, y, y, z0, z1), 'z') for x in range(x0, x1 + 1): if x in (x0, x1) or (x - x0) % 5 == 0: for z in (z0, z1): self.timber((x, x, 4, 17, z, z)) for z in range(z0, z1 + 1): if z in (z0, z1) or (z - z0) % 5 == 0: for x in (x0, x1): self.timber((x, x, 4, 17, z, z)) for y in (16, 22): self.box((28, 38, y, y, 10, 26), '@wood') self.parquet() # Exposed lower-wing gable ends. for z in range(10, 27): h = 23 - int(abs(z - 18) * .7) self.box((10, 10, 18, h - 1, z, z), '@plaster') if z in (13, 18, 23): self.timber((10, 10, 17, h - 1, z, z)) # Low roof overlaps only the shared structural wall. for x in range(8, 28): for z in range(8, 29): h = 23 - int(abs(z - 18) * .7) self.put(x, h, z, self.rng.choice(CONFIG['palettes']['roof'])) if z != 18: self.put(x, h + 1, z, 'deepslate_tile_stairs', facing='south' if z < 18 else 'north') else: self.put(x, h + 1, z, 'deepslate_tile_slab') if x in (8, 27): self.put(x, h, z, 'deepslate_bricks') roof = CONFIG['layout']['tower_roof'] for x in range(27, 40): for z in (9, 27): self.box((x, x, 20, roof[x] - 1, z, z), '@plaster') if x in (28, 31, 33, 35, 38): self.timber((x, x, 17, roof[x] - 1, z, z)) for y in (22, 28, 33): if y < roof[x]: self.put(x, y, z, 'stripped_spruce_log', axis='x') for x, h in roof.items(): inner = roof.get(x + (1 if x < 33 else -1), h) if x != 33 else h for z in range(7, 30): self.box((x, x, h, max(h, inner - 1), z, z), '@roof') self.put(x, max(h, inner - 1) + 1, z, 'deepslate_tile_stairs', facing='east' if x < 33 else 'west') if z in (7, 29): self.box((x, x, h, max(h, inner - 1), z, z), 'deepslate_bricks') for z in range(7, 30): self.put(33, 38, z, 'dark_oak_slab', type='bottom') for z in (7, 29): self.put(33, 39, z, 'dark_oak_fence') self.put(33, 40, z, 'dark_oak_fence') self.put(33, 41, z, 'lightning_rod') # Wide interior openings through the shared wall. self.box((27, 27, 4, 7, 13, 18), 'air') self.box((27, 27, 11, 14, 13, 18), 'air') for y in (8, 15): self.timber((27, 27, y, y, 12, 19), 'z') for z in (12, 19): self.timber((27, 27, 4, 15, z, z)) # Low-wing stair brackets and eave details. for x in (10, 15, 20, 25): self.put(x, 16, 9, 'spruce_stairs', facing='south', half='top') self.put(x, 17, 8, 'spruce_stairs', facing='south', half='top') for z in (11, 16, 21, 26): self.put(40, 18, z, 'spruce_stairs', facing='west', half='top') def parquet(self) -> None: """Lay coherent timber borders and end-grain accents in upper rooms.""" for y in CONFIG['layout']['floors'][1:]: bounds = [(28, 38, 10, 26)] if y == 10: bounds.append((11, 26, 11, 25)) for x0, x1, z0, z1 in bounds: for x in range(x0, x1 + 1): for z in range(z0, z1 + 1): material = 'dark_oak_planks' if x in (x0, x1) or z in (z0, z1) else 'stripped_spruce_log' if x % 3 == z % 3 == 0 else 'spruce_planks' self.put(x, y, z, material) def dormer(self) -> None: """Add a timber dormer opening into the tower study.""" x0, x1, base, peak, z0, z1 = CONFIG['layout']['dormer'] self.box((x0, x1 - 2, base, base, z0, z1), 'spruce_planks') # Union the dormer roof with the original slope at every column. main_roof = CONFIG['layout']['tower_roof'] for z in range(z0, z1 + 1): dormer_h = peak - abs(z - (z0 + z1) // 2) for x in range(x0, x1 + 1): h = max(main_roof[x], dormer_h) inner = max(main_roof[x + 1], dormer_h) self.box((x, x, base + 1, h - 1, z, z), 'air') if x == x0: self.box((x, x, base + 1, h - 1, z, z), '@plaster') elif z in (z0, z1): self.box((x, x, max(base + 1, main_roof[x]), h - 1, z, z), '@plaster') self.box((x, x, h, max(h, inner - 1), z, z), '@roof') self.put(x, max(h, inner - 1) + 1, z, 'deepslate_tile_stairs', facing='east' if inner > h else 'south' if z < 17 else 'north') for z in (z0, z1): self.timber((x0, x0, base, peak - 4, z, z)) self.timber((x0, x1, base, base, z, z), 'x') self.window('x', x0, 16, 3, 25, 2, -1) for z in (16, 17, 18): self.put(30, 23, z, 'spruce_stairs', facing='west') self.put(28, 24, 19, 'barrel', facing='north') self.put(28, 25, 19, 'potted_blue_orchid') self.ceiling_lamp(28, 17, 30, 4) def openings(self) -> None: """Fit all windows and doors without intersecting structural chimneys.""" self.door(24, 4, 10, 'north', 'left') self.door(25, 4, 10, 'north', 'right') self.timber((23, 26, 6, 6, 10, 10), 'x') for x in (23, 26): self.timber((x, x, 4, 5, 10, 10)) for x in range(23, 27): self.put(x, 7, 9, 'deepslate_tile_stairs', facing='south') self.door(10, 4, 15, 'west') # Concealed rear service entry completes the reconstructed elevation. self.door(30, 4, 27, 'south') for start in (12, 18): self.window('z', 10, start, 2, 5, 2, -1) self.window('z', 10, start, 2, 12, 3, -1) self.window('z', 26, start, 2, 12, 3, 1) self.window('x', 10, 12, 3, 13, 2, -1) self.window('x', 10, 15, 3, 19, 2, -1) for b, height in ((5, 2), (12, 3), (18, 3), (24, 3), (30, 2)): self.window('z', 9, 32, 3 if b < 30 else 2, b, height, -1) for b in (5, 12, 18, 24): self.window('z', 27, 32, 3, b, 2, 1) for start in (12, 19): self.window('x', 39, start, 3, 5, 2, 1) self.window('x', 39, start, 3, 12, 3, 1) # Entry lamps attached to timber brackets. for x in (22, 28): self.put(x, 7, 8, 'spruce_fence', south='true') self.put(x, 7, 9, 'spruce_fence', north='true', south='true') self.lantern(x, 6, 8, hanging=True) def stairs(self) -> None: """Install three two-block-wide flights with cleared two-block headroom.""" for floor, top in CONFIG['layout']['stairs']: route = [(28, floor + 1, 24)] for i in range(top - floor): x, y = 29 + i, floor + i + 1 for z in (24, 25): self.box((x, x, floor + 1, y - 1, z, z), 'spruce_planks') self.put(x, y, z, 'spruce_stairs', facing='east') self.box((x, x, y + 1, y + 2, z, z), 'air') route.append((x, y + 1, 24)) route.append((29 + top - floor, top + 1, 24)) self.stair_routes.append(route) # Clear flights after every upper support has been installed. for route in self.stair_routes: for x, y, z in route: self.box((x, x, y, y + 2, 24, 25), 'air') for y in (10, 16, 22): for x in range(31, 36): self.put(x, y + 1, 23, 'spruce_fence', east='true', west='true') # Supported ladder reaches a small service shelf above the ground workshop. self.box((11, 12, 7, 7, 23, 25), 'spruce_slab', type='top') self.put(12, 8, 24, 'chest', facing='north') for y in range(4, 8): self.put(11, y, 22, 'ladder', facing='north') self.put(11, y, 23, 'spruce_planks') def forge(self) -> None: """Build the covered smithy, fueled furnace, open hearth, and flue.""" self.box((2, 9, 2, 2, 11, 22), '@stone') self.box((2, 9, 3, 3, 11, 22), 'stone_bricks') for x, z in ((2, 11), (2, 22), (9, 11), (9, 22)): self.box((x, x, 4, 8, z, z), 'spruce_log') self.put(x, 8, z + (1 if z == 11 else -1), 'spruce_stairs', facing='south' if z == 11 else 'north', half='top') for x in range(1, 10): h = 8 + (x // 3) for z in range(10, 24): self.put(x, h, z, 'deepslate_tiles') self.put(x, h + 1, z, 'deepslate_tile_stairs', facing='east') # Fireplace is outside the house wall, with its flue safely behind windows. self.box((7, 9, 4, 7, 18, 21), '@stone') self.put(7, 4, 19, 'blast_furnace', facing='west', lit='true') self.tile(7, 4, 19, 'blast_furnace', BurnTime=Short(20000), 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'), 'count': Int(64) }), ])) self.put(7, 5, 20, 'campfire', facing='west', lit='true') self.put(6, 5, 20, 'iron_bars', north='true', south='true') self.box((8, 9, 8, 26, 19, 20), '@stone') self.box((7, 10, 27, 27, 18, 21), 'stone_brick_slab', type='top') self.put(8, 28, 19, 'campfire', lit='true', signal_fire='true') self.put(9, 28, 20, 'campfire', lit='true', signal_fire='true') for x, z in ((8, 20), (9, 19)): self.put(x, 28, z, 'cobblestone_wall') self.box((7, 10, 29, 29, 18, 21), 'stone_brick_slab') self.put(4, 4, 16, 'anvil', facing='north') self.put(4, 4, 20, 'smithing_table') self.put(3, 4, 12, 'barrel', facing='up') self.put(4, 4, 12, 'barrel', facing='up') self.put(3, 5, 12, 'chest', facing='west') self.put(8, 4, 12, 'water_cauldron', level='3') self.lantern(3, 7, 11, hanging=True) self.put(3, 8, 11, 'spruce_fence') self.lantern(6, 4, 22) self.put(6, 3, 22, 'stone_bricks') def carpet(self, x0: int, x1: int, z0: int, z1: int, y: int, color: str) -> None: """Place a bordered rug on an existing solid floor. Args: x0, x1, z0, z1: Rug bounds. y: Carpet height. color: Center color. """ for x in range(x0, x1 + 1): for z in range(z0, z1 + 1): self.put(x, y, z, ('brown' if x in (x0, x1) or z in (z0, z1) else color) + '_carpet') def ceiling_lamp(self, x: int, z: int, ceiling: int, drop: int = 1) -> None: """Hang a lantern from a supported ceiling beam. Args: x, z: Horizontal coordinates. ceiling: Existing ceiling height. drop: Distance below the ceiling. """ for y in range(ceiling - drop + 1, ceiling): self.put(x, y, z, 'chain', axis='y') self.lantern(x, ceiling - drop, z, hanging=True) def cabinet(self, x: int, y: int, z: int, facing: str = 'north') -> None: """Place a barrel cupboard with an upper cabinet. Args: x, y, z: Cabinet base. facing: Front face. """ self.put(x, y, z, 'barrel', facing=facing) self.put(x, y + 2, z, 'barrel', facing=facing) self.put(x, y + 3, z, 'spruce_slab') def furnished_ground(self) -> None: """Furnish the entrance hall, internal workshop, and storage room.""" # Workshop partition with an oak glazed door. self.box((21, 21, 4, 8, 11, 25), 'spruce_planks') self.box((21, 21, 6, 7, 13, 16), 'glass') self.door(21, 4, 18, 'east', wood='oak') self.carpet(23, 25, 12, 17, 4, 'red') self.carpet(29, 35, 15, 20, 4, 'red') for x in (12, 14, 16, 18): self.cabinet(x, 4, 25) self.frame(x, 6, 24, 'north', 'iron_ingot' if x % 4 else 'coal') self.put(12, 4, 12, 'crafting_table') self.put(13, 4, 12, 'smithing_table') self.put(14, 4, 12, 'barrel', facing='south') self.put(15, 4, 12, 'stonecutter', facing='south') self.put(17, 4, 12, 'grindstone', face='floor', facing='south') self.put(13, 5, 12, 'potted_blue_orchid') self.put(17, 4, 20, 'anvil') for z in (13, 16, 19, 22): self.put(38, 4, z, 'barrel', facing='west') self.put(38, 5, z, 'chest', facing='west') for x in (29, 30, 31): self.put(x, 4, 11, 'spruce_stairs', facing='north') self.put(36, 4, 11, 'barrel') self.put(36, 5, 11, 'potted_fern') self.box((28, 28, 4, 7, 20, 21), 'bookshelf') self.put(22, 4, 12, 'barrel') self.put(22, 5, 12, 'candle', candles='3', lit='true') for x, z in ((14, 16), (18, 22), (24, 19), (32, 13), (36, 21)): self.ceiling_lamp(x, z, 10, 2) def furnished_living(self) -> None: """Furnish a lounge, hearth, dining room, and pantry.""" self.carpet(13, 20, 16, 22, 11, 'green') for x in (14, 15, 16, 17): self.put(x, 11, 24, 'spruce_stairs', facing='south') for z in (17, 18, 19): self.put(12, 11, z, 'dark_oak_stairs', facing='west') for x in (15, 16, 17): self.put(x, 11, 19, 'dark_oak_slab', type='top') self.put(16, 12, 19, 'candle', candles='3', lit='true') self.put(19, 11, 24, 'barrel') self.put(19, 12, 24, 'potted_azalea_bush') # A lined hearth against the party wall is capped beneath the ceiling. self.box((24, 26, 11, 15, 21, 23), 'stone_bricks') self.put(24, 11, 22, 'campfire', facing='west', lit='true') self.put(23, 11, 22, 'iron_bars', north='true', south='true') self.box((24, 26, 16, 17, 21, 23), 'andesite') self.put(23, 14, 22, 'stone_brick_stairs', facing='east', half='top') for x in (12, 13, 14): self.cabinet(x, 11, 11, 'south') self.put(13, 12, 11, 'potted_blue_orchid') for z in (12, 13, 14): self.put(25, 11, z, 'bookshelf') self.put(25, 12, z, 'bookshelf') self.put(25, 13, z, 'spruce_slab') self.put(23, 11, 13, 'lectern', facing='west', has_book='true') self.book(23, 11, 13, 'The Lodge Guestbook') self.carpet(30, 36, 13, 19, 11, 'red') for x in (32, 33, 34): for z in (15, 16): self.put(x, 11, z, 'spruce_fence', east='true', west='true') self.put(x, 12, z, 'spruce_pressure_plate') for x in (32, 34): self.put(x, 11, 13, 'dark_oak_stairs', facing='north') self.put(x, 11, 18, 'dark_oak_stairs', facing='south') self.put(30, 11, 15, 'dark_oak_stairs', facing='west') self.put(36, 11, 15, 'dark_oak_stairs', facing='east') # Candles stand on full barrel sideboards, avoiding floating tabletop props. for z in (12, 14, 16, 18, 20): self.put(38, 11, z, 'barrel', facing='west') self.put(38, 12, 14, 'candle', candles='3', lit='true') self.put(38, 12, 18, 'potted_fern') self.put(29, 11, 11, 'smoker', facing='south', lit='true') self.put(30, 11, 11, 'water_cauldron', level='3') self.put(29, 12, 11, 'stone_bricks') self.put(29, 13, 11, 'stone_brick_wall') for x, z in ((32, 12), (35, 21)): self.ceiling_lamp(x, z, 16, 2) # Low-wing rafters support the lanterns below a tall vaulted ceiling. for z in (14, 20, 25): self.timber((10, 27, 17, 17, z, z), 'x') for x, z in ((17, 14), (20, 20), (14, 25)): self.ceiling_lamp(x, z, 17, 2) def book(self, x: int, y: int, z: int, title: str) -> None: """Put a real readable book on a generated lectern. Args: x, y, z: Lectern coordinates. title: Book title. """ content = Compound({'title': Compound({'raw': String(title)}), 'author': String('Amberstone Lodge'), 'generation': Int(0), 'resolved': Byte(1), 'pages': NBTList[Compound]([Compound({'raw': String(json.dumps({'text': 'Welcome to Amberstone Lodge. The pines shelter travelers, and the forge keeps the hearth warm.'}))})])}) self.tile(x, y, z, 'lectern', Book=Compound({'id': String('minecraft:written_book'), 'count': Int(1), 'components': Compound({'minecraft:written_book_content': content})}), Page=Int(0)) def furnished_bedroom(self) -> None: """Reconstruct the raised green bed, curtains, cabinetry, and window seat.""" self.carpet(30, 36, 17, 21, 17, 'green') # Raised platform and broad approach step. self.box((34, 37, 17, 17, 12, 15), 'dark_oak_planks') for x in (34, 35, 36, 37): self.put(x, 17, 16, 'dark_oak_stairs', facing='north') for x in (35, 36): self.put(x, 18, 14, 'green_bed', part='foot', facing='north') self.put(x, 18, 13, 'green_bed', part='head', facing='north') for x in (34, 37): self.put(x, 18, 12, 'barrel', facing='south') self.put(x, 19, 12, 'potted_fern' if x == 34 else 'candle', **({} if x == 34 else {'candles': '2', 'lit': 'true'})) for x in (35, 36): self.put(x, 18, 15, 'dark_oak_trapdoor', facing='south', open='true') self.put(x, 20, 12, 'bookshelf') self.put(x, 21, 12, 'spruce_slab') self.box((35, 36, 18, 19, 12, 12), 'dark_oak_planks') # Curtains stand beside glass, attached to actual solid side mullions. for x in (31, 35): self.put(x, 20, 10, 'white_wall_banner', facing='south') self.tile(x, 20, 10, 'banner', patterns=NBTList[Compound]([Compound({'color': String('green'), 'pattern': String('minecraft:small_stripes')})])) self.banners.append((x, 20, 10)) for x in (32, 33, 34): self.put(x, 17, 10, 'dark_oak_stairs', facing='north') self.put(x, 18, 10, 'white_carpet') self.put(30, 17, 10, 'barrel', facing='south') self.put(30, 18, 10, 'potted_blue_orchid') for z in (17, 19, 21): self.cabinet(28, 17, z, 'east') self.put(28, 18, 19, 'chest', facing='east') self.put(37, 17, 20, 'barrel', facing='west') self.put(37, 18, 20, 'candle', candles='3', lit='true') self.put(37, 17, 21, 'spruce_stairs', facing='east') self.frame(29, 19, 19, 'east', 'clock') for x, z in ((31, 14), (34, 20)): self.ceiling_lamp(x, z, 22, 1) def furnished_attic(self) -> None: """Furnish the vaulted study with an open book and storage cabinets.""" self.carpet(31, 35, 15, 21, 23, 'green') # Backing is inside the sealed sloping roof, with usable center aisle. for z in (12, 14, 20): self.put(30, 23, z, 'barrel', facing='east') self.put(30, 24, z, 'bookshelf') self.put(30, 25, z, 'barrel', facing='east') self.put(30, 26, z, 'spruce_slab') for z in (12, 13, 14): self.put(36, 23, z, 'spruce_planks') self.put(36, 24, 13, 'lectern', facing='west', has_book='true') self.book(36, 24, 13, 'Pines and Iron') self.put(36, 24, 12, 'candle', candles='3', lit='true') self.put(36, 24, 14, 'potted_fern') self.put(34, 23, 13, 'dark_oak_stairs', facing='west') for z in (18, 20): self.put(36, 23, z, 'barrel', facing='west') self.put(36, 24, z, 'chest', facing='west') self.put(34, 23, 20, 'dark_oak_stairs', facing='south') self.put(34, 23, 18, 'dark_oak_slab', type='top') self.put(34, 24, 18, 'candle', candles='2', lit='true') self.frame(31, 25, 12, 'east', 'compass') for z in (12, 19, 26): self.timber((30, 36, 29, 29, z, z), 'x') for z in (12, 19): self.ceiling_lamp(33, z, 29, 3) # Service ledge stays clear of the main stairwell and roof. for y in range(23, 30): self.put(35, y, 26, 'ladder', facing='north') self.box((33, 34, 28, 28, 25, 26), 'spruce_slab', type='top') self.box((33, 34, 29, 30, 25, 26), 'air') self.put(33, 29, 26, 'barrel', facing='north') self.lantern(33, 30, 26) def greenery(self) -> None: """Build hand-shaped pines and supported climbing greenery.""" for x, z, height, radius in CONFIG['layout']['trees']: self.box((x, x, 2, height, z, z), 'spruce_log') for y in range(5, height, 3): r = max(1, round(radius * (height - y) / (height - 5))) for dx, dz in ((1, 0), (-1, 0), (0, 1), (0, -1)): for i in range(1, r + 1): self.put(x + dx * i, y, z + dz * i, 'spruce_log', axis='x' if dx else 'z') for dx in range(-r - 1, r + 2): for dz in range(-r - 1, r + 2): if abs(dx) + abs(dz) <= r + 1 and not (dx == dz == 0): if self.get(x + dx, y + 1, z + dz) == AIR and (x + dx, y + 1, z + dz) not in self.window_outsides.values(): self.put(x + dx, y + 1, z + dz, 'spruce_leaves', persistent='true', distance='1') if abs(dx) + abs(dz) <= r and self.get(x + dx, y, z + dz) == AIR and (x + dx, y, z + dz) not in self.window_outsides.values(): self.put(x + dx, y, z + dz, 'spruce_leaves', persistent='true', distance='1') self.put(x, height + 1, z, 'spruce_leaves', persistent='true', distance='1') self.put(x, height + 2, z, 'spruce_leaves', persistent='true', distance='1') for x, z in ((28, 8), (29, 8), (37, 8), (40, 23), (40, 24)): self.put(x, 4, z, 'mossy_cobblestone') for y in range(5, 15 if x < 31 else 10): support = self.get(x, y, z + 1) if z == 8 else self.get(x - 1, y, z) if 'glass' not in support and support != AIR and self.get(x, y, z) == AIR: self.put(x, y, z, 'vine', **({'south': 'true'} if z == 8 else {'west': 'true'})) # Potted climbing plant in the entry hall, rooted on a cabinet. self.put(29, 4, 21, 'barrel') self.put(29, 5, 21, 'flower_pot') self.put(29, 6, 21, 'azalea_leaves', persistent='true', distance='1') self.put(28, 6, 21, 'azalea_leaves', persistent='true', distance='1') self.put(28, 7, 21, 'azalea_leaves', persistent='true', distance='1') # Natural scatter avoids the pathway and the terrace. for _ in range(150): x, z = self.rng.randrange(2, 45), self.rng.randrange(2, 35) if self.get(x, 2, z) == AIR and 'grass_block' in self.get(x, 1, z): self.put(x, 2, z, self.rng.choice(('short_grass', 'fern', 'poppy', 'azure_bluet'))) def build(self) -> 'Lodge': """Run deterministic construction passes and return this lodge. Returns: Populated generator instance. """ self.landscape() self.shell() self.openings() self.dormer() self.forge() self.furnished_ground() self.furnished_living() self.furnished_bedroom() self.furnished_attic() self.stairs() self.greenery() return self def export(self, path: Path, crop: tuple | None = None, cut_front: bool = True) -> None: """Export canvas blocks and generated entity payloads to one region. Args: path: Destination litematic. crop: Optional cutaway bounds, used only for preview exports. cut_front: Remove north/west walls, or south/east for a reverse view. """ if crop is None: sx, sy, sz = CONFIG['size_xyz'] x0, x1, y0, y1, z0, z1 = 0, sx - 1, 0, sy - 1, 0, sz - 1 else: x0, x1, y0, y1, z0, z1 = crop canvas = LitematicCanvas((y1 - y0 + 1, z1 - z0 + 1, x1 - x0 + 1)) kept = set() for (x, y, z), state in self.blocks.items(): if x0 <= x <= x1 and y0 <= y <= y1 and z0 <= z <= z1: # Remove front and west walls above the sill to expose interiors. if crop and y > y0 + 1: if cut_front and (z <= z0 + 1 or x <= x0): continue if not cut_front and (z >= z1 - 1 or x >= x1): continue canvas.block((y - y0, z - z0, x - x0), state) kept.add((x, y, z)) schematic = canvas.to_litematica(name=CONFIG['name'], author='Amberstone workshop', description='Furnished lodge, seed ' + str(self.seed), minecraft_data_version=CONFIG['data_version']) schematic.metadata.time_created = CONFIG['epoch_ms'] schematic.metadata.time_modified = CONFIG['epoch_ms'] nbt = schematic.write_to_nbt() region = nbt['Regions'][CONFIG['name']] tiles = [] for pos, tile in self.tile_entities.items(): if pos in kept: tile = Compound(tile) for key, delta in (('x', x0), ('y', y0), ('z', z0)): tile[key] = Int(int(tile[key]) - delta) tiles.append(tile) region['TileEntities'] = NBTList[Compound](tiles) region['Entities'] = NBTList[Compound](self.entities if crop is None else []) path.parent.mkdir(parents=True, exist_ok=True) buffer = io.BytesIO() NBTFile(nbt).write(buffer) path.write_bytes(gzip.compress(buffer.getvalue(), mtime=0)) def verify_roundtrip(self, path: Path) -> dict: """Reload and compare every cell, complete state, dimensions, and counts. Args: path: Exported schematic. Returns: JSON-safe verification evidence. """ loaded = load_schematic(path) sx, sy, sz = CONFIG['size_xyz'] if loaded.size_yzx != (sy, sz, sx): raise AssertionError(('dimensions', loaded.size_yzx)) actual = np.array(loaded.palette, dtype=object)[loaded.read_flat(0, loaded.volume)].reshape(loaded.size_yzx) expected = np.full((sy, sz, sx), AIR, dtype=object) for (x, y, z), state in self.blocks.items(): expected[y, z, x] = state mismatches = np.argwhere(actual != expected) if mismatches.size: raise AssertionError(('state roundtrip', mismatches[:10])) counts = Counter(actual.ravel()) if loaded.warnings: raise AssertionError(loaded.warnings) return {'seed': self.seed, 'dimensions_xyz': [sx, sy, sz], 'region_count': 1, 'minecraft_data_version': CONFIG['data_version'], 'total_cells_compared': loaded.volume, 'non_air_blocks': len(self.blocks), 'unique_non_air_states': len(counts) - 1, 'full_state_mismatches': 0, 'sha256': loaded.sha256, 'tile_entities': len(self.tile_entities), 'item_frames': len(self.entities), 'counts_by_block': dict(sorted(Counter(split_state(s)[0] for s in self.blocks.values()).items())), 'counts_by_full_state': dict(sorted(counts.items()))} def main() -> None: """Generate output and review cutaways from a clean working directory.""" parser = argparse.ArgumentParser(description=__doc__) parser.add_argument('--output', type=Path, default=Path('output.litematic')) parser.add_argument('--seed', type=int, default=CONFIG['seed']) parser.add_argument('--no-previews', action='store_true') args = parser.parse_args() lodge = Lodge(args.seed).build() lodge.export(args.output) evidence = lodge.verify_roundtrip(args.output) evidence_path = args.output.parent / 'validation.json' evidence_path.write_text(json.dumps(evidence, indent=2) + '\n') if not args.no_previews: for name, crop in CONFIG['layout']['cutaways'].items(): lodge.export(args.output.parent / 'previews' / (name + '.litematic'), crop, cut_front=name != 'bedroom_detail') print(json.dumps({k: v for k, v in evidence.items() if not k.startswith('counts')}, indent=2)) if __name__ == '__main__': main()

# Check actual exported geometry, navigation, attachment, and vanilla state legality. from __future__ import annotations from collections import deque from pathlib import Path from generate_lodge import AIR, CONFIG, DIRECTIONS, split_state from mcio.schematic import load_schematic from mcio.nbt.nbt import File as NBTFile NEIGHBORS = ((1, 0, 0), (-1, 0, 0), (0, 1, 0), (0, -1, 0), (0, 0, 1), (0, 0, -1)) THIN = {'air', 'vine', 'ladder', 'short_grass', 'fern', 'poppy', 'azure_bluet', 'chain', 'flower_pot', 'iron_bars'} def add(pos: tuple, delta: tuple) -> tuple: """Add XYZ coordinate tuples. Args: pos: Origin. delta: Offset. Returns: Translated position. """ return tuple(a + b for a, b in zip(pos, delta)) def read_blocks(path: Path) -> tuple[dict, dict]: """Decode a litematic independently of the generator's placement map. Args: path: Actual saved artifact. Returns: Sparse XYZ state map and raw NBT. """ loaded = load_schematic(path) sy, sz, sx = loaded.size_yzx ids = loaded.read_flat(0, loaded.volume).reshape(loaded.size_yzx) blocks = {(x, y, z): loaded.palette[int(ids[y, z, x])] for y in range(sy) for z in range(sz) for x in range(sx) if loaded.palette[int(ids[y, z, x])] != AIR} return blocks, NBTFile.load_regardless_of_gzipped(filename=path) def door_errors(blocks: dict) -> list: """Find incomplete doors and mismatched orientation or hinge properties. Args: blocks: Sparse XYZ states. Returns: Diagnostic records. """ errors = [] for pos, state in blocks.items(): name, props = split_state(state) if not name.endswith('_door'): continue upper = props['half'] == 'upper' other = add(pos, (0, -1 if upper else 1, 0)) other_name, other_props = split_state(blocks.get(other, AIR)) expected = {**props, 'half': 'lower' if upper else 'upper'} if name != other_name or other_props != expected: errors.append((pos, 'pair', state, blocks.get(other))) if not upper and blocks.get(add(pos, (0, -1, 0)), AIR) == AIR: errors.append((pos, 'no threshold')) return errors def bed_errors(blocks: dict) -> list: """Find orphan bed halves, unsupported beds, or mismatched facing. Args: blocks: Sparse XYZ states. Returns: Diagnostic records. """ errors = [] for pos, state in blocks.items(): name, props = split_state(state) if not name.endswith('_bed'): continue delta = DIRECTIONS[props['facing']] head = props['part'] == 'head' other = add(pos, tuple(-v for v in delta) if head else delta) other_name, other_props = split_state(blocks.get(other, AIR)) if name != other_name or other_props != {**props, 'part': 'foot' if head else 'head'}: errors.append((pos, 'pair')) if blocks.get(add(pos, (0, -1, 0)), AIR) == AIR: errors.append((pos, 'no platform')) return errors def passable(state: str, open_doors: bool = True) -> bool: """Conservatively classify cells usable by a walking player. Args: state: Complete block state. open_doors: Allow the player to open wooden doors. Returns: Whether the cell leaves sufficient walking space. """ name, props = split_state(state) return (name in {'air', 'ladder', 'vine'} or name.endswith('_carpet') or name.endswith('_wall_banner') or (name.endswith('_door') and open_doors)) def reachable_cells(blocks: dict, start: tuple) -> set: """Flood walkable positions with two cells of clearance and stair/ladder moves. Args: blocks: Actual loaded block map. start: Feet position at the entrance. Returns: Reachable feet coordinates. """ sx, sy, sz = CONFIG['size_xyz'] def viable(p): x, y, z = p if not (0 <= x < sx and 1 <= y < sy - 1 and 0 <= z < sz): return False if not all(passable(blocks.get(add(p, (0, d, 0)), AIR)) for d in (0, 1)): return False below_name, _ = split_state(blocks.get(add(p, (0, -1, 0)), AIR)) here_name, _ = split_state(blocks.get(p, AIR)) return here_name == 'ladder' or (below_name not in THIN and not below_name.endswith(('_carpet', '_wall_banner', '_door', '_fence'))) if not viable(start): raise AssertionError(('entrance blocked', start)) seen, queue = {start}, deque([start]) while queue: p = queue.popleft() for dx, _, dz in DIRECTIONS.values(): for dy in (0, -1, 1): q = add(p, (dx, dy, dz)) if q in seen or not viable(q): continue # A rise must have a proper stair, or a climbable ladder. if dy == 1: name, props = split_state(blocks.get(add(q, (0, -1, 0)), AIR)) here_name, _ = split_state(blocks.get(p, AIR)) if not name.endswith('_stairs') and here_name != 'ladder': continue if name.endswith('_stairs') and DIRECTIONS[props['facing']] != (dx, 0, dz): continue if not passable(blocks.get(add(p, (0, 2, 0)), AIR)): continue if dy == -1 and not passable(blocks.get(add(q, (0, 2, 0)), AIR)): continue seen.add(q) queue.append(q) if split_state(blocks.get(p, AIR))[0] == 'ladder': for dy in (-1, 1): q = add(p, (0, dy, 0)) if q not in seen and viable(q): seen.add(q) queue.append(q) return seen def enclosure_leaks(blocks: dict, starts: list) -> list: """Flood interior air and report any component reaching the region boundary. Args: blocks: Loaded sparse states. starts: Interior feet positions in each room. Returns: First boundary escape per leaking component. """ sx, sy, sz = CONFIG['size_xyz'] seen = set() leaks = [] # Small props are air for enclosure, while closed doors and glass seal rooms. def permeable(p): name, _ = split_state(blocks.get(p, AIR)) return name in THIN or name.startswith('potted_') or name.endswith(('_carpet', '_wall_banner', '_candle')) or name in {'candle', 'lantern'} for start in starts: if start in seen: continue queue = deque([start]) seen.add(start) leaking = False while queue: p = queue.popleft() if any(v == 0 or v == bound - 1 for v, bound in zip(p, (sx, sy, sz))): if not leaking: leaks.append(p) leaking = True for delta in NEIGHBORS: q = add(p, delta) if q not in seen and all(0 <= v < bound for v, bound in zip(q, (sx, sy, sz))) and permeable(q): queue.append(q) seen.add(q) return leaks def attachment_errors(blocks: dict, entities: list) -> list: """Check grounded components and direction-specific decoration supports. Args: blocks: Actual saved geometry. entities: Saved item-frame NBT. Returns: Unsupported decoration diagnostics. """ errors = [] seen = {p for p in blocks if p[1] == 0} queue = deque(seen) while queue: p = queue.popleft() for delta in NEIGHBORS: q = add(p, delta) if q in blocks and q not in seen: seen.add(q) queue.append(q) floating = set(blocks) - seen if floating: errors.append(('disconnected components', sorted(floating)[:30], len(floating))) for pos, state in blocks.items(): name, props = split_state(state) below = add(pos, (0, -1, 0)) support = None if name == 'lantern': support = add(pos, (0, 1 if props['hanging'] == 'true' else -1, 0)) elif name in ('ladder',) or name.endswith('_wall_banner'): support = add(pos, tuple(-v for v in DIRECTIONS[props['facing']])) elif name == 'vine': for direction, delta in DIRECTIONS.items(): if props[direction] == 'true' and blocks.get(add(pos, delta), AIR) == AIR: errors.append((pos, name, 'missing face', direction)) elif name.startswith('potted_') or name in ('flower_pot', 'candle') or name.endswith(('_candle', '_carpet', '_pressure_plate')): support = below if support is not None and blocks.get(support, AIR) == AIR: errors.append((pos, name, 'missing support', support)) if name.startswith('potted_') or name in ('flower_pot', 'candle') or name.endswith(('_candle', '_carpet', '_pressure_plate')): support_name, support_props = split_state(blocks.get(below, AIR)) if support_name.endswith('_slab') and support_props['type'] == 'bottom': errors.append((pos, name, 'half-block air below')) if support_name.endswith('_carpet'): errors.append((pos, name, 'on carpet')) facing_ids = {2: 'north', 3: 'south', 4: 'west', 5: 'east'} for entity in entities: pos = tuple(int(entity[k]) for k in ('TileX', 'TileY', 'TileZ')) facing = facing_ids[int(entity['Facing'])] support = add(pos, tuple(-v for v in DIRECTIONS[facing])) if blocks.get(pos, AIR) != AIR: errors.append((pos, 'item frame clips block')) if blocks.get(support, AIR) == AIR: errors.append((pos, 'item frame missing backing')) return errors def lighting_errors(blocks: dict) -> list: """Check every room has light sources and lit reachable room samples. Args: blocks: Loaded state map. Returns: Unlit room diagnostics. """ sources = {} for p, state in blocks.items(): name, props = split_state(state) if name == 'lantern' or (name in ('campfire', 'candle', 'blast_furnace', 'smoker') and props.get('lit') == 'true'): sources[p] = 15 if name in ('lantern', 'campfire') else 3 * int(props.get('candles', '1')) if name == 'candle' else 13 result = [] for name, room in CONFIG['layout']['rooms'].items(): x0, x1, y0, y1, z0, z1 = room['bounds'] lamps = [p for p in sources if x0 <= p[0] <= x1 and y0 <= p[1] <= y1 and z0 <= p[2] <= z1] if not lamps: result.append((name, 'no source')) target = room['target'] if not any(sum(abs(a - b) for a, b in zip(p, target)) < sources[p] for p in lamps): result.append((name, 'sample outside light radius')) return result def main() -> None: """Validate the contract artifact and persist machine-readable evidence.""" import argparse import json from generate_lodge import Lodge parser = argparse.ArgumentParser() parser.add_argument('schematic', nargs='?', type=Path, default=Path('output.litematic')) parser.add_argument('--report', type=Path, default=Path('structural_validation.json')) args = parser.parse_args() intended = Lodge().build() roundtrip = intended.verify_roundtrip(args.schematic) blocks, nbt = read_blocks(args.schematic) region = next(iter(nbt['Regions'].values())) reached = reachable_cells(blocks, (24, 4, 9)) targets = {name: room['target'] for name, room in CONFIG['layout']['rooms'].items()} results = { 'door_pairing': door_errors(blocks), 'bed_pairing': bed_errors(blocks), 'enclosure': enclosure_leaks(blocks, list(targets.values())), 'decoration_support': attachment_errors(blocks, region['Entities']), 'room_lighting': lighting_errors(blocks), 'room_reachability': [(name, pos) for name, pos in targets.items() if pos not in reached], 'stair_clearance': [pos for route in intended.stair_routes for pos in route if pos not in reached], 'raised_platform_access': [pos for pos in ((34, 18, 15), (11, 8, 24), (34, 29, 26)) if pos not in reached], 'window_clearance': [(pos, outside) for pos, outside in intended.window_outsides.items() if blocks.get(outside, AIR) != AIR or 'stained_glass' not in blocks.get(pos, AIR)], } evidence = { 'artifact': str(args.schematic.resolve()), 'sha256': roundtrip['sha256'], 'all_passed': not any(results.values()), 'checks': results, 'reachable_feet_positions': len(reached), 'room_targets_reached': { name: list(pos) for name, pos in targets.items() if pos in reached }, 'door_pairs': sum('_door[' in s and 'half=lower' in s for s in blocks.values()), 'complete_beds': sum('_bed[' in s and 'part=head' in s for s in blocks.values()), 'unobstructed_window_cells': len(intended.windows), 'full_state_roundtrip_cells': roundtrip['total_cells_compared'], 'full_state_mismatches': roundtrip['full_state_mismatches'], } args.report.write_text(json.dumps(evidence, indent=2) + '\n') print(json.dumps(evidence, indent=2)) if not evidence['all_passed']: raise AssertionError(results) if __name__ == '__main__': main()

# Validate vanilla structure and entity integrity from a freshly reloaded export. from __future__ import annotations from collections import Counter from pathlib import Path import tempfile import sys import pytest sys.path.insert(0, str(Path(__file__).resolve().parents[1])) from generate_lodge import AIR, CONFIG, Lodge, split_state from structural_checks import attachment_errors, bed_errors, door_errors, enclosure_leaks, lighting_errors, read_blocks, reachable_cells @pytest.fixture(scope='module') def artifact(): """Generate only in an automatically cleaned directory under test. Yields: Intended lodge, loaded blocks, saved NBT, and full round-trip evidence. """ with tempfile.TemporaryDirectory(prefix='lodge_', dir=Path(__file__).parent) as temp: path = Path(temp) / 'output.litematic' lodge = Lodge().build() lodge.export(path) evidence = lodge.verify_roundtrip(path) blocks, nbt = read_blocks(path) yield lodge, blocks, nbt, evidence def test_full_state_round_trip_and_single_region(artifact): """Check every air and non-air cell plus metadata and complete state counts.""" lodge, blocks, nbt, evidence = artifact assert len(nbt['Regions']) == 1 assert int(nbt['MinecraftDataVersion']) == 3955 assert evidence['dimensions_xyz'] == list(CONFIG['size_xyz']) assert evidence['full_state_mismatches'] == 0 assert evidence['total_cells_compared'] == 47 * 43 * 37 assert Counter(blocks.values()) == Counter(lodge.blocks.values()) assert blocks == lodge.blocks assert int(nbt['Metadata']['TotalBlocks']) == len(blocks) def test_every_state_is_vanilla_and_explicit(artifact): """Check all names, keys, values and defaults against the 1.21.1 registry.""" lodge, blocks, _, _ = artifact for state in set(blocks.values()): name, props = split_state(state) assert name in lodge.registry allowed, defaults = lodge.registry[name] assert set(props) == set(defaults) assert all(v in allowed[k] for k, v in props.items()) assert any('shape=straight' in s for s in blocks.values()) assert any('hinge=right' in s for s in blocks.values()) def test_door_pairing_and_negative_control(artifact): """Check every door and demonstrate detection of a missing or reversed half.""" _, blocks, _, _ = artifact assert not door_errors(blocks) broken = blocks.copy() broken.pop((24, 5, 10)) assert door_errors(broken) broken = blocks.copy() broken[24, 5, 10] = broken[24, 5, 10].replace('hinge=left', 'hinge=right') assert door_errors(broken) def test_bed_pairing_and_negative_control(artifact): """Check both green beds, support, facing, and missing-half detection.""" _, blocks, _, _ = artifact assert not bed_errors(blocks) assert sum('_bed[' in state for state in blocks.values()) == 4 broken = blocks.copy() broken.pop((35, 18, 13)) assert bed_errors(broken) def test_front_door_reaches_every_room_and_stair_route(artifact): """Require walkable, two-cell-high routes through all floors and room groups.""" lodge, blocks, _, _ = artifact seen = reachable_cells(blocks, (24, 4, 9)) missing = {name: room['target'] for name, room in CONFIG['layout']['rooms'].items() if room['target'] not in seen} assert not missing, missing for route in lodge.stair_routes: assert all(p in seen for p in route), [p for p in route if p not in seen] assert (34, 18, 15) in seen, 'Raised bed platform must be accessible' assert (11, 8, 24) in seen, 'Workshop storage shelf must be accessible' assert (34, 29, 26) in seen, 'Attic service ledge must be accessible' # A sealed entrance defeats navigation, proving the graph is geometry-driven. blocked = blocks.copy() for x in (24, 25): for y in (4, 5): blocked[x, y, 10] = 'minecraft:stone' # External smithy and rear entries remain legitimate alternative routes. for pos in list(blocked): if '_door[' in blocked[pos]: blocked[pos] = 'minecraft:stone' disconnected = reachable_cells(blocked, (24, 4, 9)) assert CONFIG['layout']['rooms']['attic_study']['target'] not in disconnected def test_enclosure_and_missing_roof_negative_control(artifact): """Check sealed room air components and detect a removed roof patch.""" _, blocks, _, _ = artifact starts = [room['target'] for room in CONFIG['layout']['rooms'].values()] assert not enclosure_leaks(blocks, starts) broken = blocks.copy() # Open a complete vertical column through the living-room roof. for y in range(12, CONFIG['size_xyz'][1]): broken.pop((18, y, 18), None) assert enclosure_leaks(broken, starts) def test_no_floating_or_clipping_decorations(artifact): """Check grounded assemblies, props, vines, ladder mounts and entity backing.""" _, blocks, nbt, _ = artifact entities = next(iter(nbt['Regions'].values()))['Entities'] assert not attachment_errors(blocks, entities) broken = blocks.copy() broken[0, 41, 0] = 'minecraft:lantern[hanging=false,waterlogged=false]' assert attachment_errors(broken, entities) def test_window_openings_are_preserved(artifact): """Ensure every designed window survived roofs, trees, flues, and furniture.""" lodge, blocks, _, _ = artifact assert len(lodge.windows) > 100 for pos in lodge.windows: assert 'stained_glass' in blocks[pos], (pos, blocks.get(pos)) outside = lodge.window_outsides[pos] assert blocks.get(outside, AIR) == AIR, ('window obstructed outside', pos, outside, blocks.get(outside)) # Chimney occupies a blind wall bay and never an opening. assert not any(7 <= x <= 10 and 18 <= z <= 21 and y >= 22 for x, y, z in lodge.windows) def test_each_room_is_lit(artifact): """Require a working light source close to every named room target.""" _, blocks, _, _ = artifact assert not lighting_errors(blocks) def test_furnishings_and_entity_payloads(artifact): """Inspect banner patterns, readable books, item frames, and forge fuel.""" _, blocks, nbt, _ = artifact region = next(iter(nbt['Regions'].values())) tiles = region['TileEntities'] banners = [t for t in tiles if str(t['id']) == 'minecraft:banner'] assert len(banners) == 2 assert all(str(t['patterns'][0]['color']) == 'green' and str(t['patterns'][0]['pattern']) == 'minecraft:small_stripes' for t in banners) books = [t for t in tiles if str(t['id']) == 'minecraft:lectern'] assert len(books) == 2 assert all(len(t['Book']['components']['minecraft:written_book_content']['pages']) for t in books) furnace = next(t for t in tiles if str(t['id']) == 'minecraft:blast_furnace') assert int(furnace['BurnTime']) > 0 assert len(furnace['Items']) == 2 assert len(region['Entities']) == 6 names = {split_state(s)[0] for s in blocks.values()} assert {'barrel', 'chest', 'lectern', 'green_bed', 'ladder', 'lantern', 'anvil', 'blast_furnace', 'campfire', 'candle', 'white_wall_banner', 'potted_blue_orchid'} <= names def test_seed_reproduces_geometry(artifact): """Check deterministic regeneration including tile payloads and entity UUIDs.""" lodge, _, _, _ = artifact rebuilt = Lodge().build() assert rebuilt.blocks == lodge.blocks assert rebuilt.tile_entities == lodge.tile_entities assert rebuilt.entities == lodge.entities def test_export_bytes_are_reproducible(artifact): """Require identical gzip bytes regardless of output filename or save time.""" lodge, _, _, _ = artifact with tempfile.TemporaryDirectory(prefix='repeat_', dir=Path(__file__).parent) as temp: first = Path(temp) / 'first.litematic' second = Path(temp) / 'second.litematic' lodge.export(first) lodge.export(second) assert first.read_bytes() == second.read_bytes()