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
- Decida qual framework você irá utilizar (Cada framework define os arquivos específicos que você precisa).
- Instale o SMAPI.
- Crie o formato genérico de pacote de conteúdo (idêntico para todos os frameworks):
- Abra a pasta Mods do seu jogo (Localizada napasta do seu jogo).
- Adicione uma subpasta com o nome que você desejar (consulte a convenção de nomeação de pastas).
- Na subpasta, adicione um arquivo manifest.json com o campo ContentPackFor (consulte o formato do manifest).
- Adicione os arquivos necessários pelo framework do pacote de conteúdo (consulte a página do mod para mais detalhes).
- 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
- Adicione uma chave de atualização ao seu manifest (se ainda não tiver feito isso).
- Atualize o campo Version no manifest. (Aumente-o a cada lançamento! O SMAPI o usará para verificação de atualizações e compatibilidade.)
- Crie um arquivo .zip contendo a pasta do pacote de conteúdo.
- 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.