Add menu management and interaction functionality

This commit includes the addition of several classes, primarily related to menu management within the application. Functionality for managing menus, handling menu buttons, menu sizes, and related actions has been implemented. These changes also include warnings for button overwrites and items outside of the menu. A minimal .gitignore file is also added for exclusions of certain paths.

Author: TheRedMagic

.gitignore

@@ -0,0 +1,3 @@
+# Project exclude paths
+/.gradle/
+/build/

src/main/java/com/redmagic/undefinedapi/menu/Button.kt

@@ -0,0 +1,11 @@
+package com.redmagic.undefinedapi.menu
+
+import org.bukkit.entity.Player
+import org.bukkit.event.inventory.ClickType
+import org.bukkit.event.inventory.InventoryAction
+import org.bukkit.event.inventory.InventoryClickEvent
+import org.bukkit.inventory.ItemStack
+
+class Button(val slot:Int, val consumer: (ClickData) -> Unit)
+
+class ClickData(val slot: Int, val player: Player?, val item:ItemStack?, val click:ClickType, val action:InventoryAction)

src/main/java/com/redmagic/undefinedapi/menu/Menu.kt

@@ -0,0 +1,58 @@
+package com.redmagic.undefinedapi.menu
+
+import org.bukkit.Bukkit
+import org.bukkit.inventory.Inventory
+import org.bukkit.inventory.ItemStack
+
+open class Menu(private val title: String, private val size: Int) {
+
+
+    val inventory:Inventory;
+
+    val buttons: MutableList<Button> = mutableListOf()
+
+    val movables: MutableList<Int> = mutableListOf()
+
+
+    constructor(title: String, menuSize: MenuSize = MenuSize.LARGE):this(title, menuSize.size)
+
+    init {
+        this.inventory = Bukkit.createInventory(null, size, title)
+    }
+
+
+    fun addButton(button: Button){
+
+        if (isAllReadyButton(button.slot)){
+
+            Bukkit.getLogger().warning("Menu : $title button overwrite. Slot : ${button.slot}")
+
+            buttons.filter { it.slot == button.slot }.forEach { dupeButton: Button ->
+                run {
+                    buttons.remove(dupeButton)
+                }
+            }
+        }
+
+        buttons.add(button)
+    }
+
+    fun setItem(slot: Int, itemStack:ItemStack, movable:Boolean = true){
+        if (slot > size){
+            Bukkit.getLogger().warning("Menu : $title item outside of menu. Slot : $slot")
+            return
+        }
+
+        movables.remove(slot)
+
+        inventory.setItem(slot, itemStack)
+
+        if (movable)
+            movables.add(slot)
+
+    }
+
+    fun isSlotMoveAble(slot: Int) = movables.any {it == slot}
+    private fun isAllReadyButton(slot: Int) = buttons.any { it.slot == slot }
+
+}

src/main/java/com/redmagic/undefinedapi/menu/MenuManager.kt

@@ -0,0 +1,78 @@
+package com.redmagic.undefinedapi.menu
+
+import org.bukkit.Bukkit
+import org.bukkit.entity.Player
+import org.bukkit.event.EventHandler
+import org.bukkit.event.Listener
+import org.bukkit.event.inventory.InventoryClickEvent
+import org.bukkit.event.inventory.InventoryCloseEvent
+import org.bukkit.event.player.PlayerQuitEvent
+import org.bukkit.plugin.java.JavaPlugin
+import java.util.UUID
+
+object MenuManager : Listener {
+
+    private lateinit var plugin: JavaPlugin
+
+    val openMenus = HashMap<UUID, Menu>()
+
+    fun getPlugin(): JavaPlugin {
+        return this.plugin
+    }
+
+    fun setup(plugin: JavaPlugin) {
+        this.plugin = plugin
+        Bukkit.getPluginManager().registerEvents(this, plugin)
+    }
+
+    fun hasMenuOpen(player: Player): Boolean {
+        return openMenus.containsKey(player.uniqueId)
+    }
+
+    fun Player.hasMenuOpen(): Boolean {
+        return MenuManager.hasMenuOpen(this)
+    }
+
+    fun openMenu(player: Player, menu: Menu) {
+        Bukkit.getScheduler().runTaskLater(plugin, Runnable {
+            player.openInventory(menu.inventory)
+            openMenus[player.uniqueId] = menu
+        }, 1)
+    }
+
+    fun Player.openMenu(menu: Menu) {
+        MenuManager.openMenu(this, menu)
+    }
+
+    fun getMenu(player: Player) = openMenus[player.uniqueId]
+
+    fun Player.getMenu() = MenuManager.getMenu(this)
+
+
+    @EventHandler
+    fun onClick(e: InventoryClickEvent) {
+        if (!hasMenuOpen(e.whoClicked as Player)) return
+        val menu = getMenu(e.whoClicked as Player)
+        menu?.buttons?.filter { it.slot == e.slot }?.forEach { button ->
+            run {
+                button.consumer(ClickData(e.rawSlot, e.whoClicked as Player, e.currentItem, e.click, e.action))
+            }
+        }
+
+        menu?.movables?.contains(e.rawSlot).let {
+
+            e.isCancelled = true
+        }
+    }
+
+
+    @EventHandler
+    fun onClose(e: InventoryCloseEvent) {
+        openMenus.remove(e.player.uniqueId)
+    }
+
+    @EventHandler
+    fun onLeave(e: PlayerQuitEvent) {
+        openMenus.remove(e.player.uniqueId)
+    }
+}

src/main/java/com/redmagic/undefinedapi/menu/MenuSize.kt

@@ -0,0 +1,7 @@
+package com.redmagic.undefinedapi.menu
+
+enum class MenuSize(val size: Int) {
+
+    SMALL(27),
+    LARGE(54)
+}