minecraft-renderer 0.1.53 → 0.1.54

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecraft-renderer",
-  "version": "0.1.53",
+  "version": "0.1.54",
   "description": "The most Modular Minecraft world renderer with Three.js WebGL backend",
   "type": "module",
   "main": "./dist/index.js",

package/src/lib/buildSharedConfig.mjs

@@ -1,5 +1,6 @@
 export const dynamicMcDataFiles = {
     'blocks': 'blocksArray',
     'blockCollisionShapes': 'blockCollisionShapes',
-    'biomes': 'biomesArray'
+    'biomes': 'biomesArray',
+    'tints': 'tints',
 }

package/src/lib/worldrendererCommon.ts

@@ -1277,6 +1277,8 @@ export const initMesherWorker = (onGotMessage: (data: any) => void, workerName =
   return worker
 }
 
+let mesherMcDataTintsMissingWarned = false
+
 export const meshersSendMcData = (workers: Worker[], version: string, mcDataKeys = dynamicMcDataFiles, mcDataFull: IndexedData) => {
   const mcData = {
     version: JSON.parse(JSON.stringify(mcDataFull.version))
@@ -1284,6 +1286,10 @@ export const meshersSendMcData = (workers: Worker[], version: string, mcDataKeys
   for (const [finalKey, sourceKey] of Object.entries(mcDataKeys)) {
     mcData[finalKey] = mcDataFull[sourceKey]
   }
+  if ('tints' in mcDataKeys && !mcData.tints && !mesherMcDataTintsMissingWarned) {
+    mesherMcDataTintsMissingWarned = true
+    console.warn(`[meshersSendMcData] mcData.tints missing for version ${version}; shader cubes will use legacy path in worker`)
+  }
 
   for (const worker of workers) {
     worker.postMessage({ type: 'mcData', mcData })

package/src/three/chunkMeshManager.ts

@@ -174,7 +174,9 @@ export class ChunkMeshManager {
     if (!mat) return
     const atlas = (this.material as THREE.MeshBasicMaterial).map ?? null
     mat.uniforms.u_atlas.value = atlas
-    const { tintPalette } = getShaderCubeResources()
+    const resources = getShaderCubeResources()
+    if (!resources) return
+    const { tintPalette } = resources
     if (!tintPalette.isReady()) {
       tintPalette.createTexture()
     }

package/src/three/worldGeometryExport.ts

@@ -123,7 +123,9 @@ function shaderMaterialForExport(legacyMaterial: THREE.Material): THREE.ShaderMa
   if (!atlas) return null
   const shaderMat = createCubeBlockMaterial()
   shaderMat.uniforms.u_atlas.value = atlas
-  const { tintPalette } = getShaderCubeResources()
+  const resources = getShaderCubeResources()
+  if (!resources) return null
+  const { tintPalette } = resources
   if (!tintPalette.isReady()) tintPalette.createTexture()
   shaderMat.uniforms.u_tintPalette.value = tintPalette.getTexture()
   return shaderMat

package/src/wasm-mesher/bridge/shaderCubeBridge.ts

@@ -81,6 +81,7 @@ export interface ShaderCubeModelInput {
 
 let tintPalette: TintPalette | null = null
 let textureIndexMapping: TextureIndexMapping | null = null
+let tintsMissingWarned = false
 
 /** Convert mc-assets texture scales (normalized or negative) to pixel tile size for index lookup. */
 function normalizeTextureEntryForTileIndex(
@@ -122,10 +123,14 @@ export function resolveFaceTileIndex(
 }
 
 /** Main thread + worker: use `loadedData` set by the app / mesher (see mesherWasm). */
-function getTintsJson(): Record<string, any> {
+function getTintsJson(): Record<string, any> | null {
   const tints = (globalThis as any).loadedData?.tints
   if (!tints) {
-    throw new Error('shaderCubeBridge: globalThis.loadedData.tints is not available yet')
+    if (!tintsMissingWarned) {
+      tintsMissingWarned = true
+      console.warn('[shaderCubeBridge] loadedData.tints missing; shader cubes use legacy path')
+    }
+    return null
   }
   return tints
 }
@@ -133,9 +138,13 @@ function getTintsJson(): Record<string, any> {
 export function getShaderCubeResources(): {
   tintPalette: TintPalette
   textureIndexMapping: TextureIndexMapping
-} {
+} | null {
+  const tintsData = getTintsJson()
+  if (!tintsData) {
+    return null
+  }
   if (!tintPalette) {
-    tintPalette = TintPalette.fromTintsData(getTintsJson())
+    tintPalette = TintPalette.fromTintsData(tintsData)
     tintPalette.createTexture()
   }
   if (!textureIndexMapping) {
@@ -155,6 +164,7 @@ export function getShaderCubeResources(): {
 export function resetShaderCubeResources(): void {
   tintPalette = null
   textureIndexMapping = null
+  tintsMissingWarned = false
 }
 
 /**

package/src/wasm-mesher/tests/shaderCubeInstances.test.ts

@@ -358,3 +358,12 @@ test('GlobalBlockBuffer: free-list reuses slot with EMPTY sentinel', () => {
   buffer.dispose()
   mat.dispose()
 })
+
+test('getShaderCubeResources: returns null without loadedData.tints (no throw)', () => {
+  const prev = (globalThis as any).loadedData
+  ;(globalThis as any).loadedData = {}
+  resetShaderCubeResources()
+  expect(getShaderCubeResources()).toBeNull()
+  ;(globalThis as any).loadedData = prev
+  resetShaderCubeResources()
+})