Built-in Instructions — Loop Adventure Docs

Player Instructions

Name	Class	Type	Description	Constraints
Move	`Instruction_Move`	PlayerInstruction	Move one cell in the set direction with smooth lerp animation.	Blocked by any `IObstacle`.
Jump	`Instruction_Jump`	PlayerInstruction	Jump two cells along a 3-point arc.	Costs 2 stamina. Cannot carry.
Attack	`Instruction_Attack`	PlayerInstruction	Deal damage to all entities in the adjacent cell. Applies weapon effects.	Cannot carry.
Heavy Attack	`Instruction_AttackHeavy`	PlayerInstruction	Two-phase charged attack with higher damage output.	Cannot carry.
Block	`Instruction_Block`	PlayerInstruction	Enter a blocking state that reduces incoming damage from the set direction.	—
Evade	`Instruction_Evade`	PlayerInstruction	Dodge to avoid an incoming attack.	Costs stamina.
Carry	`Instruction_Carry`	PlayerInstruction	Pick up an `ICarryObject` in the set direction.	Must face a carriable object.
Drop	`Instruction_Drop`	PlayerInstruction	Drop the currently carried object at the player's position.	Must be carrying.
Throw	`Instruction_Throw`	PlayerInstruction	Throw the carried object in the set direction along an arc trajectory.	Must be carrying.
Push	`Instruction_Push`	PlayerInstruction	Push an `IPushable` object one cell in the set direction.	Must face a pushable object.
Interact	`Instruction_Interact`	PlayerInstruction	Activate an adjacent `IInteractable` (doors, chests, pressure plates).	—
Use	`Instruction_Use`	PlayerInstruction	Consume a usable item from inventory and apply its effects.	Inventory must contain a usable item.
Wait	`Instruction_Wait`	PlayerInstruction	Skip a turn without performing any action.	—

Sequence Instructions

Name	Class	Max Children	Description
Combo	`Instruction_Combo`	4	Executes all child instructions in order within a single turn slot.
Ping Pong	`Instruction_PingPong`	4	Executes children forward on even loops and backward on odd loops, creating a back-and-forth pattern. For 3+ children, the backward pass skips the first and last to avoid repetition.

Modifier Instructions

Name	Class	Description
Rotate	`Instruction_Rotate`	Rotates the child instruction's direction 90° clockwise after each execution loop.
Invert	`Instruction_Invert`	Inverts the child instruction's direction (Up↔Down, Left↔Right) after each execution.

Built-in Enemy Instructions

Name	Class	Description
Move	`EnemyInstruction_Move`	Moves the enemy one cell in the configured direction.
Attack	`EnemyInstruction_Attack`	Deals damage to the player if adjacent in the attack direction.
Block	`EnemyInstruction_Block`	Sets the enemy into a blocking state, reducing incoming damage.
Shoot	`EnemyInstruction_Shoot`	Fires a projectile in the configured direction.
Wait	`EnemyInstruction_Wait`	Skips the enemy's turn.