Usando Plugins

Activando Plugins 

Por esta razón, la ejecución de plugins está desactivada por defecto para cada proyecto. Habilita los plugins en Views > Plugins marcando la opción “Enable plugins for this project”.

Solo habilita plugins para proyectos en los que confíes. Si mueves o renombras tu proyecto, necesitarás volver a habilitar los plugins.

Instalando Plugins 

Hay dos maneras de instalar plugins: a través de las dependencias de tu proyecto o como archivos en la carpeta plugins. Después de la instalación, abre Views > Plugins para habilitarlos o deshabilitarlos por proyecto.

A través de NPM 

Puedes instalar plugins a través del gestor de paquetes de Node (NPM). Instala un plugin con el siguiente comando:

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

Reemplaza @wonderlandengine/not-a-real-plugin con cualquier plugin que desees instalar. Ejecutar este comando creará una nueva entrada en la sección devDependencies de tu archivo package.json.

El plugin aparecerá entonces en la vista Plugins.

Gestionando Plugins 

A veces querrás desactivar plugins para reducir el desorden de la interfaz de usuario o restaurar el rendimiento del editor.

Abre Views > Plugins para ver todos los plugins disponibles y gestionarlos:

• Habilita los plugins para el proyecto actual mediante el checkbox en la parte superior “Enable plugins for this project”.
• Usa las pestañas para cambiar entre “Editor Scope” (plugins que extienden el editor en sí) y “Project Scope” (plugins instalados por tu proyecto mediante devDependencies o la carpeta plugins/).
• Activa o desactiva plugins individuales usando los checkboxes. Los cambios se aplican de inmediato; algunos plugins podrían pedirte que recargues el proyecto.

Desarrollo 

Crear plugins es fácil. Tienes tres métodos disponibles:

Script de Plugin 

Un único script que puede compartir dependencias con el package.json de tu proyecto principal. Recomendamos que instales cualquier dependencia relacionada con el plugin como devDependencies (usando --save-dev).

Puedes crear un nuevo plugin creando la carpeta plugins en la raíz de tu proyecto, luego clic derecho > New Plugin.

Asegúrate de instalar el paquete @wonderlandengine/editor-api en la raíz de tu proyecto:

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

Directorio de Plugin 

De manera similar a los Scripts de Plugin, crea primero una subcarpeta plugins, pero luego crea otra subcarpeta que nombres de acuerdo con tu plugin.

En esta carpeta puedes crear un nuevo archivo package.json (por ejemplo, a través de npm init).

Asegúrate de instalar el paquete @wonderlandengine/editor-api en ese directorio:

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

Nota, --save en lugar de --save-dev, ya que no estás instalando en tu proyecto de Wonderland Engine, sino en un proyecto de plugin separado.

Paquete de Plugin 

Si deseas compartir y distribuir tu plugin, puedes ejecutar npm init en una carpeta separada, y especificar los puntos de entrada del plugin en la clave "wonderlandengine" de tu package.json:

 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}

Asegúrate de instalar el paquete @wonderlandengine/editor-api en ese directorio:

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

Para usar este plugin local en tu proyecto, ejecuta npm i --save-dev <ruta-al-directorio>, o publícalo cuando esté listo e instálalo a través del paquete. Consulta Instalando.