Использование плагинов
Включение плагинов
По этой причине выполнение плагинов по умолчанию отключено для каждого проекта, пока вы
не подтвердите выполнение плагинов в Project Settings > Enable plugins
.
Включайте плагины только для тех проектов, которым вы доверяете. Если вы переместите или переименуете свой проект, вам нужно будет снова включить плагины.
Установка плагинов
Есть два способа установки плагинов: через зависимости вашего проекта или как файлы в папке plugins
.
Через NPM
Вы можете установить плагины с помощью node package manager (NPM). Установите плагин с помощью следующей команды:
1npm i --save-dev @wonderlandengine/not-a-real-plugin
Замените @wonderlandengine/not-a-real-plugin
на любой плагин, который вы хотите установить.
Запуск этой команды создаст новую запись в разделе devDependencies
вашего файла package.json
.
Плагин затем появится в Project Settings > Plugins
.
Управление плагинами
Иногда вы можете захотеть отключить плагины, чтобы уменьшить загромождение интерфейса или восстановить производительность редактора.
Список в Project Settings > Plugins
показывает, какие плагины установлены и доступны
для включения.
Разработка
Создавать плагины легко. У вас есть три доступных метода:
Скрипт плагина
Единый скрипт, который может использовать общие зависимости с вашим основным проектом package.json
.
Мы рекомендуем устанавливать любые зависимости, связанные с плагинами, как devDependencies
(с использованием --save-dev
).
Вы можете создать новый плагин, создав папку plugins
в корне вашего проекта, затем
щелкните правой кнопкой мыши > New Plugin
.
Убедитесь, что в корне вашего проекта установлен пакет @wonderlandengine/editor-api
:
1npm i --save-dev @wonderlandengine/editor-api
Директория плагина
Аналогично Скриптам плагина, сначала создайте подпапку plugins
,
но затем создайте еще одну подпапку, которую назовите по имени вашего плагина.
В этой папке вы можете создать новый файл package.json
(например, с помощью npm init
).
Убедитесь, что в этой директории установлен пакет @wonderlandengine/editor-api
:
1npm i --save @wonderlandengine/editor-api
Обратите внимание, используется --save
вместо --save-dev
, так как вы устанавливаете не в проект Wonderland Engine,
а в отдельный проект плагина.
Пакет плагина
Если вы хотите поделиться и распространить свой плагин, вы можете npm init
в отдельной папке и добавить
ключ "wonderlandengine"
в ваш package.json
.
Убедитесь, что в этой директории установлен пакет @wonderlandengine/editor-api
:
1npm i --save @wonderlandengine/editor-api
Чтобы использовать этот локальный плагин в вашем проекте, npm i --save-dev <path-to-the-directory>
,
или опубликуйте его, когда он будет готов, и установите через пакет, см. Установку.