문제해결

이 페이지에는 Godot 및 가능한 솔루션을 사용할 때 발생하는 일반적인 문제가 나열됩니다.

더 보기

See Using the Web editor for caveats specific to the HTML5 version of the Godot editor.

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

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

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

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

이것은 Windows에서 Intel 그래픽 드라이버의`알려진 버그 <https://github.com/godotengine/godot/issues/30330>`__ 입니다.

The only workaround, for now, is to switch to the GLES2 renderer. You can switch the renderer in the top-right corner of the editor or the Project Settings.

NVIDIA Optimus와 같이 컴퓨터의 그래픽 카드를 전환할 수 있는 경우, 전용 그래픽 카드를 사용해 고도 엔진을 구동할 수 있습니다.

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

This is a known bug on Windows when you have specific USB peripherals connected. In particular, Corsair's iCUE software seems to cause the bug. Try updating your USB peripherals' drivers to their latest version. If the bug persists, you need to disconnect the faulty peripherals before opening the editor. You can then connect the peripheral again.

The Godot editor appears frozen after clicking the system console.

When running Godot on Windows with the system console enabled, you can accidentally enable selection mode by clicking inside the command window. This Windows-specific behavior pauses the application to let you select text inside the system console. Godot cannot override this system-specific behavior.

To solve this, select the system console window and press Enter to leave selection mode.

Some text such as "NO DC" appears in the top-left corner of the project manager and editor window.

This is caused by the NVIDIA graphics driver injecting an overlay to display information.

To disable this overlay on Windows, restore your graphics driver settings to the default values in the NVIDIA Control Panel.

To disable this overlay on Linux, open nvidia-settings, go to X Screen 0 > OpenGL Settings then uncheck Enable Graphics API Visual Indicator.

The project window appears blurry, unlike the editor.

Unlike the editor, the project isn't marked as DPI-aware by default. This is done to improve performance, especially on integrated graphics, where rendering 3D scenes in hiDPI is slow.

To resolve this, open Project > Project Settings and enable Display > Window > Dpi > Allow Hidpi. On top of that, make sure your project is configured to support multiple resolutions.

The project window doesn't appear centered when I run the project.

This is a known bug. To resolve this, open Project > Project Settings and enable Display > Window > Dpi > Allow Hidpi. On top of that, make sure your project is configured to support multiple resolutions.

The project works when run from the editor, but fails to load some files when running from an exported copy.

This is usually caused by forgetting to specify a filter for non-resource files in the Export dialog. By default, Godot will only include actual resources into the PCK file. Some files commonly used, such as JSON files, are not considered resources. For example, if you load test.json in the exported project, you need to specify *.json in the non-resource export filter. See 내보내기 모드 for more information.

On Windows, this can also be due to case sensitivity issues. If you reference a resource in your script with a different case than on the filesystem, loading will fail once you export the project. This is because the virtual PCK filesystem is case-sensitive, while Windows's filesystem is case-insensitive by default.