使用插件

启用插件

因此，默认情况下每个项目的插件执行都是禁用的。您可以在 Views > Plugins 中通过勾选“为此项目启用插件”来启用插件。

仅对您信任的项目启用插件。如果您移动或重命名项目，则需要重新启用插件。

安装插件

安装插件有两种方式：通过项目依赖或在 plugins 文件夹中添加文件。安装后，在 Views > Plugins 中可以为每个项目启用或禁用插件。

通过 NPM

您可以通过 Node 包管理器（NPM）安装插件。使用以下命令安装插件：

1npm i --save-dev @wonderlandengine/not-a-real-plugin

将 @wonderlandengine/not-a-real-plugin 替换为您想要安装的插件。运行该命令会在 package.json 文件的 devDependencies 部分创建一个新条目。

然后，该插件会出现在 Plugins 视图中。

管理插件

有时您可能需要停用某些插件以减少界面杂乱或提升编辑器性能。

打开 Views > Plugins 可以查看和管理所有可用插件：

可以通过顶部的复选框“为此项目启用插件”来启用当前项目的插件。
使用标签在“编辑器范围”（扩展编辑器功能的插件）和“项目范围”（通过 devDependencies 或 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，并在 package.json 的 "wonderlandengine" 键中指定插件入口点：

 1{
 2    // ...
 3    "wonderlandengine": {
 4        "plugins": [
 5            {
 6                "name": "My Plugin A",
 7                "main": "src/plugin-a.mjs"
 8            },
 9            {
10                "name": "My Plugin B",
11                "main": "src/plugin-b.mjs"
12            }
13        ]
14    },
15    // ...
16}

确保在该目录中安装 @wonderlandengine/editor-api 包：

1npm i --save-peer @wonderlandengine/editor-api

要在项目中使用本地插件，请运行 npm i --save-dev <path-to-the-directory>，或者在准备好后发布它并通过包安装，详见安装插件。