Modding:Getting Started/ru: Difference between revisions

From Vintage Story Wiki
(Created page with "В Vintage Story встроена обширная система моддинга, позволяющая любому пользователю вносить свои изм...")
No edit summary
Tags: Mobile edit Mobile web edit
 
(43 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>{{GameVersion|1.15}}
<languages/>{{GameVersion|1.19.6}}


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


For an overview of the game's modding system and philosophy, refer to the [https://www.vintagestory.at/features/modding.html/ Modding] page on the Vintage Story website.
Прежде чем приступить к работе, важно понять, чего вы хотите достичь, чтобы знать, чего ожидать.  


Before you get started, it's important to understand what you would like to accomplish so you can know what to expect.  
__TOC__
 
== Поиск по вики ==
По умолчанию поиск по вики не выдаёт страницы о создании модов. Чтобы изменить настройки поиска, нажмите кнопку "Найти в Modding" ниже. На странице результатов будет показано, что проверены пространства имен (Основное), BlockJson и Modding. Установите флажок "Запомнить в будущем", затем нажмите "Найти", чтобы сохранить изменения.
 
{{#tag:inputbox|
type=search
namespaces=Main**,Modding**,BlockJson**
break=no
width=40
searchbuttonlabel=Найти в Modding
}}


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


== What Mods can I make? ==
Текущая система моддинга для Vintage Story невероятно гибкая и довольно простая в использовании, даже если вы не умеете программировать. Вы можете добавлять в игру полнофункциональные '''блоки''', '''предметы''' и даже '''сущности''', даже не открывая [https://en.wikipedia.org/wiki/Integrated_development_environment IDE]. Более сложные изменения и системы могут быть внесены с помощью программирования на C#.


The current modding system for Vintage Story is incredibly flexible and quite easy to use even if you don't know how to program. You can add fully functional '''blocks''', '''items''' and even '''entities''' into the game without ever opening an [https://en.wikipedia.org/wiki/Integrated_development_environment IDE]. Although it is recommended you learn how to use one if you plan on modding a lot in the future, as they are very convenient.  
Это связано с тем, что почти каждая функция игры основана на использовании '''JSONов''', которые представляют собой текстовые документы в гибком, удобном для чтения формате. Вы можете открыть эти файлы в любом текстовом редакторе, и, немного попрактиковавшись, вы сможете научиться их форматировать, чтобы избежать ошибок. Лучший способ научиться этому - изучить существующие JSON-файлы, которые видны всем, у кого установлена игра. Для этого вам нужно будет найти папку Vintage Story Assets, о которой вы можете узнать на странице '''[[Modding:Asset System/ru|Asset System]]'''. Кроме того, вот [https://www.youtube.com/watch?v=94fHz4w65PY обучающее видео], которое расскажет вам, почему используется json, и об основном синтаксисе, что облегчит понимание остальной документации.


This is because nearly every feature of the game relies on the usage of '''JSONs''', which are text documents that utilize a flexible, easy to read format. You can open these files with any text editor, and with just a little bit of practice you can learn how to format them to avoid errors. The best way to learn this is to study the existing JSONs that are visible to anybody who has the game installed. To do so you'll need to locate the Vintage Story Assets folder, which you can learn about at the '''[[Modding:The Asset System | Asset System]]''' page.
Если вы хотите добавить более сложные системы в Vintage story, вы также можете это сделать, но, скорее всего, вы не сможете сделать это только с помощью JSON. Vintage Story написана на C#, и настоятельно рекомендуется изучить основы программирования и C# в целом, прежде чем переходить к более сложным модификациям, которые невозможно реализовать только с помощью JSON.


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 ==
В целом существует 3 основных типа модов, которые можно создать для Vintage Story, каждый из которых имеет разные уровни сложности:


In general there are 3 main types of mods one can create for Vintage Story, with each having different levels of complexity:
* [[Modding:Theme Pack/ru|Theme Pack]]: это моды, которые влияют только на визуальные эффекты и не добавляют больше контента или существенно не изменяют функции.
* [[Modding:Content Mods/ru|Content Mods]]: это моды, которые добавляют в игру дополнительный контент (например, блоки, предметы, мобов), но не используют код C# и в основном ограничиваются JSON.
* [[Modding:Code Mods/ru|Code Mods]]: это моды, добавляющие более сложные функции и системы, для реализации которых требуется использование кода C#.


* [[Modding:Theme Packs | Theme Packs]]: These are mods that only affect visuals and don't add more content or change features significantly.
= Дальнейшее продвижение =
* [[Modding:Content Mods | 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.
* [[Modding:Code Mods | Code Mods]]: These are mods that add more complex features and systems that require the use of C# code to accomplish.


== Moving Forward ==
Если вы только начинаете, лучше всего начать с Content Mod, так как большинство модификаций кода просто расширяют возможности блоков, элементов и сущностей, созданных на основе Content Mod. Как только вы освоите Content Mods, вы сможете приступить к написанию кода, если хотите добавить что-то действительно особенное в свою Vintage Story.


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


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.  
Первое, что нужно сделать, приступая к своим первым действиям, - ознакомиться с '''[[Modding:Asset System|Asset System]]'''. Именно здесь происходит большая часть волшебства в Vintage Story, и вы будете постоянно использовать эти ресурсы при создании модов.  


The first thing you can do while starting your first content mod is to familiarize yourself with the '''[[Modding:The Asset System | Asset System]]'''. This is where most of the magic in Vintage Story is accomplished, and you'll be using these resources constantly while modding.  
Чтобы перейти к Content Mod, перейдите на страницу [[Modding:Content Mods/ru|Content Mods]].
Чтобы начать с Theme Pack, перейдите на страницу [[Modding:Theme_Pack/ru|Theme Pack]].


{{Navbox/modding|Vintage Story}}
{{Navbox/modding/ru|Vintage Story}}

Latest revision as of 22:02, 3 July 2024

Other languages:

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


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

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

Поиск по вики

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

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

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

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

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

Типы модов

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

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

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

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

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

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

Чтобы перейти к Content Mod, перейдите на страницу Content Mods. Чтобы начать с Theme Pack, перейдите на страницу Theme Pack.

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


Retrieved from "https://wiki.vintagestory.at/index.php?title=Modding:Getting_Started/ru&oldid=187177"