Code Patterns

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

All 225 Command 60 Damage 2 Ecs 27 Entity 5 Gui 75 Interaction 2 Inventory 4 Moderation 3 Permission 2 Player 9 Plugin 4 Storage 2 Teleport 3 Ui 22 Util 5
← Back to Patterns
teleport

Teleport Pattern

Teleport a player to specific coordinates using the ECS Teleport component.

Example Code

java 
public static void teleportPlayer(Player player, double x, double y, double z) {
    World world = player.getWorld();
    if (world == null) return;

    world.execute(() -> {
        if (player.getReference() == null) return;
        Store<EntityStore> store = player.getReference().getStore();

        Teleport teleport = Teleport.createForPlayer(
            world,                          // World reference (required!)
            new Vector3d(x, y, z),          // Target position
            new Vector3f(0, 0, 0)           // Target rotation (pitch, yaw, roll)
        );

        store.addComponent(player.getReference(), Teleport.getComponentType(), teleport);
    });
}

Thread Safety

MUST be called inside world.execute() block. Teleport.createForPlayer requires World as first argument.

Common Mistakes

Calling Teleport outside world.execute(). Forgetting World parameter in createForPlayer(). Not checking for null world/reference.