Modding:Mod Packaging/ru: Difference between revisions
Mirotworez (talk | contribs) (Created page with "== Значок ==") |
Mirotworez (talk | contribs) (Created page with "'''Примечание:''' Иконки модов поддерживаются, начиная с версии 1.16. Файл <code>modicon.png</code> (если он сущ...") |
||
Line 85: | Line 85: | ||
== Значок == | == Значок == | ||
''' | '''Примечание:''' Иконки модов поддерживаются, начиная с версии 1.16. | ||
Файл <code>modicon.png</code> (если он существует) будет использоваться и отображаться в меню менеджера модов. | |||
[[File:Example Mod.png]] | [[File:Example Mod.png]] |
Revision as of 11:57, 21 February 2022
Эта страница проверялась в последний раз для версии Vintage Story 1.15.
Если ваш мод изменяет только визуальные эффекты, звуки и другие «тематические» активы, см. также страницу Theme Pack.
Zip-файлы
Чтобы мод было легко установить и использовать, его следует запаковать в zip-файл. Любые активы (изображения, файлы .json и т. д.) помещаются в каталог «assets» в корне zip-файла, любые исходные файлы в папку «src», а любые библиотеки DLL (и, возможно, файлы PDB) помещаются непосредственно в zip-файл. Корневая папка.
Обратите внимание, что если у вас есть мод с кодом, который не имеет ресурсов (т. е. ваш мод представляет собой единственную DLL C#), можно отправить чистую DLL, не упаковывая ее в zip-архив. Однако это не очень хорошая идея, так как при таком распространении трудно включить файл PDB, а загрузка DLL непосредственно в Windows может привести к проблемам с загрузкой вашего мода из-за политик безопасности, применяемых к файлам, загруженным из Интернета.
Zip File Structure |
---|
.zip |
assets |
domain |
asset files (tree overview) |
modinfo.json |
modicon.png |
compiled sources files (*.dll and *.pdb) |
src |
source code files - folders allowed (*.cs) |
Информационный файл
Для каждого мода в zip-файле требуется modinfo.json
внутри корневого каталога архива. В противном случае весь мод будет проигнорирован. В этом информационном файле указывается, что это за мод, его название, автор и т. д.
Пример информационного файла пакета тем (modinfo.json
):
{
"type": "content",
"modid": "creativemdexamplemod",
"name": "My Example Content Mod",
"description" : "This is an example mod, which does nothing",
"authors": ["CreativeMD"],
"version": "1.0",
"dependencies": {
"game": "",
"survival": ""
},
"website": "http://example.com"
}
"type": "content",
Помимо"type": "content"
, существует также "type": "theme"
и "type": "code"
.
"type": "content"
: определяет этот мод как Content Mod. Модификации контента не могут содержать код C# (если это так, они будут проигнорированы)."type": "theme"
: определяет этот мод как Theme Pack. Тематические пакеты не могут переопределить игровой процесс, влияющий на категории активов (такие как типы блоков, типы предметов и т. д.), и код C# не будет загружен."type": "code"
: Определяет этот мод как Code Mod. Модификации кода аналогичны модификациям содержимого, за исключением того, что они также могут загружать код C#, чтобы делать то, что невозможно с помощью JSON.
"dependencies": {
"game": "1.5.3"
},
Означает, что для этого требуется как минимум VintageStory v1.5.3 или более новая версия. Для получения дополнительной информации см. модинфо.
Значок
Примечание: Иконки модов поддерживаются, начиная с версии 1.16.
Файл modicon.png
(если он существует) будет использоваться и отображаться в меню менеджера модов.
Distribution and Installation
To install a mod simply place the zip file in the Mods
directory in your Vintagestory directory.
You can upload your mod to the Vintage Story Mod Database so people can find it.
![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 |