Изменения

# Загрузка мода в игру. Без SMAPI модификации не запустятся.

# Загрузка мода в игру. Без SMAPI модификации не запустятся.

# Упрощённые API, которые позволяют создать взаимодействия, которые раньше были недоступны. Они делают более простое внесение изменений в механики игры, настройку игрового персонажа, перевода и прочего. Но об этом чуть позже.

# Упрощённые API, которые позволяют создать взаимодействия, которые раньше были недоступны. Они делают более простым внесение изменений в механики игры, настройку игрового персонажа, перевода и прочего. Но об этом чуть позже.

# Кроссплатформенность. Это значит, что не нужно думать, как интегрировать модификацию на разные ОС.

# Кроссплатформенность. Это значит, что не нужно думать, как интегрировать модификацию на разные ОС.

# Изменение и обновление модификации. SMAPI обнаруживает и чинит дыры в коде, приводящие к поломке игры.

# Изменение и обновление модификации. SMAPI обнаруживает и чинит дыры в коде, приводящие к поломке игры.

Некоторые полезные ресурсы:

Некоторые полезные ресурсы:

* [https://docs.microsoft.com/en-us/dotnet/csharp/quick-starts/ ''C# Quickstarts''] интерактивно обучает базам С#.

* [https://docs.microsoft.com/en-us/dotnet/csharp/quick-starts/ ''C# Quickstarts''] интерактивно обучает базам С#.

* [https://mva.microsoft.com/en-us/training-courses/c-fundamentals-for-absolute-beginners-16169 ''C# Fundamentals for Absolute Beginners''] - видеогайд, который проведет вас по С# от базовых концептов до событийно-ориентированного програмированния (в котором чаще всего моды SMAPI и нуждаются).

* [https://mva.microsoft.com/en-us/training-courses/c-fundamentals-for-absolute-beginners-16169 ''C# Fundamentals for Absolute Beginners''] — видеогайд, который проведет вас по С# от базовых концептов до событийно-ориентированного програмированния (в котором чаще всего моды SMAPI и нуждаются).

* [https://metanit.com/sharp/ Язык программирования C# и платформа .NET] — учебник на русском языке.

===Требования===

===Требования===

Если вы не знакомы с Visual Studio (на Windows/Mac) или MonoDevelop (на Linux), [[Modding:IDE референс]] объясняет, как сделать необходимые вещи для этого гайда.

Если вы не знакомы с Visual Studio (на Windows/Mac) или MonoDevelop (на Linux), [[Modding:IDE референс]] объясняет, как сделать необходимые вещи для этого гайда.

 

==Создайте простой мод==

==Create a basic mod==

===Быстрый старт===

===Quick start===

Если у вас достаточно опыта, чтобы пропустить учебник, вот краткий обзор этого раздела:

If you're experienced enough to skip the tutorial, here's a quick summary of this section:

{{collapse|расширения для быстрого старта|content= 

{{collapse|expand for quick start|content= 

# Create an empty C# class library project.

# Create an empty C# class library project.

# Target .NET Framework 4.5, 4.5.1, or 4.5.2 for best compatibility.

# Target .NET Framework 4.5, 4.5.1, or 4.5.2 for best compatibility.

==FAQs==

==FAQs==

===Where's the SMAPI documentation?===

===Где SMAPI документация?===

This is just the 'getting started' tutorial. For more documentation, see the [[Modding:Modder Guide/APIs|SMAPI reference]] and the [[Modding:Index|topics listed on the index page]].

Это всего лишь руководство по началу. Для просмотра документации смотри: [[Modding:Modder Guide/APIs|SMAPI reference]] и [[Modding:Index|topics listed on the index page]].

===How do I make my mod work crossplatform?===

===Как сделать кросс-платформенный мод?===

SMAPI will automatically adjust your mod so it works on Linux, MacOS, and Windows. However, there are a few things you should do to avoid problems:

SMAPI автоматически настроит ваш мод таким образом, чтобы он работал в Linux, macOS и Windows. Однако есть несколько вещей, которые вы должны сделать, чтобы избежать проблем:

<ol>

<ol>

<li>Use the [https://smapi.io/package/readme crossplatform build config] package to automatically set up your project references. This makes crossplatform compatibility easier and lets your code compile on any platform. (If you followed the above guide, you already have this.)</li>

<li>Используйте [https://smapi.io/package/readme конфигурацию кросс-платформенной сборки] для автоматической настройки ссылок. Это упрощает кросс-платформенную совместимость и позволяет вашему коду компилироваться на любой платформе. (If you followed the above guide, you already have this.)</li>

<li>Use <samp>System.IO.Path.Combine</samp> to build file paths, don't hardcode path separators since they won't work on all platforms.

<li>Используйте <samp>System.IO.Path.Combine</samp> для построения путей к файлу, не кодируйте разделители путей, так как они не будут работать на всех платформах.

<syntaxhighlight lang="c#">

<syntaxhighlight lang="c#">