TLocale 使用文档

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

中心配置文件

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

 1 # 语言文件相关设置
 2 LOCALE:
 3   # 加载语言文件的顺序
 4   PRIORITY:
 5     - zh_CN
 6     - en_US
 7     # 若要增加西班牙语，则在该节点下添加对应语言代码即可。
 8     - es_ES
 9   # 语言文件名称替换
10   TRANSFER:
11     zh_hans_cn: zh_CN
12     zh_hant_cn: zh_TW
13     en_ca: en_US
14     en_au: en_US
15     en_gb: en_US
16     en_nz: en_US
17   # 默认是否启用语言文件中 PlaceholderAPI 的替换功能
18   # 关闭可提升性能
19   # 如果需要开启仍然可以在语言文件中加入 papi: true
20   USE_PAPI: false
21   # 默认是否启用语言文件中 Kether 的替换功能
22   # 关闭可提升性能
23   # 如果需要开启仍然可以在语言文件中加入 kether: true
24   USE_KETHER: false

书写规范

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

 1 language: 'Hello World!'
 2 language:
 3   ==: TEXT
 4   text: 'Hello World!'
 5 language:
 6   - ==: TEXT
 7     text: 'message %player_name%'
 8     papi: true
 9   - ==: ACTION
10     text: 'message {{ player name }}'
11     Kether: true

音效

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

标题

1 language:
2   ==: TITLE
3   title: '大标题信息'
4   subtitle: '小标题信息（可省略）'
5   fadein: 0
6   fadeout: 0
7   stay: 0

血条

1 language:
2   ==: BAR
3   text: 'BossBar 信息'
4   color: BLUE
5   style: NOTCHED_20
6   # 进度百分比
7   progress: 1.0
8   # 持续时间
9   timeout: 20

超文本

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

动作栏

1 language:
2   ==: ACTION
3   text: '动作栏信息'