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

  • name():string
    获取机器人的名称。

  • swing(side:number):boolean[, string]
    让机器人使用当前工具槽位装备的物品与正前方的方块或空间交互。如果成功则返回 true（可能需要时间，具取决于与其交互的方块，例如黑曜石需要一些时间来挖掘）。如果执行失败则返回false以及失败原因。

  • use(side: number[, sneaky: boolean[, duration: number]]): boolean[, string]
    尝试以与玩家右键单击相同的方式使用当前装备在工具槽位的物品。
    side - 若给定，则机器人仅尝试在指定面上“右键单击”，否则机器人会尝试所有可能的面。请查阅sides(方向) API以获取可能的方向列表。
    sneaky - 若设置为true，机器人将会模拟玩家的潜行右键单击（如同玩家在右键单击时按住shift键一样）。若设置为true，某些物品（例如桶）的行为会有所不同。
    duration - 使用该物品的时间。这在使用弓等需要蓄力的物品时很有用。
    返回值：若机器人可以与其前面的方块或实体交互，则返回 true，否则返回 false。若成功，会有第二个返回值，代表机器人交互的内容，可能取值为下列之一：block_activated（激活方块）、item_placed（放置物品）、item_used（使用物品）、item_interacted（与物品互动）、air（空气）。
    此函数用途非常广泛，因为机器人可以模拟右键单击大多数物品。在这方面机器人与玩家的唯一区别是机器人不能使用明确要求用户是实体的物品，因为机器人是方块。所以喝药水、吃食物或扔末影珍珠都会失败。 此函数的第二个返回值可用来判断右键单击的结果。有时候不一定能明显看出一个物品会返回哪个值，因此需要事先测试。还需注意，虽然机器人不受有害药水的影响，但它们可能会被爆炸摧毁，因此在使用此函数放置、投掷或激活任何形式的炸药时要小心。
    第二个返回值的可能值有：
    • block_activated - 某个方块被激活（例如拉杆、开关以及门）
    • item_interacted - 装备的工具与世界进行了互动，例如在羊身上使用剪刀。
    • item_placed - 某个物品被放置到了世界中。此返回值不一定由可放置的方块触发，其他会导致方块或实体出现在世界上的物品也会触发（例如燧石或刷怪蛋）。
    • item_used - 装备的物品被激活，例如喷溅式药水。
    • air - 当前装备的物品需要目标才能使用，但并不存在。请注意如果你的机器人有天使升级，此返回值将永远不会出现，但一些操作可能仍然无效果。

  • place(side: number[, sneaky: boolean]): boolean[, string]
    尝试将物品栏中前选定槽位中的方块放置在机器人的指定方向（若支持此方向）。若sneaky设置为true，那么机器人将会模拟潜行放置（按住shift点击）。若成功放置则返回 true，若操作失败则返回 false。若使用不支持的值作为参数，则操作将会失败，并返回失败原因。

  • getLightColor():number
    获取当前活动指示灯（机器人）或机翼灯（无人机）设定的颜色，形式为整数编码RGB值（0xRRGGBB）。

  • setLightColor(value:number):number
    将活动指示灯（机器人）或机翼灯（无人机）的颜色设定为给定的整数编码RGB值（0xRRGGBB）。