A comprehensive inventory menu API for Spigot with pages support. Supports Bukkit/Spigot 1.7 - 1.16 (see Version Notes).
The code for this example can be found in the library test class.
- I don't see a reason it shouldn't work in Spigot 1.7 or any version of Bukkit from 1.8 - 1.16 but it hasn't been tested on those versions.
- This library has been tested on Spigot 1.8 and Spigot 1.16 and is expected to work on every version in-between.
- The ItemBuilder API does require that
api-version
be"legacy"
(or not specified) for Spigot versions after 1.13.
Step 1: Create an instance of the SpiGUI library in your plugin
class MyPlugin extends JavaPlugin {
public static SpiGUI menuAPI;
@Override
public void onEnable() {
// (IMPORTANT!) Registers SpiGUI event handlers (and stores plugin-wide settings for SpiGUI.)
menuAPI = new SpiGUI(this);
}
}
Step 2: Use the library
public void openMyAwesomeMenu(Player player) {
// Create a GUI with 3 rows (27 slots)
SGMenu myAwesomeMenu = MyPlugin.menuAPI.create("&cMy Awesome Menu", 3);
// Create a button
SGButton myAwesomeButton = new SGButton(
// Includes an ItemBuilder class with chainable methods to easily
// create menu items.
new ItemBuilder(Material.WOOD).build()
).withListener((InventoryClickEvent event) -> {
// Events are cancelled automatically, unless you turn it off
// for your plugin or for this inventory.
event.getWhoClicked().sendMessage("Hello, world!");
});
// Add the button to your GUI
myAwesomeMenu.addButton(myAwesomeButton);
// Show the GUI
player.openInventory(myAwesomeMenu.getInventory());
}
Step 3: Profit!
Chest Inventory Menus (commonly referred to as GUIs) are the ubiquitous way to display menus, execute actions and even manage configuration in Spigot plugins. However, the Inventory API leveraged to achieve this in Spigot is not designed for menus, making code far more verbose and far less maintainable than it needs to be.
SpiGUI is a rewrite of my outdated SpigotPaginatedGUI API including improvements and features I've added whilst using the API in my own software that aims to provide a highly readable and concise API for menus.