Установка C#-плагина редактора
Структура addons, сборка, включение и проверка отключения.
Плагин EditorPlugin устанавливается в проект, не в каталог исходников движка. Он выполняет код в редакторе: перед включением проверьте его состав, зависимости и требуемую версию API.
Установка проверенного примера
- Создайте
asset://addons/docs_scene_audit/. - Сохраните туда
SceneAuditPlugin.csи файл plugin.cfg из полного примера. Скрипт в конфигурации указан относительно этого каталога. - Соберите C#-проект и устраните ошибки. Класс должен наследоваться от
EditorPlugin, бытьpartialи иметь[Tool]. - Откройте настройки проекта, раздел плагинов, и включите дополнение. Список должен обнаружить
plugin.cfg; операции мышью в этом руководстве не проверялись. - Проверьте панель Scene audit и команду Docs scene audit. Затем отключите плагин: оба элемента должны исчезнуть.
- Включите повторно. Должен появиться один экземпляр панели и одна команда без удвоенных вызовов.
Для программной проверки используются EditorInterface.Singleton.SetPluginEnabled("docs_scene_audit", true) и IsPluginEnabled("docs_scene_audit"). Здесь аргумент — имя каталога в addons, не отображаемое имя name из конфигурации и не имя C#-класса. Не включайте уже включённый плагин без проверки состояния.
Ошибка загрузки
Плагина нет в списке — проверьте глубину каталогов и точное имя plugin.cfg. Файл найден, скрипт не грузится — проверьте относительный путь и успешную сборку. Базовый тип неверен — нужен EditorPlugin, не обычная Entity. Скрипт не tool — добавьте [Tool] и пересоберите.
При обновлении сначала отключите плагин, замените согласованный комплект его файлов, соберите проект и включите снова. Не копируйте каталоги .reckfell, bin и obj из чужого проекта как способ установки. Горячая замена работающего C#-плагина не проверялась.
Программно проверены включение по имени каталога, обработчики, отключение и повторная установка UI без дублей. Сторонние плагины, их зависимости, перезапуск после обновления и экспорт проекта не проверялись.