Placeholders

%mob_type%

String

Spoofed entity type name as displayed to the client (e.g., "Creeper", "Evoker").

%mob_uuid%

String

Mob's UUID as a string, useful for issuing commands (e.g., %mob_uuid% in effect commands).

%mob_health%

Float

Current health in half-hearts.

%mob_max-health%

Float

Maximum health.

%mob_remaining-health%

Double

Health-to-max ratio (0.0 to 1.0); useful for phase gating.

%mob_has-target%

Boolean

True if the mob has an active target (player or entity).

%mob_active-goal%

String

Simple class name of the currently running AstralGoal, or "none" if no blueprint goal is active.

%mob_location%

LocationPlaceholder

Mob's current block location; supports sub-placeholders (%mob_location_x%, %mob_location_y%, %mob_location_z%, %mob_location_world%).

%mob_location-up%

LocationPlaceholder

Mob's location offset one block upward; used for particle/visual effects.

%mob_target_id%

Integer

The target's entity id — the one target key that still answers without a target, resolving to -1. That is never a real entity id (the server hands out positive ones) and is what the vanilla protocol itself uses for "no entity", so an action fed it addresses nothing rather than some other mob. Read it unconditionally instead of guarding with %mob_has-target%.

%mob_target_name%

String

Display name of the target (typically a player name).

%mob_target_type%

String

Entity type of the target (e.g., "Player", "Zombie").

%mob_target_distance%

Float

Distance in blocks from the mob to the target.

%mob_target_health%

Float

The target's current health.

%mob_target_max-health%

Float

The target's maximum health.

%mob_target_location%

LocationPlaceholder

The target's location.

%mob_target_location-up%

LocationPlaceholder

The target's location, one block up — the usual anchor for a skill aimed at its chest.

%mob_memory_<key>%

Object

Arbitrary value stored under <key> by the store-memory action. Defaults to the string "0" if the key has never been set.

%mob_timer_<key>%

Long

Milliseconds elapsed since the timer <key> was last started. Returns 0 if the timer was never started; this is the special case used in requirement gates (e.g., [compare] %mob_timer_cooldown% == 0 on the first tick).

%mob_passenger%

NMSMob or null

If this mob is a vehicle carrying a blueprint passenger, returns the passenger mob; otherwise null.

%mob_vehicle%

NMSMob or null

If this mob is mounted as a passenger on another blueprint mob, returns the vehicle mob; otherwise null.

%mob_has-passenger%

Boolean

True if this mob has a passenger.

%mob_has-vehicle%

Boolean

True if this mob is mounted on a vehicle.

%mob_type%

String

Spoofed entity type name.

%mob_uuid%

String

Mob UUID (string format).

%mob_health%

Float

Current health (half-hearts).

%mob_max-health%

Float

Maximum health.

%mob_remaining-health%

Double

Health-to-max ratio (0–1).

%mob_memory_<key>%

Object

Stored value under key, or "0" if unset.

%mob_timer_<key>%

Long

Milliseconds elapsed since timer key started (0 if never started).

%mob_passenger%

NMSMob or null

Passenger mob, or null.

%mob_vehicle%

NMSMob or null

Vehicle mob, or null.

%mob_has-passenger%

Boolean

Has a passenger.

%mob_has-vehicle%

Boolean

Mounted on a vehicle.

%mob_has-target%

Boolean

Has an active target.

%mob_location%

LocationPlaceholder

Current location.

%mob_location-up%

LocationPlaceholder

Location + 1 block up.

%mob_target_id%

Integer

Target entity id; -1 when there is no target.

%mob_target_name%

String

Target display name (null if no target).

%mob_target_type%

String

Target entity type (null if no target).

%mob_target_distance%

Float

Distance to target (null if no target).

%mob_target_health%/%mob_target_max-health%

Float

Target health (null if no target).

%mob_target_location%/%mob_target_location-up%

LocationPlaceholder

Target location, and one block above it (null if no target).

%mob_active-goal%

String

Running goal class name, or "none".