Если вы когда-либо хотели изменить правила ваших спасательных вылазок, это руководство по созданию модов для Ostranauts проведёт вас через каждый шаг — от настройки папок до публикации рабочего мода в Steam Workshop. Построенная на том же движке, что и NEO Scavenger, игра поставляется с полными текстовыми файлами данных, которые любой игрок может читать, редактировать и перепаковывать, не прикасаясь к исполняемому файлу. Именно эта открытость стала причиной того, что сообщество создало сотни модов — от балансных правок до полностью новых корабельных деталей, и остальная часть этого руководства по созданию модов для Ostranauts даёт вам самый короткий надёжный путь, чтобы присоединиться к ним.
Понимание экосистемы моддинга Ostranauts
Первое, что нужно понять, прежде чем открывать любой файл, — это то, как игра загружает свои данные. Ostranauts хранит почти каждое игровое значение — от характеристик тяги двигателей до скорости падения морали экипажа — в читаемых JSON-файлах, упакованных в каталог установки. Когда вы запускаете игру, она сначала считывает эти файлы, а затем накладывает всё, что найдено в вашей пользовательской папке модов, что означает, что моды ведут себя скорее как переопределяющие листы, чем как скомпилированные плагины. Для более глубокого разбора философии и экосистемы смотрите наше руководство по моддингу Ostranauts.
Сцена моддинга рано разделилась на два практических лагеря: авторов, которые публикуют через Steam Workshop, и авторов, которые распространяют папки напрямую через Discord. Интеграция с Workshop появилась с выходом версии 1.0 3 августа 2026 года, поэтому старые моды, которые существовали только на сообщественных Discord-серверах, теперь имеют путь установки в один клик для новичков. Любой из этих способов действителен, и уровень данных обрабатывает их одинаково.
| Канал распространения | Усилия по установке | Доставка обновлений | Обнаруживаемость |
|---|---|---|---|
| Steam Workshop | Один клик | Автоматически через Steam | Высокая (встроенный поиск) |
| Ручная папка (Documents) | Перетаскивание | Ручная загрузка заново | Низкая (только Discord/форум) |
| Внешний хаб в стиле Nexus | Различается | Вручную | Средняя |
| Архив релиза GitHub | Скачать + распаковать | Вручную | Низкая (только для разработчиков) |
Выбор в основном влияет на ваших игроков, а не на ваш код. Для вашей первой попытки следовать этому руководству по созданию модов для Ostranauts ручная установка обеспечивает самую быструю обратную связь, потому что вы можете редактировать, перезапускать и перезагружать менее чем за тридцать секунд, не открывая Steam. Как только дизайн станет стабильным, переупаковка для Workshop займёт пять минут.
Настройка среды моддинга
Вам не нужна тяжёлая IDE, чтобы начать. Большинство моддеров начинают с лёгкого текстового редактора и копии файлов базовой игры для справки. Сообщество обычно считает три инструмента стандартным набором, и наша статья инструменты для моддинга Ostranauts расширяет этот список скриншотами.
Необходимое ПО и расположение папок
Базовая установка находится по пути SteamLibrary/steamapps/common/Ostranauts/ на PC. Внутри этой папки вы найдёте каталог data/, содержащий исходники JSON, и каталог ostranauts_Data/, содержащий скомпилированные ассеты Unity, которые обычно не следует трогать. Ваша пользовательская папка модов находится на уровень выше, под SteamLibrary/steamapps/workshop/content/1022980/ для подписанных элементов Workshop и Documents/Ostranauts/mods/ для ручных установок.
Рекомендации по редакторам
Хороший редактор должен как минимум поддерживать подсветку синтаксиса JSON, соответствие скобок и кодировку UTF-8 без BOM. Visual Studio Code с расширением Even Better TOML, Notepad++ с плагином JSON Viewer и Sublime Text 4 — это три наиболее распространённых выбора, о которых сообщают моддеры на официальной вики. Сохраняйте каждый файл с Unix-переводами строк (LF), если планируете делиться модом кроссплатформенно, потому что Windows-стиль CRLF ломает некоторые загрузчики Steam Workshop и заставляет игроков исправлять ошибки кодировки, прежде чем мод загрузится.
Изучение файлов данных Ostranauts
Прежде чем вы напишете хотя бы одну строку, потратьте час на чтение оригиналов. Базовая папка data/ содержит примерно два десятка JSON-файлов, каждый из которых привязан к одной игровой системе, и наш справочник файлы данных Ostranauts подробно охватывает каждый из них. Пять файлов, которые вы будете редактировать чаще всего во время ранних экспериментов, перечислены ниже.
| Имя файла | Управляемая система | Распространённые правки |
|---|---|---|
ships.json | Корпуса кораблей, детали, схемы сетки | Добавление новых шаблонов кораблей |
items.json | Груз, инструменты, оружие, расходники | Настройка цен, весов, эффектов |
crew.json | Характеристики NPC, черты, потребности | Регулировка кривых морали, голода, кислорода |
world.json | Солнечная система, станции, товары | Добавление новых зон или товаров |
dialogue.json | Деревья разговоров | Переписывание реплик NPC |
Безопасное чтение JSON
Каждый JSON-файл в Ostranauts начинается с целочисленной версии (например, "version": 4) и массива верхнего уровня. Редактирование одного числа — скажем, скорости потребления кислорода для экипажа — так же просто, как найти соответствующий ключ внутри массива crew.json, скопировать весь объект и изменить только это значение. Всегда дублируйте файл перед любым изменением, чтобы у вас был немедленный откат, если игра откажется запускаться.
Файлы ассетов помимо JSON
Замена спрайтов и аудио требует работы с папкой ostranauts_Data/StreamingAssets/AssetBundles/, что является отдельным рабочим процессом. Для чисто информационных модов — тех, с которых большинству новичков следует начинать — вы можете оставаться внутри data/ и никогда не распаковывать ни один ассет Unity. Это удерживает ваш мод менее 50 КБ, лёгким для контроля версий и легко сравниваемым в Git, когда вы потом будете сравнивать ревизии.
Пошаговое создание вашего первого мода для Ostranauts
Когда вы знаете, где находятся файлы, реальный мод можно создать примерно за двадцать минут. Пошаговое руководство ниже нацелено на дружелюбную новичку цель: удвоение стоимости утилизации каждого обломка в K-Leg, чтобы вы могли позволить себе лучший корабль быстрее. Считайте это каноническим первым проектом для любого руководства по созданию модов для Ostranauts, потому что результат легко проверить в игре, не ломая прогрессию.
Шаг 1: Создание папки мода
Создайте новый каталог с именем KLegDoubleSalvage/ в любом удобном месте на вашем диске. Внутри повторите оригинальную структуру с подпапкой data/. Когда игра загружается, она объединяет всё, что находится внутри папки data/ вашего мода, поверх базовых файлов, поэтому путь внутри вашего мода должен точно совпадать с путём внутри игры — важны заглавные буквы, слэши и расширения файлов.
Шаг 2: Копирование и изменение целевого файла
Скопируйте world.json из базовой папки data/ в папку data/ вашего мода. Откройте копию и найдите ключи salvageValue внутри записей станции K-Leg. Измените каждое числовое значение, умножив на 2, и сохраните. Не поддавайтесь желанию переименовать файл, потому что загрузчик сопоставляет по пути, а не по внутренним идентификаторам, и переименование просто сделает ваши правки невидимыми для движка.
Шаг 3: Создание манифеста
Каждому моду нужен небольшой текстовый дескриптор, чтобы лаунчер мог показать имя и версию. Создайте файл mod.json в корне папки вашего мода со следующими полями:
| Поле | Обязательно | Назначение |
|---|---|---|
name | Да | Отображаемое имя в списке модов |
version | Да | Строка SemVer для проверки обновлений |
author | Да | Идентификатор создателя |
description | Нет | Краткое описание в лаунчере |
dependencies | Нет | Массив идентификаторов требуемых модов |
loadOrder | Нет | Целое число для принудительного упорядочивания |
Шаг 4: Ручная установка и тестирование
Поместите всю папку KLegDoubleSalvage/ в Documents/Ostranauts/mods/, запустите игру и проверьте экран Mods в главном меню. Ваш мод должен появиться с зелёной галочкой. Загрузите сохранение, пристыкуйтесь к K-Leg и утилизируйте ближайший обломок. Если выплата кредитов удвоилась, мод работает. Если лаунчер показывает красный крестик, снова откройте world.json и поищите пропущенную запятую или незакрытую скобку — эти две ошибки составляют примерно восемьдесят процентов первых неудач при загрузке, согласно данным сообщества, опубликованным на официальной вики Ostranauts.
Шаг 5: Публикация в Steam Workshop
Откройте внутриигровой Mod Manager, нажмите Upload и укажите ему на папку вашего мода. Steam обработает генерацию миниатюры, версионирование и распространение. После загрузки ваш мод будет находиться рядом с официальной страницей Ostranauts в Steam, и большинство первых загрузок становятся видны подписчикам в течение часа, потому что валидация чисто синтаксическая.
Продвинутые техники и лучшие практики
Как только ваш первый мод заработает, несколько привычек отделяют одноразовую правку от отшлифованного релиза. Сообщество сходится на нескольких соглашениях за последние несколько лет моддинга того же семейства движков, и принятие их на раннем этапе сделает остальную часть вашего пути по этому руководству по созданию модов для Ostranauts намного более гладкой.
Версионирование и журналы изменений
Присваивайте тег каждому релизу с помощью SemVer и храните CHANGELOG.md внутри папки мода. Игроки будут сообщать об ошибках против конкретных версий, и вам нужно знать, существует ли ошибка в 1.2.0 или только в 1.3.0. Чистый журнал также делает вас профессиональнее при кросс-продвижении с другими авторами на Discord и служит публичным свидетельством вашего дизайнерского замысла для новичков, читающих ваш код.
Избегание распространённых ошибок
Две самые частые ошибки новичков, о которых сообщается в темах сообщества, — это случайное редактирование скомпилированных ассетов и забывание удалить папку мода при тестах отката. Всегда храните папку вашего мода отдельно от базовой установки и всегда делайте резервную копию Documents/Ostranauts/saves/ перед тестированием чего-либо, что затрагивает файлы экипажа, диалогов или экономики, потому что это те системы, в которых сломанный мод может заблокировать сохранение и вынудить перезагрузку с более ранней резервной копии.
Совместимость с другими модами
Когда два мода редактируют items.json, побеждает тот, который загружается последним. Используйте необязательное поле loadOrder в mod.json, чтобы принудительно задать детерминированный порядок, и документируйте любую требуемую позицию загрузки в вашем описании. Моды, которые только добавляют новые записи, редко конфликтуют, тогда как моды, которые редактируют существующие числа, почти всегда конфликтуют, поэтому этикет порядка загрузки так важен в этом рабочем процессе руководства по созданию модов для Ostranauts.
Тестирование, отладка и обмен вашей работой
Мод нельзя считать действительно законченным, пока хотя бы три других человека не запустили его без сбоев. Сообщество Ostranauts маленькое и дружелюбное, а хаб Workshop позволяет легко найти бета-тестеров, готовых проверить новый релиз, прежде чем вы пометите его как стабильный.
Чтение файла журнала
Каждый запуск записывает подробный журнал в Documents/Ostranauts/logs/latest.log. Если ваш мод не загружается, журнал выведет точный путь к файлу и ошибку разбора JSON, которая обычно указывает на потерянную запятую или пропущенную закрывающую скобку. Поищите в журнале mod load failed, чтобы сразу перейти к соответствующему блоку и сэкономить десять минут прокрутки через тысячи информационных строк.
Быстрая итерация
Самый быстрый цикл обратной связи: редактировать, сохранить, переключиться, запустить, перезагрузить сохранение. С практикой полный цикл занимает меньше минуты. Если вы модите файл с большим количеством значений, такой как crew.json, ведите небольшую электронную таблицу с оригинальными числами, чтобы вы могли сравнивать дельты с одного взгляда вместо того, чтобы сравнивать необработанный JSON глазами, и вы обнаружите регрессии, которые чисто текстовое редактирование иначе скрывало бы часами.
Часто задаваемые вопросы
Нужен ли опыт программирования для руководства по созданию модов для Ostranauts?
Нет. Рабочий процесс руководства по созданию модов для Ostranauts построен вокруг редактирования простого JSON, поэтому любой игрок, который может скопировать папку и использовать текстовый редактор, может выпустить функциональный мод. Если вы умеете балансировать чековую книжку, вы можете настроить значения выплат за утилизацию, о которых говорилось ранее. Для более глубоких модов, включающих скриптинг или новые спрайты, базовое знакомство с JSON и Unity помогает, но не требуется для начала.
Где найти файлы данных базовой игры?
Базовые файлы находятся внутри вашего каталога установки Steam по пути SteamLibrary/steamapps/common/Ostranauts/data/. Вы можете попасть туда, щёлкнув правой кнопкой по игре в Steam и выбрав Manage → Browse local files. Копируйте, никогда не редактируйте эти файлы напрямую, потому что каждое изменение должно быть в вашей собственной папке мода, чтобы базовая установка оставалась чистой для проверки.
Сломают ли моды мои файлы сохранений?
Большинство модов на баланс и контент не повреждают сохранения, но моды, которые реструктурируют потребности экипажа, деревья диалогов или компоновки кораблей, могут оставить старые сохранения в несогласованном состоянии. Всегда делайте резервную копию Documents/Ostranauts/saves/ перед тестированием нового мода и избегайте загрузки сохранения, сделанного с активным модом, в ванильную установку. Согласно отчётам сообщества на официальной вики, возврат к сохранению до мода — это самый быстрый путь восстановления, когда что-то идёт не так.
Могу ли я опубликовать мод, сделанный из чужих правок?
Только если у вас есть явное разрешение или оригинальный мод использует разрешительную лицензию, такую как MIT или CC0. Ожидание по умолчанию в сообществе Ostranauts, по словам давних моддеров, — это указание авторства и раскрытие исходного кода. В случае сомнений укажите ссылку на оригинальный мод в вашем описании и отдайте должное автору в mod.json. И игроки, и создатели вознаграждают прозрачность, а хаб Workshop и без того позволяет легко обнаружить плагиат.
Как обновить существующий мод в Steam Workshop?
Откройте внутриигровой Mod Manager, выберите ваш мод и нажмите Upload New Version. Steam повторно использует вашу существующую миниатюру и описание, увеличивая номер версии. Игроки, подписанные на ваш мод, получат обновление автоматически при следующем запуске, поэтому версионирование с помощью SemVer важно — оно сообщает пользователям, является ли изменение хотфиксом или ломающим рефакторингом, который может потребовать от них начать новое сохранение.