UnnamedGUI - Menu Creator

A small, and very easy to use, library for creating menus at Spigot API!

Installation

Latest Snapshot:

Latest Release:

Maven Dependency

Add the repositories into your <repositories> tag (pom.xml)

<repository>
  <id>unnamed-releases</id>
  <url>https://repo.unnamed.team/repository/unnamed-releases/</url>
</repository>
<repository>
  <id>unnamed-snapshots</id>
  <url>https://repo.unnamed.team/repository/unnamed-snapshots/</url>
</repository>

Add the dependency into your <dependencies> tag (pom.xml)

<dependency>
  <groupId>team.unnamed.gui</groupId>
  <artifactId>core</artifactId>
  <version>VERSION</version>
</dependency>

Gradle Dependency

Add the repositories into your repositories section (build.gradle)

maven {
  name = 'unnamed-releases'
  url = 'https://repo.unnamed.team/repository/unnamed-releases/'
}
maven {
  name = 'unnamed-snapshots'
  url = 'https://repo.unnamed.team/repository/unnamed-snapshots/'
}

Add the dependency into your dependencies section (build.gradle)

implementation 'team.unnamed.gui:core:VERSION'

How to use

Remember that you can also visit the example module.

First we need register one listener for all menus. Example:

Bukkit.getPluginManager().registerEvents(new GUIListeners(), plugin);

MenuAPI

Creating menus with our api is too simple, we are going to explain everything a little, so that you can get an idea of the new functionalities and systems that were re-made.

GUIBuilder guiBuilder = GUIBuilder.newBuilder("MenuTest", 3);

This is the basic structure to create a GUIBuilder, which will be used to place all the attributes it can have.

Now let's see how we can add an item to the menu, it's quite simple, let's do it.

guiBuilder
    .addItem(
        ItemClickable.builder(13)
            .setItemStack(new ItemStack(Material.ENDER_PEARL))
            .setAction(event -> {
                System.out.print("Just testing...")

                return true;
            })
            .build()
    );

Other events

There are also 2 more methods to execute an action when opening the inventory, and another to execute an action when closing the inventory, which are:

guiBuilder
    .openEvent(
            event -> {
                Player player = (Player) event.getPlayer();

                player.sendMessage("Opening...!");
                
                return false;
            }
    )
    .closeEvent(
            event -> {
                Player player = (Player) event.getPlayer();

                player.sendMessage("Closing...!");
            }
    );

Finally

With this simple way you can create your menus easily and quickly. Now you will ask yourself, how can I get the inventory I create, it is easy, simply with the build() method that the MenuBuilder has.

Inventory inventory = guiBuilder.build();