Устранение неполадок

На этой странице перечислены распространенные проблемы, возникающие при использовании Godot, и возможные их решения.

См.также

Смотрите Использование веб-редактора, чтобы познакомиться с особенностями, относящимися к HTML5 версии редактора Godot.

Everything I do in the editor or project manager appears delayed by one frame

Это известная ошибка на графических драйверах Intel под Windows. Обновление до последней версии графического драйвера, предоставляемого Intel, должно исправить проблему.

Используйте графический драйвер от компании Intel вместо того, что поставляется изготовителем вашего ПК или ноутбука. Зачастую это объясняется устаревшей версией заводских настроек.

The grid disappears and meshes turn black when I rotate the 3D camera in the editor

Это распространённая ошибка графических драйверов Intel на Windows.

Пока что, единственный обходной путь — это переключиться на GLES2 рендерер. Переключатель находится в верхнем правом углу редактора, или же в Настройках проекта.

Если вы используете компьютер с возможностью переключения на другую видеокарту, например используя NVIDIA Optimus — вы можете выделить отдельную видеокарту для работы в Godot.

The editor or project takes a very long time to start

Это распространённая ошибка на Windows, которая возникает из-за специфических USB периферийных устройств. В частности, ошибку вызывает программное обеспечение Corsair iCUE. Попробуйте обновить драйверы подобных устройств до последней версии. Если ошибка не исчезнет, вам придётся извлечь это устройство перед запуском редактора, после чего подключить вновь.

The Godot editor appears frozen after clicking the system console

При запуске Godot через системную консоль на Windows — вы можете случайно включить режим выделения, кликая внутри командного окна. Это специфичное для Windows поведение приостанавливает работу приложения, чтобы вы могли выделить текст в системной консоли. Godot не может отменить это специфическое для системы поведение.

Для решения проблемы, выберите окно этой системной консоли и нажмите Enter, чтобы отключить режим выделения.

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

Это вызвано тем, что графические драйверы NVIDIA выводят оверлей для отображения информации.

Чтобы отключить этот оверлей в Windows, восстановите настройки видеодрайвера по умолчанию в контрольной панели NVIDIA.

Чтобы отключить этот оверлей в Linux, откройте nvidia-settings, перейдите в X Screen 0> OpenGL Settings, затем снимите флажок Enable Graphics API Visual Indicator.

The project window appears blurry, unlike the editor

В отличии от редактора, в настройках проекта по умолчанию не помечен флажок DPI-поддержки. Это сделано для повышения производительности, особенно для интегрированной графики, где рендеринг 3D-сцен в hiDPI происходит медленно.

Для решения, откройте Проект > Настройки проекта и включите опцию Display > Window > Dpi > Allow Hidpi. Кроме того, убедитесь, что ваш проект настроен на поддержку нескольких разрешений.

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

Это распространённая ошибка. Для её решения откройте Проект > Настройки проекта и включите опцию Display > Window > Dpi > Allow Hidpi. Кроме того, убедитесь, что ваш проект настроен на поддержку нескольких разрешений.

The editor/project freezes or displays glitched visuals after resuming the PC from suspend

This is a known issue on Linux with NVIDIA graphics when using the proprietary driver. There is no definitive fix yet, as suspend on Linux + NVIDIA is often buggy when OpenGL is involved.

The NVIDIA driver offers an experimental option to preserve video memory after suspend which may resolve this issue. This option has been reported to work better with more recent NVIDIA driver versions.

To avoid losing work, save scenes in the editor before putting the PC to sleep.

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

Обычно это происходит из-за того, что вы забыли указать фильтр для файлов без ресурсов в диалоге экспорта. По умолчанию Godot будет включать в файл PCK только фактические ресурсы. Некоторые часто используемые файлы, например, файлы JSON, не считаются ресурсами. Например, если вы загружаете test.json в экспортируемый проект, вам нужно указать *.json в фильтре экспорта не-ресурсов. Дополнительную информацию смотрите в Resource options.

На Windows, эта проблема бывает связана с чувствительностью к регистру. Если вы ссылаетесь на ресурс в вашем скрипте, с отличным, от принятой в системе регистром наименований файлов — экспорт проекта проваливается. Это связано с тем, что виртуальная файловая система PCK чувствительна к регистру, тогда как файловая система Windows по умолчанию не чувствительна к нему.