Установка плагинов

Godot предлагает систему плагинов для редактора с множеством плагинов, разработанных сообществом. Плагины позволяют расширить функциональность редактора, добавляя новые узлы, дополнительные доки, удобные функции и многое другое.

Поиск плагинов

Предпочтительный способ найти плагины Godot — использовать Asset Library. Хоть, их можно найти онлайн. Однако, удобнее будет это делать непосредственно в редакторе. Для этого нажмите на вкладку AssetLib в верхней части редактора:

../../../_images/installing_plugins_assetlib_tab.webp

Вы также можете найти ресурсы на сайтах хостинга кода, таких как GitHub.

Примечание

Некоторые репозитории позиционируют себя как "plugins", но на самом деле могут не быть плагинами редактора. Это особенно актуально для скриптов, предназначенных для использования в запущенном проекте. Для использования таких плагинов не требуется их включение. Скачайте их и извлеките файлы в папку проекта.

Один из способов отличить плагины-редакторы от плагинов, не являющихся редакторами, — найти файл plugin.cfg в репозитории, где находится плагин. Если репозиторий содержит файл plugin.cfg в папке, расположенной в папке addons/, то это плагин-редактор.

Установка плагина

Чтобы установить плагин, скачайте его в виде ZIP-архива. В библиотеке ресурсов это можно сделать, нажав кнопку Download в редакторе или через веб-интерфейс.

Если на GitHub у плагина объявлены теги (версии), перейдите на вкладку Releases, чтобы загрузить стабильную версию. Это гарантирует, что вы скачаете версию, объявленную автором стабильной.

На GitHub, если плагин не имеет объявленных тегов, используйте кнопку Download ZIP, чтобы загрузить ZIP-архив последней версии:

../../../_images/installing_plugins_github_download_zip.png

Распакуйте ZIP-архив и переместите содержащуюся в нём папку addons/ в папку вашего проекта. Если в вашем проекте уже есть папка addons/, переместите папку addons/ плагина в папку проекта, чтобы объединить содержимое новой папки с существующим. Файловый менеджер может спросить вас, следует ли записывать данные в эту папку; ответьте Да. При этом файлы не будут перезаписаны.

Включение плагина

Чтобы включить установленный плагин, откройте Project > Project Settings в верхней части редактора, затем перейдите на вкладку Plugins. Если плагин был упакован правильно, вы увидите его в списке плагинов. Установите флажок Enable, чтобы включить плагин.

../../../_images/installing_plugins_project_settings.webp

Вы можете использовать плагин сразу после его включения, перезапускать редактор не требуется. Аналогично, отключение плагина можно выполнить без перезапуска редактора.