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

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

См.также

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

Всё, что я делаю в редакторе или менеджере проектов, подвисает на один кадр.

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

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

Координатная сетка исчезает, а полисетки темнеют, когда я изменяю ракурс 3D-камеры в редакторе.

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

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

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

Длительный запуск редактора или проекта.

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

Godot-редактор явно подвисает после нажатия на системную консоль.

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

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

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.

Отображение в окне проекта выглядит размытым, в отличии от показанного в редакторе.

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

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

Когда я запускаю проект, окно проекта не отображается по центру.

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

Проект работает при запуске из редактора, но не может загрузить некоторые файлы при запуске из экспортированной копии.

Обычно это происходит из-за того, что вы забыли указать фильтр для файлов, не являющихся ресурсами, в диалоговом окне «Экспорт». По умолчанию, Godot будет включать актуальные ресурсы в PCK-файл. Некоторые часто используемые файлы, такие как JSON, не считаются ресурсами. К примеру, если вы загружаете test.json в экспортируемый проект, вам нужно указать *.json в фильтре экспорта без ресурсов. Смотреть Export mode (режим экспорта) для получения информации.

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