PlayerTeleportEvent does not fire for most teleports

[whimxiqal]

Expected behavior

PlayerTeleportEvent to fire for all teleportations

Observed/Actual behavior

PlayerTeleportEvent only fires for causes:

• CONSUMABLE_EFFECT: tested eating chorus fruit
• DISMOUNT: tested getting off a camel
• EXIT_BED: tested getting out of bed

It does not fire for causes:

• ENDER_PEARL: tested by throwing an ender pearl
• NETHER_PORTAL: tested by walking through nether portal
• END_PORTAL: tested by walking through an end portal

Steps/models to reproduce

final class PortalListener implements Listener {

  @EventHandler(priority = EventPriority.MONITOR)
  public void onTeleport(PlayerTeleportEvent event) {
    logger.debug("onTeleport");
  }

}

And

public final class MyPlugin extends JavaPlugin {

  @Override
  public void onEnable() {
    getServer().getPluginManager().registerEvents(
        new PortalListener()
    );
  }

}

Plugin and Datapack List

Just MyPlugin for testing

Folia version

This server is running Folia version 26.1.2-8-ver/26.1.x@62dc0f2 (2026-05-06T13:45:28Z) (Implementing API version 26.1.2.build.8-stable)
You are running the latest version

Other

No response

[Dueris]

The player teleport event is generally unsupported and left unimplemented in Folia. This is a known issue and Im unsure whether or not this is planned for future releases of Folia, but the generic teleport event I dont think will be reimplemented. However I do think the remaining teleport event calls are an issue and probably should be removed from Folia given it only covers a very small array of teleport types

[whimxiqal]

Is that also the case for Player.teleportAsync? I'm getting another issue with trying to teleport myself via a plugin to a different dimension.

[18:46:44 ERROR]: Failed to handle packet net.minecraft.network.protocol.game.ServerboundMovePlayerPacket$Pos@549ac4b7, suppressing error
java.lang.IllegalStateException: World mismatch: expected world_nether but got world
        at net.minecraft.world.level.Level.getCurrentWorldData(Level.java:834) ~[folia-26.1.2.jar:26.1.2-8-62dc0f2]
        at net.minecraft.world.level.Level.getBlockState(Level.java:1355) ~[folia-26.1.2.jar:26.1.2-8-62dc0f2]
        at net.minecraft.world.entity.Entity.doCheckFallDamage(Entity.java:2002) ~[folia-26.1.2.jar:26.1.2-8-62dc0f2]
        at net.minecraft.server.network.ServerGamePacketListenerImpl.handleMovePlayer(ServerGamePacketListenerImpl.java:1791) ~[folia-26.1.2.jar:26.1.2-8-62dc0f2]
        at net.minecraft.network.protocol.game.ServerboundMovePlayerPacket.handle(ServerboundMovePlayerPacket.java:70) ~[folia-26.1.2.jar:26.1.2-8-62dc0f2]
        at net.minecraft.network.protocol.game.ServerboundMovePlayerPacket$Pos.handle(ServerboundMovePlayerPacket.java:109) ~[folia-26.1.2.jar:26.1.2-8-62dc0f2]
        at net.minecraft.network.PacketProcessor$ListenerAndPacket.handle(PacketProcessor.java:107) ~[folia-26.1.2.jar:26.1.2-8-62dc0f2]
        at net.minecraft.network.PacketProcessor.executeSinglePacket(PacketProcessor.java:39) ~[folia-26.1.2.jar:26.1.2-8-62dc0f2]
        at net.minecraft.server.MinecraftServer.tickServer(MinecraftServer.java:1743) ~[folia-26.1.2.jar:26.1.2-8-62dc0f2]
        at net.minecraft.server.dedicated.DedicatedServer.tickServer(DedicatedServer.java:451) ~[folia-26.1.2.jar:26.1.2-8-62dc0f2]
        at io.papermc.paper.threadedregions.TickRegions$ConcreteRegionTickHandle.tickRegion(TickRegions.java:485) ~[folia-26.1.2.jar:26.1.2-8-62dc0f2]
        at io.papermc.paper.threadedregions.TickRegionScheduler$RegionScheduleHandle.runTick(TickRegionScheduler.java:481) ~[folia-26.1.2.jar:26.1.2-8-62dc0f2]
        at ca.spottedleaf.concurrentutil.scheduler.EDFSchedulerThreadPool$TickThreadRunner.run(EDFSchedulerThreadPool.java:528) ~[concurrentutil-0.0.10.jar:?]
        at ca.spottedleaf.concurrentutil.util.LazyRunnable.run(LazyRunnable.java:25) ~[concurrentutil-0.0.10.jar:?]
        at java.base/java.lang.Thread.run(Thread.java:1516) ~[?:?]

[Dueris]

Please schedule your teleport for that

teleportAsync is safe for Folia but you really can't do it during certain events because there are some events that if you do it will RIDICULOUSLY fuck up the player state and crash the server

[Dueris]

Also, if you are trying to teleport during the move event(which it looks like you are), then Id suggest using the methods provided by the move event to modify the move position rather than teleporting. It works better tbh...

I may be wrong though abt you teleporting during the move event, I only mention it because I see the move packet being processed in the stack trace you provided.

[whimxiqal]

Oop. Yes, thank you, editing the move event is what I wanted to do, it was essentially for a rudimentary teleport-pad system, separate from my original issue.

[Dueris]

Yeah def use the setTo methods, since Folia already patches those to properly teleport the entity if the new target is out of region.