Condition Check Interaction

Checks whether the entity a player interacted with matches a player, mob, NPC, or custom name.

Inputs: 1 · Outputs: Match, No Match

IMPORTANT

Use this node with an Event Trigger set to Player Interacts with Entity for right-clicks, or a damage event if you want to detect left-clicks/attacks.

Settings

Check By

Selects the category of entity to validate against. Each category exposes its own Match By sub-selector.

Value	Label
player	Player
mob	Mob (Entity)
npc	NPC
other	Custom Name

---

When Check By = Player

Setting	Type	Required	Default	Description
Match By	Select	Yes	Is Player	Is Player — any player. Username — a specific player by name.
Username	String	Yes (if Username)	—	The player's username. Placeholders allowed.
Case Sensitive	Boolean	No	false	Exact capitalisation for username match.

When Check By = Mob

Setting	Type	Required	Default	Description
Match By	Select	Yes	Is Mob	Is Mob — any mob. Entity Type — a specific Minecraft entity type. Entity ID — by spawned entity ID. Custom Name — by name tag.
Entity Type	Select (searchable)	Yes (if Entity Type)	ZOMBIE	Minecraft mob type (e.g. ZOMBIE, CREEPER).
Entity ID	String	Yes (if Entity ID)	—	The stable ID assigned when the entity was spawned with Spawn Entity. Placeholders allowed.
Custom Name	String	Yes (if Custom Name)	—	Custom name set via name tag or plugin. Placeholders allowed.
Case Sensitive	Boolean	No	false	Exact capitalisation for name match.

When Check By = NPC

Setting	Type	Required	Default	Description
Match By	Select	Yes	Is NPC	Is NPC — any NPC. NPC ID — by spawned NPC ID. Custom Name — by display name.
NPC ID	String	Yes (if NPC ID)	—	The stable ID assigned when the NPC was spawned with Spawn NPC. Placeholders allowed.
Custom Name	String	Yes (if Custom Name)	—	Display name of the NPC. Placeholders allowed.
Case Sensitive	Boolean	No	false	Exact capitalisation for name match.

When Check By = Custom Name

Setting	Type	Required	Default	Description
Custom Name	String	Yes	—	Matches any entity (player, mob, or NPC) by its display name. Placeholders allowed.
Case Sensitive	Boolean	No	false	Exact capitalisation for name match.

Examples

Match a specific NPC by ID:

1. Event Trigger → Player Interacts with Entity
2. Check Interaction → Check By: NPC, Match By: NPC ID, NPC ID: shop_keeper
3. Match → Open GUI

Match any mob of type Zombie:

1. Event Trigger → Player Interacts with Entity
2. Check Interaction → Check By: Mob, Match By: Entity Type, Entity Type: ZOMBIE
3. Match → Run Command

Match a player by name:

1. Event Trigger → Player Interacts with Entity
2. Check Interaction → Check By: Player, Match By: Username, Username: %player%
3. Match → Send Message