This page is a tutorial that allows developers to learn how to create a configurable and pageable staff mod using StaffModLib.
Introduction
In this page, you'll learn how to create a configurable and pageable staff mod using StaffModLib. This kind of staff mod is very useful when you want your players to have more than 9 items in their inventory. It introduces a page system which allows them to switch between the pages of items very easily.
We'll build this tutorial on the previous one so if you have not already read it, we recommend you to do so.
Set a staff mod pageable
First of all, we'll declare our staff mod as pageable. To do so, we'll inherit from the PageableBukkitStaffMod class instead of the SimpleBukkitStaffMod class previously used. So, let's do that into the SimpleStaffMod class that has been previously created.
publicclassSimpleStaffModextendsPageableBukkitStaffModimplementsConfigurable {// For lisibility reasons, we do not display all the previously// mentionned code but suppose that it is here. @OverridepublicNavigationItem<ItemStack> getNext() {returnnull; // Will be replaced later. } @OverridepublicNavigationItem<ItemStack> getPrevious() {returnnull; // Will be replaced later. }// ...}
Creating page items
These items are used to switch between next and previous pages of items of the staff mod. To add them into our staff mod, we first need to create a NavItem class which inherits of the BukkitNavigationItem class and which will contains their data. This class will also implements the Configurable interface to allow to configure the item from a configuration file.
This class has a constructor with two required parameters :
We'll also add another parameter which corresponds to the type of action the item will do. It will be used to get the right item in the config file. There are two possible actions : OPEN_PREVIOUS_PAGE and OPEN_NEXT_PAGE.
So here is the code of the NavItem class :
publicclassNavItemextendsBukkitNavigationItemimplementsConfigurable {privatefinalNavigationType type;privateItemStack item;publicNavItem(Plugin plugin,PageableStaffMod<Player,ItemStack> staffMod,NavigationType type) { super(plugin, staffMod);this.type= type; } @OverridepublicNavigationTypegetNavigationType() {returnthis.type; } @OverridepublicItemStackgetItem() {returnthis.item.clone(); } @Overridepublicvoidconfigure(ConfigurationSection parent) {// If page type is PREVIOUS, then the key is 'previous-page'.// Else, the key is 'next-page'.String key =this.type==NavigationType.OPEN_PREVIOUS_PAGE?"previous-page":"next-page";ConfigurationSection section =parent.getConfigurationSection(key);this.item=section.getItemStack("item").clone(); }}
You can notice that the body of the configure(ConfigurationSection parent) method is different in comparison with the one of basic items. Indeed, we'll configure the item according to its page type and as it is a page item, its slot is automatically added by the plugin.
An item which allows to go to the previous page is set in the first slot of the inventory whereas the one which allows to go to the next page is set in the last.
Register page items
Now, go back to the SimpleStaffMod class and implements the body of the getNext() and the getPrevious() methods.
These items are automatically registered at runtime by the library so don't have to register them manually.
Configure the staff mod
The configuration of the staff mod is different from the one that has been previously created. Indeed, you have to configure all the registered items and not only the held ones.
Do not configure the slot of the items in the configure() method because they will be overrided by the library at runtime when navigating between pages.
Registering items
To simulate a staff mod with a lot of items, we'll create another type of item using the TestItem class.
privatevoidregisterItems(Player player) {// Declaring items.BukkitStaffModItem freezeItem =newFreezeItem(player,this.plugin);// WARNING : Do not set slot here. They will be added automatically// by the pagination system.// Registering items.this.registerItem(freezeItem);// Adding test items for the example.for(int i =0; i <30; i++) this.registerItem(newTestItem());// Configuring the staff mod.this.configure(this.getConfigurationSection());}
Configuration file
In this part, we'll go back into the configuration file that has been previously created and we'll configure all of our items. Let's do so by opening this file and adding replacing the staffmod section by the following one :
staffmod: # The name of the section in which the item is stored. # It can be anything you want. freeze: # The configuration of the ItemStack. # Refer to the Spigot doc for more information. item:==:org.bukkit.inventory.ItemStack type:BLAZE_ROD amount:1 meta:==:ItemMeta meta-type:UNSPECIFIC display-name:"§eFreeze" lore:-"§eClick to §afreeze §eor §cunfreeze §ea player." # This section is about the test item. test-item: item:==:org.bukkit.inventory.ItemStack type:STICK amount:1 meta:==:ItemMeta meta-type:UNSPECIFIC display-name:"§eTest item" lore:-"§eA test item !" # This section is about the item which allows a player # to go to the previous page of the staff mod. previous-page: item:==:org.bukkit.inventory.ItemStack type:ARROW amount:1 meta:==:ItemMeta meta-type:UNSPECIFIC display-name:"§bPrevious Page" lore:-"§eClick to go on the §6previous page §eof the menu." # This section is about the item which allows a player # to go to the previous page of the staff mod. next-page: item:==:org.bukkit.inventory.ItemStack type:ARROW amount:1 meta:==:ItemMeta meta-type:UNSPECIFIC display-name:"§bNext page" lore:-"§eClick to go on the §6next page §eof the menu."
Do not add the slot of the items here because they will be automatically set by the library at runtime when navigating between pages. However, the order of the item in this section is important and will be conserved.
Now your pageable and configurable staff mod is ready to be used !