Code Patterns

Copy-paste examples for common plugin tasks. Commands, events, ECS, GUI, and more.

← Back to Patterns
teleport

Teleport Player

Teleport a player to specific coordinates using TransformComponent.

Example Code

java
public void teleportPlayer(Ref<EntityStore> ref, double x, double y, double z) {
    Store<EntityStore> store = ref.getStore();
    EntityStore entityStore = (EntityStore) store.getExternalData();
    World world = entityStore.getWorld();

    world.execute(() -> {
        if (!ref.isValid()) return;

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

        // Use teleportPosition for proper client sync
        transform.teleportPosition(new Vector3d(x, y, z));
    });
}

Thread Safety

Must run inside world.execute() for ECS safety. Use teleportPosition() not setPosition() for proper client sync.

Common Mistakes

Using setPosition() instead of teleportPosition() - wont sync properly to client. Forgetting world.execute() wrapper.