Command · foliage

foliage.rule.set

Add or update a seeded scatter rule; worker regeneration keeps stable identities.

scope edit:scenenot idempotentnon-destructive

Params

Typed as FoliageRuleParams. Fields marked * are required.

option<string>

Optional existing ID or new symbolic ID.

default null

rule*

FoliageRule

Seeded rule and placement filters.

required

Examples

JSON (MCP ara_apply, batches)

{
  "cmd": "foliage.rule.set",
  "args": {
    "rule": {
      "name": "Grass",
      "species": "grass",
      "asset": "@grass.foliage#fo_grass001",
      "seed": 42,
      "cellSize": 2,
      "density": 0.2,
      "height": [
        0,
        500
      ],
      "slope": [
        0,
        40
      ],
      "channel": 0,
      "minWeight": 0.1,
      "noise": 0.3,
      "scale": [
        0.8,
        1.2
      ],
      "enabled": true
    }
  }
}

CLI

ara do foliage.rule.set --args '{"rule":{"name":"Grass","species":"grass","asset":"@grass.foliage#fo_grass001","seed":42,"cellSize":2,"density":0.2,"height":[0,500],"slope":[0,40],"channel":0,"minWeight":0.1,"noise":0.3,"scale":[0.8,1.2],"enabled":true}}' --why "…"