@nodecraft/rendermite 1.1.3 → 1.2.0

package/README.md

@@ -58,12 +58,37 @@ icons/
   rc-<namespace>-failures.json     # per-item failures with reasons, never silent
 ```
 
+### Block packs
+
+A second output mode emits block **geometry and textures as data**, for a renderer that draws blocks itself rather than consuming finished icons. Java Edition, 1.13 (the Flattening) and up.
+
+```sh
+rendermite blocks --version 1.21.8 --output ./blocks/1.21.8
+rendermite blocks --version 1.20.4 --mod ./create-1.20.1.jar --output ./blocks/create
+```
+
+```
+blocks/1.21.8/
+  atlas-0.png          # stitched sprite page(s), 4px edge-extended padding
+  atlas.json           # sprite id -> rect, render layer, animation frames
+  models.json          # model id -> baked elements, OBJ meshes, stated render layer
+  blockstates.json     # block id -> variants/multipart, keys and predicates pre-parsed
+  tints.json           # plains tints, colormaps, ramps, per-block tint semantics
+  colormap/*.png       # the version's own grass/foliage/dry_foliage maps
+  failures.json        # anything not fully handled, with reasons, never silent
+  meta.json            # version, counts, sha256 of every other file
+```
+
+Everything is pre-resolved: no parent chains, no `#texture` references, no variant-key parsing at runtime.
+
+Mods are first-class. Forge/NeoForge **OBJ geometry** exports as triangle meshes alongside box elements (Create's crushing wheels, Immersive Engineering's slopes and connectors, Mekanism's pipes), stated `render_type` beats inference, arbitrary element angles and a third rotation axis are carried through, and a mod's broken assets cost a magenta face rather than the whole block. Verified by exporting a pack per jar across a 3,000-mod corpus. See [docs/block-pack-export.md](docs/block-pack-export.md) for the full contract.
+
 ### As a library
 
-Everything the CLI does is exported, from the high-level `run()` down to individual pieces (`ModelLoader`, `TextureLoader`, `renderModel`, `prepareVersionResources`, `prepareModResources`, `generateStylesheet`).
+Everything the CLI does is exported, from the high-level `run()` and `exportBlockPack()` down to individual pieces (`ModelLoader`, `TextureLoader`, `renderModel`, `prepareVersionResources`, `prepareModResources`, `generateStylesheet`, `evaluateBlockState`, `packAtlas`).
 
 ```ts
-import { run, prepareModResources, builtinPackPath } from '@nodecraft/rendermite';
+import { run, exportBlockPack, prepareModResources, builtinPackPath } from '@nodecraft/rendermite';
 ```
 
 ## Performance

package/assets/builtin/renderchest/models/block/banner_standing.json

@@ -0,0 +1,225 @@
+{
+	"credit": "Derived from renderchest:item/banner",
+	"texture_size": [
+		64,
+		64
+	],
+	"elements": [
+		{
+			"name": "post",
+			"from": [
+				7.3334,
+				0,
+				7.3334
+			],
+			"to": [
+				8.6666,
+				27.998,
+				8.6666
+			],
+			"faces": {
+				"north": {
+					"uv": [
+						12.5,
+						0.5,
+						13,
+						11
+					],
+					"texture": "#texture"
+				},
+				"east": {
+					"uv": [
+						12,
+						0.5,
+						12.5,
+						11
+					],
+					"texture": "#texture"
+				},
+				"south": {
+					"uv": [
+						11.5,
+						0.5,
+						12,
+						11
+					],
+					"texture": "#texture"
+				},
+				"west": {
+					"uv": [
+						11,
+						0.5,
+						11.5,
+						11
+					],
+					"texture": "#texture"
+				},
+				"up": {
+					"uv": [
+						11.5,
+						0,
+						12,
+						0.5
+					],
+					"texture": "#texture"
+				},
+				"down": {
+					"uv": [
+						12,
+						0,
+						12.5,
+						0.5
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				}
+			}
+		},
+		{
+			"name": "cloth",
+			"from": [
+				1.334,
+				2.6671999999999976,
+				8.6666
+			],
+			"to": [
+				14.666,
+				29.3312,
+				9.3332
+			],
+			"faces": {
+				"north": {
+					"uv": [
+						5.5,
+						0.25,
+						10.5,
+						10.25
+					],
+					"tintindex": 0,
+					"texture": "#texture"
+				},
+				"east": {
+					"uv": [
+						5.25,
+						0.25,
+						5.5,
+						10.25
+					],
+					"tintindex": 0,
+					"texture": "#texture"
+				},
+				"south": {
+					"uv": [
+						0.25,
+						0.25,
+						5.25,
+						10.25
+					],
+					"tintindex": 0,
+					"texture": "#texture"
+				},
+				"west": {
+					"uv": [
+						0,
+						0.25,
+						0.25,
+						10.25
+					],
+					"tintindex": 0,
+					"texture": "#texture"
+				},
+				"up": {
+					"uv": [
+						0.25,
+						0,
+						5.25,
+						0.25
+					],
+					"tintindex": 0,
+					"texture": "#texture"
+				},
+				"down": {
+					"uv": [
+						5.25,
+						0,
+						10.25,
+						0.25
+					],
+					"rotation": 180,
+					"tintindex": 0,
+					"texture": "#texture"
+				}
+			}
+		},
+		{
+			"name": "bar",
+			"from": [
+				1.334,
+				28,
+				7.3334
+			],
+			"to": [
+				14.666,
+				29.3312,
+				8.6666
+			],
+			"faces": {
+				"north": {
+					"uv": [
+						6,
+						11,
+						11,
+						11.5
+					],
+					"texture": "#texture"
+				},
+				"east": {
+					"uv": [
+						5.5,
+						11,
+						6,
+						11.5
+					],
+					"texture": "#texture"
+				},
+				"south": {
+					"uv": [
+						0.5,
+						11,
+						5.5,
+						11.5
+					],
+					"texture": "#texture"
+				},
+				"west": {
+					"uv": [
+						0,
+						11,
+						0.5,
+						11.5
+					],
+					"texture": "#texture"
+				},
+				"up": {
+					"uv": [
+						0.5,
+						10.5,
+						5.5,
+						11
+					],
+					"texture": "#texture"
+				},
+				"down": {
+					"uv": [
+						5.5,
+						10.5,
+						10.5,
+						11
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				}
+			}
+		}
+	]
+}

package/assets/builtin/renderchest/models/block/banner_wall.json

@@ -0,0 +1,155 @@
+{
+	"credit": "Derived from renderchest:item/banner",
+	"texture_size": [
+		64,
+		64
+	],
+	"elements": [
+		{
+			"name": "cloth",
+			"from": [
+				1.334,
+				-10.664000000000001,
+				1.3332
+			],
+			"to": [
+				14.666,
+				16,
+				2
+			],
+			"faces": {
+				"north": {
+					"uv": [
+						5.5,
+						0.25,
+						10.5,
+						10.25
+					],
+					"tintindex": 0,
+					"texture": "#texture"
+				},
+				"east": {
+					"uv": [
+						5.25,
+						0.25,
+						5.5,
+						10.25
+					],
+					"tintindex": 0,
+					"texture": "#texture"
+				},
+				"south": {
+					"uv": [
+						0.25,
+						0.25,
+						5.25,
+						10.25
+					],
+					"tintindex": 0,
+					"texture": "#texture"
+				},
+				"west": {
+					"uv": [
+						0,
+						0.25,
+						0.25,
+						10.25
+					],
+					"tintindex": 0,
+					"texture": "#texture"
+				},
+				"up": {
+					"uv": [
+						0.25,
+						0,
+						5.25,
+						0.25
+					],
+					"tintindex": 0,
+					"texture": "#texture"
+				},
+				"down": {
+					"uv": [
+						5.25,
+						0,
+						10.25,
+						0.25
+					],
+					"rotation": 180,
+					"tintindex": 0,
+					"texture": "#texture"
+				}
+			}
+		},
+		{
+			"name": "bar",
+			"from": [
+				1.334,
+				14.668800000000001,
+				0
+			],
+			"to": [
+				14.666,
+				16,
+				1.3332
+			],
+			"faces": {
+				"north": {
+					"uv": [
+						6,
+						11,
+						11,
+						11.5
+					],
+					"texture": "#texture"
+				},
+				"east": {
+					"uv": [
+						5.5,
+						11,
+						6,
+						11.5
+					],
+					"texture": "#texture"
+				},
+				"south": {
+					"uv": [
+						0.5,
+						11,
+						5.5,
+						11.5
+					],
+					"texture": "#texture"
+				},
+				"west": {
+					"uv": [
+						0,
+						11,
+						0.5,
+						11.5
+					],
+					"texture": "#texture"
+				},
+				"up": {
+					"uv": [
+						0.5,
+						10.5,
+						5.5,
+						11
+					],
+					"texture": "#texture"
+				},
+				"down": {
+					"uv": [
+						5.5,
+						10.5,
+						10.5,
+						11
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				}
+			}
+		}
+	]
+}

package/assets/builtin/renderchest/models/block/bed_foot.json

@@ -0,0 +1,44 @@
+{
+	"__comment": "The foot half of a bed, as one block. Same slab as the head from the sheet's second box (texOffs 0,22), with its outer end and legs to the south so one `facing` rotation orients both halves.",
+	"texture_size": [64, 64],
+	"elements": [
+		{
+			"name": "slab",
+			"from": [0, 3, 0],
+			"to": [16, 9, 16],
+			"faces": {
+				"up": { "uv": [1.5, 7, 5.5, 11], "texture": "#texture" },
+				"down": { "uv": [7, 7, 11, 11], "texture": "#texture" },
+				"south": { "uv": [5.5, 5.5, 9.5, 7], "texture": "#texture" },
+				"west": { "uv": [0, 7, 1.5, 11], "texture": "#texture" },
+				"east": { "uv": [5.5, 7, 7, 11], "texture": "#texture" }
+			}
+		},
+		{
+			"name": "leg_west",
+			"from": [0, 0, 13],
+			"to": [3, 3, 16],
+			"faces": {
+				"up": { "uv": [13.25, 3, 14, 3.75], "texture": "#texture" },
+				"down": { "uv": [14, 3, 14.75, 3.75], "texture": "#texture" },
+				"north": { "uv": [13.25, 3.75, 14, 4.5], "texture": "#texture" },
+				"south": { "uv": [14.75, 3.75, 15.5, 4.5], "texture": "#texture" },
+				"west": { "uv": [12.5, 3.75, 13.25, 4.5], "texture": "#texture" },
+				"east": { "uv": [14, 3.75, 14.75, 4.5], "texture": "#texture" }
+			}
+		},
+		{
+			"name": "leg_east",
+			"from": [13, 0, 13],
+			"to": [16, 3, 16],
+			"faces": {
+				"up": { "uv": [13.25, 4.5, 14, 5.25], "texture": "#texture" },
+				"down": { "uv": [14, 4.5, 14.75, 5.25], "texture": "#texture" },
+				"north": { "uv": [13.25, 5.25, 14, 6], "texture": "#texture" },
+				"south": { "uv": [14.75, 5.25, 15.5, 6], "texture": "#texture" },
+				"west": { "uv": [12.5, 5.25, 13.25, 6], "texture": "#texture" },
+				"east": { "uv": [14, 5.25, 14.75, 6], "texture": "#texture" }
+			}
+		}
+	]
+}

package/assets/builtin/renderchest/models/block/bed_head.json

@@ -0,0 +1,44 @@
+{
+	"__comment": "The head half of a bed, as one block. Vanilla ships no model: BedRenderer draws both halves from an entity model spanning two block positions. Proportions and UVs follow that model (a 16x16x6 slab plus 3x3x3 legs on the outer end) read off the 64x64 sheet's own box unwrap. Authored with the outer end to the north, so `facing` rotates it.",
+	"texture_size": [64, 64],
+	"elements": [
+		{
+			"name": "slab",
+			"from": [0, 3, 0],
+			"to": [16, 9, 16],
+			"faces": {
+				"up": { "uv": [1.5, 1.5, 5.5, 5.5], "texture": "#texture" },
+				"down": { "uv": [7, 1.5, 11, 5.5], "texture": "#texture" },
+				"north": { "uv": [1.5, 0, 5.5, 1.5], "texture": "#texture" },
+				"west": { "uv": [0, 1.5, 1.5, 5.5], "texture": "#texture" },
+				"east": { "uv": [5.5, 1.5, 7, 5.5], "texture": "#texture" }
+			}
+		},
+		{
+			"name": "leg_west",
+			"from": [0, 0, 0],
+			"to": [3, 3, 3],
+			"faces": {
+				"up": { "uv": [13.25, 0, 14, 0.75], "texture": "#texture" },
+				"down": { "uv": [14, 0, 14.75, 0.75], "texture": "#texture" },
+				"north": { "uv": [13.25, 0.75, 14, 1.5], "texture": "#texture" },
+				"south": { "uv": [14.75, 0.75, 15.5, 1.5], "texture": "#texture" },
+				"west": { "uv": [12.5, 0.75, 13.25, 1.5], "texture": "#texture" },
+				"east": { "uv": [14, 0.75, 14.75, 1.5], "texture": "#texture" }
+			}
+		},
+		{
+			"name": "leg_east",
+			"from": [13, 0, 0],
+			"to": [16, 3, 3],
+			"faces": {
+				"up": { "uv": [13.25, 1.5, 14, 2.25], "texture": "#texture" },
+				"down": { "uv": [14, 1.5, 14.75, 2.25], "texture": "#texture" },
+				"north": { "uv": [13.25, 2.25, 14, 3], "texture": "#texture" },
+				"south": { "uv": [14.75, 2.25, 15.5, 3], "texture": "#texture" },
+				"west": { "uv": [12.5, 2.25, 13.25, 3], "texture": "#texture" },
+				"east": { "uv": [14, 2.25, 14.75, 3], "texture": "#texture" }
+			}
+		}
+	]
+}

package/assets/builtin/renderchest/models/block/chest_left.json

@@ -0,0 +1,182 @@
+{
+	"credit": "Derived from the vanilla double chest sheet unwrap",
+	"texture_size": [
+		64,
+		64
+	],
+	"elements": [
+		{
+			"name": "bottom",
+			"from": [
+				0,
+				0,
+				1
+			],
+			"to": [
+				15,
+				10,
+				15
+			],
+			"faces": {
+				"north": {
+					"uv": [
+						3.5,
+						8.25,
+						7.25,
+						10.75
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				},
+				"east": {
+					"uv": [
+						7.25,
+						8.25,
+						10.75,
+						10.75
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				},
+				"south": {
+					"uv": [
+						10.75,
+						8.25,
+						14.5,
+						10.75
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				},
+				"down": {
+					"uv": [
+						3.5,
+						4.75,
+						7.25,
+						8.25
+					],
+					"texture": "#texture"
+				}
+			}
+		},
+		{
+			"name": "top",
+			"from": [
+				0,
+				10,
+				1
+			],
+			"to": [
+				15,
+				14,
+				15
+			],
+			"faces": {
+				"north": {
+					"uv": [
+						3.5,
+						3.75,
+						7.25,
+						4.75
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				},
+				"east": {
+					"uv": [
+						7.25,
+						3.75,
+						10.75,
+						4.75
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				},
+				"south": {
+					"uv": [
+						10.75,
+						3.75,
+						14.5,
+						4.75
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				},
+				"up": {
+					"uv": [
+						11,
+						0,
+						7.25,
+						3.5
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				}
+			}
+		},
+		{
+			"name": "lock",
+			"from": [
+				0,
+				7,
+				15
+			],
+			"to": [
+				1,
+				11,
+				16
+			],
+			"faces": {
+				"north": {
+					"uv": [
+						0.25,
+						0.25,
+						0.5,
+						1.25
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				},
+				"east": {
+					"uv": [
+						0.5,
+						0.25,
+						0.75,
+						1.25
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				},
+				"south": {
+					"uv": [
+						0.75,
+						0.25,
+						1,
+						1.25
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				},
+				"up": {
+					"uv": [
+						0.75,
+						0,
+						0.5,
+						0.25
+					],
+					"rotation": 180,
+					"texture": "#texture"
+				},
+				"down": {
+					"uv": [
+						0.25,
+						0,
+						0.5,
+						0.25
+					],
+					"texture": "#texture"
+				}
+			}
+		}
+	]
+}