Saltar al contenido principal

Plugins

Los plugins amplían el propio Studio. Un plugin es una carpeta de archivos que se ejecuta dentro del editor sin recompilar nada: puede añadir un panel, generar escenas, procesar recursos o dar a los objetos un nuevo tipo de componente.

¿Quieres escribir uno? → Escribir un plugin.

El panel de plugins

Dos pestañas.

My uploads: tus carpetas de desarrollo locales, tus plugins publicados y los que has instalado, en una sola lista. Desde aquí puedes crear un plugin, abrir una carpeta existente, recargarla desde disco, publicar o despublicar, y eliminar.

Library: el registro compartido — búsqueda, etiquetas, capturas, autor, valoración, número de instalaciones y favoritos. Tus plugins y los instalados suben en los resultados.

La búsqueda cubre ambas: escribe una consulta y las pestañas se pliegan en una única lista, los tuyos primero.

Instalar

Instalar añade un plugin a tu editor. Su icono aparece en tu barra de herramientas.

Añadirlo a un proyecto es distinto: entonces el plugin aparece para todo el mundo que abra ese proyecto, no solo para ti. Esa es la opción correcta para un plugin que necesita todo el equipo: un verificador de estilo de marca, un generador de escenas que usáis todos.

Retirar un plugin del registro lo retira de todos los proyectos que lo usaban.

Confianza

Un plugin se ejecuta con acceso a tu proyecto

Abrir el plugin de otra persona pide confirmación una vez, porque puede leer y cambiar tu escena y tus recursos. «No volver a preguntar» recuerda tu respuesta para ese plugin.

Trata la biblioteca como tratarías cualquier extensión de terceros: instala aquello en lo que tengas motivos para confiar.

Qué significa la verificación

Un plugin verificado no es «un buen plugin». Significa que alguien ha leído exactamente este código.

La verificación está ligada a una huella del contenido del plugin. Publicar código nuevo cambia la huella, así que un plugin verificado vuelve a quedar pendiente hasta que se revise otra vez. Editar la descripción, las etiquetas o las capturas, no: eso no se ejecuta.

Una verificación puede eximir hasta tres cosas distintas:

EximeSignifica
opensin diálogo de confirmación al abrir su panel
autorunsus partes que arrancan solas pueden ejecutarse sin preguntar — ver abajo
warningsse ocultan los avisos de «no revisamos el código de los plugins»

Un conjunto vacío es posible: solo la insignia, con todos los avisos en su sitio. «Hemos leído el código» y «dejaremos de preguntarte» son, deliberadamente, promesas distintas.

El código que arranca solo es una promesa mayor

Un panel se ejecuta cuando lo abres. Una extensión de componente o una superposición del viewport se ejecuta cada vez que alguien abre el proyecto. Por eso autorun se exime aparte, y por eso las partes autoarrancables de un plugin en el que no se confía no se montan en absoluto.

Los estados son none, pending, verified, rejected y revoked. Una verificación revocada también borra tu «no volver a preguntar» local: ese consentimiento era sobre otro código.

Valoraciones y premium

Una valoración por persona, de una a cinco estrellas. Algunos plugins están marcados como que requieren suscripción; los tuyos nunca quedan bloqueados.

Qué necesitas

La parte de desarrollo necesita un navegador basado en Chromium, porque leer una carpeta local usa la File System Access API. La biblioteca funciona en todas partes: solo construir plugins desde una carpeta local necesita Chromium.


Siguiente: Escribir un plugin