Skip to main content

Gen Tools Reference

The gen agent has access to 32 specialized tools organized by category. When running as an MCP server, 25 additional tools are available for characters, interactions, terrain, UI, and physics.

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, pyramid, etc.)
gen_spawn_batchSpawn multiple primitives in a single batch call
gen_spawn_meshSpawn custom mesh geometry from raw vertex data
gen_load_gltfLoad entities from a glTF/GLB file

Entity Modification

ToolDescription
gen_modify_entityModify entity transform, material, or visibility
gen_modify_batchModify multiple entities in a single batch call
gen_delete_entityRemove an entity and its children
gen_delete_batchDelete 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
gen_export_htmlExport world as self-contained HTML with Three.js (includes procedural audio via Web Audio API)

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.