Перейти к основному содержимому

Плагины

Плагины расширяют сам редактор. Плагин — это папка с файлами, которая работает внутри Studio без пересборки: она может добавить панель, генерировать сцены, обрабатывать ресурсы или добавлять объектам новый вид компонента.

Хотите написать свой? → Как написать плагин.

Панель плагинов

Две вкладки.

My uploads — ваши локальные папки разработки, ваши опубликованные плагины и установленные, в одном списке. Отсюда можно создать плагин, открыть существующую папку, перечитать её с диска, опубликовать или снять с публикации и удалить.

Library — общий реестр: поиск, теги, скриншоты, автор, рейтинг, число установок и избранное. Ваши собственные и установленные плагины ранжируются выше.

Поиск идёт по обеим вкладкам: введите запрос, и вкладки схлопнутся в один список, ваше — первым.

Установка

Установка добавляет плагин вам в редактор. Его иконка появляется в вашей панели инструментов.

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

Удаление плагина из реестра убирает его из всех проектов, где он использовался.

Доверие

Плагин работает с доступом к вашему проекту

Открытие чужого плагина один раз попросит подтверждения, потому что он может читать и менять вашу сцену и ресурсы. «Больше не спрашивать» запомнит ваш ответ для этого плагина.

Относитесь к библиотеке так же, как к любому стороннему расширению: ставьте то, чему у вас есть основания доверять.

Что означает проверка

Проверенный плагин — это не «хороший плагин». Это значит, что кто-то прочитал именно этот код.

Проверка привязана к отпечатку содержимого плагина. Публикация нового кода меняет отпечаток, так что проверенный плагин снова становится ожидающим проверки. Правка описания, тегов или скриншотов — нет: они не выполняются.

Проверка может снимать до трёх отдельных вещей:

СнимаетЧто это значит
openпри открытии панели не спрашивают подтверждения
autorunсамозапускающимся частям разрешено работать без вопросов — см. ниже
warningsпредупреждения «мы не проверяем код плагинов» скрыты

Пустой набор тоже возможен: значок есть, а все запросы остаются на месте. «Мы прочитали код» и «мы перестанем вас спрашивать» — намеренно разные обещания.

Самозапускающийся код — обещание посерьёзнее

Панель запускается, когда её открывают. Расширение компонента или оверлей вьюпорта запускается каждый раз, когда кто угодно открывает проект. Поэтому autorun снимается отдельно, и поэтому самозапускающиеся части недоверенного плагина вообще не монтируются.

Статусы: none, pending, verified, rejected и revoked. Отозванная проверка также сбрасывает ваше локальное «больше не спрашивать» — то согласие касалось другого кода.

Рейтинги и премиум

Одна оценка на человека, от одной до пяти звёзд. Некоторые плагины помечены как требующие подписки; ваши собственные никогда не закрываются.

Что потребуется

Для разработки нужен браузер на Chromium, потому что чтение локальной папки использует File System Access API. Библиотека работает везде — Chromium нужен только для сборки плагина из локальной папки.


Дальше: Как написать плагин