Contents5 sections
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.

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.
[meta]
name = "ridge"
seed = 42
[grid]
size_m = [512, 512]
cell_m = 1.0
[[shape]]
op = "ridged"
amplitude_m = 40
scale_m = 320
octaves = 7MCP request
{
"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
| Engine | Import |
|---|---|
| Godot | Read hills_height.r16 into a terrain mesh and bind the PNG maps to a shader using layout.json. |
| Unity | In 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 Engine | Import the height PNG into Landscape and bind unpacked weight layers using layout.json scales. |
| three.js | Load hills_height.r16 into a vertex grid and bind the PNG maps to a shader material. |
Reference and examples
- ExamplesCompile heightmaps, normal maps and material masks for River Bend and a hills tile to shade and displace terrain in your engine.
- Spec keysgeofx spec keys, defaults and ranges come from the release schema. Set the erosion filter and amplification to cut channels along runoff paths.
- geofx in Godotgeofx wire writes a shader include, a script and lossless import files for Godot 4. These are outputs from our compiled hills example.
- Errorsgeofx names invalid keys and missing inputs in its report. Exit code 5 means the compile finished but missed a budget limit.
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.