custom items can be added to paginated menu border

Author: KodySimpson

README.md

@@ -1,4 +1,4 @@
-# SimpAPI v4.1.9
+# SimpAPI v4.2.0
 ****
 SimpAPI, finally a good API that can make coding MC Plugins much easier and less painful.
 This API includes all of my primary utilities like *Menu Manager*, *Command Manager*, *ColorTranslator*, and more.
@@ -25,7 +25,7 @@ JavaDocs: https://kodysimpson.github.io/SimpAPI/index.html
 <dependency>
     <groupId>com.github.KodySimpson</groupId>
     <artifactId>SimpAPI</artifactId>
-    <version>4.1.9</version>
+    <version>4.2.0</version>
 </dependency>
 ```
 
@@ -51,7 +51,7 @@ repositories {
 Groovy/Kotlin:
 ```groovy
 dependencies {
-    implementation 'com.github.KodySimpson:SimpAPI:4.1.9'
+    implementation 'com.github.KodySimpson:SimpAPI:4.2.0'
 }
 ```
 

src/main/java/me/kodysimpson/simpapi/menu/PaginatedMenu.java

@@ -2,7 +2,10 @@
 
 import org.bukkit.ChatColor;
 import org.bukkit.Material;
+import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.Nullable;
 
+import java.util.HashMap;
 import java.util.List;
 
 public abstract class PaginatedMenu extends Menu {
@@ -34,15 +37,19 @@ public PaginatedMenu(PlayerMenuUtility playerMenuUtility) {
      */
     public abstract void loopCode(Object object);
 
+    /**
+     * @return A hashmap of items you want to be placed in the paginated menu border. This will override any items already placed by default. Key = slot, Value = Item
+     */
+    @Nullable
+    public abstract HashMap<Integer, ItemStack> getCustomMenuBorderItems();
 
     /**
-     * Set the border and menu buttons for the menu. Override this method to provide a custom menu border
+     * Set the border and menu buttons for the menu. Override this method to provide a custom menu border or specify custom items in customMenuBorderItems()
      */
     protected void addMenuBorder(){
-        inventory.setItem(48, makeItem(Material.DARK_OAK_BUTTON, ChatColor.GREEN + "Left"));
 
+        inventory.setItem(48, makeItem(Material.DARK_OAK_BUTTON, ChatColor.GREEN + "Left"));
         inventory.setItem(49, makeItem(Material.BARRIER, ChatColor.DARK_RED + "Close"));
-
         inventory.setItem(50, makeItem(Material.DARK_OAK_BUTTON, ChatColor.GREEN + "Right"));
 
         for (int i = 0; i < 10; i++) {
@@ -63,6 +70,12 @@ protected void addMenuBorder(){
                 inventory.setItem(i, super.FILLER_GLASS);
             }
         }
+
+        //place the custom items if they exist
+        if (getCustomMenuBorderItems() != null){
+            getCustomMenuBorderItems().forEach((integer, itemStack) -> inventory.setItem(integer, itemStack));
+        }
+
     }
 
     /**