AnhyLibAPI

插件

· 作者 AnhyDev

AnhyLibAPI 是一个专为集成到 Minecraft 插件中而设计的库,旨在增强在 Spigot、Paper、Purpur 及其他 Spigot 分支上运行的服务器中的插件功能。

0 本站下载 0 关注 更新于 2 年前

最新 1.7.0 · 1.21 · Paper / Purpur

一键开服(送7天)

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;
    }
}

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源