minecraft-renderer 0.1.79 → 0.1.80

package/src/graphicsBackend/rendererOptionsSync.ts

@@ -26,23 +26,25 @@ export interface RendererOptionsSubscribeHooks {
   isSafari?: boolean
   isCypress?: boolean
   getWindowFocused?: () => boolean
-  onRegisterFocusHandlers?: (handlers: { onFocus: () => void, onBlur: () => void }) => void
+  onRegisterFocusHandlers?: (handlers: { onFocus: () => void; onBlur: () => void }) => void
 }
 
 export interface RendererWorldViewLike {
   keepChunksDistance: number
 }
 
-export function menuBackgroundOptionsFromStorage(o: Pick<
-  RendererStorageOptions,
-  | 'menuBackgroundMode'
-  | 'menuBackgroundMinecraftTextures'
-  | 'menuBackgroundV2Scene'
-  | 'menuBackgroundV2Camera'
-  | 'menuBackgroundV2BlockGroup'
-  | 'menuBackgroundV2CameraSpeed'
-  | 'menuBackgroundV2BlockSpeed'
->): MenuBackgroundOptions {
+export function menuBackgroundOptionsFromStorage(
+  o: Pick<
+    RendererStorageOptions,
+    | 'menuBackgroundMode'
+    | 'menuBackgroundMinecraftTextures'
+    | 'menuBackgroundV2Scene'
+    | 'menuBackgroundV2Camera'
+    | 'menuBackgroundV2BlockGroup'
+    | 'menuBackgroundV2CameraSpeed'
+    | 'menuBackgroundV2BlockSpeed'
+  >
+): MenuBackgroundOptions {
   return {
     mode: o.menuBackgroundMode as MenuBackgroundOptions['mode'],
     useMinecraftTextures: o.menuBackgroundMinecraftTextures,
@@ -50,7 +52,7 @@ export function menuBackgroundOptionsFromStorage(o: Pick<
     v2Camera: o.menuBackgroundV2Camera as V2CameraId,
     v2BlockGroup: o.menuBackgroundV2BlockGroup as MinecraftBlockGroupId,
     v2CameraSpeed: menuBackgroundSpeedToMultiplier(o.menuBackgroundV2CameraSpeed),
-    v2BlockSpeed: menuBackgroundSpeedToMultiplier(o.menuBackgroundV2BlockSpeed),
+    v2BlockSpeed: menuBackgroundSpeedToMultiplier(o.menuBackgroundV2BlockSpeed)
   }
 }
 
@@ -58,11 +60,7 @@ export function applyMenuBackgroundLiveOptions(
   menu: MenuBackgroundRenderer,
   o: Pick<
     RendererStorageOptions,
-    | 'menuBackgroundV2Scene'
-    | 'menuBackgroundV2Camera'
-    | 'menuBackgroundV2BlockGroup'
-    | 'menuBackgroundV2CameraSpeed'
-    | 'menuBackgroundV2BlockSpeed'
+    'menuBackgroundV2Scene' | 'menuBackgroundV2Camera' | 'menuBackgroundV2BlockGroup' | 'menuBackgroundV2CameraSpeed' | 'menuBackgroundV2BlockSpeed'
   >
 ): void {
   const v2 = menu.v2
@@ -78,11 +76,7 @@ function resolveWasmMesherActive(o: RendererStorageOptions): boolean {
   return o.rendererMesher !== 'legacy-js'
 }
 
-function applyMesherWorkersPreset(
-  appViewer: AppViewer,
-  o: RendererStorageOptions,
-  wasmActive: boolean
-): void {
+function applyMesherWorkersPreset(appViewer: AppViewer, o: RendererStorageOptions, wasmActive: boolean): void {
   const cfg = appViewer.inWorldRenderingConfig
   const override = o.rendererMeshersCountOverride
   const applyMesherWorkers = (workers: number) => {
@@ -104,11 +98,7 @@ function applyMesherWorkersPreset(
   }
 }
 
-function applyFpsLimit(
-  appViewer: AppViewer,
-  o: RendererStorageOptions,
-  windowFocused: boolean
-): void {
+function applyFpsLimit(appViewer: AppViewer, o: RendererStorageOptions, windowFocused: boolean): void {
   const backgroundFpsLimit = o.backgroundRendering
   const normalFpsLimit = o.frameLimit
 
@@ -123,11 +113,7 @@ function applyFpsLimit(
   }
 }
 
-function applyStatsVisible(
-  appViewer: AppViewer,
-  o: RendererStorageOptions,
-  ctx: ApplyRendererOptionsContext
-): void {
+function applyStatsVisible(appViewer: AppViewer, o: RendererStorageOptions, ctx: ApplyRendererOptionsContext): void {
   const { renderDebug } = o
   if (renderDebug === 'none' || ctx.isCypress) {
     appViewer.config.statsVisible = 0
@@ -139,11 +125,7 @@ function applyStatsVisible(
 }
 
 // ensure no object assigns to the config
-export function applyRendererOptions(
-  appViewer: AppViewer,
-  o: RendererStorageOptions,
-  ctx: ApplyRendererOptionsContext = {}
-): void {
+export function applyRendererOptions(appViewer: AppViewer, o: RendererStorageOptions, ctx: ApplyRendererOptionsContext = {}): void {
   const cfg = appViewer.inWorldRenderingConfig
   const wasmActive = resolveWasmMesherActive(o)
 
@@ -180,10 +162,7 @@ export function applyRendererOptions(
 export function applyRendererWorldViewOptions(
   appViewer: AppViewer,
   worldView: RendererWorldViewLike,
-  o: Pick<
-    RendererStorageOptions,
-    'keepChunksDistance' | 'renderEars' | 'showHand' | 'viewBobbing' | 'dayCycleAndLighting'
-  >
+  o: Pick<RendererStorageOptions, 'keepChunksDistance' | 'renderEars' | 'showHand' | 'viewBobbing' | 'dayCycleAndLighting'>
 ): void {
   worldView.keepChunksDistance = o.keepChunksDistance
   const cfg = appViewer.inWorldRenderingConfig
@@ -211,7 +190,7 @@ export function subscribeRendererOptions<T extends RendererStorageOptions>(
     applyRendererOptions(appViewer, snapshot, {
       isSafari: hooks.isSafari,
       isCypress: hooks.isCypress,
-      windowFocused,
+      windowFocused
     })
 
     if (appViewer.currentDisplay === 'menu') {
@@ -230,18 +209,13 @@ export function subscribeRendererOptions<T extends RendererStorageOptions>(
     onBlur: () => {
       windowFocused = false
       run()
-    },
+    }
   })
 
   return subscribe(optionsProxy, run)
 }
 
 /** Call when mineflayer bot is created (lighting depends on protocol features). */
-export function applyRendererEnableLighting(
-  appViewer: AppViewer,
-  newVersionsLighting: boolean,
-  blockStateIdSupported: boolean
-): void {
-  appViewer.inWorldRenderingConfig.enableLighting =
-    !blockStateIdSupported || newVersionsLighting
+export function applyRendererEnableLighting(appViewer: AppViewer, newVersionsLighting: boolean, blockStateIdSupported: boolean): void {
+  appViewer.inWorldRenderingConfig.enableLighting = !blockStateIdSupported || newVersionsLighting
 }

package/src/graphicsBackend/types.ts

@@ -18,7 +18,7 @@ import { WorldRendererConfig } from './config'
 export type MaybePromise<T> = Promise<T> | T
 
 export interface SoundSystem {
-  playSound: (position: { x: number, y: number, z: number }, path: string, volume?: number, pitch?: number, timeout?: number) => void
+  playSound: (position: { x: number; y: number; z: number }, path: string, volume?: number, pitch?: number, timeout?: number) => void
   destroy: () => void
 }
 
@@ -131,7 +131,7 @@ export interface GraphicsBackend {
   updateCamera(pos: Vec3 | null, yaw: number, pitch: number): void
   soundSystem?: any
   backendMethods?: any
-  getDebugOverlay?(): { entitiesString?: string, left?: Record<string, string>, right?: Record<string, string> }
+  getDebugOverlay?(): { entitiesString?: string; left?: Record<string, string>; right?: Record<string, string> }
   /** Active main-menu background, when `currentDisplay === 'menu'`. */
   getMenuBackground?(): MenuBackgroundRenderer | undefined
 }

package/src/index.ts

@@ -37,47 +37,26 @@ export * from './graphicsBackend'
 // ============================================================================
 // World View
 // ============================================================================
-export {
-  WorldView,
-  WorldViewWorker,
-  chunkPos,
-  sectionPos,
-  delayedIterator
-} from './worldView'
+export { WorldView, WorldViewWorker, chunkPos, sectionPos, delayedIterator } from './worldView'
 export type { WorldProvider } from './worldView'
 
 // ============================================================================
 // Player State
 // ============================================================================
-export {
-  getInitialPlayerState,
-  getPlayerStateUtils,
-  getInitialPlayerStateRenderer
-} from './playerState/playerState'
+export { getInitialPlayerState, getPlayerStateUtils, getInitialPlayerStateRenderer } from './playerState/playerState'
 
 // ============================================================================
 // Resource Manager
 // ============================================================================
-export {
-  ResourcesManager,
-  LoadedResourcesTransferrable
-} from './resourcesManager'
+export { ResourcesManager, LoadedResourcesTransferrable } from './resourcesManager'
 
 // ============================================================================
 // Three.js Backend (re-exported for convenience)
 // ============================================================================
-export {
-  createGraphicsBackendSingleThread
-} from './three/graphicsBackendSingleThread'
-export {
-  createGraphicsBackendOffThread
-} from './three/graphicsBackendOffThread'
+export { createGraphicsBackendSingleThread } from './three/graphicsBackendSingleThread'
+export { createGraphicsBackendOffThread } from './three/graphicsBackendOffThread'
 
-export {
-  DocumentRenderer,
-  addCanvasForWorker,
-  isWebWorker
-} from './three/documentRenderer'
+export { DocumentRenderer, addCanvasForWorker, isWebWorker } from './three/documentRenderer'
 export { MC_RENDERER_DEBUG_OVERLAY_CLASS } from './lib/ui/newStats'
 
 // Main-menu background (title screen backdrop)

package/src/lib/DebugGui.ts

@@ -19,7 +19,7 @@ export class DebugGui {
   private readonly initialValues: Record<string, any> = {} // Store initial values
   private initialized = false
 
-  constructor (id: string, target: any, params?: string[], paramsMeta?: Record<string, ParamMeta>) {
+  constructor(id: string, target: any, params?: string[], paramsMeta?: Record<string, ParamMeta>) {
     // If in web worker, don't initialize anything
     if (isWebWorker) return
 
@@ -39,7 +39,7 @@ export class DebugGui {
   }
 
   // Initialize and show the GUI
-  activate () {
+  activate() {
     if (isWebWorker) return this
 
     if (!this.initialized && this.gui) {
@@ -52,20 +52,20 @@ export class DebugGui {
   }
 
   // Getter for visibility
-  get visible (): boolean {
+  get visible(): boolean {
     if (isWebWorker) return false
     return this._visible
   }
 
   // Setter for visibility
-  set visible (value: boolean) {
+  set visible(value: boolean) {
     if (isWebWorker || !this.gui) return
     this._visible = value
     this.gui.domElement.style.display = value ? 'block' : 'none'
     this.saveVisibility()
   }
 
-  private loadSavedValues () {
+  private loadSavedValues() {
     if (isWebWorker) return
     try {
       const saved = localStorage.getItem(this.storageKey)
@@ -86,7 +86,7 @@ export class DebugGui {
     }
   }
 
-  private saveValues (deleteKey = false) {
+  private saveValues(deleteKey = false) {
     if (isWebWorker) return
     try {
       const values = {}
@@ -103,7 +103,7 @@ export class DebugGui {
     }
   }
 
-  private saveVisibility () {
+  private saveVisibility() {
     if (isWebWorker) return
     try {
       localStorage.setItem(`${this.storageKey}_visible`, this._visible.toString())
@@ -112,21 +112,28 @@ export class DebugGui {
     }
   }
 
-  private setupControls () {
+  private setupControls() {
     if (isWebWorker || !this.gui) return
 
     // Add visibility toggle at the top
     this.gui.add(this, 'visible').name('Show Controls')
-    this.gui.add({ resetAll: () => {
-      if (!this.gui) return
-      for (const param of this.params) {
-        this.target[param] = this.initialValues[param]
-      }
-      this.saveValues(true)
-      this.gui.destroy()
-      this.gui = new GUI()
-      this.setupControls()
-    } }, 'resetAll').name('Reset All Parameters')
+    this.gui
+      .add(
+        {
+          resetAll: () => {
+            if (!this.gui) return
+            for (const param of this.params) {
+              this.target[param] = this.initialValues[param]
+            }
+            this.saveValues(true)
+            this.gui.destroy()
+            this.gui = new GUI()
+            this.setupControls()
+          }
+        },
+        'resetAll'
+      )
+      .name('Reset All Parameters')
 
     for (const param of this.params) {
       const value = this.target[param]
@@ -138,54 +145,50 @@ export class DebugGui {
         const max = meta.max ?? value + Math.abs(value * 2)
         const step = meta.step ?? Math.abs(value) / 100
 
-        this.gui.add(this.target, param, min, max, step)
-          .onChange(() => this.saveValues())
+        this.gui.add(this.target, param, min, max, step).onChange(() => this.saveValues())
       } else if (typeof value === 'boolean') {
         // For booleans, create a checkbox
-        this.gui.add(this.target, param)
-          .onChange(() => this.saveValues())
+        this.gui.add(this.target, param).onChange(() => this.saveValues())
       } else if (typeof value === 'string' && ['x', 'y', 'z'].includes(param)) {
         // Special case for xyz coordinates
         const min = meta.min ?? -10
         const max = meta.max ?? 10
         const step = meta.step ?? 0.1
 
-        this.gui.add(this.target, param, min, max, step)
-          .onChange(() => this.saveValues())
+        this.gui.add(this.target, param, min, max, step).onChange(() => this.saveValues())
       } else if (Array.isArray(value)) {
         // For arrays, create a dropdown
-        this.gui.add(this.target, param, value)
-          .onChange(() => this.saveValues())
+        this.gui.add(this.target, param, value).onChange(() => this.saveValues())
       }
     }
   }
 
   // Method to manually trigger save
-  save () {
+  save() {
     if (isWebWorker) return
     this.saveValues()
     this.saveVisibility()
   }
 
   // Method to destroy the GUI and clean up
-  destroy () {
+  destroy() {
     if (isWebWorker || !this.gui) return
     this.saveVisibility()
     this.gui.destroy()
   }
 
   // Toggle visibility
-  toggle () {
+  toggle() {
     this.visible = !this.visible
   }
 
   // Show the GUI
-  show () {
+  show() {
     this.visible = true
   }
 
   // Hide the GUI
-  hide () {
+  hide() {
     this.visible = false
   }
 }

package/src/lib/animationController.ts

@@ -9,12 +9,12 @@ export class AnimationController {
   private currentCancelCallback: (() => void) | null = null
 
   /** Main method */
-  async startAnimation (createAnimation: () => tweenJs.Group, onCancelled?: () => void): Promise<void> {
+  async startAnimation(createAnimation: () => tweenJs.Group, onCancelled?: () => void): Promise<void> {
     if (this.isAnimating) {
       await this.cancelCurrentAnimation()
     }
 
-    return new Promise((resolve) => {
+    return new Promise(resolve => {
       this.isAnimating = true
       this.cancelRequested = false
       this.currentCancelCallback = onCancelled ?? null
@@ -29,7 +29,7 @@ export class AnimationController {
   }
 
   /** Main method */
-  async cancelCurrentAnimation (): Promise<void> {
+  async cancelCurrentAnimation(): Promise<void> {
     if (!this.isAnimating) return
 
     if (this.currentCancelCallback) {
@@ -38,7 +38,7 @@ export class AnimationController {
       callback()
     }
 
-    return new Promise((resolve) => {
+    return new Promise(resolve => {
       this.cancelRequested = true
       this.completionCallbacks.push(() => {
         resolve()
@@ -46,11 +46,11 @@ export class AnimationController {
     })
   }
 
-  animationCycleFinish () {
+  animationCycleFinish() {
     if (this.cancelRequested) this.forceFinish()
   }
 
-  forceFinish (callComplete = true) {
+  forceFinish(callComplete = true) {
     if (!this.isAnimating) return
 
     if (this.currentAnimation) {
@@ -70,17 +70,17 @@ export class AnimationController {
   }
 
   /** Required method */
-  update () {
+  update() {
     if (this.currentAnimation) {
       this.currentAnimation.update()
     }
   }
 
-  get isActive () {
+  get isActive() {
     return this.isAnimating
   }
 
-  get shouldCancel () {
+  get shouldCancel() {
     return this.cancelRequested
   }
 }

package/src/lib/bakeLegacyLight.ts

@@ -1,11 +1,6 @@
 //@ts-nocheck
 /** Bake tint×AO colors with sky/block channels for static export (no live u_skyLevel uniform). */
-export function bakeLegacyVertexColors (
-  colors: ArrayLike<number>,
-  skyLights: ArrayLike<number>,
-  blockLights: ArrayLike<number>,
-  skyLevel: number,
-): number[] {
+export function bakeLegacyVertexColors(colors: ArrayLike<number>, skyLights: ArrayLike<number>, blockLights: ArrayLike<number>, skyLevel: number): number[] {
   const vertCount = colors.length / 3
   const out: number[] = []
   for (let v = 0; v < vertCount; v++) {

package/src/lib/bindAbortableListener.test.ts

@@ -9,9 +9,14 @@ describe('bindAbortableListener', () => {
     const emitter = new WorldViewWorker()
     const controller = new AbortController()
     let calls = 0
-    bindAbortableListener(emitter, 'renderDistance', () => {
-      calls++
-    }, controller.signal)
+    bindAbortableListener(
+      emitter,
+      'renderDistance',
+      () => {
+        calls++
+      },
+      controller.signal
+    )
 
     emitter.emit('renderDistance', 8)
     expect(calls).toBe(1)
@@ -28,12 +33,22 @@ describe('bindAbortableListener', () => {
     let callsA = 0
     let callsB = 0
 
-    bindAbortableListener(emitter, 'renderDistance', () => {
-      callsA++
-    }, controllerA.signal)
-    bindAbortableListener(emitter, 'renderDistance', () => {
-      callsB++
-    }, controllerB.signal)
+    bindAbortableListener(
+      emitter,
+      'renderDistance',
+      () => {
+        callsA++
+      },
+      controllerA.signal
+    )
+    bindAbortableListener(
+      emitter,
+      'renderDistance',
+      () => {
+        callsB++
+      },
+      controllerB.signal
+    )
 
     emitter.emit('renderDistance', 4)
     expect(callsA).toBe(1)
@@ -51,9 +66,14 @@ describe('bindAbortableEmitterListener', () => {
     const emitter = new EventEmitter()
     const controller = new AbortController()
     let calls = 0
-    bindAbortableEmitterListener(emitter, 'test', () => {
-      calls++
-    }, controller.signal)
+    bindAbortableEmitterListener(
+      emitter,
+      'test',
+      () => {
+        calls++
+      },
+      controller.signal
+    )
 
     emitter.emit('test')
     expect(calls).toBe(1)

package/src/lib/bindAbortableListener.ts

@@ -18,9 +18,13 @@ export function bindAbortableListener<E extends keyof WorldViewEvents>(
     emitter.off(event, handler as (...args: any[]) => void)
     return
   }
-  signal.addEventListener('abort', () => {
-    emitter.off(event, handler as (...args: any[]) => void)
-  }, { once: true })
+  signal.addEventListener(
+    'abort',
+    () => {
+      emitter.off(event, handler as (...args: any[]) => void)
+    },
+    { once: true }
+  )
 }
 
 /** Same pattern for plain EventEmitters (e.g. resourcesManager). */
@@ -35,7 +39,11 @@ export function bindAbortableEmitterListener(
     emitter.off(event, handler)
     return
   }
-  signal.addEventListener('abort', () => {
-    emitter.off(event, handler)
-  }, { once: true })
+  signal.addEventListener(
+    'abort',
+    () => {
+      emitter.off(event, handler)
+    },
+    { once: true }
+  )
 }

package/src/lib/blockEntityLightRegistry.ts

@@ -1,10 +1,6 @@
 //@ts-nocheck
 import * as THREE from 'three'
-import {
-  blockEntityBrightness,
-  DEFAULT_LIGHTMAP_PARAMS,
-  type BlockLightmapParams,
-} from './blockEntityLighting'
+import { blockEntityBrightness, DEFAULT_LIGHTMAP_PARAMS, type BlockLightmapParams } from './blockEntityLighting'
 
 export type BlockEntityOverlayLight = {
   material: THREE.MeshBasicMaterial
@@ -17,12 +13,12 @@ export class BlockEntityLightRegistry {
   private skyLevel = 1
   private lightmapParams: BlockLightmapParams = { ...DEFAULT_LIGHTMAP_PARAMS }
 
-  register (entry: BlockEntityOverlayLight): void {
+  register(entry: BlockEntityOverlayLight): void {
     this.entries.add(entry)
     this.applyBrightness(entry)
   }
 
-  unregister (material: THREE.Material): void {
+  unregister(material: THREE.Material): void {
     for (const entry of this.entries) {
       if (entry.material === material) {
         this.entries.delete(entry)
@@ -31,43 +27,38 @@ export class BlockEntityLightRegistry {
     }
   }
 
-  setSkyLevel (value: number): void {
+  setSkyLevel(value: number): void {
     this.skyLevel = value
     this.refreshAll()
   }
 
-  setLightmapParams (params: BlockLightmapParams): void {
+  setLightmapParams(params: BlockLightmapParams): void {
     this.lightmapParams = { ...this.lightmapParams, ...params }
     this.refreshAll()
   }
 
-  getSkyLevel (): number {
+  getSkyLevel(): number {
     return this.skyLevel
   }
 
-  private refreshAll (): void {
+  private refreshAll(): void {
     for (const entry of this.entries) {
       this.applyBrightness(entry)
     }
   }
 
-  private applyBrightness (entry: BlockEntityOverlayLight): void {
-    const brightness = blockEntityBrightness(
-      entry.blockLightNorm,
-      entry.skyLightNorm,
-      this.skyLevel,
-      this.lightmapParams,
-    )
+  private applyBrightness(entry: BlockEntityOverlayLight): void {
+    const brightness = blockEntityBrightness(entry.blockLightNorm, entry.skyLightNorm, this.skyLevel, this.lightmapParams)
     entry.material.color.setScalar(brightness)
   }
 }
 
-export function tintBannerMaterial (
+export function tintBannerMaterial(
   material: THREE.MeshBasicMaterial,
   blockLightNorm: number,
   skyLightNorm: number,
   skyLevel: number,
-  lightmapParams: BlockLightmapParams = DEFAULT_LIGHTMAP_PARAMS,
+  lightmapParams: BlockLightmapParams = DEFAULT_LIGHTMAP_PARAMS
 ): number {
   const brightness = blockEntityBrightness(blockLightNorm, skyLightNorm, skyLevel, lightmapParams)
   material.color.setScalar(brightness)

package/src/lib/blockEntityLighting.test.ts

@@ -1,11 +1,6 @@
 //@ts-nocheck
 import { describe, expect, it } from 'vitest'
-import {
-  applyLightmap,
-  blockEntityBrightness,
-  combinedBlockLight,
-  DEFAULT_LIGHTMAP_PARAMS,
-} from './blockEntityLighting'
+import { applyLightmap, blockEntityBrightness, combinedBlockLight, DEFAULT_LIGHTMAP_PARAMS } from './blockEntityLighting'
 
 describe('blockEntityLighting', () => {
   it('applyLightmap(1) === 1 for default params', () => {