Biblioteca e coleções

As coleções guardam os recursos que você reutiliza entre níveis. Um nível nunca se refere a uma coleção: importar copia o recurso para dentro, e o nível roda em qualquer lugar

O que é uma coleção

Uma coleção é uma pasta de recursos reutilizáveis. Ela pode guardar recursos de sete tipos:

Uma coleção não está presa a um nível. Ela fica no seu dispositivo e está disponível em qualquer nível que você abrir

Origens

A biblioteca mostra recursos de três origens. Cada uma é um chip de filtro acima da lista:

Uma coleção somente leitura é alterada assim: as entradas dela são copiadas para uma coleção sua

A aba "Biblioteca"

Biblioteca é a última aba da tela inicial do editor, depois de Comunidade

Uma coluna estreita de botões escolhe o tipo:

• Coleções
• Prefabs, Temas, Formas, Efeitos
• Texturas, Fontes, Áudio

À direita dela, o título da página (à esquerda) e os botões dela (à direita) ficam em uma só linha. A lista fica embaixo. Uma lista vazia diz isso no meio dela

Nas páginas dos sete tipos, de Prefabs a Áudio, Coleção de destino ocupa uma linha separada de largura total abaixo do título. Os chips de origem ficam na linha abaixo dela

Uma janela da Biblioteca (o cartão de uma coleção, a imagem de uma textura, a janela de compartilhamento) fecha com o X no canto. Não existe botão Fechar

Cada linha é um botão. Clicar nela faz a ação principal do tipo dela:

Os botões pequenos à direita de uma linha são as outras ações, e o ícone de lixeira exclui ou remove

Abrir pasta mostra a pasta da página atual no gerenciador de arquivos do sistema. Disponível só no Windows, macOS e Linux

Coleções

Abrir pasta e Atualizar ficam à direita do título da página. Nova coleção e Importar arquivo compactado ficam em uma linha separada abaixo dele, alinhados à direita

• Nova coleção cria uma coleção vazia e abre o cartão dela
• Importar arquivo compactado adiciona uma coleção a partir de um arquivo .zip ou .tar.gz ou de um arquivo compactado protegido por senha: um .zip com senha própria, .zip.gpg ou .tar.gz.gpg. Se essa coleção já está no dispositivo, o jogo pergunta se deve substituí-la

Um arquivo compactado protegido por senha abre a janela Senha necessária: Este arquivo compactado está criptografado. Digite a senha para abri-lo. Digite a senha e clique em Abrir. Uma senha errada mostra Essa senha não abre este arquivo compactado. Tente de novo

• Abrir pasta abre resources/collections
• Atualizar lê as pastas de novo

As suas coleções têm Editar e o ícone de lixeira. A lixeira pergunta antes e depois exclui a coleção com todos os arquivos dela

O cartão de uma coleção

Editar abre uma janela com o cartão da coleção:

• Nome, Descrição
• Autores, separados por vírgula
• Licença: Não informada ou uma das licenças típicas
• Capa escolhe uma imagem png. A linha ao lado diz se há uma capa

Salvar grava o cartão. Cancelar, o X ou um clique fora da janela descarta as alterações

A página de uma coleção

Abaixo fica o conteúdo. Uma linha abre a entrada do mesmo jeito que a página do tipo dela, e o ícone de lixeira remove a entrada da coleção

Uma coleção somente leitura diz Somente leitura. Copie os itens para uma coleção sua para alterá-los

Mais sobre Compartilhar - Publicação

Prefabs, temas, formas, efeitos

Cada uma destas páginas mostra todas as entradas de todas as origens. Os chips estreitam a lista

Coleção de destino escolhe uma das suas coleções. Por padrão é Não escolhida. Depois que um destino é escolhido, toda linha vinda de outro lugar ganha Copiar

Um tema, uma forma ou um efeito abre no mesmo editor das configurações do nível. Salvar grava a alteração onde a entrada vive: em Minha biblioteca ou na sua coleção. Uma entrada da Oficina abre somente leitura, e Salvar fica desativado. Para alterá-la, copie-a para uma coleção sua

Criar cria um tema, uma forma ou um efeito novo no editor. A entrada é salva na coleção de destino, ou em Minha biblioteca se nenhum destino foi escolhido. Os prefabs são criados em um nível e não têm Criar

As entradas que você pode alterar têm o ícone de lixeira, e ele pergunta antes

