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.

스크립트 편집기

소개

Godot Engine의 스크립트 편집기는 GDScript로 작성된 코드 작성 및 디버깅 프로세스를 간소화할 뿐만 아니라 일반 텍스트 파일 작업을 허용하여 개발자에게 게임 논리 및 동작 스크립팅을 위한 원활한 환경을 제공하는 강력하고 완전히 통합된 텍스트 편집기입니다. 코드를 강조 표시하고, 자동으로 들여쓰기하고, 구문 검사 등을 수행할 수 있습니다. 중단점을 만들어 다른 창으로 전환하지 않고도 프로젝트를 디버깅할 수도 있습니다. 텍스트 편집기는 :ref:`doc_intro_to_the_editor_interface_integrated_class_reference`에 설명된 대로 여러 방법으로 액세스할 수 있는 오프라인 클래스 참조 뷰어 역할도 합니다.

../../_images/text_editor.webp

기능 태그

텍스트 편집기의 주요 기능 중 일부는 다음과 같습니다.

  • GDScript에서 C# 노드 인스턴스화 하기

  • Github에서 구문 강조 지원.

  • GDScript 및 JSON 파일에 대한 구문 검사.

  • 플랫폼 지원

  • 정적 함수

  • Godot 버전 관리

  • 빌드 커스터마이징하기

  • :kbd:`Alt + 왼쪽 클릭`을 사용하여 활성화할 수 있는 여러 캐럿.

  • 변수, 함수, 상수 등의 자동 완성

  • 기호를 선택하고 :kbd:`Ctrl + D`을 사용하여 기호를 인라인 리팩터링합니다.

  • 프로젝트 파일 전체에서 대량 찾기 및 바꾸기.

사용례

프로젝트에서 GDScript를 사용하는 경우 Godot에 내장된 텍스트 편집기는 Godot 엔진을 완전히 활용할 수 있는 원스톱 위치 역할을 하면서 필요한 모든 것을 제공합니다. 사용자 인터페이스를 통해 조정할 수 있는 거의 모든 매개변수는 코드를 통해 직접 수정할 수도 있습니다.

참고

외부 텍스트 편집기를 사용하고 싶거나 프로젝트에서 C#을 사용하려는 경우 외부 텍스트 편집기 사용하기 및 :ref:`doc_c_sharp_setup_external_editor`를 참조하세요.

Godot 인터페이스의 많은 부분과 유사하게, 텍스트 편집기도 원하는 대로 설정을 변경하여 사용자 정의할 수 있습니다. 편집기 > 편집기 설정**을 열고 **텍스트 편집기 그룹으로 이동하여 이러한 설정에 액세스할 수 있습니다.

../../_images/editor_ui_script_editor_open.webp

Godot 인터페이스 상단 중앙에 위치한 작업 공간 선택기의 스크립트 버튼을 사용하여 스크립트 편집기를 열 수 있습니다. 또는 씬 트리 도크에서 노드 옆에 있는 Open 스크립트 버튼을 사용하거나, .gd 파일 또는 FileSystem 도크에서 인식된 텍스트 파일을 두 번 클릭하여 스크립트 편집기에서 직접 열 수 있습니다.

../../_images/editor_ui_script_editor_menu.webp

일단 열리면 씬 스위처 아래 상단에 텍스트 편집기 메뉴가 표시됩니다. 메뉴 옆에는 온라인 문서를 열거나 내장 클래스 참조 내에서 검색할 수 있는 버튼이 있습니다. 이 버튼 오른쪽에는 시청 기록을 탐색할 수 있는 두 개의 탐색 화살표가 있습니다. 마지막으로, 플로트 버튼을 사용하여 Godot 창에서 텍스트 편집기를 분리할 수 있는데, 이는 다중 모니터로 작업하는 경우 유용합니다.

