Biblioteca y colecciones

Las colecciones guardan los recursos que reutilizas entre niveles. Un nivel nunca hace referencia a una colección: importar copia el recurso dentro, y el nivel se juega en cualquier parte

Qué es una colección

Una colección es una carpeta de recursos reutilizables. Puede contener recursos de siete tipos:

Una colección no está ligada a un nivel. Está en tu dispositivo y disponible en cualquier nivel que abras

Orígenes

La biblioteca muestra recursos de tres orígenes. Cada uno es un chip de filtro encima de la lista:

Una colección de solo lectura se cambia así: sus entradas se copian a una colección tuya

La pestaña "Biblioteca"

Biblioteca es la última pestaña de la pantalla de inicio del editor, después de Comunidad

Una columna estrecha de botones elige el tipo:

• Colecciones
• Prefabs, Temas, Formas, Efectos
• Texturas, Fuentes, Audio

A su derecha, el título de la página (a la izquierda) y sus botones (a la derecha) están en una misma fila. La lista está debajo. Una lista vacía lo dice en su centro

En las páginas de los siete tipos, de Prefabs a Audio, Colección de destino ocupa una fila propia de ancho completo bajo el título. Los chips de origen están en la fila de debajo

Una ventana de la Biblioteca (la ficha de una colección, la imagen de una textura, la ventana de compartir) se cierra con la cruz de su esquina. No hay botón Cerrar

Cada fila es un botón. Hacer clic en ella hace lo principal para su tipo:

Los botones pequeños a la derecha de una fila son las demás acciones, y el icono de la papelera elimina o quita

Abrir carpeta muestra la carpeta de la página actual en el gestor de archivos del sistema. Solo disponible en Windows, macOS y Linux

Colecciones

Abrir carpeta y Actualizar están a la derecha del título de la página. Nueva colección y Importar archivo comprimido están en una fila aparte debajo, alineados a la derecha

• Nueva colección crea una colección vacía y abre su ficha
• Importar archivo comprimido añade una colección desde un archivo .zip o .tar.gz o desde un archivo comprimido protegido con contraseña: un .zip con su propia contraseña, .zip.gpg o .tar.gz.gpg. Si esa colección ya está en el dispositivo, el juego pregunta si reemplazarla

Un archivo comprimido protegido con contraseña abre la ventana Se necesita contraseña: Este archivo comprimido está cifrado. Escribe su contraseña para abrirlo. Escribe la contraseña y haz clic en Abrir. Una contraseña incorrecta muestra Esa contraseña no abre este archivo comprimido. Inténtalo de nuevo

• Abrir carpeta abre resources/collections
• Actualizar vuelve a leer las carpetas

Tus propias colecciones tienen Editar y el icono de la papelera. La papelera pregunta antes y luego elimina la colección con todos sus archivos

La ficha de una colección

Editar abre una ventana con la ficha de la colección:

• Nombre, Descripción
• Autores, separados por comas
• Licencia: Sin indicar o una de las licencias habituales
• Portada elige una imagen png. La línea de al lado dice si hay portada

Guardar escribe la ficha. Cancelar, la cruz o un clic fuera de la ventana descartan los cambios

La página de una colección

Debajo está el contenido. Una fila abre la entrada igual que la página de su tipo, y el icono de la papelera quita la entrada de la colección

Una colección de solo lectura dice Solo lectura. Copia sus entradas a una colección tuya para cambiarlas

Más sobre Compartir - Publicación

Prefabs, temas, formas, efectos

Cada una de estas páginas muestra todas las entradas de todos los orígenes. Los chips acotan la lista

Colección de destino elige una de tus propias colecciones. Por defecto es Sin elegir. Una vez elegido un destino, cada fila de otro sitio recibe Copiar

Un tema, una forma o un efecto se abren en el mismo editor que en la configuración del nivel. Guardar escribe el cambio donde vive la entrada: en Mi biblioteca o en tu colección. Una entrada del Workshop se abre en solo lectura, y Guardar está desactivado. Para cambiarla, cópiala a una colección tuya

Crear crea un tema, una forma o un efecto nuevos en el editor. La entrada se guarda en la colección de destino, o en Mi biblioteca si no hay destino elegido. Los prefabs se crean en un nivel, y no tienen Crear

Las entradas que puedes cambiar tienen el icono de la papelera, y este pregunta antes

