minecraft-renderer 0.1.49 → 0.1.50

package/package.json

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

package/src/graphicsBackend/rendererOptionsSync.ts

@@ -7,6 +7,7 @@
 import { subscribe } from 'valtio/vanilla'
 import type { AppViewer } from './appViewer'
 import type { RendererStorageOptions } from '../three/menuBackground/defaultOptions'
+import { rendererShaderCubeDebugModeToValue } from '../three/menuBackground/defaultOptions'
 import type { MenuBackgroundOptions } from '../three/menuBackground/types'
 import type { MenuBackgroundRenderer } from '../three/menuBackground/renderer'
 import { menuBackgroundSpeedToMultiplier } from '../three/menuBackground/config'
@@ -171,6 +172,7 @@ export function applyRendererOptions(
   cfg.starfield = o.starfieldRendering
   cfg.defaultSkybox = o.defaultSkybox
   cfg.fov = o.fov
+  cfg.shaderCubeDebugMode = rendererShaderCubeDebugModeToValue(o.rendererShaderCubeDebugMode)
 }
 
 /** World-view + hand/camera options (call when WorldView is ready). */

package/src/three/menuBackground/defaultOptions.ts

@@ -26,6 +26,26 @@ export type RendererMesherPipeline = 'wasm' | 'legacy-js'
 
 export type RendererGpuPreference = 'default' | 'high-performance' | 'low-power'
 
+export type RendererShaderCubeDebugMode =
+  | 'off'
+  | 'holes'
+  | 'texIndex'
+  | 'faces'
+  | 'atlasAlpha'
+
+const SHADER_CUBE_DEBUG_MODE_TO_VALUE: Record<RendererShaderCubeDebugMode, number> = {
+  off: 0,
+  holes: 1,
+  texIndex: 2,
+  faces: 3,
+  atlasAlpha: 4,
+}
+
+/** Maps stored option → `inWorldRenderingConfig.shaderCubeDebugMode` (0–4). */
+export function rendererShaderCubeDebugModeToValue(mode: RendererShaderCubeDebugMode): number {
+  return SHADER_CUBE_DEBUG_MODE_TO_VALUE[mode]
+}
+
 /** Maps stored `gpuPreference` to WebGL `powerPreference` (undefined = browser default). */
 export function gpuPreferenceToWebGLPowerPreference(
   preference: RendererGpuPreference
@@ -54,6 +74,7 @@ export const RENDERER_DEFAULT_OPTIONS = {
   rendererPerfDebugOverlay: false as boolean,
   disableBlockEntityTextures: false as boolean,
   rendererMesher: 'wasm' as RendererMesherPipeline,
+  rendererShaderCubeDebugMode: 'off' as RendererShaderCubeDebugMode,
   showChunkBorders: false as boolean,
   renderEntities: true as boolean,
   renderDebug: 'basic' as 'none' | 'basic' | 'advanced',
@@ -166,6 +187,17 @@ export const RENDERER_OPTIONS_META: Partial<Record<RendererDefaultOptionKey, Ren
     tooltip: 'WASM is faster. Use JS if WASM is not working. Requires reload.',
     requiresRestart: true
   },
+  rendererShaderCubeDebugMode: {
+    text: 'Shader cube debug',
+    tooltip: 'Instanced cube path visualization (requires shader cubes enabled).',
+    possibleValues: [
+      ['off', 'Off'],
+      ['holes', 'Hole test (red)'],
+      ['texIndex', 'Tile index colors'],
+      ['faces', 'Face id colors'],
+      ['atlasAlpha', 'Atlas alpha'],
+    ],
+  },
   showChunkBorders: {
     text: 'Chunk borders'
   },
@@ -301,7 +333,8 @@ export const RENDERER_RENDER_GUI_SECTIONS: ReadonlyArray<{
       title: 'Renderer debug',
       keys: [
         'rendererFuturisticReveal',
-        'rendererPerfDebugOverlay'
+        'rendererPerfDebugOverlay',
+        'rendererShaderCubeDebugMode',
       ]
     }
   ]

package/src/three/menuBackground/index.ts

@@ -38,7 +38,11 @@ export type {
   RendererDefaultOptionKey,
   RendererGpuPreference,
   RendererMesherPipeline,
+  RendererShaderCubeDebugMode,
   RendererOptionMeta,
   RendererStorageOptions
 } from './defaultOptions'
-export { gpuPreferenceToWebGLPowerPreference } from './defaultOptions'
+export {
+  gpuPreferenceToWebGLPowerPreference,
+  rendererShaderCubeDebugModeToValue
+} from './defaultOptions'

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

@@ -121,10 +121,13 @@ export function resolveFaceTileIndex(
   return texMapping.tileIndexFromTextureEntry(entry)
 }
 
-/** Tints via esbuild-data (worker plugin, web-client rsbuild alias, vitest alias). */
+/** Main thread + worker: use `loadedData` set by the app / mesher (see mesherWasm). */
 function getTintsJson(): Record<string, any> {
-  const mod = require('esbuild-data') as { tints?: Record<string, any>, default?: { tints?: Record<string, any> } }
-  return mod.tints ?? mod.default?.tints ?? {}
+  const tints = (globalThis as any).loadedData?.tints
+  if (!tints) {
+    throw new Error('shaderCubeBridge: globalThis.loadedData.tints is not available yet')
+  }
+  return tints
 }
 
 export function getShaderCubeResources(): {