feat: add customPlayerClick and playerCallback methods to DialogActionBuilder for player-specific interactions

Author: twisti-dev

surf-api-bukkit/surf-api-bukkit-api/api/surf-api-bukkit-api.api

@@ -1045,8 +1045,11 @@ public final class dev/slne/surf/surfapi/bukkit/api/dialog/builder/DialogActionB
 	public final fun customClick (Lnet/kyori/adventure/text/event/ClickCallback$Options;Lio/papermc/paper/registry/data/dialog/action/DialogActionCallback;)V
 	public static synthetic fun customClick$default (Ldev/slne/surf/surfapi/bukkit/api/dialog/builder/DialogActionBuilder;Lnet/kyori/adventure/key/Key;Lnet/kyori/adventure/nbt/api/BinaryTagHolder;ILjava/lang/Object;)V
 	public static synthetic fun customClick$default (Ldev/slne/surf/surfapi/bukkit/api/dialog/builder/DialogActionBuilder;Lnet/kyori/adventure/text/event/ClickCallback$Options;Lio/papermc/paper/registry/data/dialog/action/DialogActionCallback;ILjava/lang/Object;)V
+	public final fun customPlayerClick (Lnet/kyori/adventure/text/event/ClickCallback$Options;Lkotlin/jvm/functions/Function2;)V
+	public static synthetic fun customPlayerClick$default (Ldev/slne/surf/surfapi/bukkit/api/dialog/builder/DialogActionBuilder;Lnet/kyori/adventure/text/event/ClickCallback$Options;Lkotlin/jvm/functions/Function2;ILjava/lang/Object;)V
 	public final fun openUrl (Ljava/lang/String;)V
 	public final fun openUrl (Ljava/net/URL;)V
+	public final fun playerCallback (Lnet/kyori/adventure/text/event/ClickCallback;)V
 	public final fun showDialog (Lkotlin/jvm/functions/Function1;)V
 	public final fun showDialog (Lnet/kyori/adventure/dialog/DialogLike;)V
 	public final fun staticAction (Lnet/kyori/adventure/text/event/ClickEvent;)V

surf-api-bukkit/surf-api-bukkit-api/src/main/kotlin/dev/slne/surf/surfapi/bukkit/api/dialog/builder/DialogActionBuilder.kt

@@ -3,6 +3,8 @@
 package dev.slne.surf.surfapi.bukkit.api.dialog.builder
 
 import dev.slne.surf.surfapi.bukkit.api.dialog.dialog
+import dev.slne.surf.surfapi.core.api.messages.adventure.sendText
+import io.papermc.paper.dialog.DialogResponseView
 import io.papermc.paper.registry.data.dialog.DialogRegistryEntry
 import io.papermc.paper.registry.data.dialog.action.DialogAction
 import io.papermc.paper.registry.data.dialog.action.DialogActionCallback
@@ -14,6 +16,7 @@ import net.kyori.adventure.nbt.TagStringIO
 import net.kyori.adventure.nbt.api.BinaryTagHolder
 import net.kyori.adventure.text.event.ClickCallback
 import net.kyori.adventure.text.event.ClickEvent
+import org.bukkit.entity.Player
 import java.net.URL
 
 class DialogActionBuilder {
@@ -52,6 +55,15 @@ class DialogActionBuilder {
         staticAction(ClickEvent.callback(callback))
     }
 
+    fun playerCallback(callback: ClickCallback<Player>) {
+        callback(ClickCallback.widen(callback, Player::class.java) { other ->
+            other.sendText {
+                appendPrefix()
+                error("Only players can use this action!")
+            }
+        })
+    }
+
     fun commandTemplate(template: String) {
         action = DialogAction.commandTemplate(template)
     }
@@ -76,6 +88,24 @@ class DialogActionBuilder {
         action = DialogAction.customClick(callback, options)
     }
 
+    fun customPlayerClick(
+        options: ClickCallback.Options? = null,
+        callback: (response: DialogResponseView, player: Player) -> Unit,
+    ) {
+        customClick(
+            options
+        ) { response, audience ->
+            if (audience !is Player) {
+                audience.sendText {
+                    appendPrefix()
+                    error("Only players can use this action!")
+                }
+            } else {
+                callback(response, audience)
+            }
+        }
+    }
+
     internal fun build(): DialogAction {
         val action = action
         require(action != null) { "DialogAction must be built" }