Изменения

{{Переведите}}

{{Переведите}}

Do you want to create SMAPI mods for Stardew Valley? This guide is for you! '''For using mods, see [[Modding:Player Guide/Getting Started|Modding:Player Guide]]. For creating Content Patcher packs, see [[Модификации:Content Patcher]].'''

Желаете начать создавать моды для игры Stardew Valley с помощью SMAPI? Тогда этот гайд для вас! '''Для использования модов, перейди в [[Modding:Player Guide/Getting Started|Modding:Player Guide]]. for creating content patcher packs, see [[Модификации:Content Patcher]].'''

==Вступление==

==Вступление==

===What is a SMAPI mod?===

===Что за SMAPI?===

A SMAPI mod uses the [https://smapi.io/ SMAPI] modding API to extend the game logic. The mod can respond when something happens in the game (like when an object is placed in the world), run code periodically (like once per update tick), change the game's assets and data, etc. SMAPI mods are written in C# using the .NET Framework, and Stardew Valley uses XNA/MonoGame for the game logic (drawing to the screen, user input, etc).

SMAPI — это специальное API для создания модификаций с целью расширения логик игры. Мод поможет реализовать изменения в игре (например, добавить новый предмет в мир), периодично запускать строчки кода (например, добавить автоматическую проверку обновлений), изменять игровые механики, логики и другое. Модификации SMAPI написаны на языке программирования C#, используют технологию .NET Framework. Stardew Valley использует движок XNA/MonoGame для реализации игровых механик (отрисовка объектов, отслеживание пользовательского ввода и прочее).

===Why do mods use SMAPI?===

===Почему модификации используют SMAPI?===

SMAPI does a lot for you! For example, SMAPI will...

SMAPI предоставляет возможность для реализации многих функций. Например:

# Load your mod into the game. Code mods aren't possible without SMAPI to load them.

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

# Provide APIs and events which let you interact with the game in ways you otherwise couldn't. There are simplified APIs for game asset/data changes, player configuration, translation, reflection, etc. These are covered later in the guide.

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

# Rewrite your mod for crossplatform compatibility when it's loaded. That lets you write mod code without worrying about the differences between the Linux/Mac/Windows versions of the game.

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

# Rewrite your mod to update it. SMAPI detects and fixes mod code broken by a game update in common cases.

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

# Intercept errors. If your mod crashes or causes an error, SMAPI will intercept the error, show the error details in the console window, and in most cases automatically recover the game. This means your mod won't accidentally crash the game, and it makes it much easier to troubleshoot errors.

# Вывод ошибок. Если мод ломает игру или работает неправильно, SMAPI обнаружит ошибку, выведет её детали в окне консоли, и во многих случаях автоматически перезагрузит игру. Это значит, что поиск и устранение неполадки займёт гораздо меньше времени.

# Provide update checks. SMAPI automatically alerts players when a new version of your mod is available.

# Система обновлений. SMAPI автоматически уведомляет игроков о выходе новой версии мода.

# Provide compatibility checks. SMAPI automatically detects when your mod is incompatible and disables it before it causes problems, so players aren't left with broken games.

# Проверка совместимости. SMAPI автоматически проверяет и определяет несовместимость или неработоспособность модификации на текущей системе и отключает его до появления проблем у игроков. Так пользователи не останутся со сломанными версиями игр.

===Can I make a mod?===

===Can I make a mod?===