The 3D Editor
In this tutorial, we’ll look at how to start working in 3D in Godot. You’ll learn how to navigate in the 3D editor, how to create and manipulate 3D objects, and how to work with some of Godot’s essential 3D nodes, such as cameras and lighting.
Are you ready?
A word of warning: 3D development can be quite a bit more complex than working in 2D. While many of the same principles apply - such as working with nodes, writing scripts, and handling logic/data - 3D brings with it a number of other considerations. For this reason, it’s a good idea to stick to 2D for your first few projects, moving to 3D once you have a good understanding of the game development process. This tutorial will assume you have completed at least an introductory Godot 2D project, such as the one in the [official Godot tutorial] (https://docs.godotengine.org/en/stable/getting_started/step_by_step/your_first_game.html).
Getting Started in 3D
One of Godot’s strengths is its ability to handle both 2D and 3D games. While much of what you’ve learned working on 2D projects (nodes, scenes, signals, etc.) applies equally well in 3D, there is also a whole new layer of complexity and capabilities. First, you’ll find that there are some additional features available in the 3D editor window, so we’ll start there:
Orienting in 3D Space
When you first open a new project in Godot, you will see the 3D project view:
The first thing you should notice is the three colored lines in the center.
These are the x (red), y (green), and z (blue) axes. The point where
they meet is the origin, which has the coordinates
(0, 0, 0). You’ll find
that this color scheme will also apply elsewhere in the Inspector.
Different 3D applications follow different conventions for orientation. Godot uses Y-Up orientation, so that when looking at the axes, if x is pointing to the left/right, then y is up/down, and z is forward/back. Some other popular 3D software uses Z-UP. It’s good to keep this in mind when moving between applications.
Navigation in 3D is performed using the mouse and keyboard. Here are the basic controls for the view camera:
- Mousewheel up/down: zoom in/out
- Middle button + drag: orbit camera around current target
- Shift + middle button + drag: pan camera
- Right-click + drag: rotate camera in place
In addition, if you’re familiar with popular 3D games, you might prefer Freelook mode, which you can toggle on/off using Shift+F. In this mode, you can use the WASD keys to fly around the scene while aiming with the mouse.
You can also alter the camera’s view by clicking on the
in the upper-left corner. Here, you can snap the camera to a particular
Adding 3D Objects
Now let’s add our first 3D node. Just as all 2D nodes inherit from
which provides properties such as
rotation, 3D nodes inherit
Spatial. Add one to your scene and you’ll see the following object
appear at the origin:
This object is not the node. It is something called a 3D gizmo. Gizmos are tools that allow you to move and rotate objects in space. The three rings control rotation, while the three arrows move (translate) the object along the three axes. Note that the rings and arrows are color-coded to match the axis colors.
Take a few minutes to experiment and get familiar with the gizmo. Use Undo if you find yourself getting lost.
Sometimes you may feel the gizmos are getting in your way. You can click on the mode icons to restrict yourself to only one type of transformation: move, rotate, or scale:
Global vs. Local Space
By default, the gizmo controls operate in global space. When you rotate the object, the gizmo’s arrows still point along the axes. However, if you click the “Local Space Mode” button, the gizmo will switch to moving the body in local space.
Now when you rotate the object, the gizmo arrows point along the object’s axes and not the world’s. Switching back and forth between Local and World space can make it much easier to place an object exactly where you want it.
Look at the Inspector for the
Spatial node. Instead of a Position property,
you have Translation, as well as Rotation Degrees, and Scale. Drag the
object around with the gizmo and observe how these values change.
You’ll also find a Transform property, which changes as you move the object. A transform is a matrix that describes an object’s translation, rotation, and scale all in one. The math behind transforms can get quite complex - you’ll start working with them in a later tutorial.
Just like a
Spatial has no size or appearance of its own. In 2D,
you would use a
Sprite to add a texture to the node. In 3D, you need to add
a mesh. A mesh is a mathematical description of a shape. It consists of a
collection of points, called vertices. These vertices are connected by lines,
called edges, and multiple edges (at least three) together make a face.
For example, a cube is made up of 8 vertices, 12 edges, and 6 faces.
Typically, meshes are created by using 3D modeling software, such as Blender. You can also find many collections of 3D models available for download, if you’re unable to create your own. However, often you just need a basic shape such as a cube or sphere. In this case, Godot provides a way to create simple meshes called primitives.
MeshInstance node as a child of the
Spatial and in the Inspector,
click its Mesh property:
Here you can see the list of available primitives. They represent a handy collection of common useful shapes. Select “New CubeMesh” and you’ll see a plain cube appear on the screen. Note that the cube is white by default, although it may appear slightly blue on your screen due to the default ambient lighting. We’ll talk about lighting a little bit later.
Try running the scene with your cube object. Did you see anything? In 3D, you
won’t see anything in the game viewport without adding a
Camera. Add one and
use the camera’s gizmo to position it pointing towards the cube:
The pinkish-purple pyramid shape on the camera is called the fustrum and represents the camera’s view. Notice the small triangular arrow which represents the camera’s “up” orientation. As you’re moving the camera around, try pressing the “Preview” button in the upper-left to see what the camera sees. Play the scene to verify everything is working as expected.
In this tutorial you learned how to use Godot’s 3D editor, how to add 3D
nodes such as
Camera, and how to use gizmos to place
your objects. You also learned a bunch of new terminology. Hopefully you’re
In the next part, we’ll look at how to build a 3D scene by importing 3D assets and how to use more of Godot’s 3D nodes.
You can also find a video version of this lesson here: