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. После того, как вы загрузили файл, вы можете просто добавить его в проект, щелкнув правой кнопкой мыши проект и выбрав «Добавить -> Добавить файлы...», затем перейдя к файлу и нажав «Открыть». ', затем Скопируйте файл в каталог и ОК.

Additional command line arguments when debugging

• -oFoobar open a world named "foobar", if it doesn't exists it will create a new one
• -pcreativebuilding new worlds are created with given playstyle ("surviveandbuild" or "creativebuilding" by default)
• --rndWorld always creates a new world with an incrementing file name

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.