Create your first MAGES project¶

Import the empty scene¶

1. From Unity’s top bar menu navigate to MAGES > MAGES Panel > Getting Started > Samples. Then import the Empty Scene MAGES sample. This downloads the Empty MAGES Project under Assets > Samples, opening the Empty Scene with Camera and MAGES Hub.

   

2. In the Unity Editor, go to MAGES > MAGES Panel and click on the Scenegraph Editor tab.

   

3. After clicking, you will be redirected to the Action Wizard. Additionally, the scenegraph editor of the active scenegraph will pop up, and you’ll have the option to activate the recommended layout. Choose as you wish.

   

4. If you select the recommended layout, your Unity Editor will be set up as follows. Click on the collapse button of the MAGES Panel to better view the wizard.

   

5. Once done, you can see the available actions, select the one you want to create, the active scene, and the active scenegraph editor. Now, you are ready to create your actions.

6. Make sure that you have selected the Empty Project from the dropdown list.

   

Create your first Insert Action¶

Now we will demonstrate how to create your first Insert Action using the Action Pattern Wizard

1. Click on the Insert Action button among the available actions. The side panel displays the necessary steps to create the action. Enter your action’s name in the name property, then click the Next button to proceed.

   

2. After clicking Next, you will be redirected to the Setup Insert Object step. Here, you can either create a new GameObject from a model in your assets or select an existing prefab from your assets.

   

3. Click the Create New button, then select the Cube model from your assets. This creates a GameObject of the cube in your scene that you can position as desired. This will be the position that the GameObject will be initially spawned.

   

4. Position the Cube on the table in your scene using the gizmos, and then click the Next button again.

5. You will be redirected to the final step, where you need to set up the final position of the insert object. In this step, a new GameObject of the cube will be spawned to represent the final position.

6. Once again, using the gizmos, move the final GameObject to the position where you want to be inserted and then click the Finish button.

   

7. Your insert action has been created and placed in your scenegraph as the second action, ready to be used.

   

8. Make sure to save the scenegraph editor by clicking the Save button.

   

Create your first Use Action¶

1. Click on the Use Action. Enter your action’s name in the name property, then click the Next button to proceed.

   

2. After clicking Next, you will be redirected to the Setup Use Object step. Here, you can either create a new GameObject from a model in your assets or select an existing GameObject from your assets.

   

3. Click the Create New button, then select the Sphere model from your assets.

   

4. Position the sphere in your scene using the gizmos, and then click the Next button again.

5. Now you need to set up the use collider of the use object. Again, press the Create New button, and select the Sphere model from your assets.

6. Once again, using the gizmos, move the use collider GameObject to your desired position, where you want the Cube to be used, and then click the Finish button.

   

7. Click the Finish button, the use action will be created in your scenegraph after the Insert Action.

   

8. Make sure to save the scenegraph editor by clicking the Save button.

   

Create your First Remove Action¶

1. Click on the Remove Action. Enter your action’s name in the name property, then click the Next button to proceed.

   

2. Since we will use the cube from the previous Insert Action, search the interactable cube (not the final position) from your Assets and drag and drop it in the prefab field. In our case its path is Assets/Resources/Actions/Insert the Cube in the Right Place/Insert the Cube in the right place_InsertObject.

   

3. Click the Finish button. The remove action will be created in your scenegraph after the Use Action.

   

4. Make sure to save the scenegraph editor by clicking the Save button.

   

Create your First Question Action¶

1. Click on the Question Action. Enter your action’s name in the name property, then click the Next button to proceed.

   

2. Position the question object where you wanted to be and click the Next button.

   

3. Fill the question to be asked and click the Next button.

   

4. Populate a list with possible answers to this question by clicking the + button. Also select which answer is the correct one by clicking the correct button. Then click the Finish button.

   

5. The Question action will be created in your scenegraph after the Remove Action.

   

6. Make sure to save the scenegraph editor by clicking the Save button.

   

Select your camera and play¶

1. Select the appropriate device from the MAGES Panel. Mobile 3D refers to the device for non-VR play mode, while XR Devices refers to using a Head-Mounted Display (HMD). For detailed controls associated with each device, please consult the information located at the bottom of the page.

   

   Note

   The Mobile 3D camera is only for spectating as it does not support any interaction with the 3D objects. You can only perform and undo the Actions by pressing the corresponding buttons on your screen.

2. Press the button to play your simulation.

3. While in play mode, by clicking the Open SceneGraph button at the bottom right during the scene preview, you can watch the Scenegraph in running mode.

   

   

   Each node has a different outline color. A green outline means the action has been performed. An orange outline means the action is activated and waiting to be performed, and the grey outline means the action is still locked. Under each active node, there’s a skip and undo button.

4. Regarding movement, you can find the controls for every supported platform and headset.

End of the operation¶

When you reach the Operation End Action. This menu appears on the screen.

From this menu you can restart or exit the application.

You can modify the UI shown on the Operation End Action by applying another prefab in the scenegraph editor.