Stardew Valley Wiki

Alterações

Modificações:Guia do Modder/Começando (ver código-fonte)

Revisão das 23h14min de 20 de fevereiro de 2024

3 bytes removidos ,  20 fevereiro
m
→‎Adicionando seu manifest: fixed bad translate
Linha 6: Linha 6:  
==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? ===
Linha 24: Linha 24:  
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á.
    
=== Onde posso obter ajuda? ===
 
=== Onde posso obter ajuda? ===
−
<span id = "help"> </span> A comunidade de modificação de Stardew Valley é muito acolhedora. Sinta-se livre para pedir ajuda em [[Modding: Community # Discord | #modding na Stardew Valley Discord]].
+
<span id="help"></span>A comunidade de modificação de Stardew Valley é muito acolhedora. Sinta-se livre para pedir ajuda em [[Modding:Community#Discord|modding na Stardew Valley Discord]].
    
== Introdução ==
 
== Introdução ==
−
=== Aprenda C # ===
+
=== Aprenda C# ===
−
Como os mods são escritos em C #, é uma boa idéia familiarizá-lo primeiro. Você não precisa memorizar tudo, mas uma compreensão do básico (como campos, métodos, variáveis ​​e classes) facilitará todo o resto.
+
Como os mods são escritos em C#, é uma boa idéia familiarizá-lo primeiro. Você não precisa memorizar tudo, mas uma compreensão do básico (como campos, métodos, variáveis ​​e classes) facilitará todo o resto.
    
Alguns recursos úteis:
 
Alguns recursos úteis:
−
* [https://docs.microsoft.com/en-us/dotnet/csharp/quick-starts/ '' C # Quickstarts ''] ensina o básico do C # com exemplos interativos.
+
* [https://docs.microsoft.com/en-us/dotnet/csharp/quick-starts/ ''C# Quickstarts''] ensina o básico do C# com exemplos interativos.
−
* [https://mva.microsoft.com/en-us/training-courses/c-fundamentals-for-absolute-beginners-16169 '' Fundamentos de C # para iniciantes absolutos ''] é um guia em vídeo que o orientará C #, dos conceitos básicos à programação orientada a eventos (que é o que os mods SMAPI usam principalmente).
+
* [https://mva.microsoft.com/en-us/training-courses/c-fundamentals-for-absolute-beginners-16169 ''Fundamentos de C# para iniciantes absolutos''] é um guia em vídeo que o orientará C#, dos conceitos básicos à programação orientada a eventos (que é o que os mods SMAPI usam principalmente).
    
=== Requisitos ===
 
=== Requisitos ===
 
Antes que você comece:
 
Antes que você comece:
−
# Leia o [[Modding: Player Guide / Getting Started | Player Guide]]. O restante deste guia pressupõe que você já esteja familiarizado com o uso de mods.
+
# Leia o [[Modding:Player Guide/Getting Started|Player Guide]]. O restante deste guia pressupõe que você já esteja familiarizado com o uso de mods.
 
# Instale o Stardew Valley.
 
# Instale o Stardew Valley.
−
# Instale [[Modding: Guia do Player / Introdução # Instale SMAPI | SMAPI]].
+
# Instale [[Modificações:Guia do Player/Introdução#Instale SMAPI|SMAPI]].
−
# Instale o IDE ('' ambiente de desenvolvimento integrado '').
+
# Instale o IDE (''ambiente de desenvolvimento integrado'').
 
# * No Linux: instale [http://www.monodevelop.com/ MonoDevelop].
 
# * No Linux: instale [http://www.monodevelop.com/ MonoDevelop].
 
# * No Mac: instale [https://www.visualstudio.com/vs/visual-studio-mac/ Visual Studio para Mac]. (Este é um MonoDevelop renomeado.)
 
# * No Mac: instale [https://www.visualstudio.com/vs/visual-studio-mac/ Visual Studio para Mac]. (Este é um MonoDevelop renomeado.)
 
# * No Windows: instale [https://www.visualstudio.com/vs/community/ Visual Studio Comumnity]. Quando o instalador perguntar sobre cargas de trabalho, ative '' .NET Desktop Development ''.
 
# * No Windows: instale [https://www.visualstudio.com/vs/community/ Visual Studio Comumnity]. Quando o instalador perguntar sobre cargas de trabalho, ative '' .NET Desktop Development ''.
   −
Se você não está familiarizado com o Visual Studio (no Windows / Mac) ou o MonoDevelop (no Linux), [[Modding: IDE reference]] explica como fazer as coisas importantes necessárias para este guia.
+
Se você não está familiarizado com o Visual Studio (no Windows / Mac) ou o MonoDevelop (no Linux), [[Modding:IDE reference]] explica como fazer as coisas importantes necessárias para este guia.
    
==Crie um mod básico==
 
==Crie um mod básico==
Linha 69: Linha 69:     
# Abra o Visual Studio 2022 ou MonoDevelop.
 
# Abra o Visual Studio 2022 ou MonoDevelop.
−
# Crie uma solução com projeto de biblioteca de classes (veja [[Modding:IDE reference#create-project|como criar um projeto]]).(Não escolha Biblioteca de Classes .NET Framework!)
+
# Crie uma solução com projeto de biblioteca de classes (veja [[Modding:IDE reference#create-project|como criar um projeto]]). (Não escolha Biblioteca de Classes .NET Framework!)
 
# Mude a versão framework para .NET 5 (veja [[Modding:IDE reference#set-target-framework|como alterar a versão do framework]]). Talvez você precise [https://dotnet.microsoft.com/en-us/download/dotnet/5.0 instalar o SDK]
 
# Mude a versão framework para .NET 5 (veja [[Modding:IDE reference#set-target-framework|como alterar a versão do framework]]). Talvez você precise [https://dotnet.microsoft.com/en-us/download/dotnet/5.0 instalar o SDK]
 
# Referêncie [https://www.nuget.org/packages/Pathoschild.Stardew.ModBuildConfig <samp>Pathoschild.Stardew.ModBuildConfig</samp> NuGet package] (veja [[Modding:IDE reference#add-nuget|como adicionar o pacote]]).
 
# Referêncie [https://www.nuget.org/packages/Pathoschild.Stardew.ModBuildConfig <samp>Pathoschild.Stardew.ModBuildConfig</samp> NuGet package] (veja [[Modding:IDE reference#add-nuget|como adicionar o pacote]]).
Linha 96: Linha 96:  
     {
 
     {
 
         /*********
 
         /*********
−
         ** 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>
Linha 107: Linha 107:     
         /*********
 
         /*********
−
         ** 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>
Linha 119: Linha 119:     
             // 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}.");
 
         }
 
         }
 
     }
 
     }
Linha 128: Linha 128:  
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.
Linha 154: Linha 154:  
</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 ===
−
# Compile o projeto. (Para compilar o projeto: Visual Studio - Compilação > Compilar [Nome do seu projeto]) <br /> <small>Se você executou as etapas ''[[#Criar o projeto|crie o projeto]]'' corretamente, isso adicionará automaticamente seu mod aos <samp>Mods do jogo</samp>.</small>  
+
# Compile o projeto. (Para compilar o projeto: Visual Studio - Compilação > Compilar [Nome do seu projeto]) <br /><small>Se você executou as etapas ''[[#Criar o projeto|crie o projeto]]'' corretamente, isso adicionará automaticamente seu mod aos <samp>Mods do jogo</samp>.</small>  
 
# Execute o jogo através do SMAPI.
 
# Execute o jogo através do SMAPI.
   Linha 169: Linha 169:  
# * No Visual Studio, clique em ''Build > Rebuild Solution'' e verifique o painel ''Output'' ou a lista ''Error''.
 
# * No Visual Studio, clique em ''Build > Rebuild Solution'' e verifique o painel ''Output'' ou a lista ''Error''.
 
# * No MonoDevelop, clique em ''Build > Rebuild All'' e aguarde até que esteja pronto. Em seguida, clique na barra "Build: XX errors, XX warnings" na parte superior e verifique as guias ''XX Errors'' e ''Build Output''.
 
# * No MonoDevelop, clique em ''Build > Rebuild All'' e aguarde até que esteja pronto. Em seguida, clique na barra "Build: XX errors, XX warnings" na parte superior e verifique as guias ''XX Errors'' e ''Build Output''.
−
# Consulte o [[Modding: Guia do Modder/Guia de Teste e Solução de Problemas|Guia do Modder/Guia de Teste e Solução de Problemas]].
+
# Consulte o [[Modificações:Guia do Modder/Teste e Solução de Problemas|Guia do Modder/Guia de Teste e Solução de Problemas]].
 
# Se tudo mais falhar, peça ajuda na [[Modding:Community#Discord|#modding na Stardew Valley Discord]]. :)
 
# Se tudo mais falhar, peça ajuda na [[Modding:Community#Discord|#modding na Stardew Valley Discord]]. :)
   Linha 218: Linha 218:  
{{modding guide footer
 
{{modding guide footer
 
  |prev =  
 
  |prev =  
−
  |next = [[Modding:Modder Guide/Test and Troubleshoot|Testar e solucionar problemas]]
+
  |next = [[Modificações:Guia do Modder/Teste e Solução de Problemas|Teste e solução de problemas]]
 
}}
 
}}
    
[[en:Modding:Modder Guide/Get Started]]
 
[[en:Modding:Modder Guide/Get Started]]
 
[[zh:模组:创建 SMAPI 模组]]
 
[[zh:模组:创建 SMAPI 模组]]
LokKol
37

edições

Obtida de "https://pt.stardewvalleywiki.com/Especial:MobileDiff/25759...31243"