====== 使用 CrowdinTranslate 提供实时的社区翻译  ======

Crowdin 是一个很爽很好很劲爆的翻译平台。更加爽的是，一个用户创建了一个[[https://github.com/gbl/CrowdinTranslate/tree/master|开源库]]，你可以在你的 mod 中使用，它可以从 Crowdin 实时获取翻译，并在游戏启动时应用它们。

===== 开始！ =====

首先，创建或登录你的 Crowdin 帐户然后创建或导航到你的项目。

如果你有一个 Crwodin 会员，那简直是太棒了！如果没有，你仍然可以免费使用 Crowdin（虽然最多 15000 个字符串），但是如果你的项目是开源的，你可以免费申请开源会员。

请注意以下事项：

  * 你的 Crowdin 项目 ID。
  * 你的 mod ID

将你的主要语言设置为你的源语言文件所使用的语言，如果你的源语言文件是 ''en_us.json''，则将其设置为 ''English, United States'' 。

现在，一旦你选择了目标语言，你就可以上传你的源语言文件了。

===== 实现上文提到的功能！ =====

要开始在你的 mod 中实现这个功能，首先在你的项目的 ''build.gradle'' 文件中添加 maven repository。

<code Java>
repositories {
    maven {
        url = "https://minecraft.guntram.de/maven/"
    }
}
</code>

现在将必要的 ''modImplementation'' 和 ''include'' 添加到你的 dependencies 中。

<code Java>
modImplementation "de.guntram.mcmod:crowdin-translate:1.2"
include "de.guntram.mcmod:crowdin-translate:1.2"
</code>

现在你可以在你的 ''ClientModInitializer'' 中添加以下方法，用你的 Crowdin 项目名称替换 ''projectname'' ，用你的 mod 的 ID 替换 ''modid'' 。

<code Java>
CrowdinTranslate.downloadTranslations("projectname", "modid");
</code>

现在，当启动游戏时，你可以看到翻译已经从 Crowdin 下载并应用于你的 mod 。

==== FAQ ====

Q：没有任何东西被下载 / 依赖库说该文件不存在!

A：请确保在 Crowdin 项目设置中按下 "Build Project"。当你向更新玩家的翻译的时候，你必须要重新构建你的项目。

Q：下载的文件格式不对！ / 它们出现的是 ''es_ES.json'' 而不是 ''en_us.json'' ，他不是正确的格式！

A：请确保你将源文件设置为小写格式，因为在lowerUpper格式下，它是无法工作的。