37
edições
Alterações
Modificações:Guia do Modder/Começando (ver código-fonte)
Revisão das 23h14min de 20 de fevereiro de 2024
, 20 fevereiro→Adicionando seu manifest: fixed bad translate
==Intro==
==Intro==
=== O que é um mod SMAPI? ===
=== O que é um mod SMAPI? ===
Um mod SMAPI usa a API de modificação [https://smapi.io/ SMAPI] para estender a lógica do jogo. O mod pode responder quando algo acontece no jogo (como quando um objeto é colocado no mundo), executar código periodicamente (como uma vez por atualização), alterar os ativos e dados do jogo, etc. Mods SMAPI são escritos em C # usando o O .NET Framework e o Stardew Valley usam XNA / MonoGame para a lógica do jogo (desenho na tela, entrada do usuário, etc.).
Um mod SMAPI usa a API de modificação [https://smapi.io/ SMAPI] para estender a lógica do jogo. O mod pode responder quando algo acontece no jogo (como quando um objeto é colocado no mundo), executar código periodicamente (como uma vez por atualização), alterar os ativos e dados do jogo, etc. Mods SMAPI são escritos em C# usando o O .NET Framework e o Stardew Valley usam XNA / MonoGame para a lógica do jogo (desenho na tela, entrada do usuário, etc.).
=== Por que os mods usam SMAPI? ===
=== Por que os mods usam SMAPI? ===
Se você é iniciante em programação: muitos desenvolvedores de mod começam com pouca ou nenhuma experiência em programação. Você certamente pode aprender ao longo do caminho, se estiver determinado, mas deve estar preparado para uma curva de aprendizado acentuada. Não seja muito ambicioso a princípio; é melhor começar com um mod pequeno quando você descobrir isso. É fácil ficar impressionado no começo e desistir. A comunidade modding é muito acolhedora, portanto, não tenha medo de fazer perguntas!
Se você é iniciante em programação: muitos desenvolvedores de mod começam com pouca ou nenhuma experiência em programação. Você certamente pode aprender ao longo do caminho, se estiver determinado, mas deve estar preparado para uma curva de aprendizado acentuada. Não seja muito ambicioso a princípio; é melhor começar com um mod pequeno quando você descobrir isso. É fácil ficar impressionado no começo e desistir. A comunidade modding é muito acolhedora, portanto, não tenha medo de fazer perguntas!
Se você já tem experiência em programação, deve ficar bem. A experiência de programação em C # ou Java facilitará as coisas, mas não é crítica. Se você não está familiarizado com o C #, pode percorrer as referências abaixo de '' Learning C # '' para preencher as lacunas.
Se você já tem experiência em programação, deve ficar bem. A experiência de programação em C# ou Java facilitará as coisas, mas não é crítica. Se você não está familiarizado com o C#, pode percorrer as referências abaixo de ''Learning C#'' para preencher as lacunas.
=== Posso fazer um mod '' sem SMAPI ''? ===
=== Posso fazer um mod ''sem SMAPI''? ===
Sim. Muitos mods SMAPI suportam 'pacotes de conteúdo', que permitem fornecer arquivos de texto JSON, imagens etc. que eles usam. Por exemplo, você pode usar o [https://www.nexusmods.com/stardewvalley/mods/1915 Content Patcher] para editar as imagens e os dados do jogo sem necessidade de programação. O restante deste guia é sobre como criar um novo mod SMAPI; para pacotes de conteúdo, consulte a documentação do mod que o lerá.
Sim. Muitos mods SMAPI suportam 'pacotes de conteúdo', que permitem fornecer arquivos de texto JSON, imagens etc. que eles usam. Por exemplo, você pode usar o [https://www.nexusmods.com/stardewvalley/mods/1915 Content Patcher] para editar as imagens e os dados do jogo sem necessidade de programação. O restante deste guia é sobre como criar um novo mod SMAPI; para pacotes de conteúdo, consulte a documentação do mod que o lerá.
{
{
/*********
/*********
** Métodos publicos
** Métodos públicos
*********/
*********/
/// <summary>O ponto de entrada do mod, chamado após o mod ser carregado pela primeira vez.</summary>
/// <summary>O ponto de entrada do mod, chamado após o mod ser carregado pela primeira vez.</summary>
/*********
/*********
** Private methods
** Métodos privados
*********/
*********/
/// <summary>Chamado após o jogador pressionar um botão no teclado, controle ou mouse.</summary>
/// <summary>Chamado após o jogador pressionar um botão no teclado, controle ou mouse.</summary>
// imprima o botão pressionado na janela do console.
// imprima o botão pressionado na janela do console.
this.Monitor.Log($"{Game1.player.Name} pressed {e.Button}.");
this.Monitor.Log($"{Game1.player.Name} apertou o botão {e.Button}.");
}
}
}
}
Aqui um detalhamento do que o código faz:
Aqui um detalhamento do que o código faz:
# <code>using X;</code> (see [https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/using-directive using directive]) torna as classes desse namespace disponiveis no seu código.
# <code>using X;</code> (veja [https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/using-directive using directive]) torna as classes desse namespace disponiveis no seu código.
# <code>namespace YourProjectName</code> (see [https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/namespace namespace keyword]) define o escopo do código do seu mod. Não se preocupe com isso quando estiver começando, o Visual Studio ou o MonoDevelop vai adiciona-lo automaticamente quando você adicionar um arquivo.
# <code>namespace YourProjectName</code> (see [https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/namespace namespace keyword]) define o escopo do código do seu mod. Não se preocupe com isso quando estiver começando, o Visual Studio ou o MonoDevelop vai adiciona-lo automaticamente quando você adicionar um arquivo.
# <code>public class ModEntry : Mod</code> (veja [https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/class class keyword]) cria a classe principal do seu mod, e subclasses da classe <samp>Mod</samp> do SMAPI. O SMAPI vai detectar as subclasses do <samp>Mod</samp> automaticamente, e o <samp>Mod</samp> lhe dará acesso as APIs do SMAPI.
# <code>public class ModEntry : Mod</code> (veja [https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/class class keyword]) cria a classe principal do seu mod, e subclasses da classe <samp>Mod</samp> do SMAPI. O SMAPI vai detectar as subclasses do <samp>Mod</samp> automaticamente, e o <samp>Mod</samp> lhe dará acesso as APIs do SMAPI.
</ol>
</ol>
Isso será listado na saída do console quando o jogo for iniciado. Para obter mais informações, consulte os documentos do [[Modding: Modder Guide / APIs / Manifest | manifest]].
Isso será listado na saída do console quando o jogo for iniciado. Para obter mais informações, consulte a documentação do [[Modding: Modder Guide / APIs / Manifest | manifest]].
=== Experimente o seu mod ===
=== Experimente o seu mod ===