왼쪽 메뉴 아래에 스크립트 패널이 표시됩니다. 중앙에는 스크립트 패널 옆에 코딩 영역이 있습니다. 코딩 영역 아래에는 코드의 오류 및 경고 개수를 표시하는 상태 표시줄이 있습니다. 오류 또는 경고 아이콘을 클릭하면 줄 번호와 함께 오류 목록이 표시됩니다. 하나를 클릭하면 해당 라인으로 이동합니다. 목록을 열고 ``Ignore``를 클릭하여 경고를 무시하도록 선택할 수도 있습니다. 상태 표시줄에서는 백분율 값을 클릭하여 코드의 확대/축소 수준을 변경할 수도 있습니다. Ctrl + 마우스 휠`(Mac의 경우 :kbd:`Cmd + 마우스 )을 사용하여 동일한 효과를 얻을 수도 있습니다. 상태 표시줄에는 줄과 열 측면에서 캐럿의 현재 위치와 탭 또는 공백을 사용하여 들여쓰기가 수행되는지 여부도 표시됩니다.

텍스트 편집기에서 수행되는 대부분의 작업은 바로가기를 사용하여 실행할 수도 있습니다. 작업 옆에는 해당 바로가기가 표시됩니다. 전체 바로가기 목록을 보려면 :ref:`텍스트 편집기 바로가기 <doc_default_key_mapping_shortcuts_text_editor>`를 참조하세요.

다음 섹션에서는 텍스트 편집기의 다양한 측면을 살펴보겠습니다. 아래 섹션을 선택하여 특정 주제로 이동할 수도 있습니다.

스크립트 패널 토글

../../_images/editor_ui_script_editor_script_panel.webp

메뉴 아래 왼쪽 패널에는 열린 파일 및 문서 페이지 목록이 표시됩니다. 파일 유형에 따라 이 목록에는 파일 이름 옆에 아이콘이 표시됩니다. 예를 들어, 스크립트 아이콘은 GDScript임을 의미합니다. |scriptcsharp|는 C# 스크립트임을 의미합니다. |documentation|는 이것이 내장 클래스 참조임을 의미합니다. 마지막으로, |toolscript|는 현재 실행 중인 스크립트임을 의미합니다(자세한 내용은 tool 주석 참조). 파일을 마우스로 가리키면 프로젝트 폴더에서의 상대 위치에 대한 도구 설명이 표시됩니다.

상태 표시줄에서 왼쪽 화살표를 클릭하면 스크립트 패널이 숨겨지고, 오른쪽 화살표를 클릭하면 표시됩니다.

설정을 변경하지 않은 경우 파일 이름 색상도 다를 수 있습니다. 이렇게 하면 최근에 편집한 파일을 강조 표시하여 식별하는 데 도움이 됩니다. 이 동작은 텍스트 편집기 섹션의 스크립트 온도 속성을 조정하여 **편집기 > 편집기 설정**에서 변경할 수 있습니다.

파일 이름 위의 필터 표시줄에는 대/소문자를 구분하지 않는 편리한 검색 기능이 있어 특정 파일을 찾을 수 있습니다. 파일 이름의 문자를 바에 입력하더라도 해당 문자가 순서대로 포함된 파일도 나타납니다. 목록에 ``button.gd``라는 파일이 있다고 가정합니다. 필터 표시줄에 ``btn``를 입력하면 이 파일이 결과에 나타납니다. 필터를 재설정하려면 필터 표시줄을 지우세요.

파일 이름 옆의 별표(*)는 파일에 저장되지 않은 변경 사항이 있음을 나타냅니다.

필터 표시줄에 "*"만 입력하면 저장되지 않은 모든 파일을 표시할 수 있습니다.

파일을 끌어서 순서를 변경할 수 있습니다. 파일을 마우스 가운데 버튼으로 클릭하면 파일이 닫힙니다. 파일을 마우스 오른쪽 버튼으로 클릭하면 파일을 저장하거나 닫거나 파일의 상대 경로를 복사할 수 있는 여러 옵션이 제공됩니다. 이 메뉴에서:

