Modding:Начало работы

From Vintage Story Wiki
This page is a translated version of the page Modding:Getting Started and the translation is 70% complete.
Outdated translations are marked like this.
Other languages:

Эта страница проверялась в последний раз для версии Vintage Story 1.15.

В Vintage Story встроена обширная система моддинга, позволяющая любому пользователю вносить свои изменения и дополнения по своему усмотрению.

Прежде чем приступить к работе, важно понять, чего вы хотите достичь, чтобы знать, чего ожидать.

Поиск по вики

По умолчанию поиск по вики не выдаёт страницы о создании модов. Чтобы изменить настройки поиска, нажмите кнопку "Найти в Modding" ниже. На странице результатов будет показано, что проверены пространства имен (Основное), BlockJson и Modding. Установите флажок "Запомнить в будущем", затем нажмите "Найти", чтобы сохранить изменения.

Какие моды я могу сделать?

Нынешняя система моддинга для Vintage Story невероятно гибкая и довольно простая в использовании, даже если вы не знаете, как программировать. Вы можете добавлять в игру полнофункциональные блоки, предметы и даже сущности, даже не открывая IDE. Хотя рекомендуется научиться использовать её, если вы планируете много модифицировать в будущем, так как она очень удобна.

Это связано с тем, что почти каждая функция игры основана на использовании JSONов, которые представляют собой текстовые документы, использующие гибкий, удобный для чтения формат. Вы можете открыть эти файлы в любом текстовом редакторе, и, немного потренировавшись, вы научитесь форматировать их, чтобы избежать ошибок. Лучший способ узнать это — изучить существующие файлы JSON, которые видны всем, у кого установлена игра. Для этого вам нужно найти папку Vintage Story Assets, о которой вы можете узнать на странице системы ассетов.
Кроме того, в этом 12-минутном видео вы узнаете, почему используется json, и основному синтаксису, что облегчит понимание остальной документации.

Если вы хотите добавить более сложные системы в Vintage story, вы также можете это сделать, но, скорее всего, вы не сможете сделать это только с помощью JSON. Vintage Story написана на C#, и настоятельно рекомендуется изучить основы программирования и C# в целом, прежде чем переходить к более сложным модификациям, которые невозможно реализовать только с помощью JSON.

Типы модов

В целом существует 3 основных типа модов, которые можно создать для Vintage Story, каждый из которых имеет разные уровни сложности:

  • Пакеты тем: это моды, которые влияют только на визуальные эффекты и не добавляют больше контента или существенно не изменяют функции.
  • Моды контента: это моды, которые добавляют в игру дополнительный контент (например, блоки, предметы, мобов), но не используют код C# и в основном ограничиваются JSON.
  • Модификации кода: это моды, добавляющие более сложные функции и системы, для реализации которых требуется использование кода C#.

Дальнейшее продвижение

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

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

Первое, что вы можете сделать при запуске своего первого мода контента, это ознакомиться с системой ассетов. Именно здесь совершается большая часть волшебства в Vintage Story, и вы будете постоянно использовать эти ресурсы при создании модов.

To move on with a content mod, head over to the Content Mods page. To start with a theme pack, head over to the Theme Pack page.

Icon Sign.png

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.

Modding
Modding Introduction Getting Started Пакет тем
Content Modding Content Mods Developing a Content Mod Basic Tutorials Intermediate Tutorials Advanced Tutorials Content Mod Concepts
Code Modding Code Mods Setting up your Development Environment
Property Overview ItemEntityBlockBlock BehaviorsBlock ClassesBlock EntitiesBlock Entity BehaviorsWorld properties
Workflows & Infrastructure Modding Efficiency TipsMod-engine compatibilityMod ExtensibilityVS Engine
Additional Resources Community Resources Modding API Updates Programming Languages List of server commandsList of client commandsClient startup parametersServer startup parameters
Example ModsAPI DocsGitHub Repository