Modding:Setting up your Linux Development Environment/ru

Этот туториал посвящен продвинутому моддингу. Он должен научить вас, как настроить среду разработки, и познакомить вас с основами Mono Develop, этот учебник был написан для Linux, если вы используете Windows, вы можете использовать Visual Studio.

Установить VintageStory

В первую очередь скачайте VintageStory и убедитесь, что у вас установлена самая новая версия игры, иначе могут возникнуть ошибки.

Установить FlatPak

Мы будем использовать FlatPak для установки MonoDevelop, поэтому, если у вас уже есть FlatPak, вы можете пропустить этот шаг. У FlatPak есть собственные руководства для многих дистрибутивов здесь.

Установить MonoDevelop

Теперь пришло время установить MonoDevelop, а с FlatPak это всего одна команда. Просто откройте терминал и выполните следующую команду.
flatpak install --user --from https://download.mono-project.com/repo/monodevelop.flatpakref
Это может занять несколько минут в зависимости от вашего интернет-соединения. (Последняя версия на момент написания статьи весила около 275 МБ.)

Чтобы открыть MonoDevelop, запустите в терминале flatpak run com.xamarin.MonoDevelop.

Обзор API

Интерфейс API в основном задокументирован, но если вам нужна справочная документация, она доступна по адресу [1].

Примеры модов доступны на Github: [2]

Создание решения (проектная группа)

• Откройте MonoDevelop и создайте новое решение с помощью: Файл -> Новое решение... (в верхнем левом углу).
• Выберите .NET -> Library в качестве шаблона.

• Нажмите "Далее.
• Задайте свое Имя проекта, см. пример ниже, не меняйте путь, если хотите продолжить, оставьте его в покое.

• Нажмите Создать. Теперь вы должны получить экран, который выглядит примерно так:

• Щелкните правой кнопкой мыши проект (выделенный ниже) и выберите «Параметры».

• Нажмите «Выполнить» -> «Конфигурации» -> «По умолчанию» (выделено ниже).

• Установите значения, как показано ниже, но замените «cynthia» на ваше имя пользователя и «MyCoolMod» на имя вашего проекта и нажмите «ОК».

• Щелкните проект правой кнопкой мыши еще раз и выберите "Добавить -> Новый файл...".
• Нажмите «Разное -> Пустой текстовый файл» и установите «launchmod.sh» в качестве имени, нажмите «Новый».

• Вставьте содержимое раздела launchmod.sh этой страницы в новый файл launchmod.sh и сохраните его.
• Щелкните правой кнопкой мыши "Ссылки" и выберите "Редактировать ссылки...".
• Щелкните вкладку .Net Assembly и щелкните Обзор....
• Перейдите по пути установки Vintage Story (/home/yourusernamehere/ApplicationData/vintagestory) и щелкните файл VintagestoryAPI.dll.
• Нажмите «Открыть».
• Нажмите «ОК».

Тестирование

• Нажмите «Выполнить -> Запустить без отладки» или нажмите «CTRL + F5».
• Vintage Story должна запуститься.

launchmod.sh

#!/bin/bash
VINTAGE_PATH="${HOME}/ApplicationData/vintagestory/"
MOD_PATH="${VINTAGE_PATH}Mods/"
cd ${VINTAGE_PATH}
mono Vintagestory.exe -oTestworld -pcreativebuilding


Подключить ведение журнала

Если вы хотите, вы можете скачать File:RedirectLogs.cs и добавить его в свой проект, что позволит увидеть журнал Vintagestory в MonoDevelop. После того, как вы загрузили файл, вы можете просто добавить его в проект, щелкнув правой кнопкой мыши проект и выбрав «Добавить -> Добавить файлы...», затем перейдя к файлу и нажав «Открыть». ', затем Скопируйте файл в каталог и ОК.

Дополнительные аргументы командной строки при отладке

• -oFoobar открыть мир с именем "foobar", если он не существует, он создаст новый
• -pcreativebuilding новый мир создаётся с заданным стилем игры ("выжить и построить" или "творческое строительство" по умолчанию)
• --rndWorld всегда создает новый мир с увеличивающимся именем файла

Wondering where some links have gone?
The modding navbox is going through some changes! Check out Navigation Box Updates for more info and help finding specific pages.