Print (Entity Action Type)

Writes a line to the server log, and optionally to the entity’s chat. It is a debugging tool: drop it into an action list to see whether that branch ran and what a value came out as.

Type ID: apoli:print

Fields#

Field	Type	Default	Description
text	Text Component	optional	Text to print. A plain string works; so does a full text component with colour, translation or a keybind.
number	Expression	optional	A number to print. Written as a number, or as an expression that is evaluated against the entity every time the action runs.
message_id	String	apoli/print	The logger name the line is written under, so you can filter your prints out of the rest of the log.
show_in_chat	Boolean	false	Whether the entity also receives the line in chat. Only players can see chat; on any other entity this does nothing.

With both text and number the line reads Text: <text> Number: <number>. With only one of them, the line is just that value. With neither, the line is the message_id, which makes a bare apoli:print a “did this run?” marker.

A number that lands on a whole value prints without a decimal point — 5, not 5.0.

Examples#

"entity_action": {
    "type": "apoli:print",
    "text": "on_hit fired"
}

A trace marker: every time the action list runs, on_hit fired appears in the log.

"entity_action": {
    "type": "apoli:print",
    "message_id": "mypack/pollen",
    "text": "pollen level",
    "number": "resource('example:pollen')",
    "show_in_chat": true
}

Reads the resource every time the action runs and prints Text: pollen level Number: 4 both to the log under the mypack/pollen logger and to the player’s chat.

The action costs nothing when nobody is listening — if show_in_chat is false and the logger’s level excludes INFO, it returns before evaluating number. It is still a debugging tool: take it out of per-tick powers before you ship a pack, or you will write a log line every tick for every holder.