Leiv的翻译API

🌐 Leiv 的翻译 API

Leiv 的翻译 API 是 Leiv 生态系统套件 的动态本地化引擎。

当 Leiv 的 API 处理逻辑和 Leiv 的网络库 处理同步时，这个库确保每个菜单、提示文本和文本元素都完美本地化。它是一个高度优化的语言管理器，旨在运行时动态加载、缓存和应用翻译文件，无需硬编码字符串。它确保像 Leiv 的配置菜单 等模组能完美显示正确的文本。

⚠️ 玩家注意： 这是 Leiv 生态系统中用户界面和文本驱动模组的必需核心依赖。它本身不添加方块或物品，但必须与我的模组一起安装，才能正确显示本地化文本、菜单和提示！

✨ 主要特性

• 🌐 动态命名空间注册： 启动时自动发现并注册所有 11 个 Leiv 生态系统命名空间的语言文件。
• 🚀 DictCache 加速： 高速内存翻译缓存，可在微秒内解析语言键。
• 📝 动态提示文本解析： 自动将配置规则和 UI 元素与其对应的 .desc 翻译键配对。
• 🔄 热重载支持： 支持游戏中动态切换语言，无需强制重启客户端。

🛠️ 技术亮点（面向开发者与整合包作者）

Leiv 的翻译 API 提供了一条与游戏代码解耦的本地化流水线：

• 🧠 LeivTranslationEngine： 核心翻译扫描器，动态将 assets/<namespace>/lang/*.json 文件加载到统一缓存中。
• 🔍 DictCache 引擎： 优化的键值字典引擎，当特定语言中缺少键时支持即时回退处理。
• 💬 动态占位符注入器： 支持字符串插值和运行时参数注入，用于动态 UI 描述。
• 🎨 格式抽象： 按需干净地剥离或转换旧版 Minecraft 颜色代码（§）和现代组件格式。

🔗 依赖关系

该库确保生态系统的文本与其逻辑一样动态：

• 需要： Leiv 的 Lib 与 Leiv 的 API （请确保两者均已安装！）
• 被用于： Leiv 的 GUI、Leiv 的配置菜单、ItemCuller、Keybind Profiles、EnderStash 以及所有其他 Leiv 生态系统终端模组。

💬 社区与支持

有问题、反馈或需要报告错误？加入社区吧！

• 👥 Discord： 加入 Leiv 的社区
• 🐛 问题追踪器： 通过官方 Discord 工单系统或我们的 GitHub Issues 页面报告错误。