synspace-beta.vercel.app

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Type name in lowercase kebab-case, e.g. \"tree\" or \"bus-shelter\". This is what spawn_3d_asset takes as model_type. Cannot be a built-in kind."
    },
    "name": {
      "type": "string",
      "description": "Display name shown to people, e.g. \"Oak Tree\"."
    },
    "category": {
      "type": "string",
      "enum": [
        "Workstations",
        "Seating",
        "Collaboration",
        "Hospitality",
        "Storage",
        "Infrastructure",
        "Structure",
        "Urban",
        "Ambience"
      ],
      "description": "Which section of the asset library it belongs in."
    },
    "description": {
      "type": "string",
      "description": "One line on what it is and where it belongs."
    },
    "color": {
      "type": "string",
      "description": "Default 6-digit hex accent colour. Parts that set no colour of their own use it."
    },
    "clearance": {
      "type": "number",
      "description": "Optional clear space to keep around it, in metres. Derived from its size if omitted."
    },
    "signage_height_m": {
      "type": "number",
      "description": "Optional. When set, the placed object’s label is painted onto the front face at this height in metres — good for anything that should read as a named place."
    },
    "parts": {
      "type": "array",
      "minItems": 1,
      "maxItems": 24,
      "description": "The solids it is built from. Sizes and positions are metres; the origin is on the floor at the object centre, so a 2 m post is size [0.2, 2, 0.2] at position [0, 1, 0].",
      "items": {
        "type": "object",
        "properties": {
          "shape": {
            "type": "string",
            "enum": [
              "box",
              "cylinder",
              "sphere",
              "cone"
            ],
            "description": "Which primitive solid."
          },
          "size": {
            "type": "array",
            "items": {
              "type": "number"
            },
            "minItems": 3,
            "maxItems": 3,
            "description": "[width, height, depth] in metres. For a cylinder or cone, width and depth are the diameters."
          },
          "position": {
            "type": "array",
            "items": {
              "type": "number"
            },
            "minItems": 3,
            "maxItems": 3,
            "description": "[x, y, z] offset of the part centre from the asset origin, in metres."
          },
          "rotation": {
            "type": "array",
            "items": {
              "type": "number"
            },
            "minItems": 3,
            "maxItems": 3,
            "description": "Optional [x, y, z] rotation in radians."
          },
          "color": {
            "type": "string",
            "description": "Optional 6-digit hex. Omit to take the placed object’s accent colour."
          },
          "finish": {
            "type": "string",
            "enum": [
              "matte",
              "soft",
              "satin",
              "metallic"
            ],
            "description": "Optional surface treatment. Defaults to matte."
          }
        },
        "required": [
          "shape",
          "size",
          "position"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "type",
    "name",
    "category",
    "parts"
  ],
  "additionalProperties": false
}