WolfyUtilities - 核心 API 1 17 1 - 1 21 1

💡WolfyUtilities 核心 API

WolfyUtilities 是一个为基于 Spigot 的插件提供 API 和实用工具的核心库。它包含插件依赖的 API 和全局可用的工具类，并提供了一个用于注册自定义内容的注册表系统，是构建复杂插件功能的基础。

🎮基本信息

• 支持的 Minecraft 版本: 1.17.1 – 1.20.6
• 必需的 Java 版本: Java 17

🎮API 与工具

API 是插件依赖的，这意味着每个插件都有自己独立的 API 实例。而工具类是插件无关的，可以在任何地方使用。注册表与 WolfyUtilities 的核心绑定，但可以从任何地方访问。

API 功能

• Inventory: 用于创建游戏内 GUI 的功能性 API。
• Language: 加载基于 JSON 的语言文件，并为 GUI、消息等提供多语言支持。
• Chat: 发送可翻译的消息、文本点击事件回调等。
• (自 3.16.1+ 版本起) 集成了 KyoriPowered/adventure 实现。
• Config: 简单的配置工具。
• NMS: 功能完整的 NBTTag API、自定义 RecipeIterator，以及一些方块和库存工具。
• CustomItems: 创建灵活的自定义物品，支持自定义燃料、耐久度、动作等设置。

注册表

注册表是 WolfyUtilities 及其衍生插件中所有自定义内容的基础。它允许你使用唯一的命名空间键来注册类型和对象。这不仅允许插件注册 CustomItems 等内容，也可以被其他插件扩展。

🎮工具类

• NamespacedKey: 为所有可注册内容提供唯一的键。
• JSON: 各种简化序列化/反序列化的 Jackson 工具。
• 针对 Bukkit 对象的自定义序列化/反序列化器。
• 从注册表值进行简单的序列化/反序列化。
• 对象处理 (参见 @OptionalKeyReference)。
• 类型到对象的映射 (参见 @KeyedTypeIdResolver 和 @KeyedTypeResolver)。
• Particles: 使用 JSON 配置自定义粒子效果和动画。
• RandomCollection: 基于权重的随机集合。
• Reflection: 基础的反射工具。
• Player Head utils: 用于设置玩家头颅纹理等。
• Basic MySQL connection: 用于执行查询和更新的基础 MySQL 连接。
• ItemBuilder: 用于编辑/创建 ItemStacks。
• Save player specific data: 保存玩家特定数据。

🔧使用 WolfyUtilities 的插件

CustomCrafting

CustomCrafting 严重依赖这些 API 和工具，它更像是一个扩展而非独立的插件。CustomCrafting 特别利用了 Inventory API 来创建和管理游戏内的配方编辑器。其 JSON / HOCON 工具则用于从 JSON / HOCON 文件加载/保存配方和物品。