minecraft-renderer 0.1.49 → 0.1.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecraft-renderer",
-  "version": "0.1.49",
+  "version": "0.1.51",
   "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/documentRenderer.ts

@@ -14,7 +14,7 @@ import Stats from 'stats.js'
 import StatsGl from 'stats-gl'
 import * as tween from '@tweenjs/tween.js'
 import type { GraphicsBackendConfig, GraphicsInitOptions } from '../graphicsBackend/types'
-import { gpuPreferenceToWebGLPowerPreference } from '../three/menuBackground/defaultOptions'
+import { gpuPreferenceToWebGLPowerPreference } from '../three/menuBackground/gpuPreference'
 import { WorldRendererConfig } from '../graphicsBackend'
 
 // ============================================================================

package/src/three/menuBackground/defaultOptions.ts

@@ -6,8 +6,9 @@ import {
   FUTURISTIC_SCENE_LABELS,
   MINECRAFT_BLOCK_GROUP_IDS,
   MINECRAFT_BLOCK_GROUP_LABELS
-} from './futuristic'
+} from './futuristicMeta'
 import { MENU_BACKGROUND_OPTION_DEFAULTS } from './config'
+import type { RendererGpuPreference } from './gpuPreference'
 
 export type RendererOptionMeta = {
   possibleValues?: string[] | Array<[string, string]>
@@ -20,19 +21,26 @@ export type RendererOptionMeta = {
   requiresRestart?: boolean
 }
 
-export type RendererDefaultOptionKey = keyof typeof RENDERER_DEFAULT_OPTIONS
-
 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 `gpuPreference` to WebGL `powerPreference` (undefined = browser default). */
-export function gpuPreferenceToWebGLPowerPreference(
-  preference: RendererGpuPreference
-): 'high-performance' | 'low-power' | undefined {
-  if (preference === 'high-performance') return 'high-performance'
-  if (preference === 'low-power') return 'low-power'
-  return undefined
+/** Maps stored option → `inWorldRenderingConfig.shaderCubeDebugMode` (0–4). */
+export function rendererShaderCubeDebugModeToValue(mode: RendererShaderCubeDebugMode): number {
+  return SHADER_CUBE_DEBUG_MODE_TO_VALUE[mode]
 }
 
 const MB = MENU_BACKGROUND_OPTION_DEFAULTS
@@ -54,6 +62,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',
@@ -76,6 +85,8 @@ export const RENDERER_DEFAULT_OPTIONS = {
   fov: 75
 } as const
 
+export type RendererDefaultOptionKey = keyof typeof RENDERER_DEFAULT_OPTIONS
+
 /** App options storage shape for renderer-owned keys. */
 export type RendererStorageOptions = typeof RENDERER_DEFAULT_OPTIONS
 
@@ -166,6 +177,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 +323,8 @@ export const RENDERER_RENDER_GUI_SECTIONS: ReadonlyArray<{
       title: 'Renderer debug',
       keys: [
         'rendererFuturisticReveal',
-        'rendererPerfDebugOverlay'
+        'rendererPerfDebugOverlay',
+        'rendererShaderCubeDebugMode',
       ]
     }
   ]

package/src/three/menuBackground/futuristic.ts

@@ -7,28 +7,24 @@ import type { MenuBackgroundView } from './activeView'
 import { resizeMenuBackgroundCamera } from './activeView'
 import { loadThreeJsTextureFromBitmap } from '../threeJsUtils'
 import { MENU_BACKGROUND_MOTION_DEFAULTS, MENU_BACKGROUND_OPTION_DEFAULTS } from './config'
-
-export const FUTURISTIC_SCENE_IDS = ['galaxy', 'nether', 'end', 'cyber', 'light'] as const
-export type FuturisticSceneId = typeof FUTURISTIC_SCENE_IDS[number]
-
-export const FUTURISTIC_CAMERA_IDS = ['cruise', 'barrel', 'dive', 'orbit', 'snake'] as const
-export type FuturisticCameraId = typeof FUTURISTIC_CAMERA_IDS[number]
-
-export const FUTURISTIC_SCENE_LABELS: Record<FuturisticSceneId, string> = {
-  galaxy: 'Galaxy',
-  nether: 'Nether',
-  end: 'The End',
-  cyber: 'Cyber',
-  light: 'Light Space'
-}
-
-export const FUTURISTIC_CAMERA_LABELS: Record<FuturisticCameraId, string> = {
-  cruise: 'Cruise',
-  barrel: 'Barrel',
-  dive: 'Dive',
-  orbit: 'Orbit',
-  snake: 'Snake'
-}
+import {
+  FUTURISTIC_CAMERA_IDS,
+  FUTURISTIC_SCENE_IDS,
+  MINECRAFT_BLOCK_GROUP_IDS,
+  type FuturisticCameraId,
+  type FuturisticSceneId,
+  type MinecraftBlockGroupId,
+} from './futuristicMeta'
+
+export {
+  FUTURISTIC_SCENE_IDS,
+  FUTURISTIC_SCENE_LABELS,
+  FUTURISTIC_CAMERA_IDS,
+  FUTURISTIC_CAMERA_LABELS,
+  MINECRAFT_BLOCK_GROUP_IDS,
+  MINECRAFT_BLOCK_GROUP_LABELS,
+} from './futuristicMeta'
+export type { FuturisticSceneId, FuturisticCameraId, MinecraftBlockGroupId } from './futuristicMeta'
 
 /** Mouse parallax scale (HTML prototype uses 1). */
 const MOUSE_INFLUENCE = 0.1
@@ -86,18 +82,6 @@ export const MINECRAFT_BLOCK_GROUPS = {
   ]
 } as const
 
