TLocale 使用文档

本文指所有由 TabooLib 创建的 i18n 语言文件。

中心配置文件

位于 plugins/TabooLib/settings.yml。
只有在该配置文件下添加特定的语言文件加载顺序，才会在插件中生效。或由插件本身代理这个节点。

# 语言文件相关设置
LOCALE:
  # 加载语言文件的顺序
  PRIORITY:
    - zh_CN
    - en_US
    # 若要增加西班牙语，则在该节点下添加对应语言代码即可。
    - es_ES
  # 语言文件名称替换
  TRANSFER:
    zh_hans_cn: zh_CN
    zh_hant_cn: zh_TW
    en_ca: en_US
    en_au: en_US
    en_gb: en_US
    en_nz: en_US
  # 默认是否启用语言文件中 PlaceholderAPI 的替换功能
  # 关闭可提升性能
  # 如果需要开启仍然可以在语言文件中加入 papi: true
  USE_PAPI: false
  # 默认是否启用语言文件中 Kether 的替换功能
  # 关闭可提升性能
  # 如果需要开启仍然可以在语言文件中加入 kether: true
  USE_KETHER: false

书写规范

任何节点均可使用单独的 TLocale 对象，或 TLocale 对象列表。

language: 'Hello World!'
language:
  ==: TEXT
  text: 'Hello World!'
language:
  - ==: TEXT
    text: 'message %player_name%'
    papi: true
  - ==: ACTION
    text: 'message {{ player name }}'
    Kether: true

音效

language:
  ==: SOUND
  sound: BLOCK_ANVIL_BREAK-1-1

标题

language:
  ==: TITLE
  title: '大标题信息'
  subtitle: '小标题信息（可省略）'
  fadein: 0
  fadeout: 0
  stay: 0

血条

language:
  ==: BAR
  text: 'BossBar 信息'
  color: BLUE
  style: NOTCHED_20
  # 进度百分比
  progress: 1.0
  # 持续时间
  timeout: 20

超文本

language:
  ==: JSON
  text: '超<文本@node1>信息'
  args:
    node1:
      url: '鼠标点击打开链接'
      hover: '鼠标悬停显示内容'
      suggest: '鼠标点击补全内容'
      command: '鼠标点击执行命令'
      insertion: 'SHIFT + 鼠标点击复制内容'

动作栏

language:
  ==: ACTION
  text: '动作栏信息'