minecraft-renderer 0.1.35 → 0.1.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecraft-renderer",
-  "version": "0.1.35",
+  "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

@@ -32,6 +32,10 @@ export const defaultWorldRendererConfig = {
   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

@@ -124,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 {
@@ -310,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() {
@@ -549,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,

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/three/worldRendererThree.ts

@@ -56,7 +56,7 @@ export class WorldRendererThree extends WorldRendererCommon {
   directionalLight = new THREE.DirectionalLight(0xff_ff_ff, 0.5)
   entities = new Entities(this, (globalThis as any).mcData)
   cameraGroupVr?: THREE.Object3D
-  material = new THREE.MeshLambertMaterial({ vertexColors: true, transparent: true, alphaTest: 0.1 })
+  material = new THREE.MeshBasicMaterial({ vertexColors: true, transparent: true, alphaTest: 0.1 })
   itemsTexture!: THREE.Texture
   cursorBlock: CursorBlock
   onRender: Array<(deltaTime: number) => void> = []
@@ -632,6 +632,10 @@ export class WorldRendererThree extends WorldRendererCommon {
     this.realScene.background = new THREE.Color(color[0], color[1], color[2])
   }
 
+  changeCardinalLight(cardinalLight: string): void {
+    this.worldRendererConfig.cardinalLight = cardinalLight
+  }
+
   timeUpdated(newTime: number): void {
     // Update starfield module with time
     const starfieldModule = this.getModule<any>('starfield')