Final Page Menu Commit

Author: TheRedMagic

README.md

@@ -222,7 +222,6 @@ class MinionGUI: UndefinedMenu("Minion") {
 }
 ```
 
-
 #### Per Player
 A per player GUI is an GUI that is that the gui can be different for every player. You can do this by creating a new instance of the Menu class when opening it (See below)
 
@@ -240,6 +239,37 @@ class SettingsGUI: UndefinedMenu("Settings") {
 }
 ```
 
+### Paged Menu
+
+> [!CAUTION]
+> KOTLIN ONLY
+
+To be able to create a custom paged Menu you will need to extend the `UndefinedPageMenu`. Its never the same as a normal Menu but you will need to pase a `List` of itemStacks witch will be sorted into pages. When the same as the normal Menu you will to extend the `generateInventory` method with **`createPageInventory`** method.
+After that put in your back button and next button using the `setBackButton` and `setNextButton`. You are able to shape the inventory to your liking. (See below)
+
+> [!NOTE]
+> You need to have the `setBackButton` and `setNextButton` for the gui to work.
+
+```kotlin
+class FunGui(list: List<ItemStack>): UndefinedPageMenu("Fun", MenuSize.LARGE, list) {
+    override fun generateInventory(): Inventory = createPageInventory {
+
+        setBackButton(PageButton(45, ItemStack(Material.RED_STAINED_GLASS_PANE), ItemStack(Material.GRAY_STAINED_GLASS_PANE)))
+        setNextButton(PageButton(53, ItemStack(Material.LIME_STAINED_GLASS_PANE), ItemStack(Material.GRAY_STAINED_GLASS_PANE)))
+
+        setColumn(6, ItemBuilder(Material.LIGHT_GRAY_STAINED_GLASS_PANE).setName(" ").build())
+    }
+}
+```
+
+When lastly extend the `clickData: ClickData.()` witch will run then the gui is pressed. (See below)
+
+```kotlin
+override var clickData: ClickData.() -> Unit = {
+    println("DIAMONDS")
+}
+```
+
 ## Events
 
 > [!CAUTION]

build.gradle.kts

@@ -22,7 +22,7 @@ publishing {
 }
 
 group = "com.redmagic"
