Chapter 04

The Dream Editor

The Dream Editor is one window. The timeline fills it. Panels sit around the timeline and stay out of its way.

The whole Dream Editor window, with its panels around the timeline.
The whole Dream Editor window, with its panels around the timeline.

Around the timeline#

  • Dream tabs, along the top. One tab per Dream in the scene. The "+" adds a Dream. A tab's name is the name of the Dream's object in the Hierarchy. The cog on the Timeline bar, beside the play buttons, opens the Dream's settings in the Properties panel.
One tab per Dream. The plus at the end adds one.
One tab per Dream. The plus at the end adds one.
  • Slide tabs, under the Dream tabs, when the Dream is a slideshow. See the Slideshows chapter.
Slide tabs under the Dream tabs, with a cog on the open slide.
Slide tabs under the Dream tabs, with a cog on the open slide.
  • The ruler, with the playhead. The ruler stays in view when you scroll down a tall timeline. When a video has been fetched, its waveform draws under the ruler.
The ruler above the tracks. The blue line is the playhead.
The ruler above the tracks. The blue line is the playhead.
  • Tracks and lanes. Every kind of node has a track. A track can have several lanes, so nodes can overlap in time without sitting on top of each other.
The Cue track's two lanes let its nodes overlap in time.
The Cue track's two lanes let its nodes overlap in time.
  • The minimap, a small picture of the whole timeline. Click or drag it to move the view.
The minimap under the timeline, marked Map.
The minimap under the timeline, marked Map.
  • The Properties panel, on the right. It shows the selected node's settings. The cog on the Timeline bar swaps it for the Dream's own pages: Video, Player, Opening and Preview.
The Properties panel on the right, showing the selected Cue node.
The Properties panel on the right, showing the selected Cue node.
  • The Scene Objects list, on the left. Every object in the scene. Right-click one for Ping, which flashes it in the Scene view, and Select. A pin keeps it at the top.
The Scene Objects list on the left, with every object in the scene.
The Scene Objects list on the left, with every object in the scene.
  • The Content Drawer. Tiles for the things you can add, with a checkbox per track. Drag a tile onto the timeline and it lands on its own track at that time.
The Content Drawer. Each track has a checkbox; Animation is off.
The Content Drawer. Each track has a checkbox; Animation is off.
  • The footer. Lint, the Preview switch with its time, the version number, Report a Bug, and Donate.
The footer along the bottom, with Lint at the left.
The footer along the bottom, with Lint at the left.

Which tracks show#

A new Dream shows three tracks: Cue, FX and Move. The other tracks are turned off until you need them. Turn one on with its checkbox in the Content Drawer. A track also appears the moment you add its first node. Cue and FX share one switch: turning either off turns off both.

Adding nodes#

  • Right-click a track at a time and choose "Add" from the menu. The node lands where you clicked.
  • Drag a tile from the Content Drawer onto the timeline.
  • Drag an animation clip from the Project window onto the Animation track.
  • Duplicate a node with Ctrl+D. One node duplicates in place. Several selected land one second later, as does the right-click Duplicate.
  • Copy, cut and paste work for any node and any selection. See Copy and paste below.

Moving and resizing#

  • Drag a node's body to move it in time.
  • Drag its right edge to change its length. Drag its left edge to change where it starts. Move and Sound nodes have no left edge, and a linked FX has neither. On a Presence node the left edge moves the In point with it.
  • Very short nodes only offer the right edge.
  • Drag a node up or down to move it to another lane. Alt+Up and Alt+Down do the same for the selection.
  • A Move node shows dividers inside it for its start and return durations. Drag them.
  • Escape cancels a drag.
A Cue node. Drag the body to move it, an edge to resize.
A Cue node. Drag the body to move it, an edge to resize.

Selecting#

Click a node. Shift-click adds to the selection. Ctrl-click toggles one. Drag on empty track space to draw a box around several. Ctrl+A selects every node on the slide you are editing.

Copy and paste#

  • Ctrl+C copies the selected nodes. Ctrl+X cuts them: nothing moves until you paste. Escape cancels a cut.
  • Ctrl+V pastes onto the slide you are editing. On another slide the copied times are kept. On the same slide the copies land after the originals.
  • Right-click a clip or empty track space and choose Paste to paste at that time instead.
  • Copy a prompt together with a node that depends on its answer, and the copies depend on each other, not on the originals.
  • Pasted nodes keep their lanes where those lanes are free.

Splitting#

