文本化工具

Textualizer

一个简单的本地化管理库。

为模组开发者提供了 Minecraft 专用的实现，封装了 Minecraft 自身的本地化系统。

---

---

面向开发者

设置

你需要在 build.gradle(.kts) 文件中将其添加为依赖项。

repositories {
    maven("https://maven.deftu.dev/releases")
}

dependencies {
    modImplementation("dev.deftu:textualizer:<VERSION>")
}

将 <VERSION> 替换为你想要使用的库版本。

用法

你需要在你的项目中实现 Language、LocalizationContext 和 Localization。这意味着你需要处理语言元数据、翻译加载、翻译获取、占位符替换以及语言切换。

请参考 Minecraft 专用实现 作为示例。

---

面向 Minecraft 模组用户

为什么我需要这个？

Minecraft（以及 Forge）的语言管理系统在多个 Minecraft 版本中存在许多 bug 且不一致。本库旨在为你的模组提供一种一致且可靠的翻译管理方式。

它会影响我的 FPS / 性能吗？

不会。除了翻译的初始加载和语言切换之外，本库不会添加任何影响性能的内容。

---

面向 Minecraft 模组开发者

设置

你需要在 build.gradle(.kts) 文件中将其添加为依赖项。

repositories {
    maven("https://maven.deftu.dev/releases")
}

dependencies {
    modImplementation("dev.deftu:textualizer-<MINECRAFT VERSION>-<MOD LOADER>:<VERSION>")
}

当然，请将 <MINECRAFT VERSION> 替换为你正在开发的 Minecraft 版本，<MOD LOADER> 替换为你正在开发的模组加载器，<VERSION> 替换为你想要使用的库版本。

用法

获取当前（游戏中选定的）语言上下文可以这样做：

import dev.deftu.textualizer.minecraft.MCLocalization;

LocalizationContext context = MCLocalization.current();

要获取翻译后的字符串，你可以使用

import dev.deftu.textualizer.minecraft.MCLocalization;

LocalizationContext context = MCLocalization.current();
String text = context.get("com.example");

要获取翻译后的字符串并替换你的占位符，你可以使用

import dev.deftu.textualizer.MCLocalization;

int number = 10;
LocalizationContext context = MCLocalization.current();
String text = context.get("com.example", number);

---

---

本项目基于 LGPL-3.0 许可。
© 2024 Deftu