Skip to main content
Skip table of contents

Creator UI overview

OKO version 4.5.0 - CSP 6.34.0


This article will guide you through the OKO Web user interface. 

Instructions

Arranged around the edges of the viewport are four sets of controls to access all the functions OKO provides. These areas will change depending on whether you are in Viewer Mode or Creator Mode. If you are in Viewer Mode, then the central toolbar will be replaced with a simpler toolbar which includes the option to exit Viewer Mode and return to Creator Mode.

When in Creator Mode, you will see the following four sets of controls:

  • At the top of the screen is the main control toolbar that contains a variety of controls.

  • At the bottom of the screen is the Content Browser.

  • On the left is the Control panel that provides access to the common controls for interacting with your space.

  • On the right is the Inspector & Comms panel that allows you to view object and component properties and chat with others in the space, either via text chat or video calls. 

e606cd58-d04a-45ca-845b-e4362ecbfb94.png

Main control bar

The main control bar contains a range of functions:

 

5eda0c4f-f16b-4bc2-9681-800e70f2b9c8.png

Play Mode

Enter Play Mode.

8720aa31-4c1b-40ca-85a3-f39445367d19.png

Current Play Mode

Select the mode used when entering Play Mode.

78aafb20-71d1-4284-90f6-a34008396a63.png

Fly Mode

Indicates whether the user has fly-mode active (activate fly mode by holding the shift key).

1886ec2d-9b31-4006-9343-e1e1aec13bd6.png

Navigation Speed

Adjust your space navigation speed using the drag control or by entering a new value.

6d406ed4-f4ea-4799-a999-09ab87b43f0c.png

Additional Options

From here, you can edit the render style, adjust the visualization mode, and enable collision and icon indicators.

2d8185de-4115-4053-bd2c-a685652b20c3.png

Enter Site Map

See a bird ’s-eye view of your site.

0121be89-b2ed-4408-9cba-af470d39517b.png

Show Map as Terrain

If your space is geolocated, this function displays 2D map tiles around your space’s location.

26826ca2-af04-4bdc-b625-2ce5eacf9786.png

Show 3D Map

If your space is geolocated, this function displays 3D map tiles around your space’s location. You will need a Google Maps API key, which can be entered in the settings dialog.

02da2c17-361d-43f4-aaff-ac4b9896003c.png

Grid View

Toggle the grid view on and off.

dd573481-727d-4ec9-b1f0-76c68c1ccedc.png

Wireframe View

Toggle wireframe view mode on and off.

 

Viewing Mode

Switch between different view models to visualise the scene in different ways to resolve appearance issues with assets placed in your space.

  • Default

  • Surface Normals

  • Unlit

  • Metallic

  • Roughness

  • Lighting

  • Specular

  • Alpha

  • Uv0 coordinates

  • Emissive

  • Ambient Occlusion

  • Level of Detail

 

Visualisations

Here you can toggle various visualisations:

  • Performance statistics: Displays an information panel showing various performance statistics for the rendered scene. Clicking on the panel will switch between three different sizes with varying levels of detail.

  • Collisions: Show the bounding boxes or meshes for any collision components in your space.

  • Editor Helpers: Show or hide various graphic elements that are used to represent components that otherwise do not have a visible element in space:

    • Comments

    • Lights

    • Audio

    • Reflection probes

    • Portals

Left Control panel

The Left panel provides access to content areas. Clicking one of these icons will expand the panel to occupy the left portion of the screen. The content is accessible by clicking on any of the following icons:

fdf7c753-3503-44af-b37f-0cbfe0f0ed71.png

Hierarchy: This is the hierarchical view of the space’s content. In this view, you can add/remove entities and rearrange the hierarchical structure of your space’s content using drag-and-drop.

44451a7b-896f-4abd-a3b5-bc17100ef287.png

Comments: A list of all the comments that have been added about the space.

756cf04f-892b-4bd4-841b-4934e364dd63.png

Hotspots: A list of all the hotspot components that have been added to the space.

Selecting any item within one of these panels will show the item’s properties in the Properties panel, which is part of the right panel.

Editing controls

e3f6a6ab-bf29-4365-b948-e6c864f987ce.png

These buttons control the editing gizmo, with the vertical bar showing the active mode. The available modes are:

4b82e029-3367-43da-be29-bb42f7c04772.png Select mode: No gizmo is visible, and you can interact with selectable items in the space.

5d198f54-7715-4648-b93f-65f863ebcf6b.png Translate mode: Translate an item along an axis, on a plane or freely.

5cca5d9e-2556-418e-9684-8bc54fb99b73.png Rotate mode: Rotate along any axis, rotate in the camera plane, or free-rotate.

9ec9ff4d-0362-4126-8b6e-2cf41ba1199f.png Scale mode: Scale the selected item along a single axis, in a plane, or uniformly.

53556c6a-534a-4ace-8d30-9362013848fe.png
5cb370ff-ed0a-4ef5-aebf-ef89acad0e74.png

Translate and rotate gizmos can operate in world coordinates53556c6a-534a-4ace-8d30-9362013848fe.pngor local coordinates5cb370ff-ed0a-4ef5-aebf-ef89acad0e74.png.

This function toggles between the two modes.

c43ca2ba-c980-4a05-a89e-0da5ad82dd19.png

This enables the Snap To Surface function. When translating an item using the central grab handle, objects will be placed on the surface of any collision mesh contained within the space.

f8432ab1-5c1f-4e4b-8c73-85cbeba0513c.png

Information Panel

Clicking the information iconf8432ab1-5c1f-4e4b-8c73-85cbeba0513c.pngwill display information about your current space. This information will include:

  • Attributions from any assets you’ve included from sources such as Sketchfab, as well as manually entered attribution information.

  • Map geolocation information with the ability to adjust the geolocation associated with the space.

