介绍
Voxel-hello-world 是一个 npm 包，它提供了一种快速创建三维场景的方法。如果你想学习如何在前端创建 3D 场景，这是一个非常好的起点。
安装
使用 npm 进行安装：
npm install voxel-hello-world --save
使用
创建一个 HTML 文件，并添加一个 <canvas> 元素。在你的 JavaScript 代码中，引入这个库并创建一个 voxel-world 实例：
-- -------------------- ---- ------- --------- ----- ------ ------ ----- ---------------- ------------------------ ---------- ------- ------ ------- ------------------- ------- -------------------------------------------------------------- -------- --- ---------- - ----------------------------- --- ---- - ------------ -- --------- --- ----------------------- -- ------ ------ --- -------------------------- -- ------ --------- ------- -------展开代码
选项
当创建游戏实例时，可以向其传递一些选项。下面是一些重要的选项：
texturePath（默认为/textures/）：指定贴图文件夹的路径。materials（默认为 Voxel.js 的默认值）：覆盖默认的材质。generate（默认为 Voxel.js 的默认生成器）：覆盖默认的生成器。startingPosition（默认为[0, 20, 0]）：起始位置。startingInventory（默认为空）：起始物品。
接口
Game 对象暴露了以下一些接口来方便控制场景：
game.addToInventory(item)：将一个物品添加到玩家的物品栏中。game.createAdjacent([x,y,z])：在给定的位置旁边创建一个方块。game.getBlock([x,y,z])：返回给定位置的方块 ID。game.getBlockType([x,y,z])：返回给定位置的方块类型。game.getMaterial([x,y,z])：返回给定位置的材质。game.setBlock([x,y,z], id)：在给定位置设置方块 ID。game.setBlockType([x,y,z], type)：在给定位置设置方块类型。game.setMaterial([x,y,z], material)：在给定位置设置材质。
示例代码
以下示例代码演示了如何添加一个简单的方块，并为玩家设置一个初始位置：
-- -------------------- ---- ------- --- ---------- - ----------------------------- --- ---- - ------------ ----------------- --- ---- -- --- ---------------------------- ---- ----------------- -- --- --------- ----------------------- --------------------------展开代码
以上代码做了以下几件事情：
- 将玩家的初始位置设置为
[0, 100, 0]。 - 将 10 个砖块添加到玩家的物品栏中。
- 在位置
[0, 0, 0]处添加一个砖块。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/5f2a6f373b0ab45f74a8baee
