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.

Checking the stable version of the documentation...

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.

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:

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

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:

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:

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:

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):

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

Below is the 3D one:

也參考

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:

The Scene dock lists the active scene's nodes:

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

也參考

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:

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

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 遊戲以外，也用來製作界面。按 F1 (或是 macOS 上 Alt + 1) 來打開。

3D 工作區 可以建立網格、光照以及設計 3D 遊戲的關卡。按 F2 (或 macOS 上 Alt + 2) 來打開。

備註

關於 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.

Script 螢幕 是一個完整的程式碼編輯器，包含除錯器、豐富的自動補全、內建程式碼參考手冊。

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

也參考

你可以在 關於素材庫 中瞭解更多關於素材庫的內容。

如何撰寫類別參照文件

Godot 自帶內建類別參考手冊。

你搜尋有關類別、方法、屬性、常數或訊號的資訊時，可用以下方法:

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

• 點擊 Script 主螢幕右上角的“搜索説明”按鈕。

• 點擊“説明”功能表的“搜索説明”。

• Ctrl + Click (Cmd + Click on macOS) on a class name, function name, or built-in variable in the script editor.

執行其中的任意操作都會彈出一個視窗。通過輸入進行搜索。你也可以用它來查看所有物件和方法。

在條目上按兩下就會在腳本主螢幕中打開對應的頁面。

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.