AnhyLibAPI:适用于 Minecraft 插件
AnhyLibAPI 是一个专为集成到 Minecraft 插件中而设计的库,旨在增强在 Spigot、Paper、Purpur 及其他 Spigot 分支服务器上运行的插件的功能。
运行需要 ProtocolLib 插件 5.0.0 或更高版本。
AnhyLibAPI 必须作为插件加载到服务器中。务必理解的是,AnhyLibAPI 以插件身份运行时,不会监听任何事件、没有计时器,也不与游戏世界或玩家进行交互,从而确保不会对服务器的运行和性能造成额外负担。AnhyLibAPI 的主要目的是向其他插件提供其 API,作为扩展其功能的坚实基础。这种设计确保了 AnhyLibAPI 在不牺牲服务器效率的前提下增强插件的能力。
主要特性:
- 多语言支持:轻松为插件集成语言包。
- NBT 标签处理:高级管理 NBT 标签,实现灵活的数据交互。
- 玩家持久数据:高效使用玩家的持久数据。
- 消息自定义:针对发送给玩家的消息进行个性化定制。
- 日志记录:独特的日志记录方法。
AnhyLibAPI 的关键特性
1. 多语言支持
AnhyLibAPI 通过检查“玩家持久数据”中的玩家所选语言来实现统一的多语言支持标准。如果未找到所选语言,则默认使用玩家的 Minecraft 客户端语言。此外,它还支持包含首选语言列表,从而增强了本地化的灵活性。
2. NBT 标签处理
AnhyLibAPI 简化了物品中 NBT 标签的添加、修改和删除,使开发人员能够轻松管理游戏中的关键物品数据。
3. 玩家持久数据
此功能允许存储、检索和修改玩家的个人数据,如设置、状态和成就,提供了深度的个性化以及单个玩家详细信息的保留。
4. 消息自定义与日志记录
这些功能提供消息自定义和各种消息类型的彩色日志记录。它们增强了插件与玩家之间的通信,并促进了插件内事件更有效的跟踪和分析。
文档:
AnhyLibAPI 的 JavaDoc 可在以下链接获取:AnhyLibAPI Documentation。
Gradle 与 Maven 集成:
Gradle:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
mavenCentral()
maven { url 'https://jitpack.io' }
}
}
dependencies {
implementation 'com.github.AnhyDev:AnhyLibAPI:v1.4.0'
}
Maven:
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependency>
<groupId>com.github.AnhyDev</groupId>
<artifactId>AnhyLibAPI</artifactId>
<version>v1.4.0</version>
</dependency>
插件编写示例:
如需一个完整且可直接使用的实现了 AnhyLibAPI 的插件示例,请访问以下链接:AnhyLibAPI Plugin Examples。这个示例不仅仅是示例代码;它是一个功能齐全的插件,具备多语言支持、可配置设置和玩家命令。开发人员可以将此插件作为基础,根据需要重命名和重新打包,同时添加自己的代码以扩展其功能。它是理解和在实际插件项目中应用 AnhyLibAPI 的绝佳起点。
以下是来自该代码的一些示例:
package ink.anh.example;
import java.io.File;
import java.io.IOException;
import org.bukkit.Bukkit;
import org.bukkit.configuration.file.YamlConfiguration;
import org.bukkit.plugin.Plugin;
import ink.anh.api.LibraryManager;
import ink.anh.api.lingo.Translator;
import ink.anh.api.lingo.lang.LanguageManager;
import ink.anh.api.messages.Logger;
import net.kyori.adventure.platform.bukkit.BukkitAudiences;
import net.md_5.bungee.api.ChatColor;
public class GlobalManager extends LibraryManager {
private static GlobalManager instance;
private ExampleLangPlugin plugin;
private LanguageManager langManager;
private String pluginName;
private String defaultLang;
private static BukkitAudiences bukkitAudiences;
private boolean debug;
private GlobalManager(ExampleLangPlugin plugin) {
super(plugin);
this.plugin = plugin;
this.saveDefaultConfig();
this.loadFields(plugin);
}
public static synchronized GlobalManager getManager(ExampleLangPlugin plugin) {
if (instance == null) {
instance = new GlobalManager(plugin);
}
return instance;
}
@Override
public Plugin getPlugin() {
return plugin;
}
@Override
public String getPluginName() {
return pluginName;
}
@Override
public BukkitAudiences getBukkitAudiences() {
return bukkitAudiences;
}
@Override
public LanguageManager getLanguageManager() {
return this.langManager;
}
@Override
public String getDefaultLang() {
return defaultLang;
}
@Override
public boolean isDebug() {
return debug;
}
private void loadFields(ExampleLangPlugin plugin) {
bukkitAudiences = BukkitAudiences.create(plugin);
defaultLang = plugin.getConfig().getString("language", "en");
pluginName = ChatColor.translateAlternateColorCodes('&',plugin.getConfig().getString("plugin_name", "ExampleLangPlugin"));
debug = plugin.getConfig().getBoolean("debug", false);
setLanguageManager();
}
```java
private void saveDefaultConfig() {
File configFile = new File(plugin.getDataFolder(), "config.yml");
if (!configFile.exists()) {
YamlConfiguration defaultConfig = new YamlConfiguration();
defaultConfig.set("plugin_name", "ExampleLangPlugin");
defaultConfig.set("language", "en");
defaultConfig.set("debug", false);
try {
defaultConfig.save(configFile);
Logger.warn(plugin, "已创建默认配置。");
} catch (IOException e) {
e.printStackTrace();
}
}
}
private void setLanguageManager() {
if (this.langManager == null) {
this.langManager = LangMessage.getInstance(this);
} else {
this.langManager.reloadLanguages();
}
}
public boolean reload() {
Bukkit.getScheduler().runTaskAsynchronously(plugin, () -> {
try {
saveDefaultConfig();
plugin.reloadConfig();
loadFields(plugin);
Logger.info(plugin, Translator.translateKyeWorld(instance, "configuration_reloaded", new String[] {defaultLang}));
} catch (Exception e) {
e.printStackTrace();
Logger.error(plugin, Translator.translateKyeWorld(instance, "err_reloading_configuration", new String[] {defaultLang}));
}
});
return true;
}
package ink.anh.example;
import ink.anh.api.lingo.lang.LanguageManager;
public class LangMessage extends LanguageManager {
private static LangMessage instance = null;
private static final Object LOCK = new Object();
private LangMessage(GlobalManager manager) {
super(manager, "lang");
}
public static LangMessage getInstance(GlobalManager manager) {
if (instance == null) {
synchronized (LOCK) {
if (instance == null) {
instance = new LangMessage(manager);
}
}
}
return instance;
}
}
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