Add player join, quit, and death message events

gradle.properties

@@ -7,6 +7,6 @@ org.jetbrains.dokka.experimental.gradle.pluginMode=V2Enabled
 javaVersion=25
 mcVersion=26.2
 group=dev.slne.surf.api
-version=3.32.0
+version=3.33.0
 relocationPrefix=dev.slne.surf.api.libs
 snapshot=false

surf-api-paper/surf-api-paper/api/surf-api-paper.api

@@ -774,6 +774,59 @@ public final class dev/slne/surf/api/paper/event/common/PlayerAfkStateChangeEven
 	public fun toString ()Ljava/lang/String;
 }
 
+public final class dev/slne/surf/api/paper/event/common/connection/PlayerJoinMessageEvent : dev/slne/surf/api/core/event/SurfSyncEvent, dev/slne/surf/api/core/event/SurfCancellableEvent {
+	public fun <init> (Lorg/bukkit/entity/Player;Lnet/kyori/adventure/text/Component;)V
+	public fun cancel ()V
+	public final fun component1 ()Lorg/bukkit/entity/Player;
+	public final fun component2 ()Lnet/kyori/adventure/text/Component;
+	public final fun copy (Lorg/bukkit/entity/Player;Lnet/kyori/adventure/text/Component;)Ldev/slne/surf/api/paper/event/common/connection/PlayerJoinMessageEvent;
+	public static synthetic fun copy$default (Ldev/slne/surf/api/paper/event/common/connection/PlayerJoinMessageEvent;Lorg/bukkit/entity/Player;Lnet/kyori/adventure/text/Component;ILjava/lang/Object;)Ldev/slne/surf/api/paper/event/common/connection/PlayerJoinMessageEvent;
+	public fun equals (Ljava/lang/Object;)Z
+	public final fun getMessage ()Lnet/kyori/adventure/text/Component;
+	public final fun getPlayer ()Lorg/bukkit/entity/Player;
+	public fun hashCode ()I
+	public fun isCancelled ()Z
+	public fun setCancelled (Z)V
+	public final fun setMessage (Lnet/kyori/adventure/text/Component;)V
+	public fun toString ()Ljava/lang/String;
+}
+
+public final class dev/slne/surf/api/paper/event/common/connection/PlayerQuitMessageEvent : dev/slne/surf/api/core/event/SurfSyncEvent, dev/slne/surf/api/core/event/SurfCancellableEvent {
+	public fun <init> (Lorg/bukkit/entity/Player;Lnet/kyori/adventure/text/Component;)V
+	public fun cancel ()V
+	public final fun component1 ()Lorg/bukkit/entity/Player;
+	public final fun component2 ()Lnet/kyori/adventure/text/Component;
+	public final fun copy (Lorg/bukkit/entity/Player;Lnet/kyori/adventure/text/Component;)Ldev/slne/surf/api/paper/event/common/connection/PlayerQuitMessageEvent;
+	public static synthetic fun copy$default (Ldev/slne/surf/api/paper/event/common/connection/PlayerQuitMessageEvent;Lorg/bukkit/entity/Player;Lnet/kyori/adventure/text/Component;ILjava/lang/Object;)Ldev/slne/surf/api/paper/event/common/connection/PlayerQuitMessageEvent;
+	public fun equals (Ljava/lang/Object;)Z
+	public final fun getMessage ()Lnet/kyori/adventure/text/Component;
+	public final fun getPlayer ()Lorg/bukkit/entity/Player;
+	public fun hashCode ()I
+	public fun isCancelled ()Z
+	public fun setCancelled (Z)V
+	public final fun setMessage (Lnet/kyori/adventure/text/Component;)V
+	public fun toString ()Ljava/lang/String;
+}
+
+public final class dev/slne/surf/api/paper/event/common/death/PlayerDeathMessageEvent : dev/slne/surf/api/core/event/SurfSyncEvent, dev/slne/surf/api/core/event/SurfCancellableEvent {
+	public fun <init> (Lorg/bukkit/entity/Player;Lnet/kyori/adventure/text/Component;Lorg/bukkit/event/entity/EntityDamageEvent$DamageCause;)V
+	public fun cancel ()V
+	public final fun component1 ()Lorg/bukkit/entity/Player;
+	public final fun component2 ()Lnet/kyori/adventure/text/Component;
+	public final fun component3 ()Lorg/bukkit/event/entity/EntityDamageEvent$DamageCause;
+	public final fun copy (Lorg/bukkit/entity/Player;Lnet/kyori/adventure/text/Component;Lorg/bukkit/event/entity/EntityDamageEvent$DamageCause;)Ldev/slne/surf/api/paper/event/common/death/PlayerDeathMessageEvent;
+	public static synthetic fun copy$default (Ldev/slne/surf/api/paper/event/common/death/PlayerDeathMessageEvent;Lorg/bukkit/entity/Player;Lnet/kyori/adventure/text/Component;Lorg/bukkit/event/entity/EntityDamageEvent$DamageCause;ILjava/lang/Object;)Ldev/slne/surf/api/paper/event/common/death/PlayerDeathMessageEvent;
+	public fun equals (Ljava/lang/Object;)Z
+	public final fun getLastDamageCause ()Lorg/bukkit/event/entity/EntityDamageEvent$DamageCause;
+	public final fun getMessage ()Lnet/kyori/adventure/text/Component;
+	public final fun getPlayer ()Lorg/bukkit/entity/Player;
+	public fun hashCode ()I
+	public fun isCancelled ()Z
+	public fun setCancelled (Z)V
+	public final fun setMessage (Lnet/kyori/adventure/text/Component;)V
+	public fun toString ()Ljava/lang/String;
+}
+
 public final class dev/slne/surf/api/paper/extensions/Org_bukkit_ServerExtensionsKt {
 	public static final fun getServer ()Lorg/bukkit/Server;
 }