-export const MINECRAFT_BLOCK_GROUP_IDS = ['mixed', 'stainedGlass', 'wool', 'construction', 'glow', 'world'] as const
-export type MinecraftBlockGroupId = typeof MINECRAFT_BLOCK_GROUP_IDS[number]
-
-export const MINECRAFT_BLOCK_GROUP_LABELS: Record<MinecraftBlockGroupId, string> = {
-  mixed: 'Mixed',
-  stainedGlass: 'Stained glass',
-  wool: 'Wool',
-  construction: 'Construction',
-  glow: 'Glow',
-  world: 'World (grass & ores)'
-}
-
 interface ScenePalette {
   bg: number
   fog: number

package/src/three/menuBackground/futuristicMeta.ts

@@ -0,0 +1,36 @@
+//@ts-nocheck
+/** Settings / labels only — no Three.js or DocumentRenderer (safe for defaultOptions imports). */
+
+export const FUTURISTIC_SCENE_IDS = ['galaxy', 'nether', 'end', 'cyber', 'light'] as const
+export type FuturisticSceneId = typeof FUTURISTIC_SCENE_IDS[number]
+
+export const FUTURISTIC_CAMERA_IDS = ['cruise', 'barrel', 'dive', 'orbit', 'snake'] as const
+export type FuturisticCameraId = typeof FUTURISTIC_CAMERA_IDS[number]
+
+export const FUTURISTIC_SCENE_LABELS: Record<FuturisticSceneId, string> = {
+  galaxy: 'Galaxy',
+  nether: 'Nether',
+  end: 'The End',
+  cyber: 'Cyber',
+  light: 'Light Space'
+}
+
+export const FUTURISTIC_CAMERA_LABELS: Record<FuturisticCameraId, string> = {
+  cruise: 'Cruise',
+  barrel: 'Barrel',
+  dive: 'Dive',
+  orbit: 'Orbit',
+  snake: 'Snake'
+}
+
+export const MINECRAFT_BLOCK_GROUP_IDS = ['mixed', 'stainedGlass', 'wool', 'construction', 'glow', 'world'] as const
+export type MinecraftBlockGroupId = typeof MINECRAFT_BLOCK_GROUP_IDS[number]
+
+export const MINECRAFT_BLOCK_GROUP_LABELS: Record<MinecraftBlockGroupId, string> = {
+  mixed: 'Mixed',
+  stainedGlass: 'Stained glass',
+  wool: 'Wool',
+  construction: 'Construction',
+  glow: 'Glow',
+  world: 'World (grass & ores)'
+}

package/src/three/menuBackground/gpuPreference.ts

@@ -0,0 +1,11 @@
+//@ts-nocheck
+export type RendererGpuPreference = 'default' | 'high-performance' | 'low-power'
+
+/** Maps stored `gpuPreference` to WebGL `powerPreference` (undefined = browser default). */
+export function gpuPreferenceToWebGLPowerPreference(
+  preference: RendererGpuPreference
+): 'high-performance' | 'low-power' | undefined {
+  if (preference === 'high-performance') return 'high-performance'
+  if (preference === 'low-power') return 'low-power'
+  return undefined
+}

package/src/three/menuBackground/index.ts

@@ -36,9 +36,11 @@ export {
 } from './defaultOptions'
 export type {
   RendererDefaultOptionKey,
-  RendererGpuPreference,
   RendererMesherPipeline,
+  RendererShaderCubeDebugMode,
   RendererOptionMeta,
   RendererStorageOptions
 } from './defaultOptions'
-export { gpuPreferenceToWebGLPowerPreference } from './defaultOptions'
+export { gpuPreferenceToWebGLPowerPreference } from './gpuPreference'
+export type { RendererGpuPreference } from './gpuPreference'
+export { 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(): {