Мод Sandustry Custom Recipes: Определение входов и выходов

Sandustry выходит в Ранний доступ 13 августа 2026 года, и с первого дня в игру встроены специальные инструменты для моддинга как часть основного опыта. Официальный сайт заявляет, что игра создана с учётом моддинга, охватывая пользовательские карты, новые здания, процессы и полные переработки. Это означает, что мод Sandustry custom recipes — это не нишевый эксперимент, а полноценная функция, которую разработчик активно поддерживает. Когда вы определяете собственные входы и выходы, вы меняете поведение производственных цепочек, что позволяет настраивать сложность, создавать совершенно новые пути прогрессии или просто исправлять рецепт, который всегда казался несбалансированным. Это важно, потому что логика рецептов лежит в основе каждого цикла автоматизации в игре, поэтому её освоение открывает самый глубокий уровень творческого контроля.

Разработчик также делится инструментами для моддинга и модами сообщества через официальный Discord Sandustry, что позволяет легко увидеть, что создают другие игроки, прежде чем вы напишете свой первый файл. Если вы никогда не касались модов, не переживайте — это руководство проведёт вас через весь процесс от структуры папок до синтаксиса JSON, и оно предполагает нулевые предварительные знания. К концу у вас будет работающий мод custom recipes, который вы сможете загрузить в игру, а также уверенность, чтобы экспериментировать с более амбициозными проектами, такими как полные моды-переработки.

Понимание системы рецептов перед моддингом

Каждая машина в Sandustry обрабатывает входы в выходы через определение рецепта, и эти определения хранятся в JSON-файлах, которые игра читает при запуске. Когда вы создаёте мод Sandustry custom recipes, вы по сути говорите игре заменить или расширить эти JSON-определения своими версиями. Основные поля, которые вам нужно понять, — это список входов, список выходов, время обработки и тип машины, к которой применяется рецепт. Каждое поле имеет определённый синтаксис, и правильное его соблюдение — это разница между модом, который загружается чисто, и тем, который выдаёт ошибки в консоли.

Переработка симуляции игры, которую разработчик показал в видео «до и после» на YouTube, изменила то, как рецепты обрабатываются под капотом. Это обновление сделало систему более гибкой для моддеров, но также означает, что вы всегда должны проверять, соответствуют ли ваши файлы рецептов текущей версии игры. Сообщения сообщества указывают на то, что рецепты, написанные для старых сборок, иногда молча не работают, поэтому стоит проверять ваш мод после каждого обновления игры. Система рецептов использует простую структуру «ключ-значение», и как только вы усвоите этот шаблон, вы сможете применить его к каждой машине в игре.

Анатомия файла рецепта

Файл рецепта следует предсказуемой структуре, которая повторяет то, как сама игра определяет свои стандартные рецепты. Вы начинаете с JSON-объекта, содержащего ID рецепта, затем определяете входные предметы с их количеством, за которыми следуют выходные предметы и их количество. Время обработки измеряется в тиках, а тип машины определяет, какое здание может выполнять рецепт. Вот основная форма, с которой вы будете работать:

{
  "id": "my_custom_smelting",
  "machine": "furnace",
  "inputs": [{"item": "iron_ore", "amount": 2}],
  "outputs": [{"item": "iron_ingot", "amount": 1}],
  "time": 40
}

ID рецепта должен быть уникальным среди всех модов, потому что игра использует его для разрешения конфликтов. Поле machine сообщает игре, какое здание должно принимать этот рецепт, а массивы inputs и outputs определяют фактическое преобразование. Поле time контролирует, сколько тиков нужно машине для завершения процесса, и это напрямую влияет на ваши расчёты пропускной способности производства. Когда вы начнёте экспериментировать, попробуйте сначала изменить только значение времени — это самый безопасный способ увидеть реакцию системы, не сломав ничего другого.

Как игра разрешает конфликты рецептов

Когда несколько модов определяют рецепты для одной машины, игре нужен детерминированный способ решить, какой из них победит. Согласно тестированию сообщества, игра использует систему приоритетов, где более высокие числа имеют преимущество, а если два мода имеют одинаковый приоритет, игра полагается на порядок загрузки. Это важно, потому что мод Sandustry custom recipes, конфликтующий с другим популярным модом, может молча переопределить его, создавая неожиданные результаты на вашей фабрике. Таблица ниже показывает, как разрешение работает на практике:

