Modding:Начало работы
Эта страница проверялась в последний раз для версии 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, и вы будете постоянно использовать эти ресурсы при создании модов.
Чтобы перейти к модификации контента, перейдите на страницу Content Mods. Чтобы начать с тематического пакета, перейдите на страницу Theme Pack.
![Icon Sign.png](/images/thumb/1/15/Icon_Sign.png/32px-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 | Item • Entity • Block • Block Behaviors • Block Classes • Block Entities • Block Entity Behaviors • World properties |
Workflows & Infrastructure | Modding Efficiency Tips • Mod-engine compatibility • Mod Extensibility • VS Engine |
Additional Resources | Community Resources • Modding API Updates • Programming Languages • List of server commands • List of client commands • Client startup parameters • Server startup parameters Example Mods • API Docs • GitHub Repository |