Plugins
Los plugins añaden herramientas nuevas a Studio. Aquí verás cómo buscarlos e instalarlos, y cómo decidir en cuáles confiar.
Un plugin puede añadir un panel, generar escenas, procesar recursos o añadir un tipo nuevo de componente a tus objetos. Se ejecuta dentro del propio editor y no hace falta recompilar nada.
Un plugin también puede llevar código al proyecto publicado: cosas que se mueven solas, disparadores y pasos nuevos para los eventos y su propia sección en Project settings.
¿Quieres crear el tuyo? Consulta Crear un plugin.
El panel Plugins
El panel tiene dos pestañas:
- My uploads: todo lo que es tuyo, en una sola lista: las carpetas de plugins en las que trabajas, los plugins que has publicado y los que has instalado. Aquí puedes crear un plugin, abrir una carpeta, recargarla desde el disco, publicarlo o retirarlo, y eliminarlo.
- Creator Hub: los plugins que comparte todo el mundo. Búscalos, fíltralos por etiqueta y mira las capturas, el autor, la valoración, el número de instalaciones y de favoritos. Tus plugins y los que tienes instalados salen más arriba en los resultados.
Cuando escribes en el buscador, las dos pestañas se juntan en una sola lista, con tus plugins primero.
Instala un plugin
Al instalar un plugin, se añade solo a tu editor. Su icono aparece en tu barra de herramientas.
Para dárselo a todo tu equipo, añádelo al proyecto. Así aparece para todos los que abran ese proyecto. Hazlo con las herramientas que usa todo el equipo, como un revisor de estilo o un generador de escenas compartido.
Plugins con código para el proyecto publicado
Algunos plugins también se ejecutan en el proyecto publicado, para todos los que lo abren. Este código solo se ejecuta en los proyectos a los que se ha añadido el plugin.
Cuando añades un plugin así a un proyecto, el proyecto se queda con esa versión de su código. Las vistas previas, las pruebas de juego y las publicaciones la ejecutan, aunque el autor publique después una más nueva. Cuando hay código más nuevo, el plugin muestra update available. Pulsa Update in project para pasar el proyecto a esa versión.
Si eres el autor del plugin y lo has añadido tú, el proyecto ejecuta cada versión que guardas. Un proyecto publicado ejecuta el código con el que se publicó, hasta que lo vuelvas a publicar.
Plugins retirados
Cuando su autor pulsa Unpublish, el plugin se borra de la biblioteca. Desaparece del editor de todo el mundo y de todos los proyectos a los que se había añadido. También se borran sus valoraciones y los favoritos.
Confianza y verificación
Un plugin puede leer y cambiar tu escena y tus recursos. Por eso, la primera vez que abres un plugin de otra persona, Studio te pide que lo confirmes. Elige Don't ask again for this plugin para que recuerde tu respuesta para ese plugin.
Instala plugins como instalarías cualquier extensión del navegador: solo los que tengas motivos para considerar fiables.
Un plugin indica en su manifiesto los permisos que necesita, pero Studio no lo limita a ellos. Todos los plugins pueden acceder a todo el proyecto, indiquen lo que indiquen.
Plugins verificados
Reviewed significa que alguien ha leído el código de esta versión concreta del plugin. No es una valoración de lo bueno que es.
Cuando el autor publica código nuevo, el plugin vuelve a pending hasta que se revise de nuevo. Cambiar la descripción, las etiquetas o las capturas no quita la insignia, porque no se ejecutan.
La verificación también puede desactivar algunos avisos. Cada uno se configura por separado:
| Ajuste | Qué desactiva |
|---|---|
open | la confirmación al abrir el panel del plugin |
autorun | el aviso antes de que se ejecuten sus partes automáticas (ver más abajo) |
warnings | los avisos de que no revisamos el código de los plugins |
Un plugin puede estar verificado sin ninguno de estos ajustes. En ese caso tiene la insignia y todos los avisos se mantienen. Leer el código y quitar los avisos son dos decisiones distintas.
Un panel solo se ejecuta cuando lo abres. Un componente personalizado
o una capa superpuesta en el visor se ejecuta cada vez que alguien abre el proyecto. Por eso
autorun es un ajuste aparte.
Estas partes automáticas solo se ejecutan en un plugin que es de confianza en tu navegador:
- un plugin que abriste desde una carpeta de tu propio ordenador;
- un plugin que ya permitiste antes: pulsaste Allow o elegiste Don't ask again for this plugin al abrirlo;
- un plugin cuya verificación incluye
autorun.
En cualquier otro plugin, esperan. Un componente personalizado muestra un aviso con un botón Allow en lugar de ejecutarse. Una capa superpuesta se queda oculta. Cuando el plugin tiene algo que mostrar, una pequeña barra te pide que lo permitas. La respuesta se guarda solo en este navegador, así que otro navegador vuelve a preguntar.
Se ejecuta para todos los que abren el proyecto, igual que los scripts del propio proyecto, así que quien añade el plugin lo decide por todo el equipo. Por eso la versión se fija al añadir el plugin: el código nuevo solo llega al proyecto cuando alguien pulsa Update in project.
El estado de verificación de un plugin es uno de estos: none, pending, verified, rejected
o revoked. Si se revoca una verificación, también se borra tu elección de Don't ask again for this plugin
para ese plugin, porque aceptaste un código distinto.
Valoraciones y plugins de pago
Puedes valorar un plugin una vez, de una a cinco estrellas.
El autor elige quién puede instalar un plugin:
| Acceso | Quién puede instalarlo |
|---|---|
| Free | todo el mundo |
| Premium | quienes tienen un plan de pago |
| Subscribers only | quienes tienen una suscripción de pago al perfil público del autor |
En un proyecto, cuenta la suscripción de la organización del proyecto. Tus propios plugins siempre están disponibles para ti.
El código de ejecución de un plugin Subscribers only llega a todos los que abren el proyecto publicado, y cualquiera puede leerlo en su navegador. La suscripción decide quién puede añadir el plugin a un proyecto, actualizarlo y publicar con él.
Cuando termina la suscripción, un proyecto que usa un plugin así no se puede volver a publicar: renueva la suscripción o quita el plugin. Un proyecto que ya está publicado sigue funcionando.
Qué necesitas
- Para usar plugins de la biblioteca: cualquier navegador.
- Para crear plugins desde una carpeta de tu ordenador: un navegador basado en Chromium, como Chrome o Edge.
Siguiente: Crear un plugin: crea y publica el tuyo.