聊天类型定义格式

聊天类型定义文件是聊天类型（Chat Type）在数据包中的数据驱动定义文件。

聊天类型

聊天类型是游戏用于标识不同聊天信息作用的元信息。例如，游戏内系统信息和玩家发出的聊天信息就不是一种聊天类型。

聊天类型可以控制聊天信息在聊天框内的显示样式，也可以控制聊天信息的复述内容。游戏内只会使用下列7种聊天类型，由数据包定义的其他聊天类型在游戏内无法使用任何方式调用，但数据包可以覆盖定义这7种聊天类型以控制聊天信息的显示样式和复述内容。

下表中，sender表示发送信息的玩家名称，target表示接收信息的玩家或队伍名称，content表示发送的聊天消息。

注册名	描述	默认聊天格式	默认复述功能格式
chat	玩家发送的聊天消息	<sender> content	sender说content
emote_command	使用/me命令发送的消息	* sender content
msg_command_incoming	接收到来自其他玩家的私人消息	sender悄悄地对你说：content	sender说content
msg_command_outgoing	发送给其他玩家的私人消息	你悄悄地对target说：content
say_command	使用/say命令发送的消息	[sender] content
team_msg_command_incoming	接收到来自队伍的队伍消息	target <sender> content
team_msg_command_outgoing	发送给队伍的队伍消息	-> target <sender> content

定义格式

聊天类型在游戏内使用CHAT_TYPE注册表，数据包路径为chat_type，即所有聊天类型定义文件都需要在data/<命名空间>/chat_type目录内定义，聊天类型标签则需要在data/<命名空间>/tags/chat_type目录内定义。

由于游戏不会使用数据包自定义的聊天类型，也没有提供使用自定义聊天类型的方式，所以实际上真正可以生效的聊天类型定义文件只有游戏内定义的7个聊天类型，数据包也只能覆盖定义这7个聊天类型，其他文件均不生效，但会被游戏解析。另外，游戏也不使用聊天类型标签，因此所有聊天类型标签在游戏内无任何作用。

聊天类型定义文件使用JSON格式，并具有下列结构：

• JSON文件根对象
  • *chat：聊天信息在聊天框内的显示样式。
    • 见下文§ 聊天类型装饰。
  • *narration：聊天信息在使用复述功能时朗读的文本。
    • 见下文§ 聊天类型装饰。

聊天类型装饰

聊天消息会读取聊天类型中的装饰（Decoration）信息，将原始的发送者、接收者和消息内容格式化为文本组件或复述信息。

• 聊天类型装饰
  • *translation_key：一个翻译键。
  • *parameters：传入到翻译文本中的参数。
    • ：一个参数，对应的下标代表了传入到翻译文本中的顺序。具体取值见下文§ 生成翻译文本。
  • style：（默认没有样式）设置文本组件的样式。此项对复述文本无效。
    • 见文本组件 § 组件样式。

定义行为

聊天类型定义数据仅在服务端启动时被加载一次，使用/reload命令不可以使聊天类型定义被重新加载，而必须重启服务端。

生成翻译文本

当游戏在聊天栏内显示聊天信息，或复述聊天信息时，游戏就会读取对应聊天类型的装饰信息。

每种聊天类型的应用场景不同，导致实际上每种类型的参数不同。除一定存在的消息内容外，聊天信息还包含发送者和接收者，但有些类型不存在接收者。这三种参数可以在*parameters中定义，游戏会将对应下标的参数转换为文本组件后传入翻译文本内进行替换。下表中给出了这三种参数的枚举值和使用条件：

枚举值	参数含义	聊天类型可用性
content	聊天信息的消息内容	所有聊天类型均可用
sender	聊天信息发送者的显示名称	所有聊天类型均可用
target	聊天信息接收者的显示名称	仅msg_command_outgoing、team_msg_command_incoming和team_msg_command_outgoing可用，其他聊天类型此项为空文本组件

*parameters中参数可以重复出现。例如一个装饰信息中此项为["sender", "content", "sender"]，且翻译文本为%s: %s (%s)，假设发送者显示名称为A，消息内容为B，则最终显示的文本组件是A: B (A)。

历史

Java版
?							加入了聊天类型以区分不同聊天信息。
1.19			22w18a				重写了聊天类型系统，加入了CHAT_TYPE可写注册表，添加了聊天类型定义格式。
1.19.1			22w24a				style现在是可选的。
			pre2				简化了decoration，将其移入chat和narration中。
							移除了narration中的priority。
							移除了overlay。聊天类型现在不再能够用于动作栏。
							移除了内置聊天类型system、game_info和tellraw_command。
			pre3				聊天类型msg_command现在被拆分为msg_command_outgoing和msg_command_incoming。
							将聊天类型参数team_name重命名为target。其现在也被用于聊天类型msg_command_outgoing。
			pre5				聊天类型team_msg_command现在被拆分为team_msg_command_incoming和team_msg_command_outgoing。