// ============================================================ // Block interaction — break and place voxels via raycastVoxel // Native voxel terrain system — no entity cubes // Attached to the player // ============================================================ var voxel = require('lib/voxel.js'); var REACH = 6; var BREAK_TIME = 0; var PLACE_COOLDOWN = 0.3; // ── Block ownership helpers ── // Local cache of blocks this player placed (stored per-player in state) // We use state._myPlacedKeys instead of a module-level var to avoid sharing across players function getMyPlacedKeys(api) { return api.getState()._myPlacedKeys || {}; } function markMyPlacedKey(api, key) { var keys = Object.assign({}, api.getState()._myPlacedKeys || {}); keys[key] = true; api.patchState({ _myPlacedKeys: keys }); } function unmarkMyPlacedKeys(api, keysToRemove) { var keys = Object.assign({}, api.getState()._myPlacedKeys || {}); for (var i = 0; i < keysToRemove.length; i++) { delete keys[keysToRemove[i]]; } api.patchState({ _myPlacedKeys: keys }); } function getWorldState(api) { var results = api.query({ tags: ['voxel-world'] }); if (results.length > 0) return results[0].state || {}; return {}; } function canBreak(api, key, materialId) { // Always allow breaking your own recently placed blocks if (getMyPlacedKeys(api)[key]) return true; var ws = getWorldState(api); var owners = ws.blockOwners || {}; var ownerInfo = owners[key]; // If we have ownership data, use it if (ownerInfo) { var myUid = api.getState().userId; if (!myUid) return false; if (ownerInfo.uid === myUid) return true; if (myUid === ws.creatorUid) return true; if (ws.moderators && ws.moderators[myUid]) return true; return false; } // No owner on record — check if this could be natural terrain // Superflat: Y=0 grass, Y=-1..-3 dirt, Y=-4..-6 stone, Y<=-7 bedrock var parts = key.split(','); var by = parseInt(parts[1], 10); var mat = materialId || ''; // Natural terrain blocks — anyone can break if (by <= -7 && mat === 'b_bedrock') return true; if (by >= -6 && by <= -4 && (mat === 'b_stone' || mat === 'b_stone2')) return true; if (by >= -3 && by <= -1 && (mat === 'b_dirt' || mat === 'b_dirt2')) return true; if (by === 0 && (mat === 'b_grass' || mat === 'b_grass2')) return true; // Everything else with no owner is likely recently placed — protect it // Only creator/mods can break unowned player-placed blocks var myUid2 = api.getState().userId; if (!myUid2) return false; if (myUid2 === ws.creatorUid) return true; if (ws.moderators && ws.moderators[myUid2]) return true; return false; } function tryPoolFill(api, ox, oy, oz, liquidType) { var MAX_FILL = 512; var DX = [1, -1, 0, 0]; var DZ = [0, 0, 1, -1]; var queue = [[ox, oz]]; var visited = {}; visited[ox + ',' + oz] = true; var fills = []; var bounded = true; while (queue.length > 0) { var cur = queue.shift(); var cx = cur[0], cz = cur[1]; var mat = api.getVoxelMaterial(cx, oy, cz); // Solid non-liquid wall — boundary if (mat !== null && mat.indexOf(liquidType) === -1) continue; // Air — needs filling if (mat === null) { fills.push([cx, cz]); if (fills.length > MAX_FILL) { bounded = false; break; } } // Liquid or origin — keep searching through it for (var i = 0; i < 4; i++) { var nx = cx + DX[i]; var nz = cz + DZ[i]; var nk = nx + ',' + nz; if (!visited[nk]) { visited[nk] = true; queue.push([nx, nz]); } } } if (!bounded || fills.length === 0) return []; return fills; } function registerOwner(api, key) { var s = api.getState(); var profile = api.getProfile() || {}; markMyPlacedKey(api, key); api.emit('setBlockOwner', { key: key, uid: s.userId || profile.userId || '', name: profile.displayName || 'Unknown', }); } function removeOwners(api, keys) { if (keys.length > 0) { unmarkMyPlacedKeys(api, keys); api.emit('removeBlockOwner', { keys: keys }); } } export function onSpawn(api) { var s = api.getState(); var profile = api.getProfile() || {}; if (profile.userId && s.userId !== profile.userId) { api.patchState({ userId: profile.userId }); } if (s.hotbarSlot === undefined) { api.patchState({ hotbarSlot: 0, hotbar: [1, 2, 3, 4, 5, 6, 7, 8], inventory: buildDefaultInventory(), breakProgress: 0, breakTarget: null, placeCooldown: 0, inventoryOpen: false, selectedHotbarSlot: 0, }); } // First-time players see the How To Play popup if (!s.howToSeen && !s.howToOpen) { api.patchState({ howToOpen: true }); api.showCursor(); } // Per-player preview ghost (local only) var previewId = 'preview-' + api.id; api.spawn(previewId, { tags: ['fx', 'player-preview'], realm: 'client', audience: 'local', properties: { visible: false, primitive: { kind: 'box', width: 1, height: 1, depth: 1 }, material: { color: 'oklch(0.8 0 0)', opacity: 0.35, transparent: true, depthWrite: false }, }, }); // Per-player highlight cube (local only) var highlightId = 'highlight-' + api.id; api.spawn(highlightId, { tags: ['fx', 'player-highlight'], realm: 'client', audience: 'local', properties: { visible: false, primitive: { kind: 'box', width: 1.005, height: 1.005, depth: 1.005 }, material: { color: 'oklch(0.95 0 0)', opacity: 0.12, transparent: true, depthWrite: false }, }, }); } function buildDefaultInventory() { var inv = {}; var blocks = voxel.HOTBAR_BLOCKS; for (var i = 0; i < blocks.length; i++) { inv[blocks[i]] = 999; } return inv; } export function onDestroy(api) { try { api.destroy('preview-' + api.id); } catch(e) {} try { api.destroy('highlight-' + api.id); } catch(e) {} try { api.destroy('overlay-' + api.id); } catch(e) {} } export function onInput(input, api) { var target = api.getControlTarget(); if (target && target.id !== api.id) return; var s = api.getState(); // ── How To Play overlay ── if (input.actions.showHowTo) { api.patchState({ howToOpen: true }); api.showCursor(); return; } if (input.actions.hideHowTo) { api.patchState({ howToOpen: false, howToSeen: true }); api.hideCursor(); return; } if (s.howToOpen) { api.showCursor(); return; } // ── Chat system ── if (input.actions.sendChat && input.actionData && input.actionData.sendChat) { var chatText = (input.actionData.sendChat.text || '').trim(); if (chatText) { var profile = api.getProfile() || {}; api.emit('chatMsg', { name: profile.displayName || 'Player', text: chatText }); } api.patchState({ chatOpen: false }); api.hideCursor(); return; } if (input.actions.closeChat && s.chatOpen) { api.patchState({ chatOpen: false }); api.hideCursor(); return; } if (!s.chatOpen && input.actions.openChat) { api.patchState({ chatOpen: true }); api.showCursor(); return; } if (s.chatOpen && input.actions.openChat) { api.patchState({ chatOpen: false }); api.hideCursor(); return; } // Place naming actions if (input.actions.namePlace && input.actionData && input.actionData.namePlace) { var placeName = input.actionData.namePlace.name || 'Unnamed'; var profile = api.getProfile() || {}; api.emit('createPlace', { name: placeName, uid: profile.userId || s.userId, ownerName: profile.displayName || 'Someone' }); api.patchState({ namingPlace: false }); api.hideCursor(); return; } if (input.actions.cancelNaming) { api.patchState({ namingPlace: false }); api.hideCursor(); return; } if (s.namingPlace) { api.showCursor(); return; } // Sign text save if (input.actions.signSave && input.actionData && input.actionData.signSave) { var signKey = s.signEditing; if (signKey) { var parts = signKey.split(','); var sx = parseInt(parts[0]), sy = parseInt(parts[1]), sz = parseInt(parts[2]); var newText = input.actionData.signSave.text || ''; var newColor = input.actionData.signSave.color || 'black'; var signEntId = 'sign-' + sx + '-' + sy + '-' + sz; // Map color names to oklch values var colorMap = { 'black': 'oklch(0.12 0 0)', 'white': 'oklch(0.97 0 0)', 'red': 'oklch(0.55 0.22 27)', 'blue': 'oklch(0.45 0.2 260)', 'green': 'oklch(0.55 0.18 145)', 'yellow': 'oklch(0.85 0.18 90)', 'purple': 'oklch(0.45 0.2 305)', 'orange': 'oklch(0.7 0.18 55)', }; var textColorOklch = colorMap[newColor] || colorMap['black']; // Update sign entity text try { api.setObjectProperty(signEntId, 'sign', { width: 0.8, height: 0.45, depth: 0.08, padding: [0.04, 0.03], material: { texture: 'cdn/texture-pixel-wooden-plank-pattern-kbgyk0q6.webp', color: 'oklch(0.75 0.06 70)', roughness: 0.9, }, text: { content: newText, color: textColorOklch, size: 0.06, maxWidth: 0.7, anchor: [0.5, 0.5], offset: [0, -0.115, 0] }, }); api.patchObjectState(signEntId, { text: newText, textColor: newColor }); } catch(e) {} // Persist sign text to world manager api.emit('setSignText', { key: signKey, text: newText, color: newColor }); api.patchState({ signEditing: null, signText: null, signColor: null }); api.hideCursor(); api.playSound('cdn/sfx-click.mp3', { volume: 0.3 }); } return; } // Sign text cancel if (input.actions.signCancel) { api.patchState({ signEditing: null, signText: null, signColor: null }); api.hideCursor(); return; } if (s.signEditing) { api.showCursor(); return; } // Interact with I — doors use native voxel interact, signs open editor if (input.actions.interact) { var ray = api.getPointerRay(input); if (ray) { var hit = api.raycastVoxel(ray.origin, ray.direction, { maxDistance: REACH }); if (hit && hit.voxel) { var mat = hit.materialId || ''; if (mat.indexOf('door') !== -1) { var doorClosed = api.isVoxelSolid(hit.voxel.x, hit.voxel.y, hit.voxel.z); api.interactWithVoxel(hit.voxel.x, hit.voxel.y, hit.voxel.z); api.playSound(doorClosed ? 'cdn/sfx-minecraft-style-wooden-door-open-click.mp3' : 'cdn/sfx-minecraft-style-wooden-door-close-click.mp3', { volume: 0.5 }); } else if (mat === 'b_sign') { // Open sign text editor var sx = hit.voxel.x, sy = hit.voxel.y, sz = hit.voxel.z; var signKey = sx + ',' + sy + ',' + sz; // Read existing text from sign entity var signEntId = 'sign-' + sx + '-' + sy + '-' + sz; var existingText = ''; var existingColor = ''; try { var signSt = api.getObjectState(signEntId); if (signSt && signSt.text) existingText = signSt.text; if (signSt && signSt.textColor) existingColor = signSt.textColor; } catch(e) {} api.patchState({ signEditing: signKey, signText: existingText, signColor: existingColor || 'black' }); api.showCursor(); } } } // Also check entity-based interactables (non-block objects) var pos = api.getProperty('feetPosition'); var nearby = api.query({ radius: 4, tags: ['interactable'], excludeSelf: true }); if (nearby.length > 0) { nearby.sort(function(a, b) { var da = Math.hypot(a.feetPosition.x - pos.x, a.feetPosition.z - pos.z); var db = Math.hypot(b.feetPosition.x - pos.x, b.feetPosition.z - pos.z); return da - db; }); api.interact(nearby[0].id); } } // Toggle inventory with E if (input.actions.toggleInventory) { var isOpen = !s.inventoryOpen; api.patchState({ inventoryOpen: isOpen, heldBlock: 0, invTab: s.invTab || 'all' }); if (isOpen) api.showCursor(); else api.hideCursor(); return; } // Liquid cleanup — loop until every liquid cell is gone if (input.actions.clearLiquids) { var pos = api.getProperty('feetPosition'); var R = 50; var totalCleared = 0; var maxPasses = 3; for (var pass = 0; pass < maxPasses; pass++) { var found = 0; for (var cx = Math.floor(pos.x) - R; cx <= Math.ceil(pos.x) + R; cx++) { for (var cz = Math.floor(pos.z) - R; cz <= Math.ceil(pos.z) + R; cz++) { for (var cy = -2; cy <= 30; cy++) { var cmat = api.getVoxelMaterial(cx, cy, cz); if (cmat && (cmat.indexOf('water') !== -1 || cmat.indexOf('lava') !== -1)) { api.breakVoxel(cx, cy, cz); found++; } } } } totalCleared += found; if (found === 0) break; } api.toast('Cleared ' + totalCleared + ' liquid blocks', { duration: 3 }); return; } // Toggle admin panel with P if (input.actions.toggleAdmin) { var adminNow = !s.adminOpen; api.patchState({ adminOpen: adminNow }); if (adminNow) api.showCursor(); else api.hideCursor(); return; } // Admin command from UI if (input.actions.adminCmd) { var cmdData = input.actionData ? input.actionData.adminCmd : null; if (cmdData) { var prof = api.getProfile() || {}; api.emit('adminCmd', { uid: prof.userId || null, action: cmdData.action, targetUid: cmdData.targetUid }); } return; } // Inventory tab switch if (input.actions.invTab) { var tabData = input.actionData ? input.actionData.invTab : null; if (tabData && tabData.tab) api.patchState({ invTab: tabData.tab }); return; } // Pick up block from inventory grid if (input.actions.invPickup) { var pickData = input.actionData ? input.actionData.invPickup : null; if (pickData && pickData.blockId && voxel.BLOCKS[pickData.blockId]) { api.patchState({ heldBlock: pickData.blockId }); api.playSound('cdn/sfx-click.mp3', { volume: 0.3 }); } return; } // Drop held block into hotbar slot if (input.actions.invDrop) { var dropData = input.actionData ? input.actionData.invDrop : null; var held = s.heldBlock || 0; if (dropData && typeof dropData.slot === 'number' && held && voxel.BLOCKS[held]) { var hotbar = (s.hotbar || [1, 2, 3, 4, 5, 6, 7, 8]).slice(); hotbar[dropData.slot] = held; api.patchState({ hotbar: hotbar, heldBlock: 0, hotbarSlot: dropData.slot }); api.playSound('cdn/sfx-click.mp3', { volume: 0.4 }); } return; } if (s.inventoryOpen || s.adminOpen) return; // Hotbar selection for (var i = 1; i <= 9; i++) { if (input.actions['slot' + i]) { api.patchState({ hotbarSlot: i - 1 }); return; } } var scroll = input.axes.hotbarScroll || 0; if (scroll !== 0) { var slot = s.hotbarSlot || 0; if (scroll > 0) slot--; else slot++; var maxSlot = voxel.HOTBAR_BLOCKS.length; if (slot < 0) slot = maxSlot; if (slot > maxSlot) slot = 0; api.patchState({ hotbarSlot: slot }); } // === BLOCK BREAKING (left click) === if (input.actions.breakBlock) { var ray2 = api.getPointerRay(input); if (ray2) { // Try liquid-inclusive raycast first so we can target water/lava var hit2 = api.raycastVoxel(ray2.origin, ray2.direction, { maxDistance: REACH, includeLiquids: true }); if (hit2 && hit2.voxel) { var vx = hit2.voxel.x, vy = hit2.voxel.y, vz = hit2.voxel.z; var key = vx + ',' + vy + ',' + vz; if (s._lastBrokenKey === key) return; // Liquids break instantly var hitMat2 = hit2.materialId || ''; if (hitMat2.indexOf('water') !== -1 || hitMat2.indexOf('lava') !== -1) { api.breakVoxel(vx, vy, vz); removeOwners(api, [key]); // Check if this was a pool source — drain all connected fills var vwPool = api.query({ tags: ['voxel-world'] }); var poolSources = (vwPool.length > 0 && vwPool[0].state.poolSources) || {}; if (poolSources[key]) { var pFills = poolSources[key]; var drainKeys = []; for (var pi = 0; pi < pFills.length; pi++) { var pfk = pFills[pi]; var pParts = pfk.split(','); var px = parseInt(pParts[0], 10); var py = parseInt(pParts[1], 10); var pz = parseInt(pParts[2], 10); var pMat = api.getVoxelMaterial(px, py, pz); if (pMat && (pMat.indexOf('water') !== -1 || pMat.indexOf('lava') !== -1)) { api.breakVoxel(px, py, pz); drainKeys.push(pfk); } } if (drainKeys.length > 0) removeOwners(api, drainKeys); api.emit('drainPool', { sourceKey: key }); } api.patchState({ breakProgress: 0, breakTarget: null, _lastBrokenKey: key }); api.playSound('cdn/sfx-water-splash.mp3', { volume: 0.5 }); return; } // Ownership check — deny if block belongs to someone else if (!canBreak(api, key, hitMat2)) { var ws2 = getWorldState(api); var oi = (ws2.blockOwners || {})[key]; var ownerName2 = oi ? oi.name : 'someone'; api.toast("This block belongs to " + ownerName2); api.patchState({ breakProgress: 0, breakTarget: null }); return; } var progress = s.breakProgress || 0; var breakTarget = s.breakTarget; if (breakTarget === key) { progress += api.getDeltaTime(); } else { progress = api.getDeltaTime(); breakTarget = key; } if (progress >= BREAK_TIME) { // Final ownership check right before breaking if (!canBreak(api, key, hitMat2)) { var ws3 = getWorldState(api); var oi3 = (ws3.blockOwners || {})[key]; var ownerName3 = oi3 ? oi3.name : 'someone'; api.toast("This block belongs to " + ownerName3); api.patchState({ breakProgress: 0, breakTarget: null }); return; } api.breakVoxel(vx, vy, vz); var removedKeys = [key]; // If it's a sign, destroy the text entity and remove persisted text var brokenMat = hit2.materialId || ''; if (brokenMat === 'b_sign') { var signEntIdBreak = 'sign-' + vx + '-' + vy + '-' + vz; try { api.destroy(signEntIdBreak); } catch(e) {} api.emit('removeSignText', { key: vx + ',' + vy + ',' + vz }); } // If it's a torch, destroy all visual/fx entities and remove persisted meta if (brokenMat === 'b_torch') { try { api.destroy('torch-stick-' + vx + '-' + vy + '-' + vz); } catch(e) {} try { api.destroy('torch-flame-' + vx + '-' + vy + '-' + vz); } catch(e) {} try { api.destroy('torch-fx-' + vx + '-' + vy + '-' + vz); } catch(e) {} api.emit('removeTorchMeta', { key: vx + ',' + vy + ',' + vz }); } // If it's a door, also break the paired cell if (brokenMat.indexOf('door') !== -1) { var aboveMat = api.getVoxelMaterial(vx, vy + 1, vz); var belowMat = api.getVoxelMaterial(vx, vy - 1, vz); if (aboveMat && aboveMat.indexOf('door') !== -1) { api.breakVoxel(vx, vy + 1, vz); removedKeys.push(vx + ',' + (vy + 1) + ',' + vz); } if (belowMat && belowMat.indexOf('door') !== -1) { api.breakVoxel(vx, vy - 1, vz); removedKeys.push(vx + ',' + (vy - 1) + ',' + vz); } // Double door: also break the horizontal partner column if (brokenMat.indexOf('double') !== -1) { // Check all 4 horizontal neighbors for the partner var dirs = [[1,0],[-1,0],[0,1],[0,-1]]; for (var di = 0; di < dirs.length; di++) { var pdx = dirs[di][0], pdz = dirs[di][1]; var pmat = api.getVoxelMaterial(vx + pdx, vy, vz + pdz); if (pmat && pmat.indexOf('door') !== -1) { api.breakVoxel(vx + pdx, vy, vz + pdz); removedKeys.push((vx + pdx) + ',' + vy + ',' + (vz + pdz)); var pAbove = api.getVoxelMaterial(vx + pdx, vy + 1, vz + pdz); var pBelow = api.getVoxelMaterial(vx + pdx, vy - 1, vz + pdz); if (pAbove && pAbove.indexOf('door') !== -1) { api.breakVoxel(vx + pdx, vy + 1, vz + pdz); removedKeys.push((vx + pdx) + ',' + (vy + 1) + ',' + (vz + pdz)); } if (pBelow && pBelow.indexOf('door') !== -1) { api.breakVoxel(vx + pdx, vy - 1, vz + pdz); removedKeys.push((vx + pdx) + ',' + (vy - 1) + ',' + (vz + pdz)); } break; } } } } removeOwners(api, removedKeys); api.patchState({ breakProgress: 0, breakTarget: null, _lastBrokenKey: key }); api.playSound('cdn/sfx-impact-stone.mp3', { volume: 0.6 }); api.particleBurst({ x: vx + 0.5, y: vy + 0.5, z: vz + 0.5 }, 'dust', { scale: 0.5 }); return; } api.patchState({ breakProgress: progress, breakTarget: breakTarget }); } else { api.patchState({ breakProgress: 0, breakTarget: null, _lastBrokenKey: null }); } } } else { if (s.breakProgress > 0 || s._lastBrokenKey) { api.patchState({ breakProgress: 0, breakTarget: null, _lastBrokenKey: null }); } } // Release right-click resets door lock if (!input.actions.placeBlock && s._doorPlacedHold) { api.patchState({ _doorPlacedHold: false }); } // Empty hand: right-click interacts with voxel doors var hotbar2 = s.hotbar || [1, 2, 3, 4, 5, 6, 7, 8]; var isEmptyHand = (s.hotbarSlot === hotbar2.length); if (input.actions.placeBlock && isEmptyHand) { if (!s._handInteractLock) { var ray3 = api.getPointerRay(input); if (ray3) { var hit3 = api.raycastVoxel(ray3.origin, ray3.direction, { maxDistance: REACH }); if (hit3 && hit3.voxel && hit3.materialId) { if (hit3.materialId.indexOf('door') !== -1) { var doorClosed3 = api.isVoxelSolid(hit3.voxel.x, hit3.voxel.y, hit3.voxel.z); api.interactWithVoxel(hit3.voxel.x, hit3.voxel.y, hit3.voxel.z); api.playSound(doorClosed3 ? 'cdn/sfx-minecraft-style-wooden-door-open-click.mp3' : 'cdn/sfx-minecraft-style-wooden-door-close-click.mp3', { volume: 0.5 }); } else if (hit3.materialId === 'b_sign') { var sx3 = hit3.voxel.x, sy3 = hit3.voxel.y, sz3 = hit3.voxel.z; var signKey3 = sx3 + ',' + sy3 + ',' + sz3; var signEntId3 = 'sign-' + sx3 + '-' + sy3 + '-' + sz3; var existingText3 = ''; try { var signSt3 = api.getObjectState(signEntId3); if (signSt3 && signSt3.text) existingText3 = signSt3.text; } catch(e) {} api.patchState({ signEditing: signKey3, signText: existingText3 }); api.showCursor(); } } } api.patchState({ _handInteractLock: true }); } return; } if (!input.actions.placeBlock && s._handInteractLock) { api.patchState({ _handInteractLock: false }); } // === BLOCK PLACING (right click) === if (input.actions.placeBlock) { if (s._doorPlacedHold) return; var lastPlaceTime = s._lastPlaceTime || 0; var now = api.getWallClockTimestamp(); var elapsed = (now - lastPlaceTime) / 1000; if (elapsed >= PLACE_COOLDOWN || elapsed < 0) { // Compute placement target inline (no dependency on update loop) var placeRay = api.getPointerRay(input); var placeHit = placeRay ? api.raycastVoxel(placeRay.origin, placeRay.direction, { maxDistance: REACH }) : null; var placeTarget = null; if (placeHit && placeHit.adjacentVoxel) { placeTarget = { x: placeHit.adjacentVoxel.x, y: placeHit.adjacentVoxel.y, z: placeHit.adjacentVoxel.z, hitNormalY: placeHit.normal ? placeHit.normal.y : 0, hitNormalX: placeHit.normal ? placeHit.normal.x : 0, hitNormalZ: placeHit.normal ? placeHit.normal.z : 0, hitLocalY: placeHit.position ? (placeHit.position.y - Math.floor(placeHit.position.y)) : 0, }; // Slab merging: if hitting same slab type from top/bottom, target the hit cell var selBlock = hotbar2[s.hotbarSlot || 0]; var selDef = selBlock ? voxel.BLOCKS[selBlock] : null; if (selDef && selDef.shape === 'slab' && placeHit.voxel) { var selMat = voxel.ID_TO_MATERIAL[selBlock]; if (placeHit.materialId === selMat && placeHit.normal && Math.abs(placeHit.normal.y) > 0.5) { placeTarget.x = placeHit.voxel.x; placeTarget.y = placeHit.voxel.y; placeTarget.z = placeHit.voxel.z; } } } if (!placeTarget) return; var bx = placeTarget.x, by = placeTarget.y, bz = placeTarget.z; var blockToPlace = hotbar2[s.hotbarSlot || 0]; if (!blockToPlace || !voxel.BLOCKS[blockToPlace]) return; var materialName = voxel.ID_TO_MATERIAL[blockToPlace]; if (!materialName) return; // Don't place inside player var playerPos = api.getProperty('feetPosition'); var px = Math.floor(playerPos.x), py1 = Math.floor(playerPos.y), py2 = py1 + 1; var pz = Math.floor(playerPos.z); if (bx === px && bz === pz && (by === py1 || by === py2)) return; // Check cell is empty var existingMat = api.getVoxelMaterial(bx, by, bz); var placeDef = voxel.BLOCKS[blockToPlace]; var isSlab = placeDef && placeDef.shape === 'slab'; var isDoor = placeDef && (placeDef.shape === 'door' || placeDef.shape === 'double_door'); var isDoubleDoor = placeDef && placeDef.shape === 'double_door'; // Slab merging if (isSlab && existingMat === materialName) { // Replace with full block equivalent var fullId = placeDef.fullBlock; if (fullId && voxel.ID_TO_MATERIAL[fullId]) { api.placeVoxel(bx, by, bz, voxel.ID_TO_MATERIAL[fullId]); } registerOwner(api, bx + ',' + by + ',' + bz); api.patchState({ _lastPlaceTime: api.getWallClockTimestamp() }); api.playSound('cdn/sfx-click-wood.mp3', { volume: 0.5 }); return; } if (existingMat !== null) { // Allow placing solid blocks into water/lava to displace it if (existingMat.indexOf('water') !== -1 || existingMat.indexOf('lava') !== -1) { api.breakVoxel(bx, by, bz); } else { return; // occupied by solid block } } // Door: validate empty cell above if (isDoor) { var aboveCheck = api.getVoxelMaterial(bx, by + 1, bz); if (aboveCheck !== null) return; if (bx === px && (by + 1 === py1 || by + 1 === py2) && bz === pz) return; } // Ladder: can't place on top/bottom, needs wall behind if (placeDef.shape === 'ladder') { if (Math.abs(placeTarget.hitNormalY || 0) > 0.9) return; } // Compute state for shaped blocks var cam = api.getCamera() || {}; var cameraYaw = cam.yaw || 0; var stateWord = 0; if (isSlab) { var half = 'bottom'; if (placeTarget.hitNormalY !== undefined && placeTarget.hitNormalY < 0) half = 'top'; else if (placeTarget.hitNormalY !== undefined && placeTarget.hitNormalY > 0) half = 'bottom'; else half = (placeTarget.hitLocalY !== undefined && placeTarget.hitLocalY > 0.5) ? 'top' : 'bottom'; stateWord = voxel.packState(blockToPlace, { half: half }); } else if (placeDef.shape === 'stairs') { stateWord = voxel.packState(blockToPlace, { yaw: cameraYaw + 180 }); } else if (placeDef.shape === 'ladder') { var lnx = placeTarget.hitNormalX || 0; var lnz = placeTarget.hitNormalZ || 0; var ladderYaw = 0; if (Math.abs(lnx) > Math.abs(lnz)) { ladderYaw = (lnx > 0) ? 270 : 90; } else { ladderYaw = (lnz > 0) ? 180 : 0; } stateWord = voxel.packState(blockToPlace, { yaw: ladderYaw }); } else if (isDoor) { stateWord = voxel.packState(blockToPlace, { yaw: cameraYaw, open: false }); } var isSign = placeDef && placeDef.shape === 'sign'; if (isSign) { var signNY = placeTarget.hitNormalY || 0; var signWall = Math.abs(signNY) < 0.5 ? 1 : 0; stateWord = voxel.packState(blockToPlace, { yaw: cameraYaw, wall: signWall }); } // Place the voxel if (stateWord > 0) { api.placeVoxel(bx, by, bz, materialName, stateWord); } else { api.placeVoxel(bx, by, bz, materialName); } // Register block ownership var placeKey = bx + ',' + by + ',' + bz; registerOwner(api, placeKey); // Door: place top cell too if (isDoor) { api.placeVoxel(bx, by + 1, bz, materialName, stateWord); registerOwner(api, bx + ',' + (by + 1) + ',' + bz); } // Double door: place partner pair with mirrored hinge if (isDoubleDoor) { var snapYaw = ((Math.round(cameraYaw / 90) * 90) % 360 + 360) % 360; var ppx = bx, ppz = bz; if (snapYaw === 0) ppx = bx + 1; else if (snapYaw === 90) ppz = bz - 1; else if (snapYaw === 180) ppx = bx - 1; else ppz = bz + 1; if (api.getVoxelMaterial(ppx, by, ppz) === null && api.getVoxelMaterial(ppx, by + 1, ppz) === null) { var partnerState = voxel.packState(blockToPlace, { yaw: cameraYaw, open: false, hinge: 1 }); api.placeVoxel(ppx, by, ppz, materialName, partnerState); api.placeVoxel(ppx, by + 1, ppz, materialName, partnerState); registerOwner(api, ppx + ',' + by + ',' + ppz); registerOwner(api, ppx + ',' + (by + 1) + ',' + ppz); } } var cd2 = isDoor ? 999 : PLACE_COOLDOWN; // Sign: spawn text entity facing the player (or flush against wall) if (isSign) { var snx = placeTarget.hitNormalX || 0; var sny = placeTarget.hitNormalY || 0; var snz = placeTarget.hitNormalZ || 0; var isWallSign = Math.abs(sny) < 0.5; // horizontal normal = wall placement var signEntId = 'sign-' + bx + '-' + by + '-' + bz; var signMetaYaw = 0; if (isWallSign) { if (Math.abs(snx) > Math.abs(snz)) { signMetaYaw = (snx > 0) ? 90 : 270; } else { signMetaYaw = (snz > 0) ? 0 : 180; } } else { var sYawBits = ((Math.round(cameraYaw / 22.5) % 16) + 16) % 16; signMetaYaw = sYawBits * 22.5; } // Persist sign meta so it survives refresh api.emit('setSignMeta', { key: bx + ',' + by + ',' + bz, yaw: signMetaYaw, wall: isWallSign, }); if (!isWallSign) { // FLOOR SIGN — original behavior, 16-direction yaw from camera var signYawBits = ((Math.round(cameraYaw / 22.5) % 16) + 16) % 16; var signYawDeg = signYawBits * 22.5; var boardBottomY = by + 0.5; var signRad = signYawDeg * Math.PI / 180; var offX = -Math.sin(signRad) * 0.01; var offZ = -Math.cos(signRad) * 0.01; api.spawn(signEntId, { tags: ['sign-entity'], properties: { feetPosition: { x: bx + 0.5 + offX, y: boardBottomY, z: bz + 0.5 + offZ }, rotation: { yaw: signYawDeg }, sign: { width: 0.8, height: 0.45, depth: 0.08, padding: [0.04, 0.03], material: { texture: 'cdn/texture-pixel-wooden-plank-pattern-kbgyk0q6.webp', color: 'oklch(0.75 0.06 70)', roughness: 0.9, }, text: { content: '', color: 'oklch(0.12 0 0)', size: 0.06, maxWidth: 0.7, anchor: [0.5, 0.5], offset: [0, -0.115, 0] }, }, }, state: { text: '', signX: bx, signY: by, signZ: bz }, }); } else { // WALL SIGN — flat against the wall, no post, faces outward // Yaw: face away from wall (outward toward the normal) var wallSignYaw = 0; if (Math.abs(snx) > Math.abs(snz)) { wallSignYaw = (snx > 0) ? 90 : 270; } else { wallSignYaw = (snz > 0) ? 0 : 180; } // Position: flush against the wall face var wsx = bx + 0.5 - snx * 0.46; var wsy = by + 0.28; var wsz = bz + 0.5 - snz * 0.46; api.spawn(signEntId, { tags: ['sign-entity'], properties: { feetPosition: { x: wsx, y: wsy, z: wsz }, rotation: { yaw: wallSignYaw }, sign: { width: 0.8, height: 0.45, depth: 0.08, padding: [0.04, 0.03], material: { texture: 'cdn/texture-pixel-wooden-plank-pattern-kbgyk0q6.webp', color: 'oklch(0.75 0.06 70)', roughness: 0.9, }, text: { content: '', color: 'oklch(0.12 0 0)', size: 0.06, maxWidth: 0.7, anchor: [0.5, 0.5], offset: [0, -0.115, 0] }, }, }, state: { text: '', signX: bx, signY: by, signZ: bz }, }); } } // Liquids: try pool fill first, then trigger normal spread if (materialName === 'b_water' || materialName === 'b_lava') { var isW = materialName === 'b_water'; var poolFills = tryPoolFill(api, bx, by, bz, isW ? 'water' : 'lava'); if (poolFills.length > 0) { // Place all fill blocks as sources for (var pfi = 0; pfi < poolFills.length; pfi++) { api.placeVoxel(poolFills[pfi][0], by, poolFills[pfi][1], materialName); } // Register pool source on voxel-world var poolKey = bx + ',' + by + ',' + bz; var fillKeys = []; for (var pfj = 0; pfj < poolFills.length; pfj++) { fillKeys.push(poolFills[pfj][0] + ',' + by + ',' + poolFills[pfj][1]); } api.emit('registerPool', { sourceKey: poolKey, fillKeys: fillKeys }); } else { // Normal liquid — trigger spread via onInteract api.interactWithVoxel(bx, by, bz); } } // Torch: spawn visual entities (stick + flame) and point light + fire particles if (materialName === 'b_torch') { var tnx = placeTarget.hitNormalX || 0; var tny = placeTarget.hitNormalY || 0; var tnz = placeTarget.hitNormalZ || 0; var isWallTorch = Math.abs(tny) < 0.5; // horizontal normal = wall placement // Persist torch meta so it survives refresh api.emit('setTorchMeta', { key: bx + ',' + by + ',' + bz, wall: isWallTorch, nx: isWallTorch ? (Math.abs(tnx) > Math.abs(tnz) ? (tnx > 0 ? 1 : -1) : 0) : 0, nz: isWallTorch ? (Math.abs(tnz) >= Math.abs(tnx) ? (tnz > 0 ? 1 : -1) : 0) : 0, }); // Tilt angle for wall torches (degrees) var TILT = 22; var tiltRad = TILT * Math.PI / 180; var sinT = Math.sin(tiltRad); // ~0.375 var cosT = Math.cos(tiltRad); // ~0.927 // Base center of the voxel cell var tcx = bx + 0.5, tcz = bz + 0.5; // Wall torch offsets: shift base toward wall, lean outward var wallOffX = 0, wallOffZ = 0; // position offset toward wall var wallTiltYaw = 0; // rotation yaw for wall direction var wallTiltPitch = 0; // pitch = lean angle if (isWallTorch) { // Normal points AWAY from the wall, so offset AGAINST the normal (toward wall) wallOffX = -tnx * 0.52; wallOffZ = -tnz * 0.52; // Yaw: face away from wall (toward the normal direction) // Coordinate system: yaw 0 = -Z, 90 = -X, CCW if (Math.abs(tnx) > Math.abs(tnz)) { wallTiltYaw = (tnx > 0) ? 270 : 90; // +X normal → face +X → yaw 270; -X → yaw 90 } else { wallTiltYaw = (tnz > 0) ? 180 : 0; // +Z normal → face +Z → yaw 180; -Z → yaw 0 } wallTiltPitch = -TILT; // lean outward (tip away from wall) } // Stick dimensions var stickH = 0.5; var flameH = 0.19; if (!isWallTorch) { // FLOOR TORCH — original upright placement var stickId = 'torch-stick-' + bx + '-' + by + '-' + bz; api.spawn(stickId, { tags: ['torch-part'], properties: { feetPosition: { x: tcx, y: by, z: tcz }, primitive: { kind: 'box', width: 0.125, height: stickH, depth: 0.125 }, material: { texture: 'cdn/texture-pixel-wooden-plank-pattern-kbgyk0q6.webp?modify=brighter-very-slightly-desaturated', color: '#c4a55a', roughness: 0.9, }, physics: 'none', }, state: { torchX: bx, torchY: by, torchZ: bz }, }); var flameId = 'torch-flame-' + bx + '-' + by + '-' + bz; api.spawn(flameId, { tags: ['torch-part'], properties: { feetPosition: { x: tcx, y: by + stickH, z: tcz }, primitive: { kind: 'box', width: 0.125, height: flameH, depth: 0.125 }, material: { texture: '/cdn/texture-pixelated-golden-glowstone-block-mda4ozhy.webp', color: '#D4A830', emissive: 'oklch(0.85 0.15 85)', emissiveIntensity: 1.2, }, physics: 'none', }, state: { torchX: bx, torchY: by, torchZ: bz }, }); var fxId = 'torch-fx-' + bx + '-' + by + '-' + bz; api.spawn(fxId, { tags: ['torch-part'], properties: { feetPosition: { x: tcx, y: by + stickH + 0.1, z: tcz }, light: { kind: 'point', color: '#FFB830', intensity: 2.0, distance: 12 }, particles: { textures: 'fire', rate: 8, lifetimeMin: 0.2, lifetimeMax: 0.5, startSpeedMin: 0.1, startSpeedMax: 0.3, startSizeMin: 0.04, startSizeMax: 0.08, gravity: { x: 0, y: 0.5, z: 0 }, shape: { kind: 'point' }, blend: 'add', maxParticles: 15, }, physics: 'none', }, state: { torchX: bx, torchY: by, torchZ: bz }, }); } else { // WALL TORCH — tilted, base against wall // Calculate tilted positions manually // Stick base (bottom of stick) is offset toward wall, near cell bottom + 0.2 var baseY = by + 0.15; var baseCX = tcx + wallOffX; var baseCZ = tcz + wallOffZ; // Stick tip: from base, go up by stickH*cos(tilt) and out by stickH*sin(tilt) var tipDX = tnx * stickH * sinT; var tipDY = stickH * cosT; var tipDZ = tnz * stickH * sinT; // Stick center (for feetPosition, which is bottom-center of the box) // feetPosition should be at the base of the stick // With rotation, the box will tilt from its center, so we position the center var stickCX = baseCX + tipDX * 0.5; var stickCY = baseY + tipDY * 0.5; var stickCZ = baseCZ + tipDZ * 0.5; // Flame position: at the tip of the stick var flameCX = baseCX + tipDX; var flameCY = baseY + tipDY; var flameCZ = baseCZ + tipDZ; var stickId = 'torch-stick-' + bx + '-' + by + '-' + bz; api.spawn(stickId, { tags: ['torch-part'], properties: { feetPosition: { x: stickCX - tnx * 0.12, y: stickCY - stickH * 0.5, z: stickCZ - tnz * 0.12 }, rotation: { yaw: wallTiltYaw, pitch: wallTiltPitch }, primitive: { kind: 'box', width: 0.125, height: stickH, depth: 0.125 }, material: { texture: 'cdn/texture-pixel-wooden-plank-pattern-kbgyk0q6.webp?modify=brighter-very-slightly-desaturated', color: '#c4a55a', roughness: 0.9, }, physics: 'none', }, state: { torchX: bx, torchY: by, torchZ: bz }, }); var flameId = 'torch-flame-' + bx + '-' + by + '-' + bz; api.spawn(flameId, { tags: ['torch-part'], properties: { feetPosition: { x: flameCX - tnx * 0.03, y: flameCY - 0.02, z: flameCZ - tnz * 0.03 }, rotation: { yaw: wallTiltYaw, pitch: wallTiltPitch }, primitive: { kind: 'box', width: 0.125, height: flameH, depth: 0.125 }, material: { texture: '/cdn/texture-pixelated-golden-glowstone-block-mda4ozhy.webp', color: '#D4A830', emissive: 'oklch(0.85 0.15 85)', emissiveIntensity: 1.2, }, physics: 'none', }, state: { torchX: bx, torchY: by, torchZ: bz }, }); var fxId = 'torch-fx-' + bx + '-' + by + '-' + bz; api.spawn(fxId, { tags: ['torch-part'], properties: { feetPosition: { x: flameCX - tnx * 0.03, y: flameCY + 0.08, z: flameCZ - tnz * 0.03 }, light: { kind: 'point', color: '#FFB830', intensity: 2.0, distance: 12 }, particles: { textures: 'fire', rate: 8, lifetimeMin: 0.2, lifetimeMax: 0.5, startSpeedMin: 0.1, startSpeedMax: 0.3, startSizeMin: 0.04, startSizeMax: 0.08, gravity: { x: 0, y: 0.5, z: 0 }, shape: { kind: 'point' }, blend: 'add', maxParticles: 15, }, physics: 'none', }, state: { torchX: bx, torchY: by, torchZ: bz }, }); } } api.patchState({ _lastPlaceTime: api.getWallClockTimestamp(), _doorPlacedHold: isDoor || false }); api.playSound('cdn/sfx-click-wood.mp3', { volume: 0.5 }); } } } export function update(dt, api) { var s = api.getState(); // Throttle visual updates to every 3rd tick var vizTick = (s._vizTick || 0) + 1; if (vizTick < 3) { api.patchEphemeralState({ _vizTick: vizTick }); return; } api.patchEphemeralState({ _vizTick: 0 }); // Track chat message count for fade timing var vwResults = api.query({ tags: ['voxel-world'] }); var vwState = vwResults.length > 0 ? vwResults[0].state : {}; var chatCount = (vwState.chatMessages || []).length; var lastChatCount = s._lastChatCount || 0; var chatShowUntil = s._chatShowUntil || 0; var nowTs = api.getWallClockTimestamp(); if (chatCount !== lastChatCount) { chatShowUntil = nowTs + 10000; api.patchEphemeralState({ _lastChatCount: chatCount, _chatShowUntil: chatShowUntil, _chatNow: nowTs }); } else { api.patchEphemeralState({ _chatNow: nowTs }); } var cam = api.getCamera(); if (!cam) return; var dir = api.directionFromYawPitch(cam.yaw, cam.pitch); var origin = api.getAimOrigin(); var hit = api.raycastVoxel(origin, dir, { maxDistance: REACH }); var highlightId = 'highlight-' + api.id; var previewId = 'preview-' + api.id; // ── Highlight aimed block ── if (hit && hit.voxel) { var newKey = hit.voxel.x + ',' + hit.voxel.y + ',' + hit.voxel.z; if (newKey !== s._aimedBlock) { api.setObjectProperty(highlightId, 'visible', true); api.setObjectProperty(highlightId, 'feetPosition', { x: hit.voxel.x + 0.5, y: hit.voxel.y, z: hit.voxel.z + 0.5, }); // Look up block info for HUD tooltip var aimedMat = hit.materialId || ''; var aimedBlockId = voxel.MATERIAL_TO_ID[aimedMat] || 0; var aimedDef = aimedBlockId ? voxel.BLOCKS[aimedBlockId] : null; var aimedName = aimedDef ? aimedDef.name : ''; var aimedHex = aimedDef ? (aimedDef.hex || '#888') : '#888'; var ws = getWorldState(api); var ownerData = (ws.blockOwners || {})[newKey]; var aimedOwner = ownerData ? ownerData.name : ''; api.patchEphemeralState({ _aimedBlock: newKey, _aimedBlockName: aimedName, _aimedBlockOwner: aimedOwner, _aimedBlockHex: aimedHex }); } } else if (s._aimedBlock) { api.setObjectProperty(highlightId, 'visible', false); api.patchEphemeralState({ _aimedBlock: null, _aimedBlockName: '', _aimedBlockOwner: '', _aimedBlockHex: '' }); } // ── Placement preview ── var hotbar = s.hotbar || [1, 2, 3, 4, 5, 6, 7, 8]; var isEmptyHand = (s.hotbarSlot === hotbar.length); var selectedBlock = isEmptyHand ? 0 : hotbar[s.hotbarSlot || 0]; var def = selectedBlock ? voxel.BLOCKS[selectedBlock] : null; if (hit && hit.adjacentVoxel && def) { var tx = hit.adjacentVoxel.x, ty = hit.adjacentVoxel.y, tz = hit.adjacentVoxel.z; var hnY = hit.normal ? hit.normal.y : 0; var hnX = hit.normal ? hit.normal.x : 0; var hnZ = hit.normal ? hit.normal.z : 0; var hlY = hit.position ? (hit.position.y - Math.floor(hit.position.y)) : 0; // Slab merging preview if (def.shape === 'slab' && hit.voxel) { var matName = voxel.ID_TO_MATERIAL[selectedBlock]; if (hit.materialId === matName && Math.abs(hnY) > 0.5) { tx = hit.voxel.x; ty = hit.voxel.y; tz = hit.voxel.z; } } var py = ty, ph = 1, pw = 1, pd = 1; var px = tx + 0.5, pz = tz + 0.5; if (def.shape === 'slab') { ph = 0.5; if (hnY < 0) py = ty + 0.5; else if (hnY > 0) py = ty; else py = (hlY > 0.5) ? ty + 0.5 : ty; } else if (def.shape === 'ladder') { if (Math.abs(hnY) > 0.9) { api.setObjectProperty(previewId, 'visible', false); return; } if (Math.abs(hnX) > Math.abs(hnZ)) { pw = 0.1; pd = 1; px = (hnX > 0) ? tx + 0.95 : tx + 0.05; } else if (Math.abs(hnZ) > 0) { pw = 1; pd = 0.1; pz = (hnZ > 0) ? tz + 0.95 : tz + 0.05; } } api.setObjectProperty(previewId, 'visible', true); api.setObjectProperty(previewId, 'feetPosition', { x: px, y: py, z: pz }); api.setObjectProperty(previewId, 'primitive', { kind: 'box', width: pw, height: ph, depth: pd }); api.setObjectProperty(previewId, 'material', { texture: def.texture, color: def.color, opacity: 0.35, transparent: true, depthWrite: false, }); } else { api.setObjectProperty(previewId, 'visible', false); } }