Send message

saturn:send_message

Sends a text component to players that match the recipient condition, optionally to the chat bar or the action bar.

The context contains an actor (the initiator) and a target. The same ID may have different fields in the entity action and bi-entity action registries; the two kinds are not interchangeable.

JSON fields

Field	Type	Required	Default	Description
type	Resource ID	yes	—	saturn:send_message
message	Text component	yes	—	Text component sent to players; strings are treated as translation keys.
channel	Enum string	no	"chat"	Message channel; see the enum notes below for available values. Available values: chat, action_bar.
target	Enum string	no	"self"	Action target, target ID or target selection; see the type description on this page. Available values: self, other, all.
recipients	Entity condition	no	{"type":"saturn:always"}	Entity condition checked for each candidate recipient player.

channel accepts chat and action_bar. target=self selects the actor / item holder, other selects the bi-entity target, and all selects the players in the current server dimension. Block actions have no recipients of their own, so they usually use all. recipients is checked separately for every candidate player.

JSON example

{
  "type": "saturn:send_message",
  "message": {
    "text": "Operation complete"
  }
}

This is a value to embed in the corresponding field, not a standalone loadable data pack file. The example: references in the examples must be replaced with defined entries.

Java entry point

com.iafenvoy.saturn.data.action.builtin.SendMessageAction. This page is based on the Codec in the current 26.1.2 source.