🌍 国际化/本地化

i18n 是一套完全服务端化的本地化系统，这意味着您使用的 <i18n> 标签实际上是在服务端进行应用的。使用的语言由服务端的语言设置决定，与玩家客户端的语言无关。

l10n 则为客户端提供了定制化的本地化体验。<l10n> 标签会根据玩家客户端选择的语言来选取对应的翻译文本，不受服务端语言设置的影响。

信息

语言的国家和地区标识为可选项（如 "en_us" 可简写为 "en"）。插件会优先查找针对特定国家和地区的语言版本，若不存在则查找通用语言版本，若仍未找到则默认使用英语 (en) 作为回退语言。

示例配置：

translations:
  en:
    item.chinese_lantern: "Chinese Lantern"
    item.fairy_flower: "Fairy Flower"
    item.bench: "Bench"
    item.table_lamp: "Table Lamp"
    item.wooden_chair: "Wooden Chair"
  zh_cn:
    item.chinese_lantern: "灯笼"
    item.fairy_flower: "仙灵花"
    item.bench: "长椅"
    item.table_lamp: "台灯"
    item.wooden_chair: "木椅"

信息

使用示例 <i18n>/<l10n>:

items:
  custom:chinese_lantern:
    material: paper
    data:
      # 物品的名称将在服务端真实地被替换为 "灯笼" 并存储在数据组件中
      item-name: "<i18n:item.chinese_lantern>"

items:
  custom:chinese_lantern:
    material: paper
    data:
      # 物品的名称将以 <l10n:item.chinese_lantern> 原始文本的形式存储
      # 并在客户端收到此物品的数据包时自动选择合适的语言替换
      item-name: "<l10n:item.chinese_lantern>"

提示

您还可以在其他插件中使用 <l10n> 标签，实现实时本地化！