QuadSpinner Gaea
Download GaeaTalk to Support
  • User Guide
  • Node Reference
  • Changelog
  • Home
  • Getting Started
    • Install Gaea
      • Regular Installation
      • Portable Installation
      • Mass Deployment
      • Troubleshooting
      • Version Numbers
      • Uninstall or Clean Install
    • License Management
      • Activation
      • Deactivation
      • Hardware Thumbprint
      • Floating License
    • User Interface
      • Graph
      • Viewport
        • Render Modes
        • 2D Viewport
        • Measurement Tools
      • Property Editor
        • Modifier Stack
        • Presets
        • Binding Variables
      • Data Editor
        • Terrain View
        • Export View
        • Automation View
      • Menus and Toolbars
        • Main Menu
        • Undo and Autosave
        • Graph Toolbar
        • Viewport Toolbar
        • Property Editor Toolbar
        • Data Editor Toolbar
      • Lazy Menu
      • Keyboard Shortcuts
    • The Graph
      • Procedural Workflow
      • Toolbox and Search
      • Lock Preview and Underlays
      • Suspending Engine
      • Graph Conveniences
      • Portals and Chokepoints
      • Organizing with Tabs
      • Annotations
      • Groups
    • Managing Gaea
      • Command-line Interface
      • Options
        • Compute
      • Autosave and Recovery
    • For Gaea 1 Users
      • Migration Guide
      • Node Changes
  • Using Gaea
    • Terrain Basics
      • Creating a Snow Mountain
      • Creating a Simple Landscape
      • Exporting Elements
      • Importing Meshes
      • Masks
      • Non-Determinism
      • Scale and Resolution
      • Memory Requirements
    • Crafting the Surface
      • Noises, Primitives, and Landscapes
      • Erosion
      • Surface Nodes
      • Transpose Shapes
    • Understanding Erosion
      • Erosion_2
      • Erosion_1
      • Thermal Erosion
      • Additional Erosion Nodes
      • Nuance
    • Simulations
      • Snowfall
      • Debris
      • Water
      • Vegetation
    • Colorizing and Textures
      • Crafting Masks
      • Working with SatMaps
      • Synthesizing Colors
      • Layering Textures
      • ColorErosion
    • Managing Graphs
      • Using Modifiers
      • Portals and Chokepoints
      • Visualizing Scale
      • Accumulators
      • Navigating Complex Graphs
    • Baking Nodes
      • Linchpin Nodes
    • Build and Export
      • Exporting Nodes
      • Build Options
        • Managing Regions
      • Tiled Builds
      • Using Regions
      • Profiles and Batch Builds
      • Batch Builds
      • Mesh Exports
        • Tangent-Space Normals and Warped Maps
      • Application Specific Export Nodes
        • Unreal Node
        • Unity Node
    • Importing Terrains
      • Universal Instructions
      • Software-specific Instructions
        • Unreal
      • Common Issues
  • Advanced Topics
    • Build Swarm
      • Creating Mutations
      • Build Reports
    • Technical Information
      • File Formats
      • Learning and Predictive System
      • Paths and Storage
      • Dimensions and Scale
      • Calculating Memory Requirements
    • Automation
      • Command Line Automation
      • Managing Input and Output
      • Building a Bridge with the CLI
  • Plugins
    • Gaea2Houdini
      • Installing Gaea2Houdini
      • Using Gaea Nodes
    • Gaea2Unreal
      • Installing Gaea2Unreal
      • Importing Terrains
      • Importing Weight Maps
  • Developers
    • Scripting and Expressions
      • Variables
      • Expressions
      • Math Node
    • TOR Platform SDK
  • Troubleshooting
    • Terrains
      • Common Errors
      • Terrain Quality
    • Diagnostics (Watson)
      • Diagnostics Package
      • CPU Only Mode
      • Benchmark Devices
Powered by GitBook
LogoLogo

Copyright © 2020-2025 QuadSpinner. All rights reserved.

On this page
  • Gaea.exe
  • Gaea.Swarm.exe
  1. Getting Started
  2. Managing Gaea

Command-line Interface

Gaea provides two command line interfaces. One for the UI and for the Build Swarm.

Gaea.exe

You can use the CLI for Activation and Deactivation as well as setting the Proxy, or enforcing CPU Only Mode or enabling Verbose logging for detailed diagnostics.

USAGE: 
Gaea [[-Path] <String>] [-Activate <String>] [-CPUOnly] [-Deactivate] [-Help] 
     [-NoStart] [-Proxy <String>] [-SafeMode] [-UseProxy] [-Verbose] [-Version]

    -Path <String>
        The path of the file to read.

    -Activate <String>
        Activate license. Default value: <empty>.

    -CPUOnly [<Boolean>]
        Disable GPU/XPU acceleration, defaulting to CPU-only mode.
        Default value: False.

    -Deactivate [<Boolean>]
        Deactivate license. Default value: False.

    -Help [<Boolean>] (-?, -h)
        Displays this help message.

    -NoStart [<Boolean>]
        Disable Start Screen Default value: False.

    -Proxy <String>
        Set Proxy for all network communications. Default value: <empty>.

    -SafeMode [<Boolean>]
        Enforce Safe Mode. Default value: False.

    -UseProxy [<Boolean>]
        Use Proxy for all network communications.

    -Verbose [<Boolean>]
        Enable Verbose logging for diagnostics and technical usage purposes.
        Default value: False.

    -Version [<Boolean>]
        Displays version information.

Gaea.Swarm.exe

For the Build Swarm, see Command Line Automation.

USAGE:
Gaea.Swarm [[--Filename] <String>] [--ignorecache] [--interactive] [-p <String>] 
           [-r <String>] [--safemode] [--seed <Int32>] 
           [-v <String=String>...] [--va <String>...] [--vars <String>] [--verbose]

OPTIONS:
  --Filename <string>
      REQUIRED. Relative or absolute path to the terrain file to build.

  --ignorecache               
      Force Build Swarm to ignore Baked Cache.
  
  --interactive               
      Show interactive prompts when launched from the CLI.
  
  -p|--profile <string>       
      Build Profile to use when executing the Build.
  
  -r|--region <string>        
      Set the Region that should be built.
  
  --safemode                  
      Enforce Safe Mode.
  
  --seed <int32>              
      Mutation seed to use for the build.
  
  -v|--v <string=string>      
      Repeat in key-value pairs to assign variables. Ex: -v foo:0.63.
                              
  --va <string>               
      Comma separated variable values alphanumerically-sorted by variable names. 
      Must include all values.
                              
  --vars <string>             
      Fully qualified path to a .json or .txt file that
      contains variable name-value pairs for automation.
                              
  --verbose                   
      Enable Verbose logging for diagnostics and technical usage purposes.
PreviousManaging GaeaNextOptions

Last updated 2 months ago