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

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

См.также

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

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

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

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

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

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

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

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

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

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

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

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

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

Текст «NO DC», появляется в верхнем левом углу менеджера проектов и окна редактора.

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

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

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

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

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

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

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

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

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

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

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