Plugin Library - 插件库

💡简介

Plugin Library 是一款帮助开发者无需将其他插件直接导入类路径，即可调用其 API 的插件。它最初为解决 Autorank 插件因依赖众多插件而导致的导入混乱问题而创建。现在，它作为一个集中管理各类插件 API 连接的工具，公开提供给所有开发者使用。

🎮功能特性

• 自动挂钩：自动连接并挂钩至所有已支持的插件。
• 简化开发：开发者只需接入 Plugin Library 即可使用其统一管理的各类 API。

🔧服务器管理员使用指南

• 只需下载本插件，并将其放入服务器的 plugins 文件夹中。
• 重启服务器，插件将自动运行。

✨当前支持的插件 API

Plugin Library 目前支持以下插件的 API：

• AFKTerminator v3.0.8
• Autorank v4.2.6
• Factions v2.14.0
• mcMMO v2.1.111
• OnTime v4.1.4
• RoyalCommands v4.1.1
• Stats v5.3.3
• UltimateCore v2.1.16
• RPGme v1.0.2
• AdvancedAchievements v5.13.1
• GriefPrevention v16.12.0
• WorldGuard v7.0.1
• WorldEdit v7.0.1
• uSkyBlock v2.8.5
• Quests v3.8.1
• EssentialsX v2.17.1
• BattleLevels v8.2.2
• ASkyBlock v3.0.9.4
• AcidIsland v3.0.9.4
• Jobs v4.14.3
• Vault 1.7
• Statz 1.5.3
• CMI 8.6.16.4

⭐开发者使用指南

添加依赖

首先，你需要在你的插件配置文件 plugin.yml 中添加对 Plugin Library 的依赖。

depend: [PluginLibrary]

获取 API 接口

完成依赖添加后，你可以通过以下两种方式获取目标插件的 API 接口。

方法一：通过枚举获取（推荐）

如果你明确知道目标插件已被 Plugin Library 支持，可以使用枚举方式安全获取。

PluginLibrary.getLibrary(Library lib);

其中，Library 是一个枚举类型，由 me.staartvin.plugins.pluginlibrary.Library 类提供。

方法二：通过插件名称获取

如果你只知道目标插件的（字符串）名称，可以使用此方法。

PluginLibrary.getLibrary(String pluginName);

使用示例

以下示例演示如何获取指定玩家的 mcMMO 弓箭技能等级。

// 1. 获取 LibraryHook
LibraryHook hook = PluginLibrary.getLibrary(Library.MCMMO);
// 2. 将通用钩子转换为特定插件的钩子以调用其方法
McMMOHook mcmmoHook = (McMMOHook) hook;
// 3. 使用具体方法获取信息
int archeryLevel = mcmmoHook.getLevel(player, "archery");