Chapter 13

Troubleshooting

Nothing happens when the video plays#

  • Press Lint and fix every error first.
  • Check that the Dreamer Pro Player is in the scene and that the Dream's Video panel points at the right video player. The Inspector button "Repair Dreamer/TXL Wiring" reconnects them.
  • A Local Dream on hosted video needs its own video player. Until it has one, it plays as a Shared Dream and the Video panel says so.
  • A time Dreamer Pro cannot read counts as 00:00:00:0, so that node fires at the very start. Times read HH:MM:SS:F or HH:MM:SS:fff. Lint flags a bad one.

An object will not appear, or will not disappear#

  • The object should be turned off in the scene. Dreamer Pro turns it on at the cue's start. If it is on already, it shows before its time.
  • If the cue's end is past the end of the Dream, the object never hides. That is also how to keep something on stage to the end.
  • Two nodes fighting over the same object at the same time: one wins. Lint shows which.

An effect plays twice#

Looping videos and looping slides replay everything inside the loop. That is by design.

A sound plays nothing#

  • No Audio Clip on the node. Lint flags this.
  • The scene has no audio listener, or it is muted. VRChat provides one on the player camera.
  • The sound is 3D and its position object is far away.

The controls do not respond#

  • Who May Control decides who can press the transport. Viewers it does not allow see the bar without the three buttons.
  • In a gated Dream the transport is locked until the gate opens.
  • A control may be waiting for the clock. The first press claims it. The next press drives.

A viewer sees a different show#

Conditions do that. A conditional node plays only for viewers who match its name or prompt answer. A name must match the VRChat display name exactly, including capitals. A conditional node with an empty name plays for nobody.

The preview does not match the world#

  • The preview plays the slide you are editing. The world plays the slide the presenter is on.
  • Animation nodes preview from the source clip. The world plays baked data. Press Bake Animation Data.
  • A Local Dream's video does not play in Unity's Play mode. The video engine does nothing there. Test in VRChat.
  • Posing and hand surfaces only exist in the world, in VR.

Recording#

  • The node does not grow after Arm. The world's recording panel has not started, or VRChat is not running on this computer. Press Record on the panel.
  • The node says to press End on the panel first. A take ended in Dreamer Pro while the world kept recording. End it in the world before arming again.
  • No microphone found. The recording will have motion only. Pick a microphone in the Voice section.
  • The voice clips. Lower Recording volume. What has clipped stays clipped.
  • Monitor is silent. Monitoring needs an audio listener in the scene. The Main Camera usually has one.
  • No face parameters arrive. In VRChat, open the Action Menu, then Options, then OSC, and turn it on. If it is on and nothing arrives, turn on "Read VRChat's port 9001 directly" in the Face section.
  • The voice cuts out partway through a take. Dreamer Pro writes the gap as silence and keeps the timing true. A line in the Console names the microphone. Try a different microphone or a different input rate.

Importing a .dream file#

  • "This file is not a Dream file." The file is damaged, or is not a .dream file.
  • Written by a newer Dreamer Pro. Update Dreamer Pro, then import.
  • The report lists something it could not find. The file was exported without that object. Ask for a fresh export.

An image card has no frame#

Select the Image node. If its panel says the gallery frame may need a rebuild, press Rebuild Image Cards. Lint says the same.

The upload stops with "Dreamer Readiness"#

The message says how many problems there are. The Console lists them, and most show in Lint with the node that causes each one. Clear them and upload again.

Performance#

A Dream with several hundred nodes can cost frame time on a lower-end machine. Splitting a very long Dream into several shorter ones is the reliable way to keep it smooth. On Quest, keep the number of Local Dreams low and remember that three performers animate at once.

Report a bug#

The Report a Bug button in the editor footer opens the place to send it. Say what you did, what you expected, and what happened, and include the Unity Console if it shows a red line.