Add shared menu and compatibility APIs

Author: 54895y

src/main/kotlin/com/y54895/matrixlib/MatrixLib.kt

@@ -19,7 +19,7 @@ object MatrixLib : Plugin() {
             branding = branding,
             headline = "Loading shared Matrix runtime",
             details = listOf(
-                MatrixConsoleFact("Exports", "branding / text / yaml / console"),
+                MatrixConsoleFact("Exports", "action / menu / compat / text / yaml / console"),
                 MatrixConsoleFact("Usage", "Required by MatrixShop, MatrixAuth, MatrixCook")
             )
         )
@@ -30,7 +30,7 @@ object MatrixLib : Plugin() {
             branding = branding,
             version = pluginVersion,
             details = listOf(
-                MatrixConsoleFact("API", "MatrixText, MatrixYamlBundle"),
+                MatrixConsoleFact("API", "Action, menu, compat, text, yaml"),
                 MatrixConsoleFact("Runtime", "Console visuals and resource bridge")
             )
         )

src/main/kotlin/com/y54895/matrixlib/api/action/ActionApi.kt

@@ -0,0 +1,38 @@
+package com.y54895.matrixlib.api.action
+
+import com.y54895.matrixlib.api.text.MatrixText
+import org.bukkit.Sound
+import org.bukkit.entity.Player
+
+data class ActionContext(
+    val player: Player,
+    val placeholders: Map<String, String>,
+    val backAction: Runnable? = null
+)
+
+object ActionExecutor {
+
+    fun execute(context: ActionContext, actions: List<String>) {
+        actions.forEach { executeSingle(context, it) }
+    }
+
+    private fun executeSingle(context: ActionContext, rawAction: String) {
+        val action = MatrixText.apply(rawAction, context.placeholders)
+        when {
+            action.equals("close", true) -> context.player.closeInventory()
+            action.equals("back", true) -> context.backAction?.run() ?: context.player.closeInventory()
+            action.startsWith("tell:", true) -> context.player.sendMessage(MatrixText.color(action.substringAfter(':').trim()))
+            action.startsWith("sound:", true) -> playSound(context.player, action.substringAfter(':').trim())
+            action.isNotBlank() -> context.player.performCommand(action.removePrefix("/"))
+        }
+    }
+
+    private fun playSound(player: Player, raw: String) {
+        val split = raw.split('-')
+        val soundName = split.getOrNull(0)?.trim()?.uppercase() ?: return
+        val volume = split.getOrNull(1)?.toFloatOrNull() ?: 1f
+        val pitch = split.getOrNull(2)?.toFloatOrNull() ?: 1f
+        val sound = runCatching { Sound.valueOf(soundName) }.getOrNull() ?: return
+        player.playSound(player.location, sound, volume, pitch)
+    }
+}