Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

First look at Godot's interface

本页将向你简要介绍 Godot 的界面。我们将看看不同的主屏幕和面板,以帮助你确定自己的位置。

参见

For a comprehensive breakdown of the editor's interface and how to use it, see the Editor manual.

项目管理器

When you launch Godot, the first window you see is the Project Manager. In the default tab Projects, you can manage existing projects, import or create new ones, and more.

../../_images/editor_intro_project_manager.webp

At the top of the window, there is another tab named Asset Library. The first time you go to this tab you'll see a "Go Online" button. For privacy reasons, the Godot project manager does not access the internet by default. To change this click the "Go Online" button. You can change this option later in the settings.

Once your network mode is set to "online", you can search for demo projects in the open source asset library, which includes many projects developed by the community:

../../_images/editor_intro_project_templates.webp

The Project Manager's settings can be opened using the Settings menu:

../../_images/editor_intro_settings.webp

From here, you can change the editor's language (default is the system language), interface theme, display scale, network mode, and also the directory naming convention.

参见

要进一步了解项目管理器,请阅读 使用项目管理器

初识 Godot 编辑器

When you open a new or an existing project, the editor's interface appears. Let's look at its main areas:

../../_images/editor_intro_editor_empty.webp

By default, along the window's top edge, it features main menu on the left, workspace switching buttons in the center (active workspace is highlighted), and playtest buttons and the Movie Maker Mode toggle on the right:

../../_images/editor_intro_top_menus.webp

Just below the workspace buttons, the opened scenes as tabs are seen. The plus (+) button right next to the tabs will add a new scene to the project. With the button on the far right, distraction-free mode can be toggled, which maximizes or restores the viewport's size by hiding docks in the interface:

../../_images/editor_intro_scene_selector.webp

In the center, below the scene selector is the viewport with its toolbar at the top, where you'll find different tools to move, scale, or lock the scene's nodes (currently the 3D workspace is active):

../../_images/editor_intro_3d_viewport.webp

This toolbar changes based on the context and selected node. Here is the 2D toolbar:

../../_images/editor_intro_toolbar_2d.webp

Below is the 3D one:

../../_images/editor_intro_toolbar_3d.webp

参见

To learn more on workspaces, read The five main screens.

参见

To learn more on the 3D viewport and 3D in general, read 3D 简介.

视口的两边是停靠面板。窗口底部则是底部面板

Let's look at the docks. The FileSystem dock lists your project files, including scripts, images, audio samples, and more:

../../_images/editor_intro_filesystem_dock.webp

The Scene dock lists the active scene's nodes:

../../_images/editor_intro_scene_dock.webp

The Inspector allows you to edit the properties of a selected node:

../../_images/editor_intro_inspector_dock.webp

参见

To read more on inspector, see 检查器.

参见

Docks can be customized. Read more on 面板的移动和大小调整.

The bottom panel, situated below the viewport, is the host for the debug console, the animation editor, the audio mixer, and more. They can take precious space, that's why they're folded by default:

../../_images/editor_intro_bottom_panels.webp

When you click on one, it expands vertically. Below, you can see the animation editor opened:

../../_images/editor_intro_bottom_panel_animation.webp

Bottom panels can also be shown or hidden using the shortcuts defined in Editor Settings > Shortcuts, under the Bottom Panels category.

The five main screens

There are five main screen buttons centered at the top of the editor: 2D, 3D, Script, Game and Asset Library.

2D 屏幕可以用于任何类型的游戏。除了 2D 游戏,2D 屏幕也会用于界面的构建。

../../_images/editor_intro_workspace_2d.webp

3D 屏幕中,你可以操作网格、灯光、设计 3D 游戏的关卡。

../../_images/editor_intro_workspace_3d.webp

备注

更多关于 3D 主屏幕的细节请查看《3D 简介》。

The Game screen is where your project will appear when running it from the editor. You can go through your project to test it, and pause it and adjust it in real time. Note that this is for testing how adjustments would work, any changes made here are not saved when the game stops running.

../../_images/editor_intro_workspace_game.webp

Script 屏幕是一个完整的代码编辑器,包含调试器、丰富的自动补全、以及内置的代码参考手册。

../../_images/editor_intro_workspace_script.webp

Finally, the Asset Library is a library of free and open source add-ons, scripts, and assets to use in your projects.

../../_images/editor_intro_workspace_assetlib.webp

参见

你可以在《关于资产库》中了解更多关于资产库的内容。

内置类参考手册

Godot 自带内置的类参考手册。

要搜索类、方法、属性、常量、信号相关的信息,可以使用以下任意方法:

  • Pressing F1 (or Opt + Space on macOS, or Fn + F1 for laptops with a Fn key) anywhere in the editor.

  • 点击 Script 主屏幕右上角的“搜索帮助”按钮。

  • 点击“帮助”菜单的“搜索帮助”。

  • 在脚本编辑器中 Ctrl + 点击(macOS 上为 Cmd + 点击)类名、函数名、内置变量。

../../_images/editor_intro_search_help_button.webp

执行其中的任意操作都会弹出一个窗口。通过输入进行搜索。你也可以用它来查看所有对象和方法。

../../_images/editor_intro_search_help.webp

在条目上双击就会在脚本主屏幕中打开对应的页面。

../../_images/editor_intro_help_class_animated_sprite.webp

Alternatively,

  • Clicking while pressing the Ctrl key on a class name, function name, or built-in variable in the script editor.

  • Right-clicking on nodes and choosing Open Documentation or choosing Lookup Symbol for elements in script editor will directly open their documentation.