3375c9b7-e5f5-4b13-8342-de4cb2e7f59e.png

Help

Clicking the help icon3375c9b7-e5f5-4b13-8342-de4cb2e7f59e.pngwill show the keyboard and mouse inputs used to activate each feature of the OKO user interface. Details for both Creators and Viewers can be viewed.

3ed579fe-6d3c-4099-b2ad-98500152563e.png

Settings

This allows you to update a variety of settings within OKO:

  • Audio: The devices used for the audio input and output within OKO.

  • Video: The device used for the video conferencing feature.

  • Navigation: Used to control the first/third person view for OKO players and the “look” speed as you use the mouse to look around your space.

  • Graphics: Allows you to tune the graphical features enabled in OKO to suit your computer's level of performance.

  • Integrations: Enter API keys for the following applications to enable the associated features in OKO:

    • Google Gemini API key

    • Meshy API key

    • Google Maps 3D Tiles API key

  • Report Space: A way to report spaces that have inappropriate or offensive content.

  • Help: An alternative way to access the help screen content.

9ce4ca5e-cae2-4d14-a7a3-4577a1594d60.png

 

Exit Space

Click this button to exit the current space and return to the spaces gallery page.

Right Inspector & Comms panel

The Right panel performs two main functions:

1. Properties

Primarily, it is where the properties for any item you have selected are displayed 30f3b1cd-b4bb-4650-a798-c62e80ef57af.png.
Those items are:

  • Entities

  • Components

  • Materials

  • Comments

  • Assets

2. Communications

The secondary function is to provide access to communications functions. These are:

deee0449-8983-4dea-87eb-78a6574e9b02.png

People

The list of people currently in the space.

8a284467-2211-4ac3-9e9c-a56cea0b99e9.png

Chat

This is where you can interactively chat with other users in the space. Text and emojis can be used in messages.

16192e2f-e629-4823-9efc-43449e51bc05.png

Call

This is where you can see everyone who is using the call feature in the space. When a user has enabled their video feed, you will be able to see them here.

You can enable and disable their video feeds just for yourself, and you can also mute anyone, again just for your local session.

Audio/video multimedia controls

At the bottom of the Right Panel, there are several multimedia control functions.

68e8cbf7-dd85-478f-871e-0bdfda95ce86.png

Screenshare

Enable and disable screen sharing if you have a Screenshare Component in your space.

450160be-5a80-4d8d-b39f-3be8862fe8aa.png

Enable / Disable Audio Feed

Switch your microphone on and off when in an audio or video call.

fe8f0918-8883-4753-83d1-91ec842fb7be.png

Enable / Disable Video Feed

Switch your camera on and off when in a video call.

4fa55e37-37c1-4286-ba36-fec40987fab5.png
310e35e3-e6bb-4459-b9a9-77a962840e4b.png

Turn On Sound

Toggle the sound of audio elements in the space on/off.

Space Share

The final option in the Right panel provides access to the Share options ee56b41c-1d00-4821-8026-a9c996359a40.png. This is where individual users can be added as Viewers or Creators to your space. It is also possible to make the space generally available to all OKO users without explicitly inviting them to it.

Content Browser

The Content Browser consists of three separate groups:

Assets: Libraries of assets available to be added to your space.

Materials: The library of custom materials that have been created in your space.

Templates: A library of pre-configured components that can be added to your space.

Assets

The Assets panel has four categories, all of which can be added to your space.

In Space

In the In Space category, you will find all of the assets that have been uploaded while in this space. When you first join a newly created space, this library panel will only contain the assets from the template space used when creating your space, but once uploaded, new assets will also appear here. Assets can be uploaded to this panel directly using the upload button 602cc3a5-1a5c-4e84-a33c-2abf14997178.png or by dragging them from a file explorer view directly into the space view. For more information on how to upload your own assets, please check out this article: Importing assets

Assets can also be created using the AI-assisted technology using Gemini AI or Magnopus' Nodey – a web-based workspace that creates a unified, secure experience for Generative AI creation.

426b760a-7dea-40cc-ad08-b0a42c01ab1b.png

Global

The Global Category contains assets that are available to all users, in all spaces. Assets can be uploaded in the same way you would upload an asset for the In-Space category.

Sketchfab

OKO offers Sketchfab integration. You will need to connect OKO to your Sketchfab account, but once configured, you can access your saved asset Collections (more on using Sketchfab Collections here). 

To connect your account, click the Connect Sketchfab button, and the following window will appear. 

05d3d5ce-7245-4b10-9da9-ee4cfb9e0997.png

Select Accept, and the assets will appear in your library. You can even use the Sketchfab database and search for assets to upload to OKO. 

a5491742-0add-45b4-8c7c-b26e067ba357.png

Packs

In addition to being able to upload your own custom assets, OKO also offers a selection of essential assets and primitive objects to get you started.

37149e09-634c-4f44-882a-3df1b71a9a7b.png

Templates

In the templates group, you will find common objects grouped into categories for ease of access.

2bc547a8-43d6-46c9-b1c4-392aab5ff7b6.png

3D: Contains templates for all 3D geometry components.

Environment: Contains templates for components that affect the environment, such as lighting, fog and reflection probes.

Interactive: Contains templates for components that add interactive elements to your space, such as colliders and triggers, as well as buttons, external links, and portals.

Media: Contains templates for audio, video, image, and text components as well as screen sharing.

Space: Contains templates for fiducial markers and hotspots for navigating within a space, and an entity creation template.

Portals: The portals sub-option allows you to add portal objects to your environment. These portals enable a user to travel between spaces you have authored, connecting multiple spaces together in an experiential flow.

57bfc1ee-6497-45e0-a760-9bc2c69125d2.png

That’s it for the creator UI overview!

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.