前置插件：世界交互

介绍

世界交互主要提供了一些获取世界信息、操作机器人使其与游戏交互的接口。

获取方式

• 类是插件：

  class MyPlugin(Plugin):
      ...
  
  def __init__(self, frame):
      super().__init__(frame)
      self.ListenPreload(self.on_preload)
  
  def on_preload(self):
      chatbar = self.GetPluginAPI("聊天栏菜单")

接口

get_structure

def get_structure(
    position: tuple[int, int, int], size: tuple[int, int, int]
) -> Structure

• 获取指定坐标处的指定尺寸的结构，可能需要零点几秒的时间或者更久。

• 参数：

  • position (tuple[int, int, int])： 结构起点坐标
  • size (tuple[int, int, int])： 结构尺寸

• 参数：

  参数名	类型	说明
  position	tuple[int, int, int]	结构起点坐标
  size	tuple[int, int, int]	结构尺寸

• 返回:

  • Structure: 结构对象
  • 对于这个结构对象，可以用以下方法获取其中包含的信息：
    • get_block()

    def get_block(self, position: tuple[int, int, int]) -> Block

    • 获取结构中相对坐标处的方块。
    • 参数：
      • position (tuple[int, int, int])： 方块在结构中的相对坐标
    • 返回：
      • Block: 方块对象
      • Block 对象拥有如下信息：
        • name (str)： 方块 ID，如 minecraft:air
        • state (dict[str, Any])： 方块状态
        • val (int)： 方块特殊值
        • version (int)： 此方块的版本
        • metadata (Any | None)： 方块的附带 NBT 信息

make_packet_command_block_update

def make_packet_command_block_update(
    position: tuple[int, int, int],
    command: str,
    mode: int = 0,
    need_redstone: bool = False,
    tick_delay: int = 0,
    conditional: bool = False,
    name: str = "",
    should_track_output: bool = True,
    execute_on_first_tick: bool = True,
) -> dict[str, Any]

• 创建一个更新命令方块内容的数据包。

• 参数：

  参数名	类型	说明
  position	tuple[int, int, int]	命令方块的坐标
  command	str	命令方块中的指令
  mode	int	命令方块的模式，默认为 0，0=脉冲型，1=循环型，2=连锁型
  need_redstone	bool	是否为需要红石信号激活，默认为 False
  tick_delay	int	命令方块的执行间隔，默认为 0
  conditional	bool	是否为条件型命令方块，默认为 False
  name	str	命令方块的显示名称，默认为 ""
  should_track_output	bool	是否记上一次输出，默认为 True
  execute_on_first_tick	bool	是否在第一次执行时立刻执行，默认为 True

place_command_block()

def place_command_block(
    command_block_update_packet,
    facing=0,
    limit_seconds=0.0,
    limit_seconds2=0.0,
    in_dim="overworld",
)

• 放置一个命令方块。

• 参数：

  参数名	类型	说明
  command_block_update_packet	dict[str, Any]	使用 make_packet_command_block_update() 创建的命令方块数据包
  facing	int	命令方块的朝向，默认为 0
  limit_seconds	float	从tp到对应坐标至放置命令方块的延迟，默认为 0.5
  limit_seconds2	float	从放置方块到写入命令的延迟，默认为 0.5
  in_dim	str	放置命令方块的维度，默认为 "overworld"