minecraft-renderer 0.1.59 → 0.1.61

package/package.json

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

package/src/lib/createPlayerObject.ts

@@ -10,6 +10,22 @@ export type PlayerObjectType = PlayerObject & {
   realUsername: string
 }
 
+/** Starfield + log-depth world: cutout skin mats need alphaTest and depthWrite (not mesh traverse). */
+export function configurePlayerSkinMaterials (playerObject: PlayerObject): void {
+  const skin = playerObject.skin
+  const materials = [
+    skin.layer1Material,
+    skin.layer1MaterialBiased,
+    skin.layer2Material,
+    skin.layer2MaterialBiased,
+  ]
+  for (const mat of materials) {
+    mat.transparent = true
+    mat.alphaTest = 0.1
+    mat.depthWrite = true
+  }
+}
+
 export function createPlayerObject (options: {
   username?: string
   uuid?: string
@@ -25,12 +41,7 @@ export function createPlayerObject (options: {
   playerObject.realUsername = options.username ?? ''
   playerObject.position.set(0, 16, 0)
 
-  // fix issues with starfield
-  playerObject.traverse((obj) => {
-    if (obj instanceof THREE.Mesh && obj.material instanceof THREE.MeshStandardMaterial) {
-      obj.material.transparent = true
-    }
-  })
+  configurePlayerSkinMaterials(playerObject)
 
   wrapper.add(playerObject as any)
   const scale = options.scale ?? (1 / 16)

package/src/three/entities.ts

@@ -16,7 +16,7 @@ import PrismarineChatLoader from 'prismarine-chat'
 import { loadSkinFromUsername, loadSkinImage, stevePngUrl } from '../lib/utils/skins'
 import { renderComponent } from '../sign-renderer'
 import { createCanvas } from '../lib/utils'
-import { PlayerObjectType } from '../lib/createPlayerObject'
+import { configurePlayerSkinMaterials, PlayerObjectType } from '../lib/createPlayerObject'
 import { getBlockMeshFromModel } from './holdingBlock'
 import { createItemMesh } from './itemMesh'
 import * as Entity from './entity/EntityMesh'
@@ -832,6 +832,7 @@ export class Entities {
       playerObject.skin.map = skinTexture as any
       playerObject.skin.modelType = inferModelType(skinCanvas)
       playerObject.skin['isCustom'] = skinUrl !== stevePngUrl
+      configurePlayerSkinMaterials(playerObject)
 
       let earsCanvas: OffscreenCanvas | undefined
       if (!playerCustomSkinImage) {
@@ -902,8 +903,13 @@ export class Entities {
     // TODO CLEANUP!
     // Handle special player entity ID for bot entity in third person
     const key = String(entityPlayerId)
-    if (this.playerPerAnimation[key] === animation) return
-    this.playerPerAnimation[key] = animation
+    // `oneSwing` is a one-shot event, not a persistent state: two swings in a row
+    // are both 'oneSwing', so deduping by name would swallow every repeat swing
+    // while standing still. Only dedupe the persistent state animations.
+    if (animation !== 'oneSwing') {
+      if (this.playerPerAnimation[key] === animation) return
+      this.playerPerAnimation[key] = animation
+    }
 
     if (entityPlayerId === 'player_entity' && this.playerEntity?.playerObject) {
       const { playerObject } = this.playerEntity
@@ -1636,12 +1642,7 @@ export class Entities {
     playerObject.realUsername = entity.username ?? ''
     playerObject.position.set(0, 16, 0)
 
-    // fix issues with starfield
-    playerObject.traverse((obj) => {
-      if (obj instanceof THREE.Mesh && obj.material instanceof THREE.MeshStandardMaterial) {
-        obj.material.transparent = true
-      }
-    })
+    configurePlayerSkinMaterials(playerObject)
 
     wrapper.add(playerObject as any)
     const scale = 1 / 16

package/src/three/entity/animations.js

@@ -87,7 +87,13 @@ export class WalkingGeneralSwing extends PlayerAnimation {
   }
 
   swingArm() {
-    this._swingTime = 0
+    // Only (re)start once we're past the halfway point of the current swing, like
+    // vanilla EntityLiving.swingArm. Otherwise a burst of `animation` packets
+    // (rapid clicks / digging) keeps resetting _swingTime and the arm never
+    // completes an arc, looking like a stutter of fast partial swings.
+    if (this._swingTime === null || this._swingTime >= this._swingDuration / 2) {
+      this._swingTime = 0
+    }
   }
 
   resetLocomotion() {
@@ -189,8 +195,6 @@ export class WalkingGeneralSwing extends PlayerAnimation {
     const crouchSpeedMul = mix(1, 0.55, crouchBlend)
     const speed = baseSpeed * crouchSpeedMul
 
-    this._phase += dt * speed * moveBlend
-
     this._phase += dt * speed * moveBlend
     this._idlePhase += dt * 1.15
 
@@ -285,17 +289,22 @@ const HitAnimation = {
   animate(progress, player, isMovingOrRunning) {
     if (!player?.skin?.rightArm?.rotation) return
 
-    const t = progress * 18
-    player.skin.rightArm.rotation.x = -0.4537860552 * 2 + 2 * Math.sin(t + Math.PI) * 0.3
+    // One swing = one arc. `swing` rises to its peak at the middle of the swing
+    // (progress 0.5) and returns to rest at both ends, matching vanilla's
+    // `sin(swingProgress * PI)` and the first-person hand. Driving the trig with
+    // `progress * 18` previously ran ~3 sine cycles per click, which made other
+    // players' arms look like they were swinging several times per hit.
+    const swing = Math.sin(progress * Math.PI)
+    player.skin.rightArm.rotation.x = -0.4537860552 * 2 - 2 * swing * 0.3
 
     if (!isMovingOrRunning) {
       const basicArmRotationZ = 0.01 * Math.PI + 0.06
-      player.skin.rightArm.rotation.z = -Math.cos(t) * 0.403 + basicArmRotationZ
-      player.skin.body.rotation.y = -Math.cos(t) * 0.06
-      player.skin.leftArm.rotation.x = Math.sin(t + Math.PI) * 0.077
-      player.skin.leftArm.rotation.z = -Math.cos(t) * 0.015 + 0.13 - 0.05
-      player.skin.leftArm.position.z = Math.cos(t) * 0.3
-      player.skin.leftArm.position.x = 5 - Math.cos(t) * 0.05
+      player.skin.rightArm.rotation.z = -swing * 0.403 + basicArmRotationZ
+      player.skin.body.rotation.y = -swing * 0.06
+      player.skin.leftArm.rotation.x = -swing * 0.077
+      player.skin.leftArm.rotation.z = -swing * 0.015 + 0.13 - 0.05
+      player.skin.leftArm.position.z = swing * 0.3
+      player.skin.leftArm.position.x = 5 - swing * 0.05
     }
   },
 }