minecraft-renderer 0.1.52 → 0.1.54

package/package.json

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

package/src/graphicsBackend/rendererDefaultOptions.ts

@@ -19,6 +19,7 @@ export type RendererOptionMeta = {
   text?: string
   tooltip?: string
   requiresRestart?: boolean
+  requiresChunksReload?: boolean
 }
 
 export type RendererMesherPipeline = 'wasm' | 'legacy-js'
@@ -62,6 +63,7 @@ export const RENDERER_DEFAULT_OPTIONS = {
   rendererPerfDebugOverlay: false as boolean,
   disableBlockEntityTextures: false as boolean,
   rendererMesher: 'wasm' as RendererMesherPipeline,
+  rendererShaderCubeBlocks: false as boolean,
   rendererShaderCubeDebugMode: 'off' as RendererShaderCubeDebugMode,
   showChunkBorders: false as boolean,
   renderEntities: true as boolean,
@@ -177,6 +179,11 @@ export const RENDERER_OPTIONS_META: Partial<Record<RendererDefaultOptionKey, Ren
     tooltip: 'WASM is faster. Use JS if WASM is not working. Requires reload.',
     requiresRestart: true
   },
+  rendererShaderCubeBlocks: {
+    text: 'Instanced shader cubes',
+    tooltip: 'Render full blocks through the global GPU instanced path. Requires WASM mesher and WebGL2.',
+    requiresChunksReload: true,
+  },
   rendererShaderCubeDebugMode: {
     text: 'Shader cube debug',
     tooltip: 'Instanced cube path visualization (requires shader cubes enabled).',
@@ -253,7 +260,7 @@ export const RENDERER_OPTIONS_META: Partial<Record<RendererDefaultOptionKey, Ren
     min: 30,
     max: 110,
     unit: '°',
-    text: 'Field of view'
+    text: 'FOV (Field of View)'
   },
   gpuPreference: {
     text: 'GPU preference',
@@ -317,7 +324,7 @@ export const RENDERER_RENDER_GUI_SECTIONS: ReadonlyArray<{
     },
     {
       title: 'Mesher',
-      keys: ['rendererMesher']
+      keys: ['rendererMesher', 'rendererShaderCubeBlocks']
     },
     {
       title: 'Renderer debug',

package/src/graphicsBackend/rendererOptionsSync.ts

@@ -163,6 +163,7 @@ export function applyRendererOptions(
   cfg.fetchPlayerSkins = o.loadPlayerSkins
   cfg.highlightBlockColor = o.highlightBlockColor
   cfg.wasmMesher = wasmActive
+  cfg.shaderCubeBlocks = o.rendererShaderCubeBlocks && wasmActive
   cfg.disableMesherConversionCache = !!ctx.isSafari
 
   setSkinsConfig({ apiEnabled: o.loadPlayerSkins })

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/modules/rain.ts

@@ -155,7 +155,8 @@ export class RainModule implements RendererModuleController {
       color: 0xcc_dd_ee,
       transparent: true,
       opacity: 0.35,
-      depthWrite: false,
+      // Must write depth so log-depth blocks occlude rain correctly (see cubeBlockShader).
+      depthWrite: true,
       fog: true,
     })
 

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()
+})