surf-api-paper/surf-api-paper/src/main/kotlin/dev/slne/surf/api/paper/event/common/connection/PlayerJoinMessageEvent.kt

@@ -0,0 +1,24 @@
+package dev.slne.surf.api.paper.event.common.connection
+
+import dev.slne.surf.api.core.event.SurfCancellableEvent
+import dev.slne.surf.api.core.event.SurfSyncEvent
+import net.kyori.adventure.text.Component
+import org.bukkit.entity.Player
+
+/**
+ * Called when a join message for a player has been created and is about to be sent.
+ *
+ * The [message] can be modified to change the final join message that will be sent to
+ * eligible receivers. Cancelling this event prevents the join message from being sent.
+ *
+ * This event is fired synchronously.
+ *
+ * @property player the player that joined the server
+ * @property message the join message that will be sent
+ */
+data class PlayerJoinMessageEvent(
+    val player: Player,
+    var message: Component,
+) : SurfSyncEvent(), SurfCancellableEvent {
+    override var isCancelled = false
+}

surf-api-paper/surf-api-paper/src/main/kotlin/dev/slne/surf/api/paper/event/common/connection/PlayerQuitMessageEvent.kt

@@ -0,0 +1,24 @@
+package dev.slne.surf.api.paper.event.common.connection
+
+import dev.slne.surf.api.core.event.SurfCancellableEvent
+import dev.slne.surf.api.core.event.SurfSyncEvent
+import net.kyori.adventure.text.Component
+import org.bukkit.entity.Player
+
+/**
+ * Called when a quit message for a player has been created and is about to be sent.
+ *
+ * The [message] can be modified to change the final quit message that will be sent to
+ * eligible receivers. Cancelling this event prevents the quit message from being sent.
+ *
+ * This event is fired synchronously.
+ *
+ * @property player the player that left the server
+ * @property message the quit message that will be sent
+ */
+data class PlayerQuitMessageEvent(
+    val player: Player,
+    var message: Component,
+) : SurfSyncEvent(), SurfCancellableEvent {
+    override var isCancelled = false
+}

surf-api-paper/surf-api-paper/src/main/kotlin/dev/slne/surf/api/paper/event/common/death/PlayerDeathMessageEvent.kt

@@ -0,0 +1,27 @@
+package dev.slne.surf.api.paper.event.common.death
+
+import dev.slne.surf.api.core.event.SurfCancellableEvent
+import dev.slne.surf.api.core.event.SurfSyncEvent
+import net.kyori.adventure.text.Component
+import org.bukkit.entity.Player
+import org.bukkit.event.entity.EntityDamageEvent
+
+/**
+ * Called when a death message for a player has been created and is about to be sent.
+ *
+ * The [message] can be modified to change the final death message that will be sent to
+ * eligible receivers. Cancelling this event prevents the death message from being sent.
+ *
+ * This event is fired synchronously.
+ *
+ * @property player the player that died
+ * @property message the death message that will be sent
+ * @property lastDamageCause the last damage cause that resulted in the player's death
+ */
+data class PlayerDeathMessageEvent(
+    val player: Player,
+    var message: Component,
+    val lastDamageCause: EntityDamageEvent.DamageCause,
+) : SurfSyncEvent(), SurfCancellableEvent {
+    override var isCancelled = false
+}