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

처음 만나는 Godot 인터페이스

이 페이지에서는 Godot의 인터페이스에 대한 간략한 개요를 제공합니다. 우리는 메인 화면과 독을 살펴봄으로써 여러분이 사용할 수 있도록 도와드리겠습니다.

더 보기

편집기 인터페이스와 사용법의 포괄적인 설명은 편집기 설명서를 참조하세오.

프로젝트 매니저

Godot를 실행할 때 먼저 보는 창은 프로젝트 매니저입니다. 디폴트 탭인 프로젝트에서는 기존 프로젝트를 관리하고 새로운 프로젝트를 가져오거나 만드는 등의 관리를 할 수 있습니다.

창 상단에는 애셋 라이브러리라는 또 다른 탭이 있습니다. 이 탭에 처음 이동하면 "온라인으로 이동" 버튼을 보게 됩니다. 개인정보 보호를 위해 Godot 프로젝트 매니저는 기본적으로 인터넷에 접속하지 않습니다. 이를 변경하려면 "온라인으로 이동" 버튼을 클릭하세요. 이 옵션은 나중에 설정에서 변경할 수 있습니다.

네트워크 모드를 "온라인"으로 설정하면 커뮤니티에서 개발한 여러 프로젝트가 포함된 오픈 소스 애셋 라이브러리에서 데모 프로젝트를 검색할 수 있습니다:

프로젝트 매니저의 설정은 설정 메뉴를 사용하여 열 수 있습니다:

여기에서 편집기의 언어(디폴트는 시스템 언어), 인터페이스 테마, 표시 배율, 네트워크 모드, 그리고 디렉터리 명명 규칙을 변경할 수 있습니다.

더 보기

프로젝트 매니저의 자세한 내용을 배우려면 프로젝트 매니저를 읽어보세요.

처음 만나는 Godot 편집기

새로운 프로젝트나 기존 프로젝트를 열 때편집기의 인터페이스가 나타납니다. 주요 영역을 살펴보겠습니다:

기본적으로 창의 상단 가장자리에는 왼쪽에 주요 메뉴, 가운데에는 작업 공간 전환 버튼(활성 작업 공간은 강조 표시됨), 그리고 오른쪽에는 플레이테스트 버튼과 무비 메이커 모드 토글이 있습니다:

작업 공간 버튼 바로 아래에, 열려 있는 씬 탭이 보입니다. 탭 바로 옆에 더하기(+) 버튼은 프로젝트에 새 씬을 추가합니다. 가장 오른쪽에 있는 버튼으로는 방해받지 않는 모드를 토글할 수 있으며, 이 모드는 인터페이스의 독을 숨겨 뷰포트의 크기를 최대화하거나 복원합니다:

씬 선택기 아래 가운데는 툴바가 있는 뷰포트가 있으며, 여기서 씬의 노드를 이동, 스케일 또는 잠그는 데 사용할 수 있는 다양한 툴을 찾을 수 있습니다 (현재 3D 작업 공간이 활성 중임).

이 툴바는 상황과 선택한 노드에 따라 변경됩니다. 다음은 2D 툴바입니다:

아래는 3D 툴바입니다:

더 보기

작업 공간에 대해 더 알아보려면, 다섯 개의 주요 화면을 읽어보세요.

더 보기

3D 뷰포트와 3D 전반에 대해 자세히 알아보려면 3D 소개를 읽어보세요.

뷰포트의 양쪽에는 독이 위치하고 있습니다. 그리고 창의 하단에는 하단 패널이 있습니다.

독를 살펴보겠습니다. 파일시스템 독은 프로젝트 파일을 나열합니다. 스크립트, 이미지, 오디오 샘플 등이 포함될 수 있습니다:

씬 독은 활성화된 씬의 노드들을 나열합니다:

인스펙터는 선택한 노드의 속성을 편집할 수 있도록 해줍니다:

더 보기

인스펙터에 대해 자세히 읽으려면, doc_inspector_plugins을 참조하세요.

더 보기

독은 사용자 지정할 수 있습니다. "up"을 눌러 이동하기에서 자세히 읽으세요.

하단 패널은 뷰포트 아래에 위치하며 디버그 콘솔, 애니메이션 편집기, 오디오 믹서 등을 포함합니다. 이들은 소중한 공간을 차지할 수 있으므로, 기본적으로 접혀 있습니다:

클릭하면 세로로 확장됩니다. 아래에서 애니메이션 편집기가 열리는 것을 볼 수 있습니다.

하단 패널은 편집기 설정 > 단축키의 하단 패널 카테고리에 정의된 단축키를 사용하여 표시하거나 숨길 수도 있습니다.

다섯 개의 주요 화면

2D, 3D, 스크립트, 게임 및 애셋 라이브러리의 다섯 개의 주요 화면 버튼이 상단 중앙에 위치합니다.

모든 유형의 게임에 대해 2D 화면을 사용하게 될 것입니다. 2D 게임 외에도 2D 화면에서 인터페이스를 구축하게 됩니다.

3D 화면에서는 3D 게임에 대한 메시, 조명, 그리고 레벨 설계를 다룰 수 있습니다.

참고

3D 주요 화면에 대한 자세한 사항은 3D 소개를 참조하세요.

게임 화면은 편집기에서 실행할 때 프로젝트가 나타나는 곳입니다. 프로젝트를 테스트하고, 일시 정지하고, 실시간으로 조정할 수 있습니다. 여기서 조정이 어떻게 작동하는지 테스트하기 위한 것이며, 게임이 정지되면 여기에서 변경한 내용은 저장되지 않습니다.

스크립트 화면은 완전한 코드 편집기로서 디버거, 풍부한 자동완성 기능 및 내장된 코드 참조 기능을 제공합니다.

마지막으로 애셋 라이브러리는 프로젝트에 사용할 자유 및 오픈 소스 애드온, 스크립트, 그리고 애셋이 있는 라이브러리입니다.

더 보기

애셋 라이브러리에 대하여에서 애셋 라이브러리에 대해 자세히 알아볼 수 있습니다.

통합 클래스 참조

Godot는 클래스 참조를 내장하고 있습니다.

다음과 같은 방법으로 클래스, 메서드, 속성, 상수, 또는 시그널의 정보를 검색할 수 있습니다:

• 편집기의 어느 곳에서나 F1(또는 macOS에서는 Opt + Space, 또는 Fn 키가 있는 노트북에서는 Fn + F1)을 누르세요.

• 스크립트 주요 화면의 오른쪽 상단에 있는 "도움말 검색" 버튼을 클릭하세요.

• 도움말 메뉴에서 도움말 검색을 클릭하세요.

• 스크립트 편집기에서 클래스 이름, 함수 이름 또는 내장 변수 위에 Ctrl + 클릭(macOS에서는 Cmd + 클릭)하세요.

이 중 어떤 작업을 하든 창이 띄어집니다. 원하는 항목을 검색하려면 입력하세요. 이를 사용하여 사용 가능한 오브젝트와 메서드를 찾아볼 수도 있습니다.

해당 페이지를 스크립트 주요 화면에서 열려면 항목을 더블 클릭하세요.

또는,

• 스크립트 편집기에서 클래스 이름, 함수 이름, 내장 변수 위를 Ctrl (macOS에서는 Cmd) 키를 누른 채 클릭하기.

• 노드를 마우스 오른쪽 버튼으로 클릭하고 문서 열기를 선택하거나 스크립트 편집기에서 요소에 대해 룩업 기호를 선택하면 해당 문서가 바로 열립니다.