Skip to content

Real-world UX review: recipe API ergonomics, renderer/export discrepancies, editor UX, and doc drift #22

Open

Description

@lzif

Summary

End-to-end real-world user experience review of Voxwright evaluated from two perspectives:

  1. As an AI coding agent discovering skills/voxwright/SKILL.md, writing an original TypeScript recipe (15×22×15 Japanese-Inspired Forest Watchtower), validating against the 26.2 registry, rendering faithful previews/guides, iterating (v1 → v2), diffing runs, and exporting to .schem (v2/v3), .litematic, .nbt, and .mcstructure.
  2. As a Minecraft builder testing the CLI workflow, resulting structure quality, and the 3D WebGL viewer/editor (voxwright-cli preview) at both desktop (1280×800) and mobile (390×844 touch) viewports.

Scorecard

Category Score Summary
Onboarding & discoverability 6/10 Zero-install voxwright-cli.mjs is great, but split CLI identity (voxwright-cli vs mcbuild in --help, error prefixes, and init output) and stale "Deferred" sections in README.md / PLAN.md create immediate confusion.
AI agent skill & anti-hallucination clarity 8/10 SKILL.md and block-states.md are well-structured. Docked because mcbuild init violates the glass-pane rule, build-patterns.md promises non-existent audit lints, and the preview renderer masks missing fence/wall connection states.
TypeScript recipe API & DX 5/10 Deterministic seeded palettes and Geometry.rotate/mirror are solid. Docked for inconsistent signatures (set(x,y,z) vs pillar([x,y,z], h)), shapes.arch/parapet/skirtRoof missing from Build, no horizontal stair-row/eave helper, no door/window helpers, and patches() ignoring Build.seed.
Build quality (proportions, roofs, detail) 7/10 With custom helpers (slopedStairRing, connectedFenceRing) and roofGable + skirtRoof, v2 achieved an authentic layered Japanese watchtower. Built-in roof shapes (roofHip, skirtRoof) alone produce boxy, un-swept roofs without manual stair/slab composition.
Validation & error recovery 8/10 Registry validation against 26.2 with Levenshtein did you mean ...? suggestions, legal property/value lists, and (at file:line:col) provenance in build/check is excellent. Docked because check/run omit line numbers on thrown runtime ScriptErrors and run burns a run-NNN directory on failed validation.
CLI workflow & iteration speed 7/10 Cached runs + software PNG rendering (run --preview --guide) + inspect run in ~2s once assets are cached. Docked because diff and preview <run-id> hardcode .nbt lookup, diff lacks a "last two runs" default, and guide.md never embeds its cover image on default runs.
3D viewer 7/10 Fast WebGL2 section mesher with vanilla 26.2 textures, ambient occlusion, Orbit/Fly cameras, and layer slicing. Docked because the desktop layout wastes the top ~300px on static file/texture banners, pushing the canvas below the fold at 1280×800.
Editor UX 5/10 Basic tools (Pick, Place, Replace, Erase, Line, Rectangle, Select, Undo/Redo, IndexedDB autosave) work, but BlockStatePanel only shows properties explicitly written in the [k=v] string, Replace leaves stale hover state, and Block at coordinates cannot inspect a block without overwriting or erasing it.
Mobile experience 7/10 Thoughtful 100dvh touch layout with >=44px targets, two-tap placement confirmation, and bottom sheets—actually better laid out than desktop. Held back by the Quick start overlay and hidden horizontal tool scrolling.
Export reliability & block-state fidelity 7/10 Java exports (.schem v2/v3, .litematic, .nbt) are fast and lossless. Bedrock .mcstructure drops lightning_rod[facing=up], bell[attachment=ceiling], and campfire[lit=true], and writes non-vanilla minecraft:corner / minecraft:connection_* states.
Overall experience 6.7/10 Strong validation, rendering, and codec foundation held back by recipe API ergonomics, documentation drift, and web editor UX rough edges.

Verified Bugs & UX Problems

