发送消息

saturn:send_message

把文本组件发给符合接收条件的玩家，可选择聊天栏或动作栏。

以一个实体为对象执行操作。用于 entity_action、触发规则的 action 等实体动作字段；动作数组会按顺序执行。

JSON 字段

字段	类型	必填	默认值	说明
type	资源 ID	是	—	saturn:send_message
message	文本组件	是	—	发给玩家的文本组件；字符串按翻译键处理。
channel	枚举字符串	否	"chat"	消息通道，可用值见下文枚举说明。 可用值：chat、action_bar。
target	枚举字符串	否	"self"	动作目标、目标 ID 或目标选择，具体见本页类型说明。 可用值：self、other、all。
recipients	实体条件	否	{"type":"saturn:always"}	对每个候选接收玩家检查的实体条件。

channel 可用 chat、action_bar。target=self 选择 actor / 物品持有者，other 选择双实体 target，all 选择当前服务端维度的玩家。方块动作没有自身收件人，通常使用 all。recipients 对每位候选玩家单独检查。

JSON 示例

{
  "type": "saturn:send_message",
  "message": {
    "text": "操作完成"
  }
}

这是可嵌入相应字段的值，不是单独可加载的数据包文件。示例中的 example: 引用需要替换为已定义的条目。

Java 入口

com.iafenvoy.saturn.data.action.builtin.SendMessageAction。本页按当前 26.1.2 源码的 Codec 整理。