Toda linha tem Compartilhar. O botão empacota a entrada com tudo de que ela precisa (por exemplo, as formas, texturas e prefabs aninhados de um prefab) em um .zip ou .tar.gz, com ou sem senha, como uma coleção de uma única entrada. Quem recebe importa esse arquivo por Importar arquivo compactado, como qualquer coleção

Abrir pasta abre a pasta da biblioteca do dispositivo para aquele tipo, por exemplo resources/themes

Texturas, fontes, áudio

Estas páginas mostram os arquivos de todas as coleções. Não existe biblioteca pessoal para arquivos, por isso esses tipos vivem só em coleções

• uma linha de textura mostra a imagem
• uma linha de áudio tem um botão de reprodução. Toca uma faixa por vez, e ela para quando você sai da página
• uma linha de fonte não tem pré-visualização

Adicionar arquivo coloca um arquivo do dispositivo na coleção de destino, por isso sem destino o botão fica desativado. Uma textura é png ou jpg, uma fonte ttf ou otf, um áudio mp3, wav ou ogg. Se a coleção já tem um arquivo com os mesmos bytes, nada é adicionado, e o jogo avisa

As linhas têm Copiar e o ícone de lixeira

O que uma cópia leva junto

Uma cópia leva tudo de que a entrada precisa: as formas, texturas, fontes e prefabs aninhados de um prefab, a forma das partículas de um efeito. As informações de autoria desses recursos também vão junto com eles

A aba "Coleções"

Coleções é uma aba das configurações do nível, logo depois de Prefabs. No topo há dois modos: Importar e Criar uma coleção

Importar

1. A aba mostra uma lista de coleções. Clique na que você precisa
2. Marque as entradas de que precisa. Todos e Nenhum marcam tudo ou limpam todas as marcações
3. A linha Selecionados: N, dependências adicionadas: M mostra o que vai entrar no nível. As dependências são adicionadas sozinhas
4. Clique em Importar

Toda a importação é um único passo de desfazer

Texturas, fontes e áudio recebem ids novos no nível, e os arquivos deles são copiados para a pasta do nível com um nome único. Um arquivo que o nível já tem byte a byte não é copiado uma segunda vez: a importação usa a textura, a fonte ou a faixa que o próprio nível já tem

Criar uma coleção

1. Destino escolhe Nova coleção ou uma das suas. Uma coleção nova recebe o nome do campo Nome
2. Marque os recursos do nível, de qualquer um dos sete tipos
3. Clique em Criar

Uma coleção nova recebe os autores do nível

Não é possível criar uma coleção a partir de um nível protegido. Mais - Exportação e proteção

Escolha de recursos e pesquisa

A pesquisa e as janelas de escolha de recursos têm uma seção Biblioteca para prefabs, temas, formas e efeitos. Ela mostra todas as origens. As janelas de escolha são os campos de forma, colisor, efeito e tema e Posicionar prefab…

Escolher uma entrada da biblioteca a importa para o nível com as dependências dela e a atribui. Um conflito faz a mesma pergunta que na aba "Coleções"

Os navegadores da biblioteca dentro das abas de recursos do nível funcionam do mesmo jeito e mostram os chips de origem. Mais - Recursos do nível

Conflitos

Uma entrada importada pode já estar no nível com o mesmo id:

• o mesmo conteúdo - não é preciso fazer nada
• conteúdo diferente - a janela Já existe no nível abre

A janela lista cada conflito, cada um com um interruptor Importar como cópia:

Manter todos e Copiar todos definem todos os interruptores de uma vez. Importar aplica a escolha, Cancelar não importa nada

Nenhuma versão vence em silêncio. Todo conflito com conteúdo diferente é decidido nesta janela

Autoria

Os registros sobre os recursos de um nível cobrem temas, efeitos, formas e prefabs, além de texturas, fontes e áudio. Importar copia os registros necessários para o nível, por isso a autoria chega junto com o recurso

Mais - O registro do recurso

No disco

As coleções vivem em resources/collections/<collection-guid>/ na pasta de dados do jogo. É a mesma pasta resources ao lado de levels onde vive a biblioteca do dispositivo. Mais - A pasta do nível e os backups

Uma coleção é repassada como arquivo compactado: Compartilhar na página dela, Importar arquivo compactado na lista. Um arquivo compactado que não é uma coleção é recusado

A seguir: Publicação, Reutilização: prefabs, cópia, geradores, O registro do recurso