Languagy (多语言支持-API)

Languagy (多语言支持-API)

简介：Languagy 是一个 Spigot API，旨在为 Minecraft 插件开发者提供一种便捷的方式来支持玩家个性化语言设置。通过此 API，开发者可以根据玩家客户端设置的语言为其提供相应的翻译。需要注意的是，Languagy 本身不提供自动翻译功能，开发者需要自行提供语言文件。

功能特点：

• 支持 Minecraft 客户端所有语言
• 简化多语言支持的实现过程
• 通过提供翻译文件来达成语言支持
• 无缝集成至插件中，支持通过 gradle/maven 进行 shading 集成

配置及用法：

1. 在插件的 onEnable 方法中初始化 Translator 实例：

private Translator translator;
public Translator getTranslator(){
  return translator;
}
@Override
public void onEnable(){
  this.translator = Translator.of(this);
}

2. 记得在 onDisable 方法中调用 Translator#close 以确保文件监视器正确关闭：

@Override
public void onDisable(){
  translator.close();
}

3. 使用 Translator#getTranslationFor 来获取特定语言的翻译，通过 Translation#colour 或 Translation#send 方法来对翻译进行颜色处理和发送。

如需集成到项目中：使用 Gradle (Kotlin DSL) 或 Maven 进行依赖管理，添加 Languagy 作为依赖并进行必要的排除和重定位操作。

// Gradle (Kotlin DSL) 示例：
repositories{
  maven("https://repo.convallyria.com/releases")
}
dependencies{
  implementation("com.convallyria.languagy:api:3.0.2"){
    exclude("com.convallyria.languagy.libs")
  }
}
tasks{
  shadowJar{
    relocate("com.convallyria.languagy","YOUR_PACKAGE.libs.languagy")
  }
}

权限：此 API 专为开发者设计，不需要在服务器上安装，也无需特定的权限配置。

更多关于如何使用 Languagy 的细节，请参考官方的 JavaDocs 文档。

Languagy (多语言支持-API)

可用版本为:|1.8|1.9|1.10|1.11|1.12|1.13|1.14|1.15|1.16|1.17|1.18|1.19|1.20

源站下载

登录后前往SPIGOT