Put the playhead inside a Cue, an FX or a Presence node and press S, or right-click and choose "Split at playhead". The node becomes two. A Presence node's second half starts its recording where the first left off.

The node menu#

Right-click a node for: Mute or Unmute, Link or Unlink FX, move up or down a lane, Make Conditional or Remove Condition, Cut, Copy, Paste, Delete, Duplicate, and Split at playhead.

A muted node stays on the timeline and does nothing in the world.

The lane menu#

Right-click a lane's label for: Mute Lane, Delete Lane, Add Lane, Make this lane conditional, Lane condition settings, Apply lane condition, and Remove lane condition.

The lane labels L1 and L2 under the Cue track's name.
The lane labels L1 and L2 under the Cue track's name.

"Auto Remove unneeded lanes" in the timeline's header clears empty lanes for you. While it is on, Add Lane, lane conditions and moving nodes between lanes are off. Drag a lane's bottom edge to change its height. Double-click the edge to reset it.

Conditions#

Any node can be made conditional. Open its Condition section in the Properties panel. A condition is a way the node can happen, made of one or more requirements:

  • A viewer's VRChat name, matched exactly, including capitals.
  • A viewer's answer to a Prompt node.

"Also require" adds a requirement to the same way. "Add another way this can happen" adds a second way; the node plays for a viewer who matches any one way.

A conditional node plays only for viewers who match. Everyone else sees nothing from it. A lane can hold a condition as a default: new nodes dropped on it pick it up. For nodes already there, use Apply lane condition. Until you do, they play for everyone.

Markers#

Right-click the ruler and choose "Add marker here" to place a marker and name it. Press M to drop one at the left edge of the view, named M1, M2 and so on. A marker is a line down the timeline for your own reference. Right-click a marker to delete it.

Zoom and snapping#

  • Ctrl and the mouse wheel zoom the timeline. The header shows the zoom and a Reset button.
  • The snap menu in the header offers Off, Frame, Second, Five Seconds and Clip Edge. Hold Ctrl or Shift while dragging to ignore snapping.
The snap menu in the timeline header, set to Second.
The snap menu in the timeline header, set to Second.

Keyboard shortcuts#

These work whenever the editor window has focus and you are not typing in a field.

  • Ctrl+C, Ctrl+X, Ctrl+V: copy, cut, paste.
  • Ctrl+D: duplicate.
  • Delete: remove the selection. Backspace does not, so it stays free for typing.
  • Left and Right arrows: nudge the start time by 0.1 seconds. Hold Shift for 1 second.
  • Alt+Up, Alt+Down: move to another lane.
  • Ctrl+A: select everything on the slide you are editing.
  • S: split at the playhead.
  • M: add a marker at the left edge of the view, or at the playhead in Play mode.
  • Space: play and pause the preview, when no settings page is open.
  • Escape: cancel a drag or a cut.

Undo#

Every gesture is one undo step. Ctrl+Z undoes it.

Lint#

Press Lint in the footer. A window lists everything Dreamer Pro found, filtered by Errors, Warnings and Info.

  • Errors would stop something from playing, and they stop an upload.
  • Warnings are things that will play but may not be what you meant.
  • Info tells you how an overlap was decided.

Lint checks every track: missing objects and clips, timings past the end, malformed times, nodes fighting for the same object, a gate nobody can open, a slideshow slide that never ends, and more. In a slideshow it checks each slide on its own.

The Lint window, with Errors, Warnings and Info counts.
The Lint window, with Errors, Warnings and Info counts.

Preview#

The Preview switch in the footer plays the Dream in the Scene view. Space plays and pauses. Drag the playhead to scrub.

The Preview switch in the footer, on, with its time.
The Preview switch in the footer, on, with its time.
  • Preview shows cues, effects, moves, skybox changes, text, images, prompts, sounds, the video picture, and Dreamwalkers with their recordings and faces.
  • A viewer rig stands in for the viewer. Drag it around the scene to see what a viewer in that spot would see.
  • In a slideshow the preview plays the slide you are editing.
  • Animation nodes preview from the source clip in Unity. The world plays baked animation data, which the Building chapter explains.
  • A Local Dream's video cannot play in Unity's Play mode. Test it in VRChat.

Time format#

Every time in Dreamer Pro reads HH:MM:SS:F or HH:MM:SS:fff. One digit after the last colon is tenths of a second. Three digits are milliseconds. A time Dreamer Pro cannot read counts as the very start, and Lint flags it.