本地化

QuickShop-Hikari使用客户端语言为玩家显示语言。 所有翻译均由志愿者在Crowdin上提供。

Crowdin 项目

To help translate QuickShop-Hikari, please visit our Crowdin Homepage.

Crowdin OTA

QuickShop-Hikari将自动从 Crowdin 通过 Crowdin OTA更新翻译。当您重新加载QuickShop-Hikari 或重新启动您的服务器时，所有本地更改都会被直接覆盖。

您的插件会保持最新翻译，无需任何调整。

自定义翻译

因为所有本地更改将在重启或重新加载时丢失，所以无法直接编辑原始文件， 您必须使用我们的翻译覆盖系统来代替。

从 Github 获取原始文件

在使用覆盖系统之前，您必须从 Github 获取原始翻译文件（因为本地覆盖文件默认为空文件）。

点击此处

搜索您的语言并进入，然后点击下载翻译。

覆盖 OTA 翻译

跳转到您的语言对应的 OTA 覆盖文件夹：

MINECRAFT_SERVER_ROOT/plugins/QuickShop-Hikari/override/LOCALE_CODE/messages.yml

您应该找到一个空白的 YAML 格式文件，将其打开。

复制原始翻译中的键和值以覆盖文件，然后您可以根据需要对其进行编辑。

您可以直接复制整个内容，也可以保留结构并复制和修改其中的一部分。 未被覆盖的翻译密钥将被 Crowdin OTA 提供的值覆盖。

翻译支持 MiniMessage 语法。

使它工作

Save and execute command /quickshop reload to make it works.

更新

覆盖文件不会自动更新，一旦我们的翻译有新的更新，您必须自己来更新。

调试：我如何知道 Minecraft 使用的语言环境代码？

Type /quickshop debug in-game to turn on the debug mode, re-join the server or change the client language, the server console should print the locale code that you using.

强制使用单一语言

如果您的服务器不面向世界各地的玩家，或者如果您想禁用服务器上的特定语言，则可以在 config.yml 中进行设置。

#Choose which languages should be enabled
#Any client connect to server that using disabled language, will fallback to game-language option there
#Set to - '*' to enable all available languages
#The language files will automatically update thorough Crowdin OTA system, you can translate it there:
#https://crowdin.com/project/qs-hikari
#If you want custom the language file, use language override system:
#https://quickshop-community.github.io/QuickShop-Hikari-Documents/docs/modules/localization
enabled-languages:
  - '*'

例如，要在服务器上仅允许 zh-CN 语言，您可以设置为：

enabled-languages:
  - 'zh-CN'

或者多种语言

例如，要在服务器上仅允许 zh-CN 语言，您可以设置为：

enabled-languages:
  - 'zh-CN'
  - 'zh-HK'
  - 'zh-TW'

更改默认游戏语言

在某些情况下，QuickShop-Hikari需要使用全局默认语言，您可以使用此选项修改默认全局语言。

尽管在绝大多数情况下，QuickShop-Hikari不会使用此选项， 您仍然可以配置它(如果您想要)，我们建议保留默认值。

config.yml 中的注释可能已过时。

#Set it to default will use your system language.
#You can find the valid language code in your client language settings, like en_us
game-language: default

Disable CrowdinOTA

If you're in a region which cannot access our OTA server, or you have a really slow connection, you can disable CrowdinOTA directly, QuickShop-Hikari will still use cached translations or bundled translations.

To disable the CrowdinOTA, please add it in the startup flag:

-Dcom.ghostchu.quickshop.localization.text.SimpleTextManager.enableCrowdinOTA=false

Self-Hosted OTA Server

If you self-hosted our translation server by using CrowdinCopyDeploy tool, you're able to change the OTA server to yourself server.

-Dcom.ghostchu.quickshop.localization.text.SimpleTextManager=<YOUR_SERVER_ADDRESS>