Modificações:Pacotes de conteúdo

← Índice

Um pacote de conteúdo (também chamado content pack em inglês) é uma coleção de arquivos carregados por um framework de pacotes de conteúdo (essencialmente um sub-mod). Pacotes de conteúdo podem conter qualquer arquivo, mas normalmente consistem apenas de arquivos JSON e imagens.

Para jogadores

Se você desejar usar pacotes de conteúdo no seu jogo, instale-o como se fosse um mod SMAPI (veja o guia do jogador). Certifique-se de também ter instalado o mod de que ele depende.

Para modders

Criando um pacote de conteúdo

1. Decida qual framework você irá utilizar (Cada framework define os arquivos específicos que você precisa).
2. Instale o SMAPI.
3. Crie o formato genérico de pacote de conteúdo (idêntico para todos os frameworks):
   1. Abra a pasta Mods do seu jogo (Localizada napasta do seu jogo).
   2. Adicione uma subpasta com o nome que você desejar (consulte a convenção de nomeação de pastas).
   3. Na subpasta, adicione um arquivo manifest.json com o campo ContentPackFor (consulte o formato do manifest).
4. Adicione os arquivos necessários pelo framework do pacote de conteúdo (consulte a página do mod para mais detalhes).
5. Inicie o jogo e verifique se o seu novo pacote de conteúdo aparece em "Loaded X content packs" no console do SMAPI.

Lançando seu pacote de conteúdo

1. Adicione uma chave de atualização ao seu manifest (se ainda não tiver feito isso).
2. Atualize o campo Version no manifest. (Aumente-o a cada lançamento! O SMAPI o usará para verificação de atualizações e compatibilidade.)
3. Crie um arquivo .zip contendo a pasta do pacote de conteúdo.
4. Faça o upload desse arquivo para Nexus Mods.

Na descrição do seu mod, fornecer etapas de instalação claras ajudará a reduzir perguntas de suporte. Aqui está um exemplo de código BBCode:

[size=5]Instalação[/size]
[list=1]
[*][url=https://smapi.io]Instale a versão mais recente do SMAPI[/url].
[*][url=<url do mod requirido>]Instale <nome do mod requirido>[/url].
[*]Baixe este mod e descompacte-o na pasta [font=Courier New]Stardew Valley/Mods[/font].
[*]Inicie o jogo usando o SMAPI.
[/list]

Utilizar um pacote de conteúdo

Se você está escrevendo um mod SMAPI que irá ler pacotes de conteúdo, consulte Modificações:Guia do Modder/APIs/Content Packs.

Convenções

Essas são práticas recomendadas, mas não são obrigatórias.

Nome da pasta

O nome da pasta deve usar o CamelCase em maiúsculas, com um prefixo de sigla entre colchetes mostrando para qual mod é destinado. Por exemplo, uma pasta chamada [CP] Nome de Exemplo é um pacote de conteúdo para o Content Patcher.

Consulte Modificações:Frameworks de pacotes de conteúdo para ver as siglas comuns.

Estrutura da pasta

A pasta deve conter seu manifest.json, o content.json (ou o JSON correto para o seu framework) e uma pasta assets que contém quaisquer outros arquivos que seu mod irá utilizar. Isso pode incluir arquivos .png, outros arquivos .json e até mesmo arquivos .tmx/.tbin, entre outros. A pasta de assets pode ter subpastas adicionais, se desejar, embora não seja obrigatório.