1. Renderer vs. Exporter Discrepancy on Fence / Wall / Pane Connections (Severity: High)

  • Problem & Impact: skills/voxwright/SKILL.md (lines 118–120) and skills/voxwright/references/block-states.md (lines 71–85) instruct agents to set north, south, east, west (and up on walls) on every fence, wall, glass pane, and iron bar cell because the engine does not connect neighbours. However:
    1. BUILD.railing (packages/mcbuilder/src/shapes.ts:277-302) places bare blocks without connection properties.
    2. HOUSE_TEMPLATE in mcbuild init (packages/mcbuilder/src/node/cli.ts:100) places bare "minecraft:glass_pane".
    3. Both the 2D faithful PNG renderer and 3D WebGL viewer (packages/render/src/scene.ts:363-382) auto-infer missing fence/wall/pane connections at render time, so visual inspection of previews_faithful/*.png or voxwright-cli preview shows connected rails even when the exported .schem / .litematic / .nbt contains disconnected standalone posts (east=false,north=false,south=false,west=false).
  • Suggested Fix: Either run connector inference (buildConnectors from packages/render/src/scene.ts) when finalizing a Build / exporting schematics (or in BUILD.railing), or emit a validation warning when connector blocks are placed with no connection states and provide a --raw-states preview flag.

2. patches() Completely Ignores Build.seed (Severity: High)

  • Problem & Impact: skills/voxwright/references/builder-api.md (line 33) states that new Build({ seed }) "Drives palettes and rng(). Same seed, same build." While array palettes hash (seed, x, y, z), patches() (packages/mcbuilder/src/materials.ts:107-158) hashes unitHash("patches", salt, ix, iy, iz) without seed, and resolveMaterial (packages/mcbuilder/src/materials.ts:92) invokes spec(x, y, z) without passing seed. Changing new Build({ seed }) has zero effect on any patches() material.
  • Suggested Fix: Thread seed into MaterialFn ((x, y, z, seed?) => string) in resolveMaterial and include seed in unitHash("patches", seed, salt, ix, iy, iz).

3. 3D Editor BlockStatePanel Only Shows Properties Explicitly Written in the [k=v] Substring (Severity: High)

  • Problem & Impact: apps/web/src/lib/components/BlockStatePanel.svelte and apps/web/src/lib/block-state.ts inspect properties via parseBlockState (packages/core/src/edit/blockstate.ts:94-97), which only parses the literal [...] substring on the placed block rather than consulting the block registry:
    • Any block placed using default properties (e.g., minecraft:oak_log, minecraft:lantern) displays "This block has no properties" and hides the mobile Rotate block button.
    • Stairs placed by roofGable / roofHip (minecraft:deepslate_tile_stairs[facing=north,half=bottom]) omit shape and waterlogged, so shape (outer_left, inner_right, etc.) does not appear in the editor unless manually typed into the raw "property" input.
    • On desktop (BlockStatePanel.svelte:121-157), even known enum properties (facing, half) use raw <input type="text"> inputs instead of the tappable option chips used on mobile.
  • Suggested Fix: Populate BlockStatePanel with the block's full property schema and defaults from the registry, and use chip/select controls on desktop as well as mobile.

4. Desktop 3D Viewer/Editor Pushes the Canvas Below the Fold at 1280×800 (Severity: Medium)

  • Problem & Impact: In apps/web/src/routes/+page.svelte, the desktop layout renders large permanent "Open a schematic" and "Textures" banners across the top ~300px of the page even when launched via voxwright-cli preview <file> with a schematic and texture pack already loaded. At a standard 1280×800 desktop viewport, the 3D canvas is cut off at the bottom and requires full-page vertical scrolling to reach the Layer slicer, Block State panel, Selection panel, and Export panel.
  • Suggested Fix: Use a full-viewport (100dvh) 3-column workbench on desktop (matching the mobile 100dvh shell) and collapse file/texture pickers into compact top-bar buttons once a schematic is loaded.

5. max_dimensions in mcbuild.toml is Dead Configuration (Severity: Medium)

  • Problem & Impact: parseConfig (packages/mcbuilder/src/config.ts:66-80) parses max_dimensions, and README.md (line 279) documents it, but cfg.maxDimensions is never read in packages/mcbuilder/src/node/cli.ts (prepare) or packages/mcbuilder/src/node/skill/build.ts (runBuild).
  • Suggested Fix: Apply or validate cfg.maxDimensions in prepare() and runBuild().

6. assets_dir in mcbuild.toml Has Conflicting Path Semantics Across Commands (Severity: Medium)

  • Problem & Impact: resolveAssetsDir (packages/mcbuilder/src/config.ts:107-109) defines assets_dir as ~/.cache/mcbuilder/<mc_version>/ (versioned), which cmdRun uses at cli.ts:346 for version.json. However, loadRegistry (cli.ts:159) and cmdRun client-asset lookup (cli.ts:378, 439) append cfg.mcVersion a second time (join(cfg.assetsDir, cfg.mcVersion, ...)), while packages/mcbuilder/src/node/skill/build.ts ignores config.assetsDir altogether.
  • Suggested Fix: Use resolveAssetsDir(cfg, home) consistently across loadRegistry, cmdRun, and skill/build.ts (with a fallback to join(cfg.assetsDir, cfg.mcVersion) if the unversioned cache root was supplied).

7. check and run Omit (at file:line:col) Provenance on Thrown Runtime ScriptErrors (Severity: Medium)

  • Problem & Impact: When a recipe throws during execution (e.g., bad shape arguments in BUILD.stairs or BUILD.pillar), voxwright-cli build reports (at recipe.ts:84:9) (packages/mcbuilder/src/node/skill/build.ts:341-348), whereas voxwright-cli check and voxwright-cli run catch ScriptError in packages/mcbuilder/src/node/cli.ts:779-781 without calling locateInRecipe(e.thrown, script).
  • Suggested Fix: Format locateInRecipe(e, abs) directly inside loadScript (packages/mcbuilder/src/node/script.ts:38-43) when constructing ScriptError.

8. Bedrock .mcstructure Export Drops lightning_rod[facing=up] and Writes Synthetic States (Severity: Medium)

  • Problem & Impact:
    • FACING_DIRECTION_BLOCKS (packages/core/src/codecs/bedrock.ts:102-103) omits lightning_rod and end_rod, so exporting minecraft:lightning_rod[facing=up] tries to map facing=up to horizontal minecraft:cardinal_direction, drops facing=up, and warns lightning_rod: facing=up has no Bedrock cardinal_direction.
    • bell[attachment=ceiling] and campfire[lit=true] are dropped with warnings instead of mapping to Bedrock's attachment and extinguished states.
    • javaToBedrock (bedrock.ts:272, 347) writes minecraft:corner on stairs and minecraft:connection_north/east/south/west on fences/panes/bars, which are not vanilla Bedrock block states.
  • Suggested Fix: Add lightning_rod and end_rod to FACING_DIRECTION_BLOCKS, map campfire lit ↔ extinguished and bell attachment, and stop writing non-vanilla minecraft:corner / minecraft:connection_* states on export.

9. "Block at coordinates" Panel Cannot Inspect a Block Without Overwriting or Erasing It (Severity: Medium)

  • Problem & Impact: In apps/web/src/lib/components/SelectionPanel.svelte:84-103, the "Block at coordinates" panel states: "Works with the keyboard alone. The build spans x 0 to 14, y 0 to 21, z 0 to 14. The block state panel then shows that block." However, typing X, Y, Z does not update the Block State panel; the only buttons are Set to chosen block (which overwrites the cell) and Erase (which deletes it).
  • Suggested Fix: Add an Inspect button (or update the inspected coordinate reactively when at[0..2] changes).

10. Replace Tool in 3D Editor Leaves Stale Block Name in Readout and BlockStatePanel (Severity: Low)

  • Problem & Impact: Clicking a block with the Replace (B) tool updates the volume and WebGL mesh, but session.hover retains the pre-replacement block string until the cursor moves, so both the status bar and BlockStatePanel still show the old block name (diorite at 10, 12, 7 after replacing with minecraft:gold_block).
  • Suggested Fix: Refresh this.hover from this.volume.get(...) in apps/web/src/lib/editor-session.svelte.ts whenever an edit mutates the hovered cell.

11. guide/guide.md Never Includes Its Cover Image on Default run --preview --guide (Severity: Low)

  • Problem & Impact: cmdRun (packages/mcbuilder/src/node/cli.ts:447-451) checks for previews_faithful/iso.png to embed a cover image in guide/guide.md, but default run --preview renders az000_el025.png .. az315_el025.png + top.png and does not write iso.png.
  • Suggested Fix: Fall back to az045_el025.png / az135_el025.png (or the first non-top view in viewEntries) when iso.png does not exist.

12. mcbuild import Hardcodes @voxwright/mcbuilder Even in the Bundled CLI (Severity: Low)

  • Problem & Impact: While cmdInit (packages/mcbuilder/src/node/cli.ts:652-654) rewrites "@voxwright/mcbuilder" to "voxwright" when BUNDLED is true, cmdImport (packages/mcbuilder/src/importer.ts:340) always writes import { Build } from "@voxwright/mcbuilder";.
  • Suggested Fix: Apply the same BUNDLED package-name replacement in cmdImport (or default toScript to "voxwright").

13. Documentation Drift Across README.md, PLAN.md, SKILL.md, block-states.md, user-guide.md, and build-patterns.md (Severity: Medium)

  • Problem & Impact:
    • README.md (lines 264, 337–341) and PLAN.md (lines 113–118) claim view, (at file:line) error positions, and example mcbuild.toml files are deferred/not implemented, though commit d516143 added all three.
    • README.md (lines 329–330) and skills/voxwright/references/block-states.md (lines 162–164) claim Bedrock export drops half=top on trapdoors, persistent on leaves, and hanging on lanterns, though commit d3abe7a implemented them in packages/core/src/codecs/bedrock.ts:273-295.
    • packages/mcbuilder/docs/build-patterns.md (lines 210–246) claims mcbuild emits non-blocking audit lints in report.json (Disconnected panes / fences / walls, Half-doors / half-beds, Floating gravity blocks, Monochrome wall, Flat pancake roof), none of which exist in the TypeScript port.
    • docs/user-guide.md (line 241) and SelectionPanel.svelte (line 220) state that skipAir applies only to paste and move (and that rotating a non-square selection overwrites neighbours with air), whereas editor-session.svelte.ts:1535 passes { skipAir: this.skipAir } to rotateSelection.

Prioritized Roadmap & Actionable Checklist

P0: Must Fix (Silent Output Bugs & Core Layout)

  • Unify fence/wall/pane connection behavior between @voxwright/render (scene.ts) and schematic export / BUILD.railing so previewed connections match exported .schem / .litematic files.
  • Pass Build.seed into patches() (packages/mcbuilder/src/materials.ts).
  • Convert the desktop 3D viewer/editor (apps/web/src/routes/+page.svelte) to a full-viewport (100dvh) workbench and collapse the top file/texture banners once a schematic is loaded.

P1: High-Value API & Editor Upgrades

  • Expose BUILD.arch, BUILD.parapet, and BUILD.skirtRoof directly on Build (automatically forwarding this.seedValue).
  • Add architectural helpers to reduce coordinate boilerplate:
    • BUILD.stairRing(c1, c2, stairBlock, { half?: "bottom" | "top", facing?: "in" | "out" }) with automatic mitered shape=outer_left/outer_right corners.
    • BUILD.door(base, facing, block, { hinge?, open? }) placing both half=lower and half=upper.
    • fillGable?: Material option on BUILD.roofGable and fillUnder?: Material option on BUILD.stairs.
  • Make BlockStatePanel registry-aware so all valid properties and enum values are shown for any block (including blocks placed with default properties), using chip/select controls on desktop as well as mobile.
  • Implement the structural audit lints documented in packages/mcbuilder/docs/build-patterns.md (half-doors, half-beds, disconnected fences/walls/panes, unattached bells/wall torches).

P2: CLI & Config Polish

  • Unify CLI output (voxwright-cli vs mcbuild), include (at file:line:col) on ScriptError in check and run, and avoid creating a run-NNN directory when run fails validation.
  • Wire up max_dimensions and fix assets_dir path resolution in mcbuild.toml across check, run, and build.
  • Fix guide/guide.md cover image fallback when iso.png is not among the rendered views.
  • Default diff with no positional arguments to diff the latest two clean runs, and allow diff / preview <run-id> to work when a run exports formats other than .nbt.
  • Add an Inspect action to "Block at coordinates" (SelectionPanel.svelte) and refresh session.hover after Replace in editor-session.svelte.ts.
  • Update README.md, PLAN.md, SKILL.md, block-states.md, user-guide.md, and build-patterns.md to remove stale claims.

P3: Nice-to-Have Enhancements

  • Port the visual comparison image generator for mcbuild diff.
  • Add --watch live-reload support to voxwright-cli preview <recipe.ts>.
  • Add optional block-entity helpers (sign text, banner patterns, container items) to Build.

Activity

  1. added
    bugSomething isn't working
    documentationImprovements or additions to documentation
    enhancementNew feature or request
    on Nov 14, 2026
  2. lzif commented on Nov 14, 2026

    @lzif
    OwnerAuthor

    Status check against main at 4533ef0. Since this review, d516143 and 0680ac0 landed (recipe-line provenance, view, Build.validate/render, the diff comparison PNG and a docs audit), followed by 4533ef0 (npm package renamed to voxmc).

    Fixed

    • 7. (at file:line:col) in check/run: loadScript now appends locateInRecipe(e, abs) itself (packages/mcbuilder/src/node/script.ts:38-45), with tests in packages/mcbuilder/test/cli.test.ts (0680ac0). The location is only known when the throw happens while the recipe module loads.
    • 13a. README and PLAN no longer list view, error positions or the example mcbuild.toml as deferred (d516143, 0680ac0).
    • 13b. README and skills/voxwright/references/block-states.md now list trapdoors, leaves and lanterns as translated (d3abe7a, 0680ac0).
    • P3 diff comparison image: comparisonImage and firstCommonView (packages/mcbuilder/src/node/diff.ts), wired into mcbuild diff, which writes diff-<a>-<b>.png (0680ac0).

    Partly fixed

    • 6. assets_dir: only version.json in run accepts both layouts (cli.ts:342-348). loadRegistry and the client-asset lookups still append mc_version to the unversioned root (cli.ts:159, 378, 439). skill/build.ts and skill/registry.ts still ignore assets_dir and use cacheRoot(home).
    • P2 CLI identity:
      • build, inspect, preview and --help print mcbuild or voxwright-cli depending on how they were started (skill/common.ts:15-17).
      • init, check, run, import, diff and assets still hardcode mcbuild in usage, error prefixes and init's "next:" line.
      • The names are now voxmc (npm), mcbuild (binary) and voxwright (the import in recipes).

    Still open

    • 1. Fence/wall/pane connections: shapes.railing still places bare blocks (shapes.ts:283-302), and its comment now states that the game resolves connections at paste time. The init template still places a bare glass_pane (cli.ts:100). The renderer still infers connections (packages/render/src/scene.ts:364-391). No export-time inference or warning exists.
    • 2. patches() ignores the seed: unitHash("patches", salt, ix, iy, iz) (materials.ts:117), and resolveMaterial does not pass the seed to function materials.
    • 3. BlockStatePanel: it parses only the [k=v] string (packages/core/src/edit/blockstate.ts:94-97), so Rotate is hidden for default-state blocks. On desktop every non-boolean property is a text input.
    • 4. Desktop layout: the page header, the "Open a schematic" section and PackPanel render whenever the layout is not mobile, even with a schematic loaded (apps/web/src/routes/+page.svelte:1244-1262). main is a flowing page with a max-width of 1500px, and the canvas is capped at 80vh. This was judged from the markup only, not measured.
    • 5. max_dimensions: parsed in config.ts, never read under node/. Only new Build({ maxDimensions }) works. The README no longer mentions the key.
    • 8. Bedrock export: all three points are still there.
      • lightning_rod and end_rod are missing from FACING_DIRECTION_BLOCKS (bedrock.ts:102-103).
      • bell attachment and campfire lit=true are dropped with a warning.
      • Stairs still write minecraft:corner (:272), and fences and panes still write minecraft:connection_* (:347).
    • 9. "Block at coordinates": still only Set to chosen block and Erase (SelectionPanel.svelte:84-103). The block state panel shows the cell only after one of those changes it.
    • 10. Replace hover: the status-bar readout (session.hover.block) stays stale until the pointer moves. Correction: BlockStatePanel is not stale, because it reads session.inspectedBlock, which looks up the volume on each revision.
    • 11. Guide cover: cli.ts:447-450 still checks only previews_faithful/iso.png, and the default 9-view orbit has no iso. Recipes made by mcbuild init set views: "iso;...", so they do get a cover.
    • 12. import: still writes @voxwright/mcbuilder (importer.ts:300), while init writes voxwright in the bundle. Both names run, because the loader aliases both.
    • 13c. packages/mcbuilder/docs/build-patterns.md:211-247: still promises mcbuild audit lints in report.json that the port does not have. Correction: the lints it names are twin slits, mono-dark spires, wedding-cake setbacks, UNBACKED and THROUGH_HOLE, not the list in this issue.
    • 13d. skipAir: the label "(paste and move)" (SelectionPanel.svelte:220, 303) and docs/user-guide.md:238-242 still leave out rotate. rotateSelection has honoured skipAir since 1253404.
    • P1:
      • arch, parapet and skirtRoof are still only on shapes, not on Build.
      • There is still no stairRing, door helper, fillGable or fillUnder.
      • There are still no structural audit lints.
    • P2:
      • run still creates run-NNN on failed validation. This looks deliberate: report.json records the errors, and a test depends on it (cli.test.ts:167).
      • diff still needs two run ids (cli.ts:618).
      • diff and preview <run-id> still look only for .nbt (artifactNbtPath). run writes only .nbt today.
    • P3: --watch for preview and the block-entity helpers are not started.
  3. lzif commented on Nov 15, 2026

    @lzif
    OwnerAuthor

    Update from main (4a68d28):

    Fixed / added since 4533ef0

    • 13c (b21377e): packages/mcbuilder/docs/build-patterns.md (lines 144–146, 211–248) now explicitly marks the audit lints as planned and not yet in the TypeScript port.
    • 13d docs (2a551fd): docs/user-guide.md (lines 238–242) now notes that Leave the target alone where there is air applies to copied, moved, and rotated selections. (The UI checkbox label in apps/web/src/lib/components/SelectionPanel.svelte:220, 303 still reads (paste and move) on main.)
    • Other doc syncs (2a551fd, 8f1a177, 4a68d28): updated stale docs across README.md, PLAN.md, docs/self-hosting.md, docs/phone-test-checklist.md, skills/voxwright/*, and packages/mcbuilder/SHAPE-MAPPING.md.
    • mcbuilder shape, material, and CLI additions (c2be3bf..8f1a177, CI green at 4a68d28):
      • Added shapes.bayWall (c2be3bf, postWidth in bcff5ec), shapes.polygon (de12bdf), shapes.jetty (9c208d4), and roofGable options endFill, ridgeCap, and profile / slab / full (cfb0a5b, 9f23e06, bc2033f, b0ebf9e). Like arch, parapet, and skirtRoof, these new shapes live on shapes and are not yet exposed on Build.
      • Added gradient() (packages/mcbuilder/src/materials.ts) and mcbuild palette (near, ramp, show; 6d5a02b).

    Technical correction on item #8 (Bedrock .mcstructure export)

    • minecraft:corner (stairs, string) and minecraft:connection_north/east/south/west (fences, glass panes, iron bars) are genuine vanilla Bedrock 1.21.130+ block states, not synthetic (verified against fixtures/real/rafeals-house/Rafeals_house.mcstructure).
    • Only the NBT tag type for minecraft:connection_* in javaToBedrock (packages/core/src/codecs/bedrock.ts:347) is wrong: it writes int (int(flag(v))) instead of byte (byte:0/byte:1 in the fixture). Adding lightning_rod/end_rod to FACING_DIRECTION_BLOCKS and mapping bell attachment / campfire lit remain open.

    Next / remaining work

  4. lzif commented on Nov 16, 2026

    @lzif
    OwnerAuthor

    Update after PR #23 merged on main (d48fb56):

    Merged on main since 4a68d28 (9d077ab + PR #23 d48fb56)

    • CI: GitHub Actions per path #2 (partial) — patches() seed (packages/mcbuilder/src/materials.ts): patches() now accepts an optional { seed } parameter (lattice() hashes seed when provided). Existing unseeded patches() calls—including resolveMaterial(spec, x, y, z, build.seed)—intentionally preserve unseeded behavior so golden vectors/materials.json / examples.json outputs do not change.
    • core/blocks: block-state parsing and canonical strings #5 — max_dimensions in mcbuild.toml: wired cfg.maxDimensions into prepare() (packages/mcbuilder/src/node/cli.ts) and runBuild() (packages/mcbuilder/src/node/skill/build.ts) via loadScript(..., { maxDimensions }).
    • core/rotation: port of rotation.py #6 — assets_dir path resolution: unified assetVersionCandidates / findAssetVersionDir (packages/mcbuilder/src/node/assets.ts) across cli.ts, palette.ts, skill/build.ts, and skill/registry.ts (accepting either <assets_dir> directly or <assets_dir>/<mc_version>, without silently falling back to ~/.cache/mcbuilder).
    • Codec .nbt: read and write with round-trip tests #8 — Bedrock .mcstructure export (packages/core/src/codecs/bedrock.ts, test/mcstructure.test.ts): added end_rod and (?:.*_)?lightning_rod to FACING_DIRECTION_BLOCKS, added two-way campfire/soul_campfire (extinguished ↔ lit, consuming signal_fire=false) and bell (attachment, direction, toggle_bit ↔ attachment, facing, powered) rules, and changed minecraft:connection_* tags from int to byte (keeping genuine vanilla 1.21.130+ minecraft:corner and minecraft:connection_*).
    • Codec .schem (Sponge v2 and v3) #9 — "Block at coordinates" inspect (apps/web/src/lib/components/SelectionPanel.svelte, editor-session.svelte.ts): added inspectAt(pos) and the Inspect button (data-testid="at-inspect") to inspect a cell without editing it (handling unset/air explicitly).
    • convert script: .schem to .nbt #10 — Hover / readout synchronization (apps/web/src/lib/editor-session.svelte.ts, test/editor-session.test.ts): added syncHover() and applyHover() so edits (including Replace), undo/redo, drags, and tool switches/cancels refresh session.hover.
    • Fixtures: real-tool .schem files #11 — guide/guide.md cover fallback (packages/mcbuilder/src/node/cli.ts): cmdRun now falls back from iso to the first non-top view, then the first available preview view.
    • Check domain and trademark (npm: voxmc only) #12 — mcbuild import specifier (9d077ab, packages/mcbuilder/src/importer.ts): toScript accepts { specifier } and cli.ts passes "voxwright" when bundled.
    • #13d — skipAir UI label (SelectionPanel.svelte): updated both desktop and touch checkboxes to read (paste, move and rotate).
    • P2 — 0-arg diff (packages/mcbuilder/src/node/diff.ts, cli.ts): diff with no positional arguments compares the last two clean runs (listCleanRuns).
    • Rebuilt skills/voxwright/scripts/voxwright-cli.mjs; main CI (43830832651) and GitHub Pages (43830832818) passed on d48fb56.

    Still open on #22

    • Repo foundations #1 (P0): Fence/wall/pane connection discrepancy between @voxwright/render (packages/render/src/scene.ts) and schematic export / BUILD.railing / HOUSE_TEMPLATE (mcbuild init).
    • CI: GitHub Actions per path #2 (partial): Automatically forwarding Build.seed into unseeded patches() / MaterialFn calls (if desired alongside patches(..., { seed })).
    • vectors/: golden vector export script #3 (P1): Registry-aware BlockStatePanel showing all valid properties on default-state blocks plus chip/select controls on desktop.
    • core/nbt: reader and writer #4 (P0): Desktop 100dvh workbench layout collapsing top file/texture banners once a schematic is loaded (apps/web/src/routes/+page.svelte).
    • P1: Expose arch, parapet, skirtRoof (and bayWall, polygon, jetty) directly on Build; add stairRing, door, fillGable, fillUnder; implement structural audit lints.
    • P2 remaining: Unify remaining mcbuild strings in cli.ts (init/check/run/import/diff/assets); avoid or adjust run-NNN creation on validation errors (cli.test.ts currently expects report.json); support non-.nbt artifacts in diff / preview <run-id>.
    • P3 remaining: --watch live-reload on preview; optional block-entity helpers on Build.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingdocumentationImprovements or additions to documentationenhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions