Opus Motion ★ Star on GitHub

3D · voxel-diorama

Voxel diorama

A voxel island with beach, grass, rock, block trees and a little hut builds itself as cubes drop in waves (low and central first, decorations last) in a sea of bobbing water cubes on a slab, under drifting cube clouds, with a slow orbiting camera, soft shadows and a cube-count caption.

A free, MIT-licensed 3D motion graphic from the Opus Motion Library — 616 motions for Remotion, React and plain HTML.

Voxel diorama: three frames of the 3D motion graphic, start, middle and end
Voxel diorama — start, middle and end of the 6.0-second motion.

What Voxel diorama is for

Gaming content, playful brand "worlds", kids explainers, a loader or intro that builds a place. Pass heightmap (rows of integer column heights) to build your own terrain.

  • voxel
  • diorama
  • island
  • blocks
  • cubes
  • minecraft-like
  • build
  • world
  • game
  • kids
  • playful
  • three.js
  • 3d
  • orbit
  • heightmap
  • water
  • clouds
  • trees
  • isometric
  • loader
  • clay

Details

Category
3D motion graphics (three.js)
Length
6.0 s (180 frames at 30 fps)
Formats
16:9, 1:1, 9:16
Weight
heavy (three.js / WebGL — export to video for mobile)
Transparent overlay
no
Seamless loop
no
Text props
title subtitle
Colour props
skyTop skyBottom inkColor
Mood
paper, 3d, nature, editorial
Roles
subject

Use Voxel diorama in Remotion, React or HTML

Remotion project

terminal
# copy this motion into your Remotion project
node cli/mgl.mjs add voxel-diorama --to ../my-app/src

# render an mp4 (run in the library folder)
node cli/mgl.mjs render voxel-diorama --props '{"title":"Voxel Isle","subtitle":"built one cube at a time","skyTop":"#8ed3f2","skyBottom":"#eaf8ff","inkColor":"#173a4f"}'

# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export voxel-diorama --as mp4 --props '{"title":"Voxel Isle","subtitle":"built one cube at a time","skyTop":"#8ed3f2","skyBottom":"#eaf8ff","inkColor":"#173a4f"}'

React / Next.js

tsx
import {MotionPlayer} from 'opus-motion-library/web';

<MotionPlayer
  motion="voxel-diorama"
  props={{
    title: 'Voxel Isle',
    subtitle: 'built one cube at a time',
    skyTop: '#8ed3f2',
    skyBottom: '#eaf8ff',
    inkColor: '#173a4f',
  }}
  playOnView
  loop="auto"
/>

Plain HTML / WordPress

html
<script src="opus-motion.element.js" defer></script>

<opus-motion motion="voxel-diorama"
  props='{"title":"Voxel Isle","subtitle":"built one cube at a time","skyTop":"#8ed3f2","skyBottom":"#eaf8ff","inkColor":"#173a4f"}'>
</opus-motion>

Compose spec (multi-scene video)

json
{
  "width": 1920,
  "height": 1080,
  "fps": 30,
  "scenes": [
    {
      "motion": "voxel-diorama",
      "props": {
        "title": "Voxel Isle",
        "subtitle": "built one cube at a time",
        "skyTop": "#8ed3f2",
        "skyBottom": "#eaf8ff",
        "inkColor": "#173a4f"
      }
    }
  ]
}

Voxel diorama props

21 parameters — change any of them to make the motion yours.

PropDefaultWhat it does
title"Voxel Isle"caption headline ("" for none)
subtitle"built one cube at a time"caption sub-line
heightmap[]optional rows of integer column heights (0 = sea); empty = generated island
size22generated island grid size (cells)
seed7terrain / tree / cloud seed
trees6number of block trees
houses1number of huts
maxHeight6peak height of the generated terrain in cubes
buildAt12frame the first cube starts to fall
buildFrames78frames over which the build runs (1-3 s)
fallFrames14fall time of each cube
dropHeight22drop height in cubes
orbit15camera orbit speed in degrees per second
yaw35start camera azimuth in degrees
elevation32camera elevation in degrees
clouds3drifting cube clouds
hudtrueshow the "n / total cubes" counter
skyTop"#8ed3f2"sky gradient top
skyBottom"#eaf8ff"sky gradient bottom
inkColor"#173a4f"caption colour
palette{"water":"#3b9fd1","waterLight":"#4aa9d9","sand":"#f3dca4","grass":"#79c25b","grass2":"…colour overrides {water,waterLight,sand,grass,grass2,rock,snow,dirt,wood,leaf,leaf2,roof,wall,cloud}

Notes & credits

Technique sources:

  • prompt-corpus: voxel-diorama (11 cases, awesome-opus5-5-videos)