Place actors and capture the viewport

Before you start

• Hayba is installed and your agent is connected. See Getting started.
• A level with a floor is open, such as the default open world template.
• Review each external edit is off. Spawning actors cannot be approved by the exact review on this version. Moving and deleting existing actors can; see What can be approved.

Prompt

List the actors in the level. Then place three cubes from /Engine/BasicShapes/Cube in a row 300 units apart, starting at 0, 0, 100, snapped to the floor, labelled Crate_1 to Crate_3. Check each spot is clear before placing it. Frame Crate_2 in the viewport, wait for shaders, and show me a capture.

What the agent does

1. actor_list lists every actor with label, class and transform.
2. placement_validate checks whether an actor would overlap anything at a spot, without spawning it.
3. actor_spawn_from_asset places each mesh by asset path, with snap_to_floor, and reads back the final transform.
4. actor_transform moves, rotates or scales an actor afterwards.
5. editor_focus_actor frames an actor from its bounds without tilting the horizon.
6. editor_capture_viewport returns the viewport as an image. With wait_for_shaders it waits for shader compiles first.

Things worth knowing:

• To spawn by class rather than asset, such as a light or a volume, the agent uses actor_spawn. For many actors at once, actor_batch_spawn uses one call and one undo entry.
• placement_validate answers about overlap only. It does not say whether the spot makes sense or is on the navmesh.
• Rotation order is not the same in every tool: actor_spawn_from_asset takes [roll, pitch, yaw], and the reference lists each tool's format. To aim the camera at a point, editor_set_camera takes look_at, which avoids computing angles.
• A capture taken while shaders compile shows grey placeholder materials. Use wait_for_shaders, or wait_for_idle before the capture.
• For a file on disk at a fixed resolution, render_camera renders a camera view and checks that the file was written.

Check the result

• Look at the capture the agent returns.
• Each placement is one entry in Edit, Undo History, named Hayba: <command>. Ctrl+Z removes them one at a time.
• The level is not saved until you or the agent save it.