**This is an old revision of the document!**

  • compare(side:number[, fuzzy:boolean=false]):boolean
    将机器人指定方向处的方块与当前选定槽位中的物品进行比较,返回它们是否相同。方块相同的条件是类型和元数据相同,不检查额外物品堆信息。空方块被视为空气方块,不能与物品栏的空槽位进行比较。detect() 函数可用于确定机器人前面是否有方块。
    对于掉落不同物品而非本身的方块,compare()方法不起作用(例如:钻石矿石掉落钻石物品);对这种情况,请使用精准采集获取原方块进行比较。

  • drop(side:number[, count:number]):boolean
    从物品栏的当前选定槽位中提取并丢弃指定数量的物品。若丢弃了至少一个物品,则返回 true,否则返回 false。若机器人前面的方块为物品容器,机器人会尝试把物品放入容器中。 若该容器不能接收该物品,物品不会被丢弃在世界中(操作将会执行失败并返回 false)。机器人本身被视为带物品栏的方块,并且可以使用drop()函数将物品移入其中。drop() 函数不适用非物品容器,例如流体储罐(use() 函数适用于这些情况)。

  • suck(side:number[, count:number]):boolean
    尝试拾取指定数量的物品并将其置于当前选定槽位中。若当前选定槽位被占用,则物品将被置于第一个可用槽位中。返回值为拾取的物品数量,其他情况返回false