AnvilGUI 使用指南

项目介绍

AnvilGUI 是一个基于 Spigot/Paper 的 Minecraft 插件开发框架，由 WesJD 开发并维护。它专门用于简化在 Minecraft 游戏内使用 Anvil 界面（铁砧界面）进行交互的流程。通过这个库，开发者能够更加方便地创建自定义对话框，实现如物品命名、交易确认等场景，而无需深入了解复杂的 NMS（Netty Message Serializer）代码。

项目快速启动

要开始使用 AnvilGUI，首先确保你的开发环境已配置了Minecraft服务器开发所需的Java环境和Spigot/Paper API。

步骤一：添加依赖

在你的 Maven 项目的 pom.xml 文件中，加入 AnvilGUI 的依赖。这里以 Maven 示例：

<dependencies>
    <dependency>
        <groupId>net.wesjd</groupId>
        <artifactId>AnvilGUI</artifactId>
        <version>最新的版本号</version> <!-- 替换为实际最新版本 -->
    </dependency>
</dependencies>

步骤二：编写示例代码

以下是一个简单的使用 AnvilGUI 创建一个对话框的示例：

import net.wesjd.anvilgui.AnvilGUI;
import org.bukkit.entity.Player;

public class Example {

    public void openAnvil(Player player) {
        new AnvilGUI.Builder()
                .onComplete((player1, text) -> {
                    if (text.equals("Hello")) {
                        player1.sendMessage("You said hello!");
                    } else {
                        player1.sendMessage("Unknown response.");
                    }
                    return AnvilGUI.Response.close();
                })
                .item(new ItemStack(Material.STONE)) // 设置左侧物品，这里是石块作为示例
                .title("Type something") // 设置铁砧的标题
                .open(player);
    }
}

这段代码会在玩家打开铁砧时，在其输入框提示“Type something”，如果玩家输入“Hello”，则会收到一条消息回复。

应用案例和最佳实践

AnvilGUI 可广泛应用于角色命名、特殊交易、任务接受/完成确认等多种场景。最佳实践包括始终提供清晰的指令给玩家，确保UI简洁明了，避免滥用导致游戏体验下降。

实践示例：角色重命名

当玩家想要更改他们的角色名字时，可以利用 AnvilGUI 请求新的名字输入，并立即更改为新名称（假设你有一套处理逻辑来执行这个名字变更）。

典型生态项目

虽然直接关联的特定生态项目较少公开提及，但AnvilGUI被广泛集成在众多定制服务器插件中，特别是在那些需要提供高度定制化玩家交互的模组或服务器中。例如，角色扮演游戏（RPG）、生存服务器中的任务系统，或者任何需要与玩家通过铁砧进行复杂交互的游戏模式都能找到它的身影。开发者社区经常将AnvilGUI与其他工具结合，创造出独特的游戏互动体验。

---

本指南提供了快速入门AnvilGUI的基础知识，对于深入学习和高级功能探索，请参考其GitHub仓库上的详细文档和源码。