数据类型

这里列出了 LocationAPI 提供的数据类型,它们可以帮助你更轻松地定位玩家和管理位置。

Point2D(二维点)

表示一个二维点 (x, z)

class location_api.Point2D(x: float, z: float)[源代码]

使用 x 和 z 坐标定义一个二维点。

这个类表示一个二维平面中的点,具有 x 和 z 坐标。它使用浮点精度来表示坐标值。

x: float

该点的 x 坐标。

z: float

该点的 z 坐标。

distance_to(point: Self) float[源代码]

计算该点和另一个点之间的欧几里德距离。

参数:

point -- 用于计算距离的另一个二维点。

返回:

该点和另一个点之间的欧几里德距离。

distance2d_to(point: Point2D | Point3D) float[源代码]

计算该点和另一个点之间的平面欧几里德距离。

参数:

point -- 用于计算距离的另一个二维或三维点。

返回:

该点和另一个点之间的平面欧几里德距离。

classmethod from_point3d(point: Point3D) Self[源代码]

从一个三维点实例创建一个二维点实例。

参数:

point -- 用于创建二维点的三维点实例。

返回:

一个二维点实例

to_point3d(y: float) Point3D[源代码]

从一个二维点实例和作为高度的 y 坐标创建一个三维点实例。

参数:

y -- 三维点的高度。

返回:

一个三维点实例。

Point3D(三维点)

表示一个三维点 (x, y, z)

class location_api.Point3D(x: float, y: float, z: float)[源代码]

使用 x、y、z 坐标定义一个三维点。

这个类表示一个三维平面中的点,具有 x、y、z 坐标。它使用浮点精度来表示坐标值。

x: float

该点的 x 坐标。

y: float

该点的 y 坐标。

z: float

该点的 z 坐标。

distance_to(point: Self) float[源代码]

计算该点和另一个点之间的欧几里德距离。

参数:

point -- 要计算距离的另一个三维点。

返回:

该点和另一个点之间的欧几里德距离。

distance2d_to(point: Point3D | Point2D) float[源代码]

计算该点和另一个点之间的平面欧几里德距离。

参数:

point -- 用于计算距离的另一个二维或三维点。

返回:

该点和另一个点之间的平面欧几里德距离。

height_to(point: Self) float[源代码]

计算该点与另一个点的高度差。

参数:

point -- 要计算高度差的另一个三维点。

返回:

该点与另一个点的高度差。

classmethod from_point2d(point: Point2D, y: float) Self[源代码]

从一个二维点和一个高度创建一个三维点。

参数:
  • point -- 要创建三维点的二维点。

  • y -- 三维点的高度。

返回:

一个三维点实例

to_point2d() Point2D[源代码]

从一个三维点实例创建一个二维点实例。

返回:

一个二维点实例

MCPosition(Minecraft 位置)

表示一个在 Minecraft 维度中的特定位置。

class location_api.MCPosition(point: Point3D, dimension: str)[源代码]

使用一个三维点实例和一个维度字符串定义一个 Minecraft 位置。

这个类使用一个三维点和一个维度字符串表示一个在 Minecraft 维度中的特定位置。它使用浮点精度来表示坐标值。

point: Point3D

该位置的三维点。

dimension: str

该位置的维度字符串。

property x: float

该位置的 x 坐标。

property y: float

该位置的 y 坐标。

property z: float

该位置的 z 坐标。

asdict() dict[源代码]

MCPosition 对象序列化成字典。

返回:

序列化后(得到)的字典。

classmethod from_dict(data: dict) Self[源代码]

从字典中反序列化出 MCPosition 对象。

参数:

data -- 要(进行)反序列化的字典。

返回:

反序列化出的 MCPosition 对象。

Location(地点)

表示一个已保存的地点,带有名字、说明和其他额外信息。

class location_api.Location(position: MCPosition, name: str, description: str | None = None, other: PrimitiveMap | None = None)[源代码]

定义一个地点,带有名字、说明和其他额外信息。

这个类表示一个在 Minecraft 中的地点,带有名字、说明和其他额外信息。它使用浮点精度来表示坐标值。

position: MCPosition

该地点的位置数据。

name: str

该地点的名字。

description: str | None = None

该地点的说明。

other: PrimitiveMap | None = None

其他关于该地点的信息。

property x: float

该地点的 x 坐标。

property y: float

该地点的 y 坐标。

property z: float

该地点的 z 坐标。

property dimension: str

该地点的维度。

asdict() dict[源代码]

Location 对象序列化为字典。

返回:

序列化后(得到)的字典。

classmethod from_dict(data: dict) Self[源代码]

从字典中反序列化 Location 对象。

参数:

data -- 要(进行)反序列化的字典。

返回:

反序列化出的 Location 对象。