Modding:Начало работы
Эта страница проверялась в последний раз для версии Vintage Story 1.15.
В Vintage Story встроена обширная система моддинга, позволяющая любому пользователю вносить свои изменения и дополнения по своему усмотрению.
Обзор системы моддинга и философии игры см. на странице [1] на веб-сайте Vintage Story.
Прежде чем приступить к работе, важно понять, чего вы хотите достичь, чтобы знать, чего ожидать.
Какие моды я могу сделать?
Нынешняя система моддинга для Vintage Story невероятно гибкая и довольно простая в использовании, даже если вы не знаете, как программировать. Вы можете добавлять в игру полнофункциональные блоки, предметы и даже сущности, даже не открывая IDE. Хотя рекомендуется научиться использовать её, если вы планируете много модифицировать в будущем, так как она очень удобна.
Это связано с тем, что почти каждая функция игры основана на использовании «JSON», которые представляют собой текстовые документы, использующие гибкий, удобный для чтения формат. Вы можете открыть эти файлы в любом текстовом редакторе, и, немного потренировавшись, вы научитесь форматировать их, чтобы избежать ошибок. Лучший способ узнать это — изучить существующие файлы JSON, которые видны всем, у кого установлена игра. Для этого вам нужно найти папку Vintage Story Assets, о которой вы можете узнать на странице Страница системы ассетов.
If you're looking to add more complex systems to Vintage story you can accomplish this as well, but you likely won't be able to do this with JSONs alone. Vintage Story is written in C#, and it is highly suggested you learn the basics of programming and of C# in general before moving onto more complex mods that can't be accomplished with just JSONs.
Types of Mods
In general there are 3 main types of mods one can create for Vintage Story, with each having different levels of complexity:
- Theme Packs: These are mods that only affect visuals and don't add more content or change features significantly.
- Content Mods: These are mods that add additional content (i.e. blocks, items, mobs) to the game but don't utilize C# code and are mostly limited to JSONs.
- Code Mods: These are mods that add more complex features and systems that require the use of C# code to accomplish.
Moving Forward
If you're just starting out it is certainly best to begin with a content mod, as most code mods simply extend the features of blocks, items and entities made from a content mod anyway. Once you've mastered content mods you can move onto coding if you want to add some really special things to your Vintage Story experience.
More advanced programmers may be tempted to jump to code mods immediately, but it is still highly suggested you familiarize yourself with content mods first since you'll almost certainly be using them in tandem with any C# code you write.
The first thing you can do while starting your first content mod is to familiarize yourself with the Asset System. This is where most of the magic in Vintage Story is accomplished, and you'll be using these resources constantly while modding.
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 |