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의 스크립팅 API (응용 프로그래밍 인터페이스)를 사용하는 데 관한 것입니다. 이 참조는 온라인 및 오프라인에서 모두 이용할 수 있습니다. 클래스 참조는 Godot 편집기 안에서 오프라인으로 살펴보는 것을 권장합니다. 이를 위해 도움말 -> 도움말 검색으로 이동하거나 :kbd:`F1`을 누르세요.

../../_images/manual_class_reference_search.webp

온라인으로 보려면 매뉴얼의 클래스 참조 섹션으로 이동하세요.

클래스 참조 페이지는 제공합니다:

클래스가 상속 계층 구조에서 어디에 존재하는지에 대한 정보를 제공합니다. 맨 위의 링크를 클릭하여 상위 클래스로 이동하면 해당 타입이 상속한 속성과 방법을 볼 수 있습니다.
클래스의 역할과 사용 사례에 대한 요약을 제공합니다.
클래스의 속성, 방법, 신호, 열거형 및 상수에 대한 설명을 제공합니다.
해당 클래스를 자세히 설명하는 매뉴얼 페이지로의 링크를 제공합니다.

참고

만약 매뉴얼이나 클래스 참조에 부족한 정보가 있거나 누락된 경우, 공식 godot-docs GitHub 저장소에 이를 보고하기 위해 이슈(Issue)를 열어주시기 바랍니다.

Ctrl`(macOS에서는 :kbd:`Cmd)를 누른 채 클래스, 속성, 메서드, 시그널, 상수 이름 같은 텍스트 위에 마우스를 올리면 밑줄이 표시됩니다. 이어서 Ctrl + Click`(macOS에서는 :kbd:`Cmd + Click)하면 해당 항목으로 이동할 수 있습니다.

프로그래머처럼 생각하는 법 배우기

프로그래밍의 기초와 게임 개발자처럼 사고하는 법을 가르치는 것은 Godot 문서의 범위를 벗어납니다. 프로그래밍이 처음이라면, 시작하는 데 도움이 되는 두 가지 훌륭한 무료 자료를 추천합니다:

GDQuest의 *Learn GDScript From Zero*는 완전 초보자가 Godot의 GDScript 언어로 프로그래밍을 배울 수 있도록 만든 무료 오픈 소스 인터랙티브 튜토리얼입니다. 데스크톱 애플리케이션 또는 브라우저 에서 이용할 수 있습니다.
책을 선호한다면, Al Sweigart의 무료 전자책 Automate The Boring Stuff With Python을 확인해 보세요.

커뮤니티와 함께 배우기

Godot는 점점 성장하는 사용자 커뮤니티를 가지고 있습니다. 문제에 막혀있거나 어떤 것을 어떻게 구현할 수 있는지 더 잘 이해하기 위해 도움이 필요하다면 다른 사용자들에게 도움을 요청할 수 있습니다. 많은 활발한 커뮤니티 중 하나에서 도움을 받을 수 있습니다. 이러한 커뮤니티는 다음 링크에서 확인할 수 있습니다. active communities.

질문을 하고 이미 답변된 질문을 찾기에 가장 좋은 곳은 공식 Godot Forum 입니다. 이곳의 답변은 검색 엔진 결과에 표시되고 보존되므로, 다른 사용자들도 플랫폼의 토론 내용을 통해 도움을 받을 수 있습니다. 질문을 올린 뒤에는 그 링크를 다른 소셜 플랫폼에 공유할 수도 있습니다. 질문하기 전에 이 웹사이트나 선호하는 검색 엔진을 사용해, 문제를 해결해 줄 기존 답변이 있는지 먼저 확인하세요.

다른 사람들이 답변을 더 빠르고 더 잘 할 수 있도록 질문을 잘하고 세부 정보를 제공하는 것이 좋습니다. 질문을 할 때, 다음과 같은 정보를 포함하는 것이 좋습니다:

**목표를 설명**하세요. 디자인 관점에서 어떤 결과를 달성하려고 하는지 설명하세요. 만약 해결 방법을 구현하는 데 문제가 있다면, 동일한 목표를 달성하는 다른, 더 간단한 해결책이 있을 수 있습니다.
**정확한 오류 메시지를 공유**하세요. 디버거 하단 패널의 오류 메시지를 복사하기 위해 "오류 복사" 아이콘을 클릭하여 정확한 오류 메시지를 복사할 수 있습니다. 어떤 오류가 발생했는지 알면 커뮤니티 회원들이 해당 오류가 어떻게 발생했는지 더 잘 파악할 수 있습니다.
**코드 샘플을 공유**하세요. 코드를 보지 않고는 다른 사용자가 문제를 해결하는 데 도움을 줄 수 없습니다. 코드를 텍스트로 직접 공유하세요. 이를 위해 코드 스니펫을 채팅 박스(chat box)에 복사하여 붙여넣거나, Pastebin과 같은 웹사이트를 사용하여 긴 코드를 공유할 수 있습니다.
작성한 코드와 함께 씬 독의 **스크린샷을 공유**하세요. 여러분이 작성한 대부분의 코드는 씬 안의 노드에 영향을 미칩니다. 따라서 해당 씬도 소스 코드의 일부로 생각해야 합니다.

또한, 휴대전화로 사진을 찍지 마세요. 낮은 품질과 화면 반사로 인해 이미지를 이해하기 어려울 수 있습니다. 여러분의 운영 체제에는 PrtSc(Print Screen) 키로 스크린샷을 찍을 수 있는 내장 도구가 있을 것입니다 (macOS: 전체 화면 스크린샷은 Cmd + Shift + 3을 사용하세요, 자세한 정보는 여기를 참조하세요).

또는 Windows에서는 ShareX, Windows/macOS/Linux에서는 Flameshot 같은 프로그램을 사용할 수도 있습니다.
게임 실행 중인 비디오를 공유하는 것은 문제 해결에 매우 유용할 수 있습니다. OBS Studio 및 Screen to GIF와 같은 프로그램을 사용하여 화면을 녹화할 수 있습니다.

그런 다음 streamable과 같은 서비스나 클라우드를 사용하여 비디오를 업로드하고 무료로 공유할 수 있습니다.
만약 Godot의 stable 버전이 아닌 다른 버전을 사용 중이라면, 사용 중인 버전을 명시해 주세요. 사용 가능한 기능과 인터페이스가 빠르게 변화하기 때문에 답변이 달라질 수 있습니다.

이 가이드라인을 따르면 원하는 답을 얻을 가능성을 최대한 높일 수 있습니다. 여러분과 여러분을 도와주는 사람들 모두의 시간을 아껴 줄 것입니다.

커뮤니티 튜토리얼

이 매뉴얼은 Godot의 기능에 대한 포괄적인 참조를 제공하는 것을 목표로 합니다. 2D 및 3D 시리즈 이외에도 특정 게임 장르를 구현하는 튜토리얼은 포함되어 있지 않습니다. 만약 롤플레잉 게임, 플랫포머 또는 기타 게임을 만드는 방법에 대한 튜토리얼을 찾고 있다면, 튜토리얼과 리소스를 참조하세요. 해당 페이지에는 Godot 커뮤니티가 작성한 내용이 나열되어 있습니다.