GETTING STARTED FUNDAMENTALS

Quick Start

From nothing to a 3D app running in the browser in minutes.

Welcome to Wonderland Engine. Please install the Wonderland Editor before continuing with this tutorial.

Create a Project 

Enter a project name of your choice and create the project through the “Project Wizard” that launches when you start the editor for the first time.

Choose the “VR” template.

Quick Start

You are presented with a basic project that has VR teleportation set up. Pretty boring! We should add an asset here.

Quick Start

On the bottom left you see the “Asset Browser”. It shows the contents of the project’s directory. All assets for the project should be placed into this directory.

Run in the Browser 

To package the project and view it in the browser, click on the green arrow at the top of the window:

Quick Start

Now, whenever we “package” the project (by clicking the 🔨 icon), the browser will automatically reload with our changes.

Quick Start

Remove Objects 

With the VR template, we get some lights, objects and most importantly: the player setup.

We do not need all objects. Delete them by selecting them with left mouse-click and then either delete them by right-clicking in the “Scene Outline”, or by pressing the “Del” key.

Delete these:

  • Cube
  • Sphere
  • Cone
  • Panel

Make sure to keep:

  • Player
  • Light
  • Light.000
  • 3DCursorHitLeft / 3DCursorHitRight
  • TeleportIndicator
Quick Start

Modify the Navigation Mesh 

The plane we kept has a “collision” component attached, which defines the shape of the object for collision and ray casts.

In this case it is used for teleport navigation. In the next step, we will be adding a scene that already has a floor, so we will remove the mesh, but keep the collision.

Click on the plane, then in the “Properties” click ⋮ (vertical dots) on the “mesh” component, finally “Delete”:

Quick Start

You will see that the green lines for the collision component are kept, while the mesh for rendering disappeared. In the browser, this collision visualization does not appear by default.

Add an Asset 

Create a new folder assets by right-clicking on the root directory and selecting “New folder”.

Quick Start

Download low_poly_winter_scene.zip and extract it or drag and drop the files into that new folder in the Asset Browser. If you use WinRAR you can also drag and drop the files directly from WinRAR.

This beautiful scene was created by “EdwinRC” and can be found on Sketchfab.

Quick Start

To import the scene, simply drag and drop scene.gltf (not the scene.bin) into the “Scene View”. Alternatively you can drag and drop it directly onto an existing object in the “Scene Outline”.

Quick Start

Look Around 

To look around in the “Scene View”, hold down the right mouse button while moving the mouse. Use W-A-S-D keys to move forward, left, back and right while still holding down the right mouse button. To increase the speed, scroll up, while still holding down the right mouse button.

You can also hold the mouse-wheel button (hold Alt on MacOS) to orbit around the scene.

Position the Lights 

The lights now feel out of place for this new scene.

To move them somewhere useful, select one in the “Scene Outline” and use the “translation gizmo” handles to drag the light around the 3D scene.

Quick Start

If you don’t have the arrows for translation, you can switch gizmo type using the following keys:

  • G (“Grab”): position gizmo
  • R (“Rotate”): rotation gizmo
  • S (“Scale”): scaling gizmo

Double tap G to toggle translation in local vs world space.

You can also use the toolbar at the top of the Scene View:

Quick Start

Component Properties 

The “Light” object makes light, because it has a “light” component attached to it. You can make the light brighter by reducing the “intensity” property of the light component:

Quick Start

Summary 

While this scene only has a few objects, Wonderland Engine is great at rendering many different meshes. See the Scene Optimization Example.

You can continue by adding custom behaviour with your own JavaScript components.

Or you may want to add VR controller support.

See Also