|
|
| Line 1: |
Line 1: |
| <languages/>
| | {{Delete|Outdated duplicate of [[Modding:Setting up your Development Environment/ru]].}} |
| Этот туториал посвящен продвинутому моддингу. Он должен научить вас, как настроить среду разработки, и познакомить вас с основами Mono Develop, этот учебник был написан для Linux, если вы используете Windows, вы можете использовать [[Advanced_Modding/ru|Visual Studio]].
| |
| | |
| == Установить VintageStory ==
| |
| В первую очередь скачайте VintageStory и убедитесь, что у вас установлена самая новая версия игры, иначе могут возникнуть ошибки.
| |
| | |
| == Установить FlatPak ==
| |
| Мы будем использовать FlatPak для установки MonoDevelop, поэтому, если у вас уже есть FlatPak, вы можете пропустить этот шаг. У FlatPak есть собственные руководства для многих дистрибутивов [http://flatpak.org/getting.html здесь].
| |
| | |
| == Установить MonoDevelop ==
| |
| Теперь пришло время установить MonoDevelop, а с FlatPak это всего одна команда.
| |
| Просто откройте терминал и выполните следующую команду.
| |
| <br />
| |
| <code>flatpak install --user --from https://download.mono-project.com/repo/monodevelop.flatpakref</code>
| |
| <br />
| |
| Это может занять несколько минут в зависимости от вашего интернет-соединения. (Последняя версия на момент написания статьи весила около 275 МБ.)
| |
| | |
| Чтобы открыть MonoDevelop, запустите в терминале <code>flatpak run com.xamarin.MonoDevelop</code>.
| |
| | |
| == Обзор API ==
| |
| Интерфейс API в основном задокументирован, но если вам нужна справочная документация, она доступна по адресу [http://apidocs.vintagestory.at].
| |
| | |
| Примеры модов доступны на Github: [https://github.com/tyronx/vsmodexamples]
| |
| | |
| == Создание решения (проектная группа) ==
| |
| * Откройте MonoDevelop и создайте новое решение с помощью: '''Файл -> Новое решение...''' (в верхнем левом углу).
| |
| * Выберите '''.NET -> Library''' в качестве шаблона.
| |
| [[File:mono_new_library.png|800px]]
| |
| * Нажмите "Далее.
| |
| * Задайте свое '''Имя проекта''', см. пример ниже, не меняйте путь, если хотите продолжить, оставьте его в покое.
| |
| [[File:mono_new_library_2.png|800px]]
| |
| * Нажмите Создать. Теперь вы должны получить экран, который выглядит примерно так:
| |
| [[File:mono_new_cs_file.png|800px]]
| |
| * Щелкните правой кнопкой мыши проект (выделенный ниже) и выберите «Параметры».
| |
| [[File:mono_project_menu.png]]
| |
| * Нажмите «Выполнить» -> «Конфигурации» -> «По умолчанию» (выделено ниже).
| |
| [[File:mono_run_config_menu.png]]
| |
| * Установите значения, как показано ниже, но замените «cynthia» на ваше имя пользователя и «MyCoolMod» на имя вашего проекта и нажмите «ОК».
| |
| [[File:mono_run_config.png]]
| |
| * Щелкните проект правой кнопкой мыши еще раз и выберите "Добавить -> Новый файл...".
| |
| * Нажмите «Разное -> Пустой текстовый файл» и установите «launchmod.sh» в качестве имени, нажмите «Новый».
| |
| [[File:mono_new_file.png]]
| |
| * Вставьте содержимое раздела '''launchmod.sh''' этой страницы в новый файл ''launchmod.sh'' и сохраните его.
| |
| * Щелкните правой кнопкой мыши "Ссылки" и выберите "Редактировать ссылки...".
| |
| * Щелкните вкладку '''.Net Assembly''' и щелкните '''Обзор...'''.
| |
| * Перейдите по пути установки Vintage Story (<code>/home/yourusernamehere/ApplicationData/vintagestory</code>) и щелкните файл <code>VintagestoryAPI.dll</code>.
| |
| * Нажмите «Открыть».
| |
| * Нажмите «ОК».
| |
| | |
| === Тестирование ===
| |
| * Нажмите «Выполнить -> Запустить без отладки» или нажмите «CTRL + F5».
| |
| * Vintage Story должна запуститься.
| |
| | |
| === launchmod.sh ===
| |
| <code>
| |
| <nowiki>#!/bin/bash</nowiki><br />
| |
| <nowiki>VINTAGE_PATH="${HOME}/ApplicationData/vintagestory/"</nowiki><br />
| |
| <nowiki>MOD_PATH="${VINTAGE_PATH}Mods/"</nowiki><br />
| |
| <nowiki>cd ${VINTAGE_PATH}</nowiki><br />
| |
| <nowiki>mono Vintagestory.exe -oTestworld -pcreativebuilding</nowiki><br />
| |
| </code>
| |
| | |
| == Подключить ведение журнала ==
| |
| Если вы хотите, вы можете скачать [[File:RedirectLogs.cs]] и добавить его в свой проект, что позволит увидеть журнал Vintagestory в MonoDevelop. После того, как вы загрузили файл, вы можете просто добавить его в проект, щелкнув правой кнопкой мыши проект и выбрав «Добавить -> Добавить файлы...», затем перейдя к файлу и нажав «Открыть». ', затем '''Скопируйте файл в каталог''' и '''ОК'''.
| |
| | |
| == Дополнительные аргументы командной строки при отладке ==
| |
| * -oFoobar открыть мир с именем "foobar", если он не существует, он создаст новый
| |
| * -pcreativebuilding новый мир создаётся с заданным стилем игры ("выжить и построить" или "творческое строительство" по умолчанию)
| |
| * --rndWorld всегда создает новый мир с увеличивающимся именем файла
| |
| | |
| {{Navbox/modding|Vintage Story}}
| |
