From fd063507dbb5af7abccb3ca36897c12502dbaee0 Mon Sep 17 00:00:00 2001 From: Szymon Date: Sat, 15 Aug 2026 14:35:13 +0200 Subject: [PATCH] Document undefined tracker behavior in track/untrack events. --- .../io/papermc/paper/event/player/PlayerTrackEntityEvent.java | 2 ++ .../io/papermc/paper/event/player/PlayerUntrackEntityEvent.java | 2 ++ 2 files changed, 4 insertions(+) diff --git a/paper-api/src/main/java/io/papermc/paper/event/player/PlayerTrackEntityEvent.java b/paper-api/src/main/java/io/papermc/paper/event/player/PlayerTrackEntityEvent.java index 0e37c8c94a77..705400de0b16 100644 --- a/paper-api/src/main/java/io/papermc/paper/event/player/PlayerTrackEntityEvent.java +++ b/paper-api/src/main/java/io/papermc/paper/event/player/PlayerTrackEntityEvent.java @@ -15,6 +15,8 @@ *

* Adding or removing entities from the world at the point in time this event is called is completely * unsupported and should be avoided. + * Teleporting entities in the world at the point in time this event is called yields an undefined tracker + * behavior and should be avoided. */ @NullMarked public class PlayerTrackEntityEvent extends PlayerEvent implements Cancellable { diff --git a/paper-api/src/main/java/io/papermc/paper/event/player/PlayerUntrackEntityEvent.java b/paper-api/src/main/java/io/papermc/paper/event/player/PlayerUntrackEntityEvent.java index 30e01ffc8b0d..b499b6620f77 100644 --- a/paper-api/src/main/java/io/papermc/paper/event/player/PlayerUntrackEntityEvent.java +++ b/paper-api/src/main/java/io/papermc/paper/event/player/PlayerUntrackEntityEvent.java @@ -12,6 +12,8 @@ *

* Adding or removing entities from the world at the point in time this event is called is completely * unsupported and should be avoided. + * Teleporting entities in the world at the point in time this event is called yields an undefined tracker + * behavior and should be avoided. */ @NullMarked public class PlayerUntrackEntityEvent extends PlayerEvent {