Cada fila tiene Compartir. El botón empaqueta la entrada con todo lo que necesita (por ejemplo, las formas, texturas y prefabs anidados de un prefab) en un .zip o .tar.gz, con o sin contraseña, como una colección de una sola entrada. Quien lo recibe importa ese archivo con Importar archivo comprimido, como cualquier colección

Abrir carpeta abre la carpeta de la biblioteca del dispositivo para ese tipo, por ejemplo resources/themes

Texturas, fuentes, audio

Estas páginas muestran los archivos de todas las colecciones. No hay biblioteca personal para archivos, así que estos tipos viven solo en colecciones

• una fila de textura muestra la imagen
• una fila de audio tiene un botón de reproducción. Suena una pista a la vez, y se detiene cuando sales de la página
• una fila de fuente no tiene vista previa

Añadir archivo pone un archivo del dispositivo en la colección de destino, así que sin destino el botón está desactivado. Una textura es png o jpg, una fuente ttf u otf, el audio mp3, wav u ogg. Si la colección ya tiene un archivo con los mismos bytes, no se añade nada, y el juego lo dice

Las filas tienen Copiar y el icono de la papelera

Qué se lleva una copia

Una copia se lleva todo lo que necesita la entrada: las formas, texturas, fuentes y prefabs anidados de un prefab, la forma de partícula de un efecto. La información de autoría de esos recursos también va con ellos

La pestaña "Colecciones"

Colecciones es una pestaña de la configuración del nivel, justo después de Prefabs. Arriba hay dos modos: Importar y Crear una colección

Importar

1. La pestaña muestra una lista de colecciones. Haz clic en la que necesitas
2. Marca las entradas que necesitas. Todo y Nada lo marcan todo o quitan todas las marcas
3. La línea Seleccionados: N, dependencias añadidas: M muestra lo que entrará en el nivel. Las dependencias se añaden solas
4. Haz clic en Importar

Toda la importación es un solo paso de deshacer

Las texturas, fuentes y audio reciben ids nuevos en el nivel, y sus archivos se copian a la carpeta del nivel con un nombre único. Un archivo que el nivel ya tiene byte a byte no se copia una segunda vez: la importación toma la textura, la fuente o la pista propia del nivel

Crear una colección

1. Destino elige Una colección nueva o una de las tuyas. Una nueva toma su nombre del campo Nombre
2. Marca los recursos del nivel, de cualquiera de los siete tipos
3. Haz clic en Crear

Una colección nueva recibe los autores del nivel

No se puede crear una colección a partir de un nivel protegido. Más - Exportación y protección

Elegir recursos y buscar

La búsqueda y las ventanas para elegir recursos tienen un nivel Biblioteca para prefabs, temas, formas y efectos. Muestra todos los orígenes. Las ventanas para elegir son los campos de forma, colisionador, efecto y tema y Colocar prefab…

Elegir una entrada de la biblioteca la importa al nivel con sus dependencias y la asigna. Un conflicto hace la misma pregunta que en la pestaña "Colecciones"

Los exploradores de la biblioteca dentro de las pestañas de recursos del nivel funcionan igual y muestran los chips de origen. Más - Recursos del nivel

Conflictos

Una entrada importada puede estar ya en el nivel con el mismo id:

• el mismo contenido - no hay que hacer nada
• otro contenido - se abre la ventana Ya está en el nivel

La ventana lista cada conflicto, cada uno con un interruptor Importar como copia:

Mantener todo y Copiar todo fijan todos los interruptores a la vez. Importar aplica la elección, Cancelar no importa nada

Ninguna versión gana en silencio. Cada conflicto con contenido distinto se decide en esta ventana

Autoría

Los registros sobre los recursos de un nivel cubren temas, efectos, formas y prefabs igual que texturas, fuentes y audio. Importar copia al nivel los registros necesarios, así que la autoría llega junto con el recurso

Más - El registro del recurso

En el disco

Las colecciones viven en resources/collections/<collection-guid>/ en la carpeta de datos del juego. Es la misma carpeta resources junto a levels donde vive la biblioteca del dispositivo. Más - La carpeta del nivel y las copias de seguridad

Una colección se pasa como archivo comprimido: Compartir en su página, Importar archivo comprimido en la lista. Un archivo comprimido que no es una colección se rechaza

Siguiente: Publicación, Reutilización: prefabs, copia, generadores, El registro del recurso