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

From Vintage Story Wiki
Revision as of 19:53, 3 July 2024 by LiokoCoder (talk | contribs)
Other languages:

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


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

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

Поиск по вики

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

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

Текущая система моддинга для Vintage Story невероятно гибкая и довольно простая в использовании, даже если вы не умеете программировать. Вы можете добавлять в игру полнофункциональные блоки, предметы и даже сущности, даже не открывая IDE. Более сложные изменения и системы могут быть внесены с помощью программирования на C#.

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

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

Типы модов

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

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

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

Если вы только начинаете, лучше всего начать с Content Mod, так как большинство модификаций кода просто расширяют возможности блоков, элементов и сущностей, созданных на основе Content Mod. Как только вы освоите Content Mods, вы сможете приступить к написанию кода, если хотите добавить что-то действительно особенное в свою 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