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.

doc_inspector_plugins

인스펙터 독는 개체, 리소스 또는 노드의 모든 속성을 나열합니다. 씬 트리 도크에서 다른 노드를 선택하거나 파일 시스템의 상황에 맞는 메뉴에서 열기 명령을 사용하면 속성 목록이 업데이트됩니다.

../../_images/inspector_overview.webp

이 페이지에서는 인스펙터 독가 어떻게 작동하는지 자세히 설명합니다. 속성 편집, 영역 접기 및 펼치기, 검색 창 사용 방법 등을 배우게 됩니다.

사용례

검사기 도크가 보이는 경우 씬 트리에서 노드를 클릭하면 해당 속성이 자동으로 표시됩니다. 표시되지 않는 경우 **Editor > Editor Docks > 인스펙터**로 이동하여 표시할 수 있습니다.

도크 상단에는 파일 및 탐색 버튼이 있습니다.

../../_images/inspector_top_buttons.webp

왼쪽에서 오른쪽으로:

  • 메모리에 있는 리소스를 선택, 생성하고 편집할 수 있는 새 창을 엽니다.

  • 편집할 FileSystem에서 리소스를 엽니다.

  • 현재 편집된 리소스를 디스크에 저장합니다.

  • 다음과 같은 옵션을 제공합니다.

    • 복사한 리소스를 붙여넣어 **클립보드에서 리소스를 편집**하세요.

    • 리소스를 복사 클립보드에 복사합니다.

    • 리소스가 이미 저장된 경우 파일 시스템에 표시.

    • **리소스를 내장**하여 디스크의 리소스가 아닌 내장 리소스에서 작업합니다.

  • "<" 및 ">" 화살표를 사용하면 편집된 개체 기록을 탐색할 수 있습니다.

  • 옆에 있는 버튼을 누르면 더 빠른 탐색을 위해 기록 목록이 열립니다. 메모리에 여러 리소스를 생성한 경우 여기에도 표시됩니다.

아래에서 선택한 노드의 아이콘과 이름, 오른쪽에 해당 문서를 열 수 있는 빠른 버튼이 있습니다. 노드 이름 자체를 클릭하면 이 노드의 하위 리소스가 있는 경우 나열됩니다.

그러면 검색창이 나옵니다. 표시된 속성을 필터링하려면 아무 내용이나 입력하세요. 검색을 지우려면 텍스트를 삭제하세요. 이 검색은 대소문자를 구분하지 않으며 입력할 때 문자별로 검색합니다. 예를 들어 ``vsb``를 입력하면 표시되는 결과 중 하나가 가시성 속성이 됩니다. 이 속성에는 이러한 문자가 모두 포함되어 있기 때문입니다.

필터 표시줄 옆에 있는 도구 버튼에 대해 논의하기 전에 실제로 아래에 표시되는 내용과 구성 방식에 대해 언급하는 것이 좋습니다.

../../_images/inspector_dock_overlay.webp

속성은 해당 클래스 내에서 *섹션*으로 그룹화됩니다. 각 섹션을 확장하여 관련 속성을 볼 수 있습니다.

클래스를 마우스 오른쪽 버튼으로 클릭하고 **문서 열기**를 선택하여 각 클래스의 문서를 열 수도 있습니다. 마찬가지로 속성을 마우스 오른쪽 버튼으로 클릭하고 해당 값을 복사 또는 붙여넣고, 속성 경로를 복사하고, 즐겨찾기에 표시하여 검사기 상단에 표시하거나, 해당 문서 페이지를 열 수 있습니다.

속성 위로 마우스를 가져가면 해당 속성이 수행하는 작업에 대한 설명과 스크립트 내에서 호출할 수 있는 방법이 표시됩니다.

클릭하거나 입력하거나 메뉴에서 선택하여 값을 직접 변경할 수 있습니다. 속성이 숫자 또는 슬라이더인 경우 마우스 왼쪽 버튼을 누른 채로 드래그하여 값을 변경할 수 있습니다.

../../_images/inspector_dock_subresource.webp

노드의 속성이 하위 리소스인 경우 아래쪽 화살표를 클릭하여 리소스 유형을 선택하거나 빠른 로드 또는 로드 옵션을 사용하여 로드할 수 있습니다. 또는 지원되는 리소스를 파일 시스템에서 끌어올 수 있습니다. 드래그를 시작하면 호환되는 속성이 강조 표시됩니다. 적절한 속성 값 위에 놓기만 하면 됩니다.

하위 리소스를 로드한 후 해당 리소스를 클릭하여 해당 속성을 확인하거나 조정할 수 있습니다.

원래 값과 다른 값을 가진 값에는 되돌리기 아이콘(실행 취소)이 표시됩니다. 이 아이콘을 클릭하면 값이 원래 상태로 되돌아갑니다. 값이 서로 연결되어 있으면 체인 아이콘이 표시되며 하나를 변경하면 다른 값도 변경됩니다. 이 아이콘을 클릭하면 연결을 해제할 수 있습니다.

속성을 많이 변경하는 경우 마우스 오른쪽 버튼을 클릭하고 **즐겨찾는 속성**을 선택하여 즐겨찾기에 추가하는 것이 좋습니다. 그러면 이 클래스의 모든 개체에 대해 검사기 상단에 표시됩니다.

이제 용어를 더 잘 이해했으므로 도구 메뉴를 진행할 수 있습니다. 필터 표시줄 옆에 있는 도구 메뉴 아이콘을 클릭하면 드롭다운 메뉴에 다양한 보기 및 편집 옵션이 제공됩니다.

../../_images/inspector_tools_menu.webp
  • 모두 확장: 사용 가능한 모든 속성을 표시하는 모든 섹션을 확장합니다.

  • 모두 축소: 클래스와 섹션만 표시하는 모든 속성을 축소합니다.

  • 기본값이 아닌 확장: 원래 값이 현재 값과 다른 섹션(되돌리기 아이콘(실행 취소)이 있는 속성)만 확장합니다.

  • 속성 이름 스타일: 이 섹션에서는 속성의 텍스트가 검사기에 표시되는 방식을 결정합니다. ``Raw``는 속성 자체 이름 지정을 사용하고, ``Capitalized``는 각 단어의 첫 글자를 대문자로 변경하고 밑줄을 제거하여 제목 케이스를 사용하고, ``Localized``는 영어 이외의 언어로 편집기를 사용하는 경우 속성 번역을 표시합니다.

  • 속성 복사: 현재 노드의 모든 속성을 현재 값으로 복사합니다.

  • 속성 붙여넣기: 클립보드에서 복사한 속성을 붙여넣습니다. 한 노드의 공통 속성을 다른 노드에 적용하는 데 유용합니다.

  • 하위 리소스를 고유하게 만들기: 기본적으로 복제된 노드는 원본 노드의 하위 리소스를 공유합니다. 하나의 노드에서 하위 리소스의 매개변수 하나를 변경하면 다른 하나에도 영향을 미칩니다. 이 옵션을 클릭하면 이 노드에 사용된 각 하위 리소스가 다른 노드와 구분되어 고유하게 만들어집니다.

노드가 연결된 스크립트에서 변수를 내보낸 경우 검사기에서도 해당 변수를 볼 수 있습니다. 이 섹션의 첫 번째 이미지에는 플레이어 노드: `Action Suffix`에 대한 이미지가 있습니다. 이 주제에 대한 자세한 내용은 :ref:`doc_gdscript_exports`를 참조하세요.

더 보기

자세한 설명은 프로젝트 내보내기 를 참고하세요.