3D direction and velocity

Vector

A Vector is a simple 3D coordinate used for velocities, offsets, and directional calculations. Unlike Location, a Vector has no world, yaw, or pitch.

---

Constructor

Vector(x=0.0, y=0.0, z=0.0)

Create a vector.

• Parameters:
• x (float) — X component. Default 0.
• y (float) — Y component. Default 0.
• z (float) — Z component. Default 0.

velocity = Vector(0, 1.5, 0)       # Straight up
direction = Vector(0.5, 0.2, -0.3) # Angled

---

Attributes

x

• Type: float

X component.

y

• Type: float

Y component.

z

• Type: float

Z component.

---

Common Uses

Setting entity velocity

# Launch a player upward
await player.set_velocity(Vector(0, 2.0, 0))

Spawning projectiles with velocity

arrow = await world.spawn_projectile(
    player,
    "ARROW",
    velocity=Vector(0, 1, 0)
)

As position tuples

Many methods accept Vector | tuple[int,int,int] interchangeably:

# Both are equivalent
await world.fill(Vector(0, 60, 0), Vector(10, 65, 10), "STONE")
await world.fill((0, 60, 0), (10, 65, 10), "STONE")

Player spawn offset

await world.spawn_at_player(player, "ZOMBIE", offset=Vector(3, 0, 0))