xrwise-datastructure/objects/Billboard.md

Billboard

Type

pre-defined

3D

The Billboard is a 4m x 2,25m opaque Plane. Its Origin is at the Bottom-Center. Spawnpoint should be {0,1,0} so its 1m above the floor.

Custom Args:

Key	Type	Implemented	Description
url	string	✔️	Storage path within user_files bucket (e.g. uuid/image.png). A signed URL is generated at runtime.
grabable	"true" / "false"	⚠️ (Unity missing)	Whether the item can be grabbed in-experience (common to all types)

Special Notes:

The Creator handles image uploads and assigns the storage path to url. The url value is a Supabase storage path, not a full URL — the runtime calls CreateSignedUrl to fetch the actual image.

Example:

{
  "position": { "x": 5, "y": 1, "z": -6 },
  "rotation": { "x": 0.0, "y": 0.0, "z": 0.0 },
  "scale":    { "x": 1.0, "y": 1.0, "z": 1.0 },
  "type": "pre-defined",
  "resourcename": "Billboard",
  "item-custom-args": [
    { "argument": "url", "value": "b83a17ab-92bf-4122-a4d0-7b467a105ae0/Screenshot_Loading.png" }
  ],
  "item-custom-args-adv": null
}