minecraft-renderer 0.1.34 → 0.1.36

package/package.json

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

package/src/graphicsBackend/config.ts

@@ -19,7 +19,7 @@ export const defaultWorldRendererConfig = {
 
   // Debug settings
   showChunkBorders: false,
-  enableDebugOverlay: false,
+  enableDebugOverlay: true,
   debugModelVariant: undefined as undefined | number[],
   futuristicReveal: false,
 
@@ -29,8 +29,13 @@ export const defaultWorldRendererConfig = {
   addChunksBatchWaitTime: 200,
   _experimentalSmoothChunkLoading: true,
   _renderByChunks: false,
+  autoLowerRenderDistance: false,
 
   // Rendering engine settings
+  /** Face shading: vanilla Minecraft vs higher-contrast client look */
+  shadingTheme: 'high-contrast' as 'vanilla' | 'high-contrast',
+  /** Synced from player reactive state (dimension / nether) — consumed by mesher */
+  cardinalLight: 'default' as string,
   dayCycle: true,
   smoothLighting: true,
   enableLighting: true,

package/src/graphicsBackend/playerState.ts

@@ -32,6 +32,7 @@ export const getInitialPlayerState = (): PlayerStateReactive => proxy({
   itemUsageTicks: 0,
   username: '',
   onlineMode: false,
+  cardinalLight: 'default',
   lightingDisabled: false,
   shouldHideHand: false,
   heldItemMain: undefined,

package/src/lib/worldrendererCommon.ts

@@ -77,6 +77,7 @@ export abstract class WorldRendererCommon<WorkerSend = any, WorkerReceive = any>
   enableChunksLoadDelay = false
   texturesVersion?: string
   viewDistance = -1
+  onRenderDistanceChanged?: (viewDistance: number) => void
   chunksLength = 0
   allChunksFinished = false
   messageQueue: any[] = []
@@ -123,6 +124,7 @@ export abstract class WorldRendererCommon<WorkerSend = any, WorkerReceive = any>
   soundSystem: SoundSystem | undefined
 
   abstract changeBackgroundColor(color: [number, number, number]): void
+  abstract changeCardinalLight(cardinalLight: string): void
 
   /** Override in subclass to check if any enabled module requires heightmap data */
   protected anyModuleRequiresHeightmap(): boolean {
@@ -309,6 +311,9 @@ export abstract class WorldRendererCommon<WorkerSend = any, WorkerReceive = any>
     this.onReactivePlayerStateUpdated('backgroundColor', (value) => {
       this.changeBackgroundColor(value)
     })
+    this.onReactivePlayerStateUpdated('cardinalLight', (value) => {
+      this.changeCardinalLight(value)
+    })
   }
 
   watchReactiveConfig() {
@@ -548,6 +553,8 @@ export abstract class WorldRendererCommon<WorkerSend = any, WorkerReceive = any>
       enableLighting: this.worldRendererConfig.enableLighting,
       skyLight,
       smoothLighting: this.worldRendererConfig.smoothLighting,
+      shadingTheme: this.worldRendererConfig.shadingTheme,
+      cardinalLight: this.worldRendererConfig.cardinalLight,
       outputFormat: this.outputFormat,
       // textureSize: this.resourcesManager.currentResources!.blocksAtlasParser.atlas.latest.width,
       debugModelVariant: this.worldRendererConfig.debugModelVariant,
@@ -813,6 +820,7 @@ export abstract class WorldRendererCommon<WorkerSend = any, WorkerReceive = any>
       this.viewDistance = d
       this.chunksLength = d === 0 ? 1 : generateSpiralMatrix(d).length
       this.allChunksFinished = Object.keys(this.finishedChunks).length === this.chunksLength
+      this.onRenderDistanceChanged?.(d)
     })
 
     worldEmitter.on('markAsLoaded', ({ x, z }) => {

package/src/mesher/models.ts

@@ -395,7 +395,16 @@ function renderElement(world: World, cursor: Vec3, element: BlockElement, doAO:
     const aos: number[] = []
     const neighborPos = position.plus(new Vec3(...dir))
     // 10%
-    const baseLight = world.getLight(neighborPos, undefined, undefined, block.name) / 15
+    const { smoothLighting, shadingTheme, cardinalLight } = world.config
+    const faceLight = world.getLight(neighborPos, undefined, undefined, block.name)
+    const sideShading = (shadingTheme === 'high-contrast')
+      ? (0.8 + 0.5 * Math.max(0, 0.66 * dir[0] + 0.66 * dir[1] + 0.33 * dir[2])) // old directional light behavior
+      : (
+          cardinalLight === 'nether'
+            ? (0.5 + Math.abs(0.1 * dir[0] + 0.4 * dir[1] + 0.3 * dir[2]))
+            : (0.75 + 0.25 * dir[1] + 0.05 * (Math.abs(dir[2]) - 3 * Math.abs(dir[0])))
+        )
+    const baseLight = sideShading * faceLight / 15
     for (const pos of corners) {
       let vertex = [
         (pos[0] ? maxx : minx),
@@ -429,8 +438,6 @@ function renderElement(world: World, cursor: Vec3, element: BlockElement, doAO:
       }
 
       let light = 1
-      const { smoothLighting } = world.config
-      // const smoothLighting = true
       if (doAO) {
         const dx = pos[0] * 2 - 1
         const dy = pos[1] * 2 - 1
@@ -442,7 +449,7 @@ function renderElement(world: World, cursor: Vec3, element: BlockElement, doAO:
         const side2 = world.getBlock(cursor.offset(...side2Dir))
         const corner = world.getBlock(cursor.offset(...cornerDir))
 
-        let cornerLightResult = baseLight * 15
+        let cornerLightResult = faceLight
 
         if (smoothLighting) {
           const dirVec = new Vec3(...dir)
@@ -459,7 +466,7 @@ function renderElement(world: World, cursor: Vec3, element: BlockElement, doAO:
           const cornerLightDir = getVec(new Vec3(...cornerDir))
           const cornerLight = world.getLight(cursor.plus(cornerLightDir))
           // interpolate
-          const lights = [side1Light, side2Light, cornerLight, baseLight * 15]
+          const lights = [side1Light, side2Light, cornerLight, faceLight]
           cornerLightResult = lights.reduce((acc, cur) => acc + cur, 0) / lights.length
         }
 
@@ -470,8 +477,10 @@ function renderElement(world: World, cursor: Vec3, element: BlockElement, doAO:
         // TODO: correctly interpolate ao light based on pos (evaluate once for each corner of the block)
 
         const ao = (side1Block && side2Block) ? 0 : (3 - (side1Block + side2Block + cornerBlock))
+        const ao_bias = (shadingTheme === 'high-contrast') ? 0.25 : 0.4
+        const ao_scale = (shadingTheme === 'high-contrast') ? 0.25 : 0.2
         // todo light should go upper on lower blocks
-        light = (ao + 1) / 4 * (cornerLightResult / 15)
+        light = sideShading * (ao * ao_scale + ao_bias) * (cornerLightResult / 15)
         aos.push(ao)
 
         // Log AO and light for this corner (corner index is aos.length - 1)

package/src/mesher/shared.ts

@@ -11,7 +11,9 @@ export const defaultMesherConfig = {
   worldMinY: 0,
   enableLighting: true,
   skyLight: 15,
-  smoothLighting: false,
+  smoothLighting: true,
+  shadingTheme: 'high-contrast' as 'vanilla' | 'high-contrast',
+  cardinalLight: 'default' as string,
   outputFormat: 'threeJs' as 'threeJs' | 'webgpu',
   // textureSize: 1024, // for testing
   debugModelVariant: undefined as undefined | number[],

package/src/playerState/playerState.ts

@@ -39,6 +39,8 @@ export const getInitialPlayerState = () => proxy({
   itemUsageTicks: 0,
   username: '',
   onlineMode: false,
+  /** Dimension ambient lighting preset (e.g. nether) — from login/respawn dimension data when available */
+  cardinalLight: 'default' as string,
   lightingDisabled: false,
   shouldHideHand: false,
   heldItemMain: undefined as HandItemBlock | undefined,

package/src/playground/scenes/main.ts

@@ -219,7 +219,7 @@ class MainScene extends BasePlaygroundScene {
 
     // Temporarily replace PerspectiveCamera with OrthographicCamera for block rendering
     this.worldRenderer.camera = new THREE.OrthographicCamera(-1, 1, 1, -1, 0, 10) as any
-    this.worldRenderer.scene.background = null
+    this.worldRenderer.realScene.background = null
 
     const rad = THREE.MathUtils.degToRad(-120)
     this.worldRenderer.directionalLight.position.set(