Software INIfier

O INIfier permite substituir o conteúdo do TextAsset do Unity sem atualizar/substituir os próprios arquivos de recurso. Isso é útil principalmente para desenvolvedores que precisam substituir TextAssets como parte de suas modificações e não se destina a usuários finais. No entanto, ainda pode ser útil para os usuários, por exemplo, se TextAsset armazenar texto que eles gostariam de traduzir para outro idioma.

Isso geralmente requer a atualização dos arquivos .assets no jogo e a distribuição de arquivos atualizados ou um patch que pode exigir redesenvolvimento e distribuição a cada nova atualização do jogo. Com o INIfier, até que o nome do recurso mude, você pode continuar a usar o mesmo arquivo de substituição em qualquer versão do jogo. E até que o arquivo seja sobrescrito ou excluído, você não precisa recriá-lo toda vez que iniciar ou atualizar o jogo.

Instalação (para usuários finais)

Instale o Unity Mod Manager para o jogo de destino. Adicione um arquivo .zip deste modo ao Unity Mod Manager. O mod estará ligado por padrão, mas pode ser ligado ou desligado usando o menu UMM no jogo (o padrão é Ctrl+F10 para abrir/fechar). Se a modificação estiver habilitada, ela substituirá o texto/bytes cada vez que eles forem lidos do TextAsset. Se desabilitada, o conteúdo original será retornado ao ler o texto/bytes. Se o texto de TextAsset estiver armazenado em uma variável diferente ou armazenado em cache, em vez de ser lido novamente a partir do recurso cada vez, o INIfier manipulará somente a primeira leitura.

Uso (para autores de modificações)

Consulte a .dll no seu projeto para usar os métodos INIfier. Um arquivo .xml também é incluído para fornecer entrada inteligente para métodos disponíveis.

Há duas maneiras de substituir um arquivo

• Forneça o arquivo .ini a ser substituído pelo mod para que o usuário possa colocá-lo no diretório INIfier/Assets
• Registrar o arquivo a ser substituído programaticamente

Você também pode usar o INIfier para verificar um arquivo encontrado/substituído e obter seu conteúdo. Cuidadosamente usado, isso permite que vários modos atualizem o mesmo TextAsset, alterando apenas a parte afetada do arquivo, em vez de substituir as alterações anteriores em cada modo.

A sequência de caracteres ou matriz de bytes substituída é armazenada no arquivo .ini na pasta Ativos, dentro do diretório do modo INIfier criado pelo Unity Mod Manager. Se usar métodos INIfier para trabalhar com arquivos de substituição, você não precisa se preocupar com o local real da pasta Ativos.

O arquivo será usado em vez das propriedades text ou bytes na ocorrência de TextAsset. Cada TextAsset tem um nome que deve corresponder ao nome do arquivo de substituição. Se o arquivo a ser substituído não existir, o INIfier criará um arquivo .found (mas não substituirá o arquivo .found existente) com o mesmo nome que TextAsset e colocará o conteúdo nele. Dependendo se a propriedade "text" ou "bytes" é chamada, o arquivo .found será gravado como uma string ou como uma matriz de bytes. Todos os arquivos que usam a propriedade "text" serão lidos/gravados no formato UTF8.

Você pode adicionar um requisito para o INIfier ao arquivo json com as informações de modificação. Você deve usar um INIfier, não um nome. O identificador deve ter 3 espaços antes dele (uma vez que as modificações são carregadas em ordem alfabética, isso ajuda o INIfier a corrigir os métodos apropriados antes que qualquer outra coisa possa usar TextAsset), então use a string "INIfier-1.0.0"