Практический вывод: вы должны установить чёткое значение приоритета в манифесте вашего мода и задокументировать его для других игроков. Если вы создаёте мод для личного использования, стандартный приоритет подойдёт, но если вы планируете делиться им через мастерскую Sandustry, вам стоит подумать о том, как он взаимодействует с более широкой экосистемой моддинга. Хорошее эмпирическое правило — начинать с приоритета 50 и корректировать только при возникновении конкретного конфликта.

Настройка вашего первого мод-проекта

Прежде чем вы сможете написать какие-либо определения рецептов, вам нужно создать структуру папок, которую ожидает игра. Процесс прост, но именно здесь многие новички спотыкаются, поэтому не торопитесь с этим разделом. Игра ищет моды в выделенной директории внутри папки установки Sandustry, и каждый мод должен иметь свою собственную подпапку с файлом манифеста, который описывает мод игре. Манифест — это небольшой JSON-файл, содержащий название мода, версию и список файлов контента, которые должны быть загружены.

Официальные инструменты моддинга, поставляемые с игрой, включают валидатор, который проверяет ваши файлы на распространённые ошибки ещё до запуска Sandustry. Этот инструмент — спасение, потому что он ловит опечатки в ID предметов и некорректный JSON, которые в противном случае вызвали бы сбой игры при запуске. Сообщения сообщества предполагают, что большинство ошибок новичков происходит из-за неправильного копирования названий предметов, поэтому валидатор экономит часы разочарования. Как только ваш проект пройдёт валидацию, вы сможете загрузить его в игру и сразу протестировать.

Создание структуры папки мода

Папка вашего мода должна соответствовать определённой структуре, которую игра распознаёт. Корневая папка должна иметь имя, совпадающее с ID вашего мода, а внутри неё вы размещаете файл манифеста плюс папку контента для ваших определений рецептов. Вот структура, которую вам нужно создать:

• Корневая папка мода — названа по ID вашего мода, например my_custom_recipes

• manifest.json — описывает мод, его версию и приоритет

• content/recipes/ — содержит все ваши пользовательские JSON-файлы рецептов

• content/items/ — опционально, для пользовательских предметов, на которые ссылаются ваши рецепты

Файл манифеста — самая важная часть, потому что игра читает его первым, чтобы понять, что содержит ваш мод. Минимальный манифест выглядит так:

Поле id должно точно совпадать с именем вашей папки, а массив content перечисляет каждый JSON-файл, который игра должна загрузить. Если вы добавите больше файлов рецептов позже, вам нужно обновить этот массив, что является частым источником путаницы для новичков. Инструмент валидатора напомнит вам, если вы забудете, но полезно понимать связь между манифестом и вашими файлами контента.

Использование инструментов моддинга, поставляемых с игрой

Sandustry включает набор инструментов моддинга, которые разработчик обновляет вместе с основной игрой, и эти инструменты — ваши лучшие друзья при обучении. Валидатор ловит синтаксические ошибки, браузер предметов позволяет искать точные ID предметов, а функция живого перезапуска позволяет тестировать изменения без перезапуска игры. Согласно официальному сайту, эти инструменты — основная часть дизайна игры, а не второстепенная мысль, что означает, что они отполированы и надёжны.

Браузер предметов особенно ценен, когда вы определяете мод Sandustry custom recipes, потому что он устраняет догадки вокруг названий предметов. Вместо того чтобы вводить iron_ore и надеяться, что это правильно, вы можете найти предмет и скопировать его точный ID. Это может показаться тривиальным, но данные сообщества показывают, что опечатки в ID предметов составляют большую долю ошибок моддинга у новичков. Живой перезапуск — ещё одно изменение правил игры, потому что он позволяет вам настраивать значения рецептов и видеть эффект немедленно, что делает экспериментирование гораздо более приятным.

Проектирование рецептов, улучшающих игровой процесс

Как только вы освоите технические основы, начинается самая интересная часть: проектирование рецептов, которые действительно делают игру лучше. Мод Sandustry custom recipes может исправить проблемы баланса, создать новые пути прогрессии или открыть совершенно новые стили игры. Ключ в том, чтобы думать о производственной цепочке в целом, а не об отдельных рецептах изолированно. Когда вы меняете один рецепт, вы влияете на всё, что ниже по цепочке, поэтому продуманный подход даёт гораздо лучшие результаты, чем случайные изменения.

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

Сравнение стратегий балансировки рецептов

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