위로 이동**아래로 이동**을 사용하여 파일 순서를 변경하거나 **정렬**을 사용하여 모든 파일을 알파벳순으로 정렬할 수도 있습니다. **스크립트 패널 전환**은 상태 표시줄의 오른쪽 화살표를 사용하여 다시 표시할 수 있는 패널을 숨깁니다. **문서 닫기**는 열려 있는 클래스 내 참조 문서를 모두 닫고 스크립트 파일만 열어 둡니다. **Show in FileSystem**은 FileSystem 도크에서 파일을 찾아 강조 표시합니다.

파일 목록 아래에는 현재 열려 있는 파일의 이름이 표시됩니다. 옆에 있는 버튼은 이 파일에 정의된 메소드의 순서를 알파벳순과 표시되는 순서로 전환합니다. 이 아래에는 파일의 개요가 있습니다. 스크립트 파일인 경우 정의된 메소드 목록이 포함됩니다. 그러나 수업 참조 페이지가 열려 있으면 이 영역에 이 문서의 목차가 표시됩니다. 이 목록의 항목을 클릭하면 파일의 해당 기능이나 섹션으로 이동합니다. 마찬가지로 필터 방법 막대를 사용하면 스크립트 필터링과 동일한 동작으로 선택한 문서 내에서 특정 기능이나 섹션을 검색할 수 있습니다.

플레이어 움직이기

참고

이 섹션에서는 사용자 인터페이스 측면에서 코딩 영역의 기본 사항만 다룹니다. Godot의 스크립팅에 대해 더 자세히 알아보려면 GDScript 또는 Scripting 문서를 참조하세요.

../../_images/editor_ui_script_editor_coding_area.webp

내장된 텍스트 편집기를 사용하는 경우 코딩 영역은 스크립트를 입력하는 곳입니다. 코딩하는 동안 도움이 되는 강조 표시 및 자동 완성 기능을 제공합니다.

코딩 영역의 왼쪽에는 줄 번호가 표시됩니다. 오른쪽 탐색 화살표 아래에는 전체 스크립트의 개요를 제공하는 클릭 가능한 미니맵이 있어 스크롤할 수 있습니다.

코드 줄이 충분히 길면(기본적으로 80자 이상) 텍스트 편집기에 부드러운 안내선으로 사용할 수 있는 수직선이 표시됩니다. 엄격한 지침의 경우 이 값은 기본적으로 100자로 설정됩니다. 두 값 모두 변경하거나 텍스트 편집기의 "모양" 설정에서 줄 표시를 전환할 수 있습니다.

스크립트에서는 기능 정의 왼쪽에 추가 아이콘이 표시될 수 있습니다. 오버라이드 아이콘은 이 함수가 기존 함수의 :ref:`override <doc_overridable_functions>`임을 나타냅니다. 클릭하면 원래 함수의 문서가 열립니다. 수신기 아이콘은 시그널의 수신 방식임을 의미합니다. 이를 클릭하면 시그널의 출처가 표시됩니다. 줄 왼쪽의 접기 가능 아이콘은 접을 수 있는 블록을 나타냅니다. 클릭하여 축소하거나 확장할 수 있습니다. 또는 줄임표(...) 아이콘을 클릭하여 접힌 블록을 확장할 수도 있습니다.

아래 예는 위의 단락을 요약한 것입니다. 52행, 56행, 58행은 접을 수 있는 블록이고, 57행은 접을 수도 있는 "New Code Region"이라는 이름의 코드 영역이며, 62행은 접힌 블록입니다. 53행은 북마크이며 이동 > 북마크 메뉴를 사용하여 빠르게 이동할 수 있습니다. 55행은 :ref:`debugging <doc_overview_of_debugging_tools>`에서 사용할 수 있는 중단점입니다.

../../_images/text_editor_coding_area_indicators.webp

강조 색상이나 중단점 또는 책갈피 아이콘 색상과 같은 텍스트 편집기의 다양한 색상을 사용자 정의할 수 있습니다. 편집기 > 편집기 설정 > 텍스트 편집기 섹션으로 이동하여 텍스트 편집기 설정을 열어 실험해 볼 수 있습니다.