使用插件
启用插件
因此,默认情况下,在您在 Project Settings > Enable plugins
中确认插件执行之前,插件执行在每个项目中都是禁用的。
只对您信任的项目启用插件。如果您移动或重命名您的项目,您需要重新启用插件。
安装插件
有两种安装插件的方法:通过项目依赖或作为文件放在 plugins
文件夹中。
通过NPM
您可以通过node包管理器(NPM)来安装插件。使用以下命令安装插件:
1npm i --save-dev @wonderlandengine/not-a-real-plugin
将 @wonderlandengine/not-a-real-plugin
替换为您想要安装的任何插件。运行此命令将在您的 package.json
文件的 devDependencies
部分创建一个新条目。
然后,插件会出现在 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>
,或者准备好后发布它并通过包安装,参见安装。