Easily use anvil guis to get a user's input.
This project was made since there is no way to prompt users with an anvil input with the Spigot / Bukkit API. It requires interaction with NMS and that is a pain in plugins where users have different versions of the server running.
Note on the Fork: This fork aims to be compatible with WesJD/AnvilGUI as long as you only use public api methods. The main goal of this fork is to provide adventure support and to make it easier to update and understand the nms code by using the paperweight gradle plugin
Java 17 and a Paper Server (1.19+).
If you are a developer, submit a pull request adding a wrapper module for your version. Otherwise, please create an issue on the issues tab. Note on the Fork: We won't support versions older than 1.19. If you want to support older versions use the repository this was forked on: WesJD/AnvilGUI
AnvilGUI requires the usage of Maven or a Maven compatible build system.
<dependency>
<groupId>eu.cafestube</groupId>
<artifactId>anvilgui</artifactId>
<version>1.0.7-SNAPSHOT</version>
</dependency>
<repository>
<id>cafestube-public-snapshots</id>
<url>https://repo.cafestu.be/repository/maven-public-snapshots/</url>
</repository>It is best to be a good citizen and relocate the dependency to within your namespace in order to prevent conflicts with other plugins. Here is an example of how to relocate the dependency:
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>${shade.version}</version> <!-- The version must be at least 3.5.0 -->
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<relocations>
<relocation>
<pattern>net.wesjd.anvilgui</pattern>
<shadedPattern>[YOUR_PLUGIN_PACKAGE].anvilgui</shadedPattern> <!-- Replace [YOUR_PLUGIN_PACKAGE] with your namespace -->
</relocation>
</relocations>
<filters>
<filter>
<artifact>*:*</artifact>
<excludeDefaults>false</excludeDefaults>
<includes>
<include>net/wesjd/anvilgui/**</include>
</includes>
</filter>
</filters>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>Note: In order to solve <minimizeJar> removing AnvilGUI VerionWrappers from the final jar and making the library unusable,
ensure that your <filters> section contains the example <filter> as seen above.
The AnvilGUI.Builder class is how you build an AnvilGUI.
The following methods allow you to modify various parts of the displayed GUI. Javadocs are available here.
Takes a Consumer<StateSnapshot> argument that is called when a player closes the anvil gui.
builder.onClose(stateSnapshot -> {
stateSnapshot.getPlayer().sendMessage("You closed the inventory.");
});Takes a BiFunction with the slot that was clicked and a snapshot of the current gui state.
The function is called when a player clicks any slots in the inventory.
You must return a List<AnvilGUI.ResponseAction>, which could include:
- Closing the inventory (
AnvilGUI.ResponseAction.close()) - Replacing the input text (
AnvilGUI.ResponseAction.replaceInputText(String)) - Updating the title of the inventory (
AnvilGUI.ResponseAction.updateTitle(String, boolean)) - Opening another inventory (
AnvilGUI.ResponseAction.openInventory(Inventory)) - Running generic code (
AnvilGUI.ResponseAction.run(Runnable)) - Nothing! (
Collections.emptyList())
The list of actions are ran in the order they are supplied.
builder.onClick((slot, stateSnapshot) -> {
if (slot != AnvilGUI.Slot.OUTPUT) {
return Collections.emptyList();
}
if (stateSnapshot.getText().equalsIgnoreCase("you")) {
stateSnapshot.getPlayer().sendMessage("You have magical powers!");
return Arrays.asList(
AnvilGUI.ResponseAction.close(),
AnvilGUI.ResponseAction.run(() -> myCode(stateSnapshot.getPlayer()))
);
} else {
return Arrays.asList(AnvilGUI.ResponseAction.replaceInputText("Try again"));
}
});Takes a ClickHandler, a shorthand for BiFunction<Integer, AnvilGui.StateSnapshot, CompletableFuture<AnvilGUI.ResponseAction>>,
that behaves exactly like onClick() with the difference that it returns a CompletableFuture and therefore allows for
asynchronous calculation of the ResponseActions.
builder.onClickAsync((slot, stateSnapshot) -> CompletedFuture.supplyAsync(() -> {
// this code is now running async
if (slot != AnvilGUI.Slot.OUTPUT) {
return Collections.emptyList();
}
if (database.isMagical(stateSnapshot.getText())) {
// the `ResponseAction`s will run on the main server thread
return Arrays.asList(
AnvilGUI.ResponseAction.close(),
AnvilGUI.ResponseAction.run(() -> myCode(stateSnapshot.getPlayer()))
);
} else {
return Arrays.asList(AnvilGUI.ResponseAction.replaceInputText("Try again"));
}
}));Tells the AnvilGUI to disable the mechanism that is put into place to prevent concurrent execution of the
click handler set by onClickAsync(ClickHandler).
builder.allowConcurrentClickHandlerExecution();This allows or denies users to take / input items in the anvil slots that are provided. This feature is useful when you try to make a inputting system using an anvil gui.
builder.interactableSlots(Slot.INPUT_LEFT, Slot.INPUT_RIGHT);Tells the AnvilGUI to prevent the user from pressing escape to close the inventory. Useful for situations like password input to play.
builder.preventClose(); This toggles compatibility with Geyser software, specifically being able to use AnvilGUI with 0 experience level on Bedrock. Enabled by default.
builder.geyserCompat();Takes a String that contains what the initial text in the renaming field should be set to.
builder.text(Component.text("What is the meaning of life?")); If itemLeft is provided, then the display name is set to the provided text. If no itemLeft
is set, then a piece of paper will be used.
builder.text("What is the meaning of life?");Takes a custom ItemStack to be placed in the left input slot.
ItemStack stack = new ItemStack(Material.IRON_SWORD);
ItemMeta meta = stack.getItemMeta();
meta.setLore(Arrays.asList("Sharp iron sword"));
stack.setItemMeta(meta);
builder.itemLeft(stack);Takes a custom ItemStack to be placed in the right input slot.
ItemStack stack = new ItemStack(Material.IRON_INGOT);
ItemMeta meta = stack.getItemMeta();
meta.setLore(Arrays.asList("A piece of metal"));
stack.setItemMeta(meta);
builder.itemRight(stack);Takes a Component that will be used as the inventory title. Only displayed in Minecraft 1.14 and above.
builder.title(Component.text("Enter your answer"));Takes a String which contains rich text components serialized as JSON.
Useful for settings titles with hex color codes or Adventure Component interop.
Only displayed in Minecraft 1.14 and above.
builder.jsonTitle("{\"text\":\"Enter your answer\",\"color\":\"green\"}")Takes the Plugin object that is making this anvil gui. It is needed to register listeners.
builder.plugin(pluginInstance);Takes an Executor that must execute on the main server thread.
If the main server thread is not accessible via the Bukkit scheduler, like on Folia servers, it can be swapped for a
Folia aware executor.
builder.mainThreadExecutor(executor);Takes a Player that the anvil gui should be opened for. This method can be called multiple times without needing to create
a new AnvilGUI.Builder object.
builder.open(player);new AnvilGUI.Builder()
.onClose(stateSnapshot -> {
stateSnapshot.getPlayer().sendMessage("You closed the inventory.");
})
.onClick((slot, stateSnapshot) -> { // Either use sync or async variant, not both
if(slot != AnvilGUI.Slot.OUTPUT) {
return Collections.emptyList();
}
if(stateSnapshot.getText().equalsIgnoreCase("you")) {
stateSnapshot.getPlayer().sendMessage("You have magical powers!");
return Arrays.asList(AnvilGUI.ResponseAction.close());
} else {
return Arrays.asList(AnvilGUI.ResponseAction.replaceInputText("Try again"));
}
})
.preventClose() //prevents the inventory from being closed
.text("What is the meaning of life?") //sets the text the GUI should start with
.title("Enter your answer.") //set the title of the GUI (only works in 1.14+)
.plugin(myPluginInstance) //set the plugin instance
.open(myPlayer); //opens the GUI for the player providedWe use Maven to handle our dependencies. Run gradle build using Java 17 to build the project.
This project is licensed under the MIT License.