DOCS // geofx

geofx docs Available

Shape hills, valleys and rivers from a .geo.toml recipe to build terrain surfaces with matching soil, rock and wetness.

Contents5 sections
  1. Output files
  2. Estimate and bake
  3. Engine import
  4. Reference and examples
  5. Questions

geofx runs on the hosted API: try it in the Playground.

Output files

For the Hills example, height is written to godot/hills_height.r16 and normals to godot/hills_normal.png. Material weight PNGs and layout.json guide how terrain layers map in your scene.

A winding riverbed runs between limestone ridges.
River bend

Estimate and bake

First call MCP estimate with the request payload and check the quoted price. If approval is required and the user agrees, include the returned quote.id as accept_quote in submit, or use POST /v1/estimate then POST /v1/jobs over REST with the same approval flow.

ridge.geo.toml
[meta]
name = "ridge"
seed = 42

[grid]
size_m = [512, 512]
cell_m = 1.0

[[shape]]
op = "ridged"
amplitude_m = 40
scale_m = 320
octaves = 7
MCP request
JSON
{
  "module": "geofx",
  "operation": "bake",
  "quality": "draft",
  "spec": "[meta]\nname = \"ridge\"\nseed = 42\n\n[grid]\nsize_m = [512, 512]\ncell_m = 1.0\n\n[[shape]]\nop = \"ridged\"\namplitude_m = 40\nscale_m = 320\noctaves = 7\n"
}

Engine import

EngineImport
GodotRead hills_height.r16 into a terrain mesh and bind the PNG maps to a shader using layout.json.
UnityIn Unity, normalize decoded geofx heights before passing them to TerrainData.SetHeights. Read channel names from layout.json and unpack the material weights from the PNG maps into alphamaps.
Unreal EngineImport the height PNG into Landscape and bind unpacked weight layers using layout.json scales.
three.jsLoad hills_height.r16 into a vertex grid and bind the PNG maps to a shader material.

Reference and examples

Questions

What output files does a geofx bake produce?

A geofx bake writes 16 bit heightmaps, normal maps, material weight PNGs and layout.json to guide terrain layers in your scene.

How do I estimate and submit a geofx job?

Call MCP estimate with your payload first, then pass the returned quote.id as accept_quote in submit if approval is required.

How do engines import geofx height and material maps?

Godot and three.js read the raw height file into a mesh, Unity normalizes heights for TerrainData and Unreal imports the height PNG.