Skip to main content

本地化

QuickShop-Hikari uses each player's client language. All translations are provided by volunteers on Crowdin.

Crowdin 项目​

Crowdin

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

Crowdin OTA​

QuickShop-Hikari automatically updates translations through Crowdin OTA. Any direct changes to the local translation files will be overwritten when you reload QuickShop-Hikari or restart the server.

This keeps your translations up to date without manual intervention.

自定义翻译​

Because direct local changes are lost after a restart or reload, do not edit the original file. Use the Translation Override system instead.

Get the original file from GitHub​

Before using the override system, download the original translation file from GitHub (the local override file is empty by default).

点击此处

Find your locale, open it, and download the translation file.

覆盖 OTA 翻译​

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

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

You should find a blank YAML file. Open it.

Copy the keys and values that you want to change from the original translation into the override file, then edit them as needed.

You can copy the entire content directly, or keep the structure and copy and modify parts of it. Translation keys that are not overridden will be overridden with the value provided by Crowdin OTA.

Translations support MiniMessage syntax.

You also may need MiniMessage web viewer

使它工作​

Save the file, then run /quickshop reload to apply the changes.

更新​

The override file is not updated automatically. You must update it manually when the upstream translation changes.

DEBUG: How can I find the locale code used by Minecraft?​

Run /quickshop debug in game to enable debug mode. Rejoin the server or change your client language; the server console should then print the locale code in use.

强制使用单一语言​

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

# Enable specific languages for players.
# If a player uses a disabled language, the plugin will fall back to "game-language".
#
# Use:
#   - '*' to enable all available languages.
#
# Language files can update automatically via Crowdin OTA:
#   https://crowdin.com/project/qs-hikari
#
# For custom translations, use the language override system:
#   https://quickshop-community.github.io/QuickShop-Hikari-Documents/docs/modules/localization
enabled-languages:
- '*'

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

enabled-languages:
  - 'zh-CN'

或者多种语言

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

更改默认游戏语言​

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

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

The comments in config.yml may be outdated.

# Default language used by the plugin.
# Set to "default" to use the player's Minecraft client language automatically.
# Example language code: 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

🆕 Starting in 6.3.0.0 SNAPSHOT 2​

Beginning with 6.3.0.0 SNAPSHOT 2, the JVM startup flag has been replaced by an entry in config.yml.

Use

use-crowdin-ota: false

Self-Hosted OTA Server​

If you self-host the translation server using CrowdinCopyDeploy, you can point the OTA client to your own server.

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

🆕 Starting in 6.3.0.0 SNAPSHOT 2​

Beginning with 6.3.0.0 SNAPSHOT 2, the JVM startup flag has been replaced by an entry in config.yml.

Use

crowdin-host: <YOUR_SERVER_ADDRESS>