Docs menu · File formats & export

Documentation

File formats & export

Export formats

FormatContainsBest for
.glb / .gltfTriangle meshes with vertex colours, UVs and one PBR material per material nameUnreal, Unity, Blender, the web
.objMesh with vertex colours (as extra vertex columns) and material groups; points only if there are no facesUniversal exchange
.plyMesh, or a coloured point cloud when the geometry has only pointsPoint clouds, scans, particles
.stlPlain triangle mesh3D printing
.tgeo.npzTessera’s own cache: everything, including all attributes, groups, volumes and heightfieldsBaking and reloading in Tessera
.png 16-bit + .r16Heightmap and 8-bit mask weightmaps (via hf_export)Unreal Landscape

The format is chosen from the file extension. Exports go to %USERPROFILE%\Tessera\exports unless you give a full path.

How to export

  • Ask the AI: “export the village as a GLB to C:\Game\Assets\village.glb”.
  • Export node: add an export node at the end of a chain and set its file. It writes on cook and passes the geometry through, so the export is part of the recipe.
  • API / MCP: POST /api/export or the export tool with path (the node) and file.
Export a node to GLB
Invoke-RestMethod -Method Post -Uri http://127.0.0.1:7419/api/export -ContentType 'application/json' -Body '{"path":"main/OUT_village","file":"C:/Game/Assets/village.glb"}'

Frame sequences

Give frame_start and frame_end to export one file per frame, for example a simulation. Put $F4 in the file name for a 4-digit frame number ($F for no padding); without it Tessera inserts .$F4 before the extension.

{"path":"sim","file":"~/Tessera/exports/debris.$F4.glb","frame_start":1,"frame_end":90}

File paths in nodes and exports also understand $HOME, ~ and environment variables such as %USERPROFILE%.

Colours and materials

  • Colours come from Cd (point or primitive, 0..1) and are written as vertex colours.
  • The material node assigns a material name, base colour, roughness and metallic to primitives. GLB export builds one PBR material per name, so each material gets its own slot in Unreal or Blender.
  • The building, fairy and nature nodes already set materials (wall, glass, timber, roof, bark, leaf, rock…).
  • The Unreal live link always sends one mesh with vertex colours and the shared vertex-colour material; use a GLB export when you want separate material slots.

Heightmaps

hf_export writes a 16-bit greyscale PNG, an .r16 raw file and 8-bit mask PNGs, resampled to an Unreal-recommended size, and reports the Landscape import scale and location. See Terrain & Unreal heightmaps.

Importing files

The file node imports OBJ, PLY, STL, GLB / GLTF and OFF meshes, and .tgeo.npz caches. Bring in a hero asset and scatter, fracture or sculpt it like any other geometry. stash keeps a frozen copy of geometry inside the scene itself.

Scene files (.tsr)

A .tsr is the whole project as JSON: graphs, nodes, parameters, expressions, wires, flags, comments, positions and frame settings. It contains the recipe, not the cooked geometry, so it stays small; opening it re-cooks. Save with Ctrl+S; files go to %USERPROFILE%\Tessera\scenes unless you give a path.

Renders

Tessera has a built-in software renderer the AI uses to look at its work (render tool, POST /api/render): perspective, front, side, top, back, left or a four-view quad, at any frame and size. The latest render is saved as %USERPROFILE%\Tessera\renders\last.png. For final images, export to Unreal or Blender.