minecraft-renderer 0.1.25 → 0.1.27

package/package.json

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

package/src/graphicsBackend/types.ts

@@ -119,7 +119,7 @@ export interface GraphicsBackend {
   updateCamera(pos: Vec3 | null, yaw: number, pitch: number): void
   soundSystem?: any
   backendMethods?: any
-  getDebugOverlay?(): { entitiesString?: string, right?: string }
+  getDebugOverlay?(): { entitiesString?: string, left?: Record<string, string>, right?: Record<string, string> }
 }
 
 /** Graphics backend loader function type */

package/src/lib/worldrendererCommon.ts

@@ -108,6 +108,13 @@ export abstract class WorldRendererCommon<WorkerSend = any, WorkerReceive = any>
   protocolCustomBlocks = new Map<string, CustomBlockModels>()
   private heightmapDebounceTimers = new Map<string, ReturnType<typeof setTimeout>>()
 
+  // Geometry throttle: first dirty per section is instant, subsequent within window are grouped
+  private sectionDirtyCount = new Map<string, number>()
+  private sectionDirtyTimers = new Map<string, ReturnType<typeof setTimeout>>()
+  private sectionDirtyPendingArgs = new Map<string, { pos: Vec3; value: boolean; useChangeWorker: boolean }>()
+  private static readonly GEOMETRY_THROTTLE_THRESHOLD = 1
+  private static readonly GEOMETRY_THROTTLE_DELAY = 100 // ms
+
   blockStateModelInfo = new Map<string, BlockStateModelInfo>()
 
   abstract outputFormat: 'threeJs' | 'webgpu'
@@ -682,6 +689,15 @@ export abstract class WorldRendererCommon<WorkerSend = any, WorkerReceive = any>
       clearTimeout(pendingTimer)
       this.heightmapDebounceTimers.delete(debounceKey)
     }
+    // Cancel any pending geometry throttle timers for sections in this chunk
+    for (const [key, timer] of this.sectionDirtyTimers) {
+      if (key.startsWith(`${x},`) && key.endsWith(`,${z}`)) {
+        clearTimeout(timer)
+        this.sectionDirtyTimers.delete(key)
+        this.sectionDirtyCount.delete(key)
+        this.sectionDirtyPendingArgs.delete(key)
+      }
+    }
     for (const worker of this.workers) {
       worker.postMessage({ type: 'unloadChunk', x, z })
     }
@@ -955,14 +971,65 @@ export abstract class WorldRendererCommon<WorkerSend = any, WorkerReceive = any>
     if (!this.forceCallFromMesherReplayer && this.mesherLogReader) return
 
     if (this.viewDistance === -1) throw new Error('viewDistance not set')
-    this.reactiveState.world.mesherWork = true
+
     const distance = this.getDistance(pos)
     // todo shouldnt we check loadedChunks instead?
     if (!this.workers.length || distance[0] > this.viewDistance || distance[1] > this.viewDistance) return
+
+    // When unloading chunks (value=false) — always immediate, no throttle
+    if (!value) {
+      this._dispatchDirtyImmediate(pos, value, useChangeWorker)
+      return
+    }
+
     const CHUNK_SIZE = 16
     const sectionHeight = this.getSectionHeight()
     const key = `${Math.floor(pos.x / CHUNK_SIZE) * CHUNK_SIZE},${Math.floor(pos.y / sectionHeight) * sectionHeight},${Math.floor(pos.z / CHUNK_SIZE) * CHUNK_SIZE}`
-    // if (this.sectionsOutstanding.has(key)) return
+
+    const currentCount = (this.sectionDirtyCount.get(key) ?? 0) + 1
+    this.sectionDirtyCount.set(key, currentCount)
+
+    if (currentCount <= WorldRendererCommon.GEOMETRY_THROTTLE_THRESHOLD) {
+      // First request in window — dispatch immediately for instant feedback
+      this._dispatchDirtyImmediate(pos, value, useChangeWorker)
+
+      // Schedule trailing dispatch after throttle window
+      if (!this.sectionDirtyTimers.has(key)) {
+        this.sectionDirtyTimers.set(key, setTimeout(() => {
+          const args = this.sectionDirtyPendingArgs.get(key)
+          this.sectionDirtyCount.delete(key)
+          this.sectionDirtyTimers.delete(key)
+          this.sectionDirtyPendingArgs.delete(key)
+          if (args) {
+            this._dispatchDirtyImmediate(args.pos, args.value, args.useChangeWorker)
+          }
+        }, WorldRendererCommon.GEOMETRY_THROTTLE_DELAY))
+      }
+    } else {
+      // Subsequent requests — throttle: store latest args, existing timer will dispatch
+      this.sectionDirtyPendingArgs.set(key, { pos, value, useChangeWorker })
+
+      if (!this.sectionDirtyTimers.has(key)) {
+        this.sectionDirtyTimers.set(key, setTimeout(() => {
+          const args = this.sectionDirtyPendingArgs.get(key)
+          this.sectionDirtyCount.delete(key)
+          this.sectionDirtyTimers.delete(key)
+          this.sectionDirtyPendingArgs.delete(key)
+          if (args) {
+            this._dispatchDirtyImmediate(args.pos, args.value, args.useChangeWorker)
+          }
+        }, WorldRendererCommon.GEOMETRY_THROTTLE_DELAY))
+      }
+    }
+  }
+
+  /** Dispatch dirty message to worker without throttle (original logic) */
+  private _dispatchDirtyImmediate(pos: Vec3, value: boolean, useChangeWorker: boolean) {
+    this.reactiveState.world.mesherWork = true
+    const CHUNK_SIZE = 16
+    const sectionHeight = this.getSectionHeight()
+    const key = `${Math.floor(pos.x / CHUNK_SIZE) * CHUNK_SIZE},${Math.floor(pos.y / sectionHeight) * sectionHeight},${Math.floor(pos.z / CHUNK_SIZE) * CHUNK_SIZE}`
+
     this.renderUpdateEmitter.emit('dirty', pos, value)
     // Dispatch sections to workers based on position
     // This guarantees uniformity accross workers and that a given section
@@ -981,7 +1048,6 @@ export abstract class WorldRendererCommon<WorkerSend = any, WorkerReceive = any>
     } else {
       this.toWorkerMessagesQueue[hash] ??= []
       this.toWorkerMessagesQueue[hash].push({
-        // this.workers[hash].postMessage({
         type: 'dirty',
         x: pos.x,
         y: pos.y,
@@ -1054,6 +1120,14 @@ export abstract class WorldRendererCommon<WorkerSend = any, WorkerReceive = any>
     }
     this.heightmapDebounceTimers.clear()
 
+    // Cancel all pending geometry throttle timers
+    for (const timer of this.sectionDirtyTimers.values()) {
+      clearTimeout(timer)
+    }
+    this.sectionDirtyTimers.clear()
+    this.sectionDirtyCount.clear()
+    this.sectionDirtyPendingArgs.clear()
+
     // Stop all workers
     for (const worker of this.workers) {
       worker.terminate()

package/src/three/graphicsBackendBase.ts

@@ -215,6 +215,11 @@ export const createGraphicsBackendBase = () => {
       get entitiesString() {
         return worldRenderer?.entities.getDebugString()
       },
+      get left() {
+        return {
+          'Geo Memory': worldRenderer?.worldBlockGeometry.getEstimatedMemoryUsage().readable ?? '-'
+        }
+      },
     }),
     updateCamera(pos: Vec3 | null, yaw: number, pitch: number) {
       // Mark camera update event for frame timing visualization