문제 해결

이 페이지에는 Godot 사용 중 발생하는 일반적인 문제와 가능한 해결 방법이 나열되어 있습니다.

더 보기

HTML5 버전 Godot 편집기 주의 사항은 Using the Web editor를 참고하세요.

편집기나 프로젝트 매니저에서 하는 모든 작업이 한 프레임 지연된 것처럼 보입니다.

이는 Windows에서 발생하는 Intel 그래픽 드라이버의 알려진 버그입니다. 인텔에서 제공하는 최신 그래픽 드라이버 버전으로 업데이트하면 문제가 해결됩니다.

데스크톱 또는 랩톱 제조업체에서 제공하는 그래픽 드라이버가 종종 오래되었기 때문에 인텔에서 제공하는 그래픽 드라이버를 사용해야합니다.

편집기에서 3D 카메라를 회전하면 그리드가 사라지고 메시가 검게 변합니다.

이는 Windows에서 발생하는 Intel 그래픽 드라이버의 알려진 버그입니다.

현재로서는 GLES2 렌더러로 전환하는 것이 유일한 해결 방법입니다. 편집기의 오른쪽 상단 모서리 또는 프로젝트 설정에서 렌더러를 변경할 수 있습니다.

NVIDIA Optimus와 같이 그래픽 카드를 변경할 수 있는 컴퓨터를 사용하는 경우 전용 그래픽 카드로 Godot를 실행할 수 있습니다.

편집기 및 프로젝트가 시작하기까지 오랜 시간이 걸립니다.

이는 특정 USB 주변 장치가 연결되어 있을 때 Windows에서 발생하는 '알려진 버그 <https://github.com/godotengine/godot/issues/20566>'__입니다. 특히, Corsair의 iCUE 소프트웨어가 버그를 일으키는 것 같습니다. USB 주변 기기의 드라이버를 최신 버전으로 업데이트해 보세요. 버그가 지속되면 편집기를 열기 전에 결함이 있는 주변 장치를 분리해야 합니다. 그런 다음 주변 장치를 다시 연결할 수 있습니다.

시스템 콘솔을 클릭하면 Godot 편집기가 고정된 것처럼 보입니다.

시스템 콘솔을 활성화한 Windows에서 Godot을 실행할 때, 명령 창 내부를 클릭해 실수로 선택 모드를 활성화할 수 있습니다. 이 Windows 관련 동작은 응용 프로그램을 일시 중지하여 시스템 콘솔 내에서 텍스트를 선택할 수 있도록 합니다. Godot는 이 시스템 전용 동작을 바꿀 수 없습니다.

이것을 해결하려면 시스템 콘솔 창을 선택하고 Enter를 눌러 선택 모드를 종료하십시오.

프로젝트 매니저 및 편집기 창의 왼쪽 상단 모서리에 "NO DC"와 같은 텍스트가 나타납니다.

이것은 NVIDIA 그래픽 드라이버가 정보를 표시하기 위해 오버레이를 삽입하기 때문에 발생합니다.

Windows에서 이 오버레이를 비활성화하려면, 그래픽 드라이버 설정을 NVIDIA 제어판의 기본값으로 복원하십시오.

리눅스에서 이 오버레이 사용을 중지하려면, ``nvidia-settings``을 열고, X Screen 0 > OpenGL Setting에서 Enable Graphics API Visual Indicator를 선택 취소합니다.

편집기와 달리 프로젝트 창이 흐릿하게 나타납니다.

에디터와 달리 프로젝트는 기본값으로 DPI 인식을 사용하지 않습니다. 이는 hiDPI에서 3D 장면을 렌더링하는 속도가 느린 곳(특히 내장 그래픽)에서 성능을 향상시키기 위함입니다.

이 문제를 해결하려면 프로젝트(Project) > 프로젝트 설정(Project Settings)을 열고 디스플레이(Display) > 창(Window) > Dpi > Hidpi 허용(Allow Hidpi)을 활성화합니다. 가장 먼저, 프로젝트가 multiple resolutions를 지원하도록 설정되어 있는지 확인하세요.

프로젝트를 실행할 때 프로젝트 창이 중앙에 나타나지 않습니다.

이는 알려진 오류입니다. 해결하려면 프로젝트(Project) > 프로젝트 설정(Project Settings)에서 디스플레이(Display) > 윈도우(Window) > Dpi > Hidpi 허용(Allow Hidpi)를 활성화하세요. 이 때, 프로젝트가 multiple resolutions을 지원하도록 설정되어 있어야 합니다.

에디터에서는 프로젝트가 잘 실행되지만 내보낸 사본에서 프로젝트를 실행할 시 일부 파일을 불러올 수 없습니다.

이는 '대화 상자 내보내기'(export dialog)에서 리소스 파일이 아닌 파일의 필터링을 특정하지 않아 발생하는 오류입니다. 기본적으로 Godot은 PCK 파일에 실제 리소스만을 포함하고 있습니다. JSON 파일과 같이 일반적으로 자주 사용되는 일부 파일 형식은 리소스로 취급하지 않습니다. 예를 들어, 내보낸 프로젝트에서 test.json 파일을 불러오는 경우 비-리소스 파일 내보내기 필터(non-resource export filter)에서 *.json 파일 형식을 특정해야 합니다. 자세한 내용은 내보내기 모드를 참고하세요.

Windows의 대소 문자 구분 문제 때문일 수도 있습니다. 파일 시스템과 다른 대소 문자를 사용하여 스크립트에서 리소스를 참조하는 경우 프로젝트를 내보내면 리소스 로드가 실패합니다. 가상 PCK 파일 시스템은 대소 문자를 구분하지만, Windows의 파일 시스템은 기본적으로 대소 문자를 구분하지 않기 때문입니다.