用途
threejs-voxel-block-system 是一个用于在 Three.js 中构建 Minecraft 风格体素方块系统的技能,围绕方块注册、分块世界管理、实例化渲染、可选物理和存档序列化提供模块化方案。它适合需要方块摆放、破坏、射线拾取和存档的体素交互项目。
主要能力
1. 方块注册表 BlockRegistry
文件为 scripts/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});支持按标签、固体、透明等条件过滤(getByTag、getSolidBlocks、getTransparentBlocks);内置约 30 个默认方块,覆盖固体(grass、stone、dirt、obsidian、bedrock)、矿物(coal/iron/gold/diamond/emerald)、木材、植物、流体(water/lava)、功能方块(crafting/furnace/chest)、传送门(frame/block)、装饰(torch/lantern/glowstone)。
示例:
import { BlockRegistry } from './scripts/block-registry.js';
const registry = new BlockRegistry();
registry.registerBlockType('grass_block', { color: 0x4a7c2e, tags: ['natural'] });
2. 体素世界 VoxelWorld
文件为 scripts/voxel-world.js。按 16×256 的区块组织世界,提供 getOrCreateChunk、程序化地形与矿物生成、setBlock/getBlock/removeBlock(带 onPlace/onBreak 回调)、精确到体素面的射线检测、按方块类型分组的 InstancedMesh 区块网格、getVisibleChunks 与 render(重建脏区块、移除远处区块)、JSON 序列化/反序列化。
3. 实例化管理 InstancedBlockManager
文件为 scripts/instanced-blocks.js。每种类型最多支持 100k 实例,提供 addBlock/removeBlock(swap-remove,O(1))、setBlockBatch、clear(释放几何体与材质)。
4. 物理 VoxelPhysics(可选 Rapier.js)
文件为 scripts/voxel-physics.js。支持动态/运动学刚体、1×1×1 长方体碰撞体(可设 restitution/friction,bouncy 标签)、step(delta)、Rapier 射线检测;未安装 Rapier 时可降级运行。
5. 序列化 VoxelSerializer
文件为 serialization.js。提供 serialize/deserialize、saveToFile/loadFromFile(下载 JSON)、compress/decompress(LZ-string)。
使用方式
技能说明以触发场景组织,例如“Three.js 体素方块系统”“Three.js Minecraft blocks”“Three.js block registry”“Three.js instanced mesh blocks”。各模块代码位于 scripts/ 目录,按需引入;物理模块依赖 Rapier.js 为可选。交付清单包括:BlockRegistry 50+ 标准类型、带区块与体素精确射线的 VoxelWorld、大规模渲染的 InstancedBlockManager、可选 Rapier 物理、带保存/加载与压缩的 VoxelSerializer,以及方块状态、tile entity 和优化 InstancedMesh。
适用场景
- 沙盒建造与方块编辑类 Three.js 项目
- 可破坏地形与体素世界的渲染与存档
- 需要方块类型注册、状态与掉落/采集规则的游戏原型
限制与边界
该技能不覆盖整体场景组织、自定义着色器、部署流水线和响应式模式等,这些场景分别指向 threejs-scene-composer、threejs-shader-effects、threejs-deploy-pipeline、threejs-responsive-patterns 等。物理功能需额外引入 Rapier.js,未安装时功能降级。具体收费、平台支持与性能实测数据暂未提供。