-version = "1.0.1"
+version = "1.0.2"
 
 repositories {
     mavenCentral()

src/main/java/com/redmagic/undefinedapi/TestGUI.kt

@@ -1,9 +1,11 @@
 package com.redmagic.undefinedapi
 
+import com.redmagic.undefinedapi.event.event
 import com.redmagic.undefinedapi.menu.MenuManager
 import com.redmagic.undefinedapi.scheduler.TimeUnit
 import com.redmagic.undefinedapi.scheduler.delay
 import com.redmagic.undefinedapi.scheduler.repeatingTask
+import org.bukkit.event.player.PlayerJoinEvent
 import org.bukkit.plugin.java.JavaPlugin
 
 
@@ -12,6 +14,8 @@ class UndefinedAPI(javaPlugin: JavaPlugin) {
     init {
         plugin = javaPlugin
         MenuManager.setup(plugin)
+
+
     }
 
     companion object{

src/main/java/com/redmagic/undefinedapi/UndefinedAPI.kt

@@ -124,12 +124,17 @@ object MenuManager : Listener {
 
     }
 
+    /**
+     * Runs the page menu logic based on the inventory click event.
+     *
+     * @param menu The undefined page menu.
+     * @param e The inventory click event.
+     */
     private fun runPageMenu(menu: UndefinedPageMenu, e: InventoryClickEvent){
         val player = e.whoClicked as Player
         if (e.currentItem == null) return
         if (e.currentItem!!.type.isAir) return
         e.isCancelled = true
-        if (menu.itemsMap.containsKey(e.rawSlot)) return
         when(e.rawSlot){
             menu.bButton!!.slot ->{
                 menu.previousPage()
@@ -140,8 +145,16 @@ object MenuManager : Listener {
                 return
             }
         }
+        if (menu.itemsMap.containsKey(e.rawSlot)) return
+        menu.clickData.invoke(ClickData(e.rawSlot, player, e.currentItem, e.click, e.action, e.clickedInventory))
     }
 
+    /**
+     * Runs the default menu behavior when a button is clicked in the inventory.
+     *
+     * @param menu The undefined menu that the button belongs to.
+     * @param e The InventoryClickEvent triggered by the button click.
+     */
     private fun runDefaultMenu(menu: UndefinedMenu, e: InventoryClickEvent){
         val player = e.whoClicked as Player
 

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

@@ -4,8 +4,10 @@ import com.google.gson.annotations.Until
 import com.redmagic.undefinedapi.extension.string.emptySlots
 import com.redmagic.undefinedapi.menu.MenuSize
 import com.redmagic.undefinedapi.menu.normal.UndefinedMenu
+import com.redmagic.undefinedapi.menu.normal.button.ClickData
 import com.redmagic.undefinedapi.menu.page.button.PageButton
 import org.bukkit.Bukkit
+import org.bukkit.Material
 import org.bukkit.inventory.Inventory
 import org.bukkit.inventory.ItemStack
 import org.jetbrains.annotations.MustBeInvokedByOverriders
@@ -18,6 +20,8 @@ abstract class UndefinedPageMenu(private val title: String, private val size: In
     var itemsMap = HashMap<Int, ItemStack>()
     private var pageList: PageList<ItemStack>? = null
 
+    abstract var clickData: ClickData.() -> Unit
+
     private var page = 1
     private var totalPages = 0
 
@@ -59,33 +63,30 @@ abstract class UndefinedPageMenu(private val title: String, private val size: In
         setItems(items)
     }
 
-    fun createPageInventory(display: Inventory.() -> Unit): Inventory?{
+    fun createPageInventory(display: Inventory.() -> Unit): Inventory{
 
-        if (bButton == null || nButton == null){
-            Bukkit.getLogger().warning("Back or next button is not set in $title page menu.")
-            return null
-        }
 
-        val inventory = Bukkit.createInventory(null, size, title).apply(display)
+        inventory = Bukkit.createInventory(null, size, title).apply(display)
 
-        inventory.contents.forEach {
+        inventory!!.contents.forEach {
             if (it != null)
-                itemsMap[inventory.contents.indexOf(it)] = it
+                itemsMap[inventory!!.contents.indexOf(it)] = it
         }
 
-        inventory.setItem(bButton!!.slot, bButton!!.activeButton)
-        inventory.setItem(nButton!!.slot, nButton!!.activeButton)
+        inventory!!.setItem(bButton!!.slot, bButton!!.activeButton)
+        inventory!!.setItem(nButton!!.slot, nButton!!.activeButton)
 
-        pageList = PageList(list, inventory.emptySlots())
+        pageList = PageList(list, inventory!!.emptySlots())
         totalPages = pageList!!.pageCount()
 
         setButtons()
 
         setItems(pageList!!.getPage(1)!!)
 
-        return inventory
+        return inventory!!
     }
 
+    fun onPress(clickData: ClickData.() -> Unit){}
 
     private fun setItems(items: List<ItemStack>){
 
@@ -95,7 +96,7 @@ abstract class UndefinedPageMenu(private val title: String, private val size: In
     }
 
     private fun setButtons(){
-        if (page + 1 >= totalPages){
+        if (page + 1 > totalPages){
             inventory!!.setItem(nButton!!.slot, nButton!!.emptyButton)
         }else {
             inventory!!.setItem(nButton!!.slot, nButton!!.activeButton)
@@ -110,14 +111,18 @@ abstract class UndefinedPageMenu(private val title: String, private val size: In
 
     fun setBackButton(slot: Int, backButton: ItemStack, emptyButton: ItemStack){
         bButton = PageButton(slot, backButton, emptyButton)
+        this.itemsMap[slot] = ItemStack(Material.AIR)
     }
     fun setBackButton(pageButton: PageButton) {
         bButton = pageButton
+        this.itemsMap[pageButton.slot] = ItemStack(Material.AIR)
     }
     fun setNextButton(slot: Int, nextButton: ItemStack, emptyButton: ItemStack){
         nButton = PageButton(slot, nextButton, emptyButton)
+        this.itemsMap[slot] = ItemStack(Material.AIR)
     }
     fun setNextButton(pageButton: PageButton) {
         nButton = pageButton
+        this.itemsMap[pageButton.slot] = ItemStack(Material.AIR)
     }
 }