猫史档案馆

哈喽大家好！这里是贝壳

岛三现在日渐趋向代码，所以现在想要继续在岛三混——除非你是资深级别的建筑师，否则就要“两行都学”啦！

一直都想找个机会学代码，一开开发API看不懂？没关系！渣·渣·贝·壳带你“从入门到入土”！

（当然，贝壳也是初学，如果有大佬光临寒帖还请多多指导）

好！现在我们步入正题

由于贝壳也没有啥教材，又是贴近box3学的，所以就以API为教材，网址不多说了吧

开发API在开头就写到了这样一段代码：

// 当玩家进入游戏
world.onPlayerJoin(({ entity }) => {
    // 如果玩家接触到了世界中的方块
    entity.onVoxelContact(({ x, y, z }) => {
        // 将方块变成空气
        voxels.setVoxel(x, y, z, 0);
    });
});

console.log('Welcome to Box 3!');

这里我们只看最后一句没有注释的——我们可以从中提取到的有效信息就是console.log()这几个奇怪的字母组合，经过贝壳举一反三的强 大能力，得知：console.log()可以在控制台输出括号内的内容！（当然如果输出字符的话别忘了加引号）

这玩意好像在创作中没啥用，不过万一有用了呢

下面我们进入真正的正文：API第一部分：World

开头介绍了World这个东西，大家可以自己去看；今天我们解决目录中的Basics部分

Basics基础

1.world.projectName

这个（函数？）是可以放到刚刚那个console.log()的括号里的，可以输出地图的名称；但如果你想在这里更改地图名称就不行了。

2.world.onTick

这玩意也没啥用，但是在初学的时候给我们曾加成就感还是可以的。这个（函数？）API中写的比较明白，就是地图一开始运行（准确地说是打开）就开始一个tick一个tick的“数数”，没喵ms“数”一次，console.log(world.onTick)可以在控制台输出当前地图的tick数。API中还给出了一个重复输出tick数的代码

// 监听此事件，会在控制台持续输出 tick 计数
world.onTick(({ tick }) => {
    console.log('tick ' + tick);
});

这里我们就要接触到nodejs的语法了：我们可以看到这里有一堆“没用”的小括号，大括号，甚至还有“=>”这个跟传送带一样的玩意。编写代码时该怎么输入它们呢？贝壳给大家支个招，我们以world.onTick为例：

最后我们把多余的换行去掉，就是这样：

world.onChat(({tick}) =>{
//此处输入代码
})

3.world.currentTick

它和world.projectName是一样的，可以用console.log()输出，输出当前地图的tick计数，省去了用world.onTick的诸多麻烦

好啦！本期教程到此结束！大家学会了吗

——————————————THE END——————————————