Подход повышения эффективности — самый популярный для личных модов, потому что он напрямую решает точки трения, которые игроки испытывают во время обычной игры. Стратегия альтернативных путей более креативна, но требует тщательного обдумывания того, какие материалы доступны на каждом этапе игры. Подход повышения сложности редок, но ценен для игроков, которые освоили стандартную игру и хотят нового вызова. Какую бы стратегию вы ни выбрали, система моддинга полностью её поддерживает.

Практические примеры рецептов, которые можно скопировать

Чтобы дать вам конкретную отправную точку, вот три примера рецептов, демонстрирующих разные дизайнерские цели. Первый снижает стоимость распространённого строительного материала, второй добавляет новый способ производства ресурса поздней игры, а третий создаёт более дорогую, но более быструю альтернативу. Каждый пример самодостаточен и может быть помещён в папку вашего мода после корректировки ID предметов под вашу версию игры:

• Более дешёвые кирпичи — измените рецепт кирпича, чтобы использовать 1 глину вместо 2, ускоряя раннее строительство

• Альтернативные схемы — добавьте рецепт, который производит схемы из медной проволоки и железных пластин вместо стандартных материалов

• Быстрый сплав — создайте рецепт стали с высокой стоимостью и низким временем, который использует больше угля, но завершается за половину тиков

Эти примеры иллюстрируют диапазон того, что вы можете сделать с модом Sandustry custom recipes, и они достаточно просты для отладки, когда что-то идёт не так. Начните с одного из них, добейтесь его работы, а затем экспериментируйте с собственными идеями. Чем больше вы практикуетесь, тем более естественным становится синтаксис JSON, и вскоре вы будете писать сложные цепочки рецептов, не заглядывая никуда.

Отладка логики рецептов и конфликтов

Тестирование — это то, где многие мод-проекты добиваются успеха или терпят неудачу, и Sandustry даёт вам надёжные инструменты, чтобы сделать процесс управляемым. Функция живого перезапуска — ваш основной инструмент тестирования, потому что она позволяет изменить значение рецепта и увидеть результат за секунды. Когда вы итерируете дизайн, эта скорость бесценна, и она поощряет экспериментирование, а не осторожные догадки. Инструмент валидатора ловит структурные ошибки до загрузки игры, что избавляет вас от самого раздражающего типа багов.

Однако не все баги структурные, и некоторые проявляются только когда рецепт взаимодействует с остальной частью игры. Например, рецепт может загрузиться нормально, но производить предмет, который ни одна машина не может использовать, или он может ссылаться на тип машины, который не существует. Эти логические ошибки требуют ручного тестирования, и лучший подход — создать небольшую тестовую установку в творческом мире. Разместите машину, подайте входы и наблюдайте, что происходит. Если рецепт не появляется в меню машины, тип машины неправильный; если он появляется, но не работает, входы, вероятно, неверны.

Распространённые ошибки и способы их исправления

Таблица ниже перечисляет наиболее распространённые ошибки, о которых сообщают члены сообщества при создании пользовательских рецептов, а также типичные причины и исправления. Это не исчерпывающий список, но он охватывает проблемы, с которыми новички сталкиваются чаще всего:

Ошибка неправильного типа машины — самая распространённая, потому что легко ввести название машины, которое звучит правильно, но не совпадает с внутренним ID игры. Ошибка отсутствующего ID предмета — вторая по распространённости, и она обычно случается, когда вы копируете название предмета из вики, использующей другую систему именования. Ошибка ничего не производит сложнее, потому что рецепт загружается и работает, но результат невидим, что затрудняет диагностику. Во всех случаях валидатор и браузер предметов — ваши лучшие инструменты, а Discord сообщества — отличное место, чтобы попросить помощи, когда вы застряли.

Использование сообщества для устранения неполадок

Сообщество моддинга Sandustry активно и отзывчиво, и официальный Discord — лучшее место для получения ответов, когда вы сталкиваетесь с проблемой, которую не можете решить. Разработчик активно участвует в обсуждениях моддинга, и опытные моддеры обычно рады просмотреть ваши файлы и указать на проблемы. Согласно сообщениям сообщества, большинство тем по устранению неполадок получают ответ в течение нескольких часов, что быстро для игры, которая ещё даже не запущена.

Когда вы просите о помощи, включите ваш файл манифеста и файл рецепта, вызывающий проблему, плюс описание того, что вы ожидали произойти, в отличие от того, что произошло на самом деле. Этот контекст значительно облегчает другим выявление проблемы. Вы также можете поискать в Discord похожие проблемы, потому что многие новички упираются в одну и ту же стену, и решения часто уже задокументированы. Сообщество — один из лучших ресурсов для изучения моддинга Sandustry, и к нему стоит присоединиться, даже если вы никогда не зададите вопрос.

