Modding:Basic Block/ru: Difference between revisions

Пожалуйста, сначала прочитайте руководство [[Modding:The_Asset_System|Система активов]], если вы этого еще не сделали. Это руководство познакомит вас с основами добавления блоков в игру, используя JSON файлы. Если вы хотите добавить функциональный блок, то вам необходимо изучить руководство по [[Advanced Blocks|Продвинутым блокам]]. С полным списком свойств которые вы можете использовать в json файлах, вы можете ознакомиться [[Block Json Properties|здесь]].

Мы будем использовать эту текстуру для нашего блока: [[File:Gold block.png]].

Теперь вам нужно создать новый файл json в вашем редакторе (мы рекомендуем использовать редактор с подсветкой синтаксиса, такой как [https://notepad-plus-plus.org/ Notepad++] или Visual Studio).

code: "mygoldblock",

creativeinventory: { "general": ["*"] },

blockmaterial: "Stone",

drawtype: "Cube",

textures: {

all: { base: "block/mygoldtexture" }

resistance: 3.5,

sounds: {

Чтобы установить мод, перейдите к [[Vintagestory folder|папке Vintage Story]] и поместите его в папку модов.

textures: {

all: {  

base: "block/mygoldtexture",

alternates: [{base: "block/mygoldtexture1" }, {base: "block/mygoldtexture2" }, {base: "block/mygoldtexture3" }],

Теперь нам нужно изменить несколько вещей в нашем файле JSON. Мы можем добавлять все виды различных групп, но пока мы сохраняем это простым. Мы добавляем группу под названием <code>type</code>, с состояниями <code>gold</code> и <code>iron</code>. Вы можете использовать любой код группы, который вы хотите.

variantgroups: [

{ code: "type", states: ["gold", "iron"] }

texturesbytype: {

all: {  

base: "block/mygoldtexture",

alternates: [{base: "block/mygoldtexture1" }, {base: "block/mygoldtexture2" }, {base: "block/mygoldtexture3" }],

all: {  

base: "block/myirontexture",

alternates: [{base: "block/myirontexture1" }, {base: "block/myirontexture2" }, {base: "block/myirontexture3" }],

textures: {

all: {  

base: "block/my{type}texture",

alternates: [{base: "block/my{type}texture1" }, {base: "block/my{type}texture2" }, {base: "block/my{type}texture3" }],

code: "myshinyblock",

creativeinventory: { "general": ["*"] },

variantgroups: [

{ code: "type", states: ["gold", "iron"] }

blockmaterial: "Stone",

drawtype: "cube",

textures: {

all: {  

base: "block/my{type}texture",

alternates: [{base: "block/my{type}texture1" }, {base: "block/my{type}texture2" }, {base: "block/my{type}texture3" }],

resistance: 3.5,

sounds: {

variantgroups: [

{ code: "type", states: ["gold", "iron"] },

{ code: "condition", states: ["good", "used"]}

texturesbytype: {

all: {  

base: "block/my{type}texture",

all: {  

base: "block/my{type}texture",

alternates: [{base: "block/my{type}texture1" }, {base: "block/my{type}texture2" }, {base: "block/my{type}texture3" }],

== Пользовательские формы (модели) ==

Therefore we will change the drawtype from <code>cube</code> to <code>json</code>:

drawtype: "json",

and the shape to <code>myshinymodel</code>

shape: { base: "block/myshinymodel" },

Although this would be enough theoretically, we also should determine this block as being non-solid, to prevent graphical glitches.

sidesolid: {

all: "false"

sideopaque: {

all: "false"

So let's run the game. This is how it should look like:

== Variants of Custom Shapes ==

I created another model for the blocks in good condition ([https://wiki.vintagestory.at/images/f/fa/Myshinymodel1.json myshinymodel1.json]), because they should look more awesome, than the ones in used conditions. Therefore we need to copy the json file to <code>assets/myshinyblock/shapes/block/</code> as well.

In order to specify the shape by type we need to remove the property <code>shape</code> and replace it with <code>shapebytype</code>:

shapebytype: {

base: "block/myshinymodel1",

base: "block/myshinymodel",

= Mod Download =

You can find the complete mod here for reference:

= Moving Forward =

The example shown here, while seemingly complex, only scratches the surface of what blocktypes are capable of in Vintage Story. It's highly suggested that you experiment with or at least familiarize yourself with all the known block properties before moving onto code mods. The best way to do this is to peruse the '''[[Modding:Block Json Properties | Block Properties]]''' page, which contains an ongoing list of all the usable JSON block properties currently incorporated into the game. Most properties in the list also have referenced files you can search for in the Vintage Story Assets folder. If you don't know where this is, you can find tutorials for each operating system at the [[Modding:The Asset System | Asset System]] page.  

If you haven't yet, it's suggested you also check out the '''[[Modding:Basic Item | Basic Item]]''' and '''[[Modding:Basic Entity | Basic Entity]]''' pages to learn how simple JSON items and entities are added to the game.  

However, if you're feeling like making the jump to code mods then you'll want to start by setting up your '''[[Modding: Setting up your Development Environment | Development Environment]]'''.