Export Formats

Your vegetation. Your data. Save manifests locally or push them straight to poqpoq World.

Vegetation Manifest

The Landscaper manifest is a JSON document that describes every placed instance: position, rotation, scale, species, and layer membership. It's the universal interchange format — any renderer can read it and populate a scene.

{
  "version": "1.0",
  "timestamp": "2025-12-15T14:30:00.000Z",
  "instanceId": "world-abc-123",
  "regionBounds": {
    "type": "bounds",
    "minX": -128, "maxX": 128,
    "minZ": -128, "maxZ": 128
  },
  "layers": [
    {
      "layerId": "layer-pine",
      "speciesId": "pine",
      "algorithm": "poisson",
      "instances": [
        {
          "position": { "x": 12.5, "y": 3.2, "z": -45.8 },
          "rotation": { "x": 0, "y": 2.14, "z": 0 },
          "scale": { "x": 1.1, "y": 1.1, "z": 1.1 }
        }
      ]
    }
  ],
  "stats": {
    "treeCount": 200,
    "triangleCount": 850000
  }
}

Manifest Structure

Export Methods

Local Download (JSON)

Click the download button to save the manifest as a JSON file. The filename includes the date: landscaper-2025-12-15.json. This is a standard browser download — the file is created client-side via the File API. No server involved.

Save to World (postMessage)

When running inside poqpoq World, click Save to World to send the manifest directly to the parent World app via postMessage. The World app receives the manifest and persists it via NEXUS. No file download needed.

Using Manifests

A manifest is renderer-agnostic. Any Three.js, Babylon.js, or custom renderer can parse it and create instances. The typical workflow:

1. Parse the manifest — Read JSON, iterate layers and instances
2. Look up species — Use speciesId to find the generator or model
3. Create instances — Generate meshes and place them at the recorded positions with recorded transforms
4. Optimize rendering — Use instanced meshes, LOD cascades, or billboards for performance

// Loading a manifest in any Three.js app
const manifest = JSON.parse(jsonString)

for (const layer of manifest.layers) {
  for (const inst of layer.instances) {
    const mesh = generateSpecies(layer.speciesId)
    mesh.position.set(inst.position.x, inst.position.y, inst.position.z)
    mesh.rotation.set(inst.rotation.x, inst.rotation.y, inst.rotation.z)
    mesh.scale.set(inst.scale.x, inst.scale.y, inst.scale.z)
    scene.add(mesh)
  }
}

OpenSim Compatibility

Species IDs map to OpenSim state IDs (0–20), ensuring manifests generated by Landscaper can be translated to Second Life / OpenSimulator tree objects. The species registry maintains this mapping.