Выход за пределы рецептов с полными модами-переработками

Как только вы освоитесь с пользовательскими рецептами, вы можете захотеть исследовать более широкий мир полных модов-переработок Sandustry. Эти проекты выходят за рамки отдельных изменений рецептов и перерабатывают целые системы, добавляя новые машины, новые предметы и новые пути прогрессии. Инструменты моддинга, поставляемые с игрой, поддерживают такой уровень амбиций, и официальный сайт явно упоминает полные переработки как поддерживаемый случай использования. Кривая обучения круче, но награда — полностью персонализированная версия игры.

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

Планирование проекта переработки

Таблица ниже описывает типичные фазы проекта полной переработки, основанные на сообщениях сообщества из других моддинг-сообществ и структуре инструментов моддинга:

Фаза дизайна — самая важная, потому что она заставляет вас думать о том, как ваши изменения взаимодействуют со стандартной игрой. Фаза рецептов — это где вы применяете навыки из этого руководства, и это лучшее место для начала, если вы новичок в проектах переработки. Фаза предметов требует изучения нового набора JSON-полей, но шаблон похож на рецепты. Фаза машин — самая сложная, потому что машины имеют визуальные и поведенческие компоненты, но инструменты моддинга включают шаблоны, которые помогут вам начать.

Учебные ресурсы для продвинутого моддинга

Если вы хотите углубиться, документация по моддингу Sandustry — авторитетный источник по мод-API, а официальный Discord имеет каналы, посвящённые разработке модов. Разработчик также публикует видеообновления, демонстрирующие новые функции моддинга, такие как видео «до и после» переработки симуляции, которое даёт вам представление о том, как работают внутренности игры. Для структурированного введения в основы руководство по моддингу Sandustry для новичков охватывает основы создания вашего первого мод-проекта.

По мере прогресса вам также стоит изучать существующие моды сообщества, чтобы увидеть, как опытные моддеры структурируют свои проекты. Руководство по модам сообщества демонстрирует некоторые из лучших примеров и объясняет, что делает их работающими. Вы также можете проверить руководство по установке модов, если вам нужно освежить знания о загрузке модов в игру. Ключ в том, чтобы продолжать экспериментировать и учиться как на своих успехах, так и на неудачах.

Часто задаваемые вопросы

Какой самый лёгкий способ начать создавать мод Sandustry custom recipes?

Скопируйте существующий файл рецепта из стандартного контента Sandustry, замените ID предметов и количества, затем прогоните его через валидатор. Протестируйте одну изменённую машину в творческом мире, прежде чем добавлять больше. Это минимизирует синтаксические ошибки, пока вы учите формат.

Могу ли я поделиться своим модом custom recipes в мастерской Sandustry?

Да, игра поддерживает интеграцию с мастерской, и разработчик поощряет игроков делиться своими модами. Перед загрузкой убедитесь, что ваш мод проходит валидатор и включает чёткое описание того, что он меняет. Вам также следует установить значение приоритета, которое хорошо сочетается с другими популярными модами, и тестировать ваш мод после каждого обновления игры для обеспечения совместимости.

Требуют ли полные моды-переработки Sandustry знаний программирования?

Нет, полные моды-переработки Sandustry полагаются на ту же JSON-систему, что и пользовательские рецепты, просто с большим количеством взаимосвязанных файлов. Вам не нужно писать код, но вам нужно будет проследить, как определения предметов, блоков и рецептов связаны друг с другом. Шаблоны и Discord сообщества покрывают сложные части.

Как исправить рецепт, который загружается, но не появляется в меню машины?

Обычно это означает, что тип машины в вашем файле рецепта не совпадает с машиной, которую вы проверяете. В инструментах моддинга Sandustry откройте браузер предметов, чтобы подтвердить точный ID машины, затем обновите ваш рецепт. Если это правильно, проверьте, что массив content в вашем манифесте ссылается на файл рецепта — не перечисленные файлы не будут загружены.

Что происходит, когда два мода определяют один и тот же рецепт?

Игра использует систему приоритетов для разрешения конфликтов, где более высокие значения приоритета побеждают. Если два мода имеют одинаковый приоритет, игра полагается на порядок загрузки, и мод, загруженный позже, получает преимущество. Чтобы избежать сюрпризов, установите чёткий приоритет в вашем манифесте и задокументируйте его, чтобы другие игроки знали, как ваш мод взаимодействует с их.