{
  "schemaVersion": 1,
  "id": "jelly-cube",
  "version": "1.0.0",
  "status": "published",
  "kind": "object",
  "title": "Jelly Cube",
  "summary": "A translucent cube of jelly that hops, lands with a squash and wobbles itself still on a plate. Loops perfectly.",
  "description": "A cube of translucent jelly on a plate. It hops, stretching tall as it leaves the plate, lands with a deep squash and then wobbles itself still, its faces rippling in several octaves of travelling waves as the jelly shivers, glowing with the light that passes through it. Choose the flavour (strawberry, lime, grape or lemon), how many hops per loop, how much the jelly shivers, the mesh detail, the seed that sets the ripples, the backdrop colour and whether the camera sways.",
  "role": "Object (3D, three.js): a squishy, satisfying hero object for food, toys and playful content.",
  "collections": [
    "satisfying",
    "bouncing-falling",
    "product-reveals"
  ],
  "tags": [
    "jelly",
    "gelatin",
    "wobble",
    "squash and stretch",
    "jelly cube",
    "dessert",
    "bounce",
    "satisfying",
    "studio",
    "loop",
    "3d"
  ],
  "synonyms": [
    "jello",
    "gelatin cube",
    "wobbly jelly",
    "jiggle",
    "squishy cube",
    "jelly dessert"
  ],
  "useCases": [
    "A dessert, sweets or kids' brand scene",
    "A satisfying squishy loop",
    "A demonstration of squash and stretch"
  ],
  "featured": null,
  "publishedAt": "2026-10-06",
  "implementation": {
    "target": "three",
    "runtime": "browser",
    "language": "javascript",
    "module": "esm",
    "entry": "src/jelly-cube.js",
    "exports": [
      {
        "name": "createJellyCube",
        "signature": "createJellyCube({ flavour?, hops?, wobble?, detail?, seed? }) => { group, setProgress(progress), dispose() }",
        "description": "The jelly cube on its plate, about 2 across and standing on y = 0; needs an environment map."
      },
      {
        "name": "FLAVOURS",
        "signature": "FLAVOURS: { strawberry, lime, grape, lemon }",
        "description": "Jelly colours and opacities."
      }
    ],
    "reusable": [
      "src/jelly-cube.js"
    ],
    "demo": "demo.js",
    "harness": "index.html"
  },
  "dependencies": [
    {
      "id": "three",
      "version": "0.185.1",
      "reason": "Renderer, geometry and shader materials."
    },
    {
      "id": "chrome-material",
      "version": "1.1.0",
      "scope": "demo",
      "reason": "Studio environment light, backdrop and contact shadow."
    },
    {
      "id": "apw-runtime",
      "version": "1.0.0",
      "scope": "demo",
      "reason": "Demo harness."
    }
  ],
  "params": [
    {
      "key": "flavour",
      "label": "Flavour",
      "type": "select",
      "default": "strawberry",
      "options": [
        {
          "value": "strawberry",
          "label": "Strawberry"
        },
        {
          "value": "lime",
          "label": "Lime"
        },
        {
          "value": "grape",
          "label": "Grape"
        },
        {
          "value": "lemon",
          "label": "Lemon"
        }
      ]
    },
    {
      "key": "hops",
      "label": "Hops per loop",
      "type": "integer",
      "min": 1,
      "max": 4,
      "step": 1,
      "default": 2
    },
    {
      "key": "wobble",
      "label": "Shiver",
      "type": "number",
      "min": 0.3,
      "max": 1.8,
      "step": 0.1,
      "default": 1
    },
    {
      "key": "detail",
      "label": "Mesh detail",
      "type": "number",
      "min": 0.6,
      "max": 1.3,
      "step": 0.1,
      "default": 1
    },
    {
      "key": "seed",
      "label": "Seed",
      "type": "integer",
      "min": 1,
      "max": 999,
      "step": 1,
      "default": 12
    },
    {
      "key": "background",
      "label": "Backdrop",
      "type": "color",
      "default": "#d8d0d8"
    },
    {
      "key": "orbit",
      "label": "Camera sway",
      "type": "boolean",
      "default": true
    }
  ],
  "presets": [
    {
      "id": "default",
      "label": "Strawberry, two hops",
      "params": {}
    },
    {
      "id": "lime",
      "label": "Lime, big shiver",
      "params": {
        "flavour": "lime",
        "wobble": 1.7,
        "background": "#d4dccf"
      }
    },
    {
      "id": "grape",
      "label": "Grape, dark",
      "params": {
        "flavour": "grape",
        "hops": 1,
        "background": "#241a30"
      }
    },
    {
      "id": "lemon",
      "label": "Lemon, four hops",
      "params": {
        "flavour": "lemon",
        "hops": 4,
        "background": "#e6e0c8"
      }
    }
  ],
  "output": {
    "width": 1080,
    "height": 1080,
    "fps": 30,
    "durationSeconds": 10,
    "posterSeconds": 2,
    "alpha": false,
    "motion": "procedural",
    "loop": {
      "seamless": true,
      "cycleSeconds": 10,
      "method": "Each hop takes a whole fraction of the loop, the ripples run whole cycles per loop, and the landing wobble has died away before the next hop begins, so the last frame meets the first."
    },
    "seed": {
      "param": "seed",
      "behavior": "Seed sets the directions and phases of the surface ripples: same seed, same shiver."
    }
  },
  "composition": {
    "inputs": "Time within the loop; the flavour, hops, shiver, detail, seed, backdrop and camera sway.",
    "outputs": "A full frame rendered in 3D with a studio environment.",
    "coordinates": "The jelly is a rounded cube 2 across sitting on a plate (radius 3.1) with its base on y = 0; it hops up to 2.6; the camera looks at y = 2.4.",
    "lighting": "A warm key light with a shadow map, a shadow-catching floor and the studio environment on the translucent jelly.",
    "timing": "setProgress(progress) rewrites the mesh each frame; frames render in any order.",
    "compatibleWith": [
      "chrome-material",
      "orbit-camera",
      "kinetic-title",
      "number-reveal"
    ],
    "notes": [
      "About 3 700 vertices are rewritten each frame; the jelly keeps its volume as it squashes."
    ]
  },
  "reuse": [
    "Dessert brand: Strawberry, two hops.",
    "Fresh: Lime, big shiver.",
    "Moody: Grape, dark."
  ],
  "integration": {
    "newProject": "Create a WebGLRenderer with a studio environment and a shadow-casting light, add createJellyCube().group and call jelly.setProgress(progress) each frame.",
    "existingProject": "Copy src/jelly-cube.js; add the group to your scene with an environment map."
  },
  "performance": {
    "notes": "About 3 700 vertices rewritten and re-normalised each frame: a couple of milliseconds a frame on an integrated Intel GPU.",
    "limits": "Software WebGL renders in about two seconds a frame."
  },
  "limitations": [
    "The jelly is translucent without true refraction or subsurface scattering.",
    "The wobble is a formula, not a soft-body simulation."
  ],
  "license": {
    "spdx": "MIT",
    "notice": "Copyright (c) 2026 AI Pixel Wizard. Released under the MIT License. See LICENSE in this folder.",
    "thirdParty": []
  },
  "provenance": "Adapted from the owner's threejs-sketches/objects-scenes/jelly-cube (MIT) and rebuilt for AI Pixel Wizard in October 2026 as an original studio object: a rounded-cube mesh with three octaves of whole-cycle ripples, a closed-form hop, stretch and ringing squash that dies away before the next hop, on an exact loop.",
  "changelog": [
    {
      "version": "1.0.0",
      "date": "2026-10-05",
      "notes": "Initial release."
    }
  ]
}