translators
8,404
edits
Changes
→Specific topics: tweak organization, update link for farm data
==Using mods==
==Using mods==
{|
|-
|style="border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;"| <span style="font-size: larger;">'''[[Modding:Player Guide/Getting Started|Using mods]]'''</span><br />How to install SMAPI, use mods, and troubleshoot them. Includes the compatibility list.
|}
* [[Modding:Help|Get help or ask question]]
* [[Modding:Community|Join the community]]
* [[Modding:Using XNB mods|Using XNB mods]] (not recommended)
==Creating mods==
==Creating mods==
===Main resources===
* [[Modding:Creating a SMAPI mod|Creating a SMAPI mod]]
Making mods can be broadly divided into two categories: C# mods and content packs (formatted text files that rely on a framework C# mod). Content packs can make new NPCs, edit maps, add new items, add shops, and more, while C# mods can change fundamental game mechanics. Usually it’s easiest to start with making content packs, since you don't need to learn how to program in C#. If you're confused and want to look at a picture of what kinds of modding is possible, see [[Modding:Modder Guide/Get Started/Pictorial Guide]].
* [[Modding:Updating deprecated SMAPI code|Updating deprecated SMAPI code]]
* [[Modding:Creating an XNB mod|Creating an XNB mod]]
{|
|-
|style="border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;"| <span style="font-size: larger;">'''[[Modding:Content pack frameworks|Creating content mods with jsons]]'''</span><br />How to create content packs for frameworks like Content Patcher.
|-
|style="border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;"| <span style="font-size: larger;">'''[[Modding:Modder Guide/Get Started|Creating SMAPI mods with C#]]'''</span><br />How to create SMAPI mods, with tutorials and documentation. This includes the full SMAPI API + event reference.
|-
|style="border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;"| <span style="font-size: larger;">'''[[Modding:Translations|Translating mods]]'''</span><br />How to contribute mod translations for any language supported by the game. (And for modders, how to enable and request translations.)
|}
* ''Looking for something specific? Try [{{fullurl:Special:Search|ns570=1}} searching the <samp>Modding</samp> namespace].''
* [[Modding:Help|Get help or ask question]]
* [[Modding:Community|Join the community]]
* [[Modding:Open source|Open source]]
===Specific topics===
* '''[[Modding:Modder Guide/APIs|SMAPI API reference]]''' (also on the sidebar in the "Creating SMAPI mods" guide above)
* '''[https://stardewmodding.wiki.gg Modding tutorials wiki]'''
* [[Modding:Common tasks|Common tasks (SMAPI mods)]]
* [[Modding:Editing XNB files|Editing XNB files]]
* [[Modding:IDE reference|IDE reference]]
* [[Modding:IDE reference|IDE reference]]
* Game:
* [[Modding:Blueprint data|Blueprint data]]
** [[Modding:Modder Guide/Game Fundamentals|Game fundamentals]]
* [[Modding:Event data|Event data]]
** [[Modding:Audio|Audio]]
* [[Modding:Gift taste data|Gift taste data]]
** [[Modding:Custom languages|Custom languages]]
* [[Modding:Object data|Object data]]
** [[Modding:Console commands|Console commands]]
* [[Modding:Weather data|Weather mechanics]]
** [[Modding:World map|World map]]
* [[Modding:Dialogue|Dialogue]]
** [[Modding:Game state queries|Game state queries]]
** [[Modding:Trigger actions|Trigger actions]]
** [[Modding:Tokenizable strings|Tokenizable strings]]
* NPCs:
** [[Modding:NPC data|Overview]]
** [[Modding:Dialogue|Dialogue]]
** [[Modding:Event data|Events]]
** [[Modding:Gift taste data|Gift tastes]]
** [[Modding:Quest data|Quests]]
** [[Modding:Schedule data|Schedules]]
* Item data:
** [[Modding:Items|Items]]
** [[Modding:Crop data|Crops]]
** [[Modding:Fruit trees|Fruit trees]]
** [[Modding:Item queries|Item queries]]
** [[Modding:Machines|Machines]]
** [[Modding:Recipe data|Recipes]]
** [[Modding:Shops|Shops]]
* Locations and maps:
** [[Modding:Maps|Maps]]
** [[Modding:Farm data|Farm data]]
** [[Modding:Festival data|Festivals]]
** [[Modding:Fish data|Fish]]
** [[Modding:Movie theater data|Movie theater]]
** [[Modding:Weather data|Weather]]
* Other content:
** [[Modding:Animal data|Animals]]
** [[Modding:Achievement data|Achievements]]
** [[Modding:Blueprint data|Blueprints]]
** [[Modding:Bundles|Bundles]]
** [[Modding:Farmer sprite|Farmer sprite]]
** [[Modding:Fish Pond data|Fish Ponds]]
** [[Modding:Location data|Locations]]
** [[Modding:Mail data|Mail]]
** [[Modding:Monster data|Monsters]]
** [[Modding:Special orders|Special orders]]
* Specialized (normally linked from other pages):
** [[Modding:Common data field types|Common data field types]]
==See also==
===Migration guides===
* [https://discord.gg/kH55QXP Chat on Discord] — get help, ask questions, or discuss with modders and SMAPI developers.
{| class="wikitable"
|-
! release
! date released
|-
| [[Modding:Migrate to SMAPI 2.0|SMAPI 2.0]] || October 2017
|-
| [[Modding:Migrate to Stardew Valley 1.3|Stardew Valley 1.3]] || May 2018
|-
| [[Modding:Migrate XNB changes to Stardew Valley 1.3|Stardew Valley 1.3 (XNB changes)]] || May 2018
|-
| [[Modding:Migrate to Stardew Valley 1.3.36|Stardew Valley 1.3.36]] || March 2019
|-
| [[Modding:Migrate to Stardew Valley 1.4|Stardew Valley 1.4]] || November 2019
|-
| [[Modding:Migrate to SMAPI 3.0|SMAPI 3.0]] || November 2019
|-
| [[Modding:Migrate to Stardew Valley 1.5|Stardew Valley 1.5]] || December 2020
|-
| [[Modding:Migrate to 64-bit on Windows|64-bit on Windows]] || May 2021
|-
| [[Modding:Migrate to Harmony 2.0|Harmony 2.0]] || July 2021
|-
| [[Modding:Migrate to Stardew Valley 1.5.5|Stardew Valley 1.5.5]] || November 2021
|-
| [[Modding:Migrate to SMAPI 4.0|SMAPI 4.0]] || March 2024
|-
| [[Modding:Migrate to Stardew Valley 1.6|Stardew Valley 1.6]] || March 2024
|}
===See also===
* Pixel art resources:
** [https://sundrop.kvdk.net/art-guide Stardew Valley art style guide]
** [https://pixeljoint.com/forum/forum_posts.asp?TID=11299&PID=139322 Pixel art tutorial on Pixel Joint]
** [https://medium.com/pixel-grimoire/how-to-start-making-pixel-art-2d1e31a5ceab Pixel art guide on Medium]
* Content pack resources:
** [https://docs.google.com/spreadsheets/d/1CpDrw23peQiq-C7F2FjYOMePaYe0Rc9BwQsj3h6sjyo The great ID spreadsheet]
** [https://stardewmodding.wiki.gg/wiki/Custom_NPC_Tiles Custom NPC festival tile positions]
* Useful tools:
** [https://smapi.io/mods SMAPI mod compatibility list] ([[Modding:Mod compatibility|you can edit it!]])
** [https://smapi.io/log SMAPI log parser]
** [https://smapi.io/json JSON validator]
* [[User:Kdau#Notes on Android SMAPI modding|Kdau's notes on Android SMAPI modding]]
* [[User:Dem1se#Getting_Started_with_Making_UIs| Dem1se's getting started guide on mod UIs]]
[[Category:Modding| ]]
[[Category:Modding| ]]
[[de:Modding:Index]]
[[es:Modding:Índice]]
[[fr:Modding:Index]]
[[pt:Modificações:Índice]]
[[ru:Модификации:Индекс]]
[[zh:使用模组:目录]]