TransformComponent

Position and rotation of an entity in the world.

Access

TransformComponent transform = store.getComponent(ref, TransformComponent.getComponentType());

Position

// read position
Vector3d pos = transform.getPosition();
double x = pos.getX();
double y = pos.getY();
double z = pos.getZ();

// modify (Vector3d is mutable)
pos.assign(newX, newY, newZ);

// teleport (handles chunk transitions gracefully)
transform.teleportPosition(new Vector3d(x, y, z));

Rotation

// read rotation (pitch, yaw, roll)
Vector3f rot = transform.getRotation();
float pitch = rot.getPitch();  // X
float yaw = rot.getYaw();      // Y
float roll = rot.getRoll();    // Z

// modify
rot.setYaw(newYaw);
rot.setPitch(newPitch);

// teleport rotation
transform.teleportRotation(new Vector3f(pitch, yaw, roll));

Teleporting

Do not use for players

Never use teleportPosition() to teleport players. The player will desync from the server — their client won’t know they moved, teleport history won’t be recorded, and velocity won’t reset. Use the Teleport component instead, which is what the built-in /tp command uses.

teleportPosition() / teleportRotation() are low-level methods for repositioning entities. They handle chunk boundary transitions but do NOT send client packets or record teleport history. Use these only for non-player entities or internal ECS systems.

// move a non-player entity
transform.teleportPosition(targetPosition);
transform.teleportRotation(targetRotation);