tutorial: understanding the lumberyard interface · tutorial: understanding the lumberyard...
TRANSCRIPT
Tutorial: Understanding the Lumberyard Interface This tutorial walks you through a basic overview of the Interface. Along the way we will create our first level,
generate terrain, navigate within the editor, explore the UI and learn some basic terminology regarding Lumberyard
objects. At the end of the tutorial you will have an understanding of where to find the various tools you will use in
Lumberyard.
You will learn how to do the following:
Create a New Level
Navigating in Lumberyard
Identify interface areas
Learn essential terms and tools
And learn a few other useful things
Prerequisites This tutorial requires that you successfully download and install the Lumberyard Editor.
Step 1: Creating a New Level The first step in the tutorial is to create a level so we have a space in which to make awesome things happen.
To create your first level follow the steps below:
1. Start by naming your level. You may use any name you wish, but for these tutorials we will use
My_First_Level.
2. For this tutorial we will keep the settings at default, more information on these settings will be covered in
subsequent tutorials. Click OK
3. In the next window we will have more terrain options. These will also be kept at default.
4. After Lumberyard is done creating the Terrain Patch your screen should look similar to this:
Now that we have successfully created a level, let’s learn how to move around inside of Lumberyard.
Step 2: Navigating in Lumberyard After you have created a level, we will learn to navigate within the engine. If you have played First-Person Shooter
(FPS) game or have used other game engines, navigating within the editor should feel familiar.
To navigate within the editor use the following controls:
W – Strafe Forward RMB + Direction – Look Direction S – Strafe Back MMB + Direction – Pan Direction A – Strafe Left LMB – Select / Marquee Select
D – Strafe Right
You now know how to navigate within the Lumberyard Editor, we will define the areas of the interface we will be
using throughout development.
Step 3: Identifying the Interface Areas The Lumberyard interface can be intimidating at first, but in this section we will identify the main areas of the
interface that are referenced throughout this and other tutorial series
Main Menu
The Main Menu contains all function and settings including menus for many tools accessible in other portions of the
interface
Editor Toolbar
The Editor Toolbar contains the most commonly used tools and editors within Lumberyard. These include grid snap
functions, undo, and redo, shortcuts to core tools such as Gepetto and the Time of Day Editor and much more.
Perspective Viewport
The Perspective Viewport is where we see our 3D environment. Here we can select objects, entities and brushes
and manipulate them within our level. The Perspective Viewport has a header and control bar that offer increased
control over what we see and what we can do.
Perspective Header
The Perspective Header contains toggles for various display options and a search bar to filter objects within the
Viewport.
Perspective Control Bar
The Perspective Control bar offers various controls for selected objects, options for adjusting navigation speed and
other viewport functionalities.
Console
The Console contains Input and Output data on the Editor and any custom code written for your level.
Rollup Bar
The Rollup Bar contains access to many objects, entities and tools for creating and managing content within the
Perspective Viewport. These tools are separated into five tabs: Objects, Terrain, Modeling, Display and Layers.
Objects Terrain
The Objects Tab contains options for various brushes, entities, volumes, prefabs and more.
The Terrain Tab contains tools for sculpting and painting terrain, creating vegetation and other environmental tools.
Display Layers
The Display Tab contains options for rendering settings, 3D display settings and hide settings for the various types of objects and entities in Lumberyard.
The Layers Tab contains options for managing and organizing assets by layers.
Now that we know where to find some of the options available to us, let’s define some terms commonly used to refer
to Lumberyard assets and some essential tools for creating and manipulating content.
Step 4: Essential Terms and Tools This section will define some commonly used terms in Lumberyard and give us an overview of some of the basic
tools we will be using in-engine.
Essential Terms
Lumberyard uses many terms when referring to the various objects that can be found and used in the engine. These
terms are commonly used throughout this and other tutorial series. Most objects in Lumberyard can be separated
into three categories: Entities, Brushes and Designer Objects
1. Entities – An Entity is any asset that contains behaviors that can be manipulated by code or scripts. Entities
are broken up into four sub-categories
a. Entities – General gameplay and visual objects such lights, volumes, camera and physics objects
b. Geometry Entities – An entity that also contains mesh data
c. Particle Entities – An entity which contains particle information
d. Archetype Entities – Entities which contain custom code or scripts.
2. Brushes – Brushes are entities which contain only mesh data. Brushes are not responsive to code or
scripts.
3. Designer Objects – Similar to brushes, designer objects are white box objects created using the designer
tool. Designer objects are not responsive to code or scripts.
Essential Tools
Lumberyard uses many robust tools, settings and options to help you develop high quality games and content, the
most essential tools for manipulating content are outlined in this section. These tools include Select, Move, Scale,
Rotate, Snap to Grid, Snap Angle and the Follow Terrain tool.
In order to use these tools effectively we must first have an object to manipulate. In order to create an object quickly
we will use the Designer Tool to create a simple polygon to move around our level. More advanced applications of
the Designer Tool are covered in another tutorial
To create a simple cube follow the steps below:
1. Open the Designer Tool by selecting the Objects tab in your Rollup Bar and then selecting Designer to
access the Designer Tool.
Objects Tab
Designer Tool
2. Scroll down and select the box option in the shapes tab
3. In the Perspective Viewport, LMB click and drag to draw a marquee box defining the x and y dimensions of
the cube. Release LMB to define the z dimension of the cube.
4. Next, click on the Object button in the designer tool to select and manipulate your newly created object.
To Select objects LMB click on them with the Select Tool.
1. Using Select (Hotkey 1), you can choose any object in the Perspective Viewport. To select, move your
cursor over the object you wish to select. When the object is highlighted yellow and the cursor changes to a
+ sign, LMB click to select the Object. The gizmo for select is a set of three lines – one for each of the three
axis.
To Move objects LMB click on them with the Move Tool.
1. The Move Tool (Hotkey 2) can select and move on object within the Perspective Viewport. To move an
object along a fixed line click the X, Y or Z line which then becomes highlighted in yellow. You can then click
and drag your object along that line.
The Move gizmo also features three small right angle squares along the XY, ZY, and XZ planes. To move
your object along a plane, click to select one of the small squares. You can then click and drag your object
along that plane.
To Rotate objects, first Select them and then use the Rotate tool.
1. The Rotate tool (Hotkey 3) can select and rotate an object. To rotate an object, select one of the small inner
circles. You can then click and drag to rotate around that rotational plane. A larger outer circle also
surrounds the entire gizmo. Select and drag this circle to rotate the object in relation to the screen display.
To Scale objects LMB click on them with the Scale Tool.
1. The Scale tool can select an object and change its size. To scale an object, select the X, Y, or Z line, then
click and drag in the direction you wish to scale your object.
To Snap object to the grid use the Snap to Grid Tool
1. The Snap Grid lets you snap to points along a grid when moving an object. The Snap Grid is on by default,
and can be turned off or on by clicking its icon on the Editor Toolbar. To customize the size of the Snap Grid,
select the small down arrow to the right of the grid icon. Adjust this value to increase or decrease the snap
steps of the object you are moving.
To rotate an object by a specific increment use the Snap Angle Tool
1. Snap Angle (on by default) sets the incremental degrees of rotation that an object snaps to when you rotate
it. To turn Snap Angle off or on, select the icon. To customize the Snap Angle degrees of rotation, select the
down arrow to the right of the Snap Angle icon. Adjust this value to increase or decrease the degree of
rotation with each snap.
To snap objects to the Terrain use the Follow Terrain Tool.
The Follow Terrain and Snap to Objects option enables you to move an object along terrain features rather than
along the X, Y, Z axes or planes. With the Follow Terrain and Snap to Objects option selected, you can freely move
your object in any direction along your terrain, and the object automatically adjusts to terrain features.
In levels with a terrain mesh, this tool can be extremely useful, as you can easily keep your objects sitting directly on
the terrain, or in whatever relation you already have it to the terrain, rather than having to adjust it manually to peaks
and valleys.
Congratulations! You have successfully learned how to create a level, navigate the engine and interface, and
learned how to manipulate objects within the Lumberyard Editor. Next we will cover a few tips and tricks to help you
streamline your workflow processes.
Step 5: Other Useful Stuff This section will provide information on a few other extremely useful menus and toggles within the Lumberyard
Editor. These tips are meant to show you more options on how to customize your workspace and workflows.
Editors
1. The Lumberyard Editor features a collection of editor tools that enables game developers to build specific
categories of content. Over the course of the Getting Started tutorial series, we will refer to many of these
editors and their uses. You can open all editors from the View > Open View Pane menu. Many of these
menus can also be opened using the Editor Toolbar.
To adjust your display options and settings use the Perspective Viewport options, Viewport Header and
Toggle Display options.
Display options and settings allow you to customize what you see within Lumberyard Editor so that you can set up
your view to be the most effective. The following sections describe the display options and settings available to
configure.
1. Perspective Viewport options
To configure display options for the Perspective Viewport, right-click on the Viewport Header. Check or clear
options to best suit your individual workflow preferences.
2. Show/Hide Helpers
The right-hand side of the Viewport Header shows additional display settings. Toggle the H "Helper" icon to
show or hide all the entity icons and their visual guidelines. Hiding these elements can de-clutter your view when
you wish to focus on other components.
3. Toggle display information
The right-hand side of the Viewport Header shows additional display settings. Toggle the H "Helper" icon to
show or hide all the entity icons and their visual guidelines. Hiding these elements can de-clutter your view when
you wish to focus on other components.
4. Navigation speed settings
You can adjust your Perspective Viewport navigation speed. The Speed setting shows the current movement speed
setting. You can type a number into the Speed field, or click .1 (Slow), 1 (Normal), or 10 (Fast).
5. AI/Physics toggle
The AI/Physics button turns on and off the movement events for physics, AI, and particles in edit mode. With these
options, you can test and view these events without entering game mode.
6. Auto backup
Lumberyard has an auto backup feature that is on by default. Auto backup saves your level file incrementally. This
helps prevent loss of your progress in case an unexpected event causes a crash/freeze while you are working in
your level. Under General Settings, choose Files. In this dialog box, you can customize your Auto Backup settings.
Related Tasks and Tutorials Now that we have knowledge on how to navigate and manipulate objects in Lumberyard let’s see what else you can
add to your game:
Making Your First Level
Working with Lighting
Setting up the Player Controller
White box Design using the Designer Tool