Skip to main content

Gen Tools Reference

The gen agent has access to 31 specialized tools organized by category.

Scene Query

ToolDescription
gen_scene_infoGet complete scene hierarchy
gen_screenshotCapture viewport screenshot
gen_entity_infoGet detailed info about a named entity

Entity Creation

ToolDescription
gen_spawn_primitiveSpawn geometric primitives (sphere, cube, cylinder, torus, etc.)
gen_spawn_entitiesSpawn multiple entities in a single batch call
gen_spawn_meshSpawn custom mesh geometry
gen_load_gltfLoad entities from a glTF/GLB file

Entity Modification

ToolDescription
gen_modify_entityModify entity transform, material, or visibility
gen_modify_entitiesModify multiple entities in a single batch call
gen_delete_entityRemove an entity and its children
gen_delete_entitiesDelete multiple entities in a single batch call

Camera & Environment

ToolDescription
gen_set_cameraPosition and orient the camera
gen_set_lightConfigure scene lighting
gen_set_environmentSet background color and ambient light

Export

ToolDescription
gen_export_screenshotExport high-res image to file
gen_export_gltfExport scene as glTF/GLB file
gen_export_worldExport world with localized mesh assets for portability

Behaviors

Data-driven animations that stack on entities — no scripting required. See Behaviors for details.

ToolDescription
gen_add_behaviorAdd a behavior (orbit, spin, bob, look_at, pulse, path_follow, bounce)
gen_remove_behaviorRemove a behavior from an entity
gen_list_behaviorsList all behaviors on an entity
gen_pause_behaviorsPause or resume all behaviors globally

Audio

Procedural environmental audio with spatial emitters. See Audio for details.

ToolDescription
gen_set_ambienceSet ambient soundscape (wind, rain, forest, ocean, cave, stream)
gen_audio_emitterAttach a sound emitter to an entity
gen_modify_audioModify an existing audio emitter
gen_audio_infoGet audio system status

World Skills

Save and load complete worlds as reusable skills. See World Skills for details.

ToolDescription
gen_save_worldSave scene, behaviors, and audio to a skill directory
gen_load_worldLoad a saved world (clears existing scene by default)
gen_clear_sceneClear all entities, behaviors, and audio

Undo/Redo

ToolDescription
gen_undoUndo the last scene edit (spawn, delete, or modify)
gen_redoRedo a previously undone edit
gen_undo_infoShow undo stack status and available operations

📝 These docs are AI-generated on a best-effort basis and may not be 100% accurate. Found an issue? Please open a GitHub issue or edit this page directly to help improve the project.