Sistema de blocos voxel estilo Minecraft: registry de tipos, mundo com chunks, instanced rendering, física opcional, serialização. Código em scripts/.
Quando usar (gatilhos concretos)
- "Sistema de blocos voxel Three.js"
- "Three.js Minecraft blocks"
- "Three.js block registry"
- "Three.js instanced mesh blocks"
- "Blocos estilo Minecraft Three.js"
Quando NÃO usar
- Composição geral de cena → use
threejs-scene-composer - Shaders customizados → use
threejs-shader-effects - Deploy → use
threejs-deploy-pipeline - Patterns responsivos → use
threejs-responsive-patterns - Config constants → use
threejs-config-constants
Os 5 Módulos (resumo — código em scripts/)
1. BlockRegistry (block-registry.js) — registerBlockType(id, {geometry, material, solid/transparent/collidable, tint/emissive, isFluid/isPlant/isTileEntity, states, renderType, drops, harvestTool/Level, onPlace/onBreak/onInteract/onTick, tags}) + filtros (getByTag, getSolidBlocks, getTransparentBlocks) + ~30 defaults: sólidos (grass, stone, dirt, obsidian, bedrock), minérios (coal/iron/gold/diamond/emerald), madeira, plantas, fluidos (water/lava), funcionais (crafting/furnace/chest), portal (frame/block), decorativos (torch/lantern/glowstone).
import { BlockRegistry } from './scripts/block-registry.js';
const registry = new BlockRegistry();
registry.registerBlockType('grass_block', { color: 0x4a7c2e, tags: ['natural'] });
2. VoxelWorld (voxel-world.js) — chunks 16×256 (getOrCreateChunk, terreno procedural + ores), setBlock/getBlock/removeBlock (com callbacks onPlace/onBreak), raycast voxel com face atingida, mesh por chunk via InstancedMesh agrupado por tipo, getVisibleChunks + render (rebuild dirty, remove distantes), serialize/deserialize JSON.
3. InstancedBlockManager (instanced-blocks.js) — até 100k instâncias por tipo, addBlock/removeBlock (swap-remove O(1)), setBlockBatch, clear (dispose geometry/material).
4. VoxelPhysics (voxel-physics.js, opcional Rapier.js) — rigid bodies dinâmicos/kinemáticos, cuboid collider 1×1×1 (restitution/friction, bouncy tag), step(delta), raycast Rapier. Degrada graciosamente sem Rapier.
5. VoxelSerializer (serialization.js) — serialize/deserialize, saveToFile/loadFromFile (download JSON), compress/decompress (LZ-string).
Checklist de Entrega
-
BlockRegistrycom 50+ tipos padrão -
VoxelWorldcom chunks (16x256) + raycast voxel-preciso -
InstancedBlockManagerpara rendering massivo -
VoxelPhysicscom Rapier.js (opcional) -
VoxelSerializercom save/load + compressão - Block states + tile entities + InstancedMesh otimizado
Adapters (Por Plataforma)
adapters/