Редактирование:Создание блоков и предметов

<div class="mw-parser-output"><div class="mw-parser-output"><h3> Регистрация ID </h3>
<p>ID - уникальный идентификатор блока\предмета, задается строкой и натуральным числом, которое сопоставляется этой строке. Чтобы зарегистрировать ID, используется модуль IDRegistry.
</p><p>Для регистрации ID блока используется метод IDRegistry.genBlockID("строковый ID") - после вызова этой функции сгенерируется новый уникальный ID для блока, доступ к числовому значению которого может быть произведен как BlockID.&lt;строковый ID&gt;
</p><p>Для регистрации ID предмета используется метод IDRegistry.genItemID("строковый ID") - после вызова этой функции сгенерируется новый уникальный ID для предмета, доступ к числовому значению которого может быть произведен как ItemID.&lt;строковый ID&gt;
</p><p>Примеры:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">IDRegistry.genBlockID(&quot;testBlock&quot;); // доступ BlockID.testBlock
IDRegistry.genItemID(&quot;testItem&quot;); // доступ ItemID.testItem</syntaxhighlight></pre>
</p>
<div class="mw-parser-output">
<h3> Текстуры </h3>
<p>В ресурсах мода текстуры блоков и предметов задаются в определенном формате: каждая текстура должна быть в формате .png и имеет имя и номер, название любой текстуры выглядит так: имя_номер.png и никак иначе. Номера текстур с одним именем должны идти последовательно и начинаться с 0.
</p><p>Текстуры блоков в ресурспаке располагаются по адресу res/terrain-atlas/
</p><p>Текстуры предметов&#160;в ресурспаке располагаются по адресу res/items-opaque/
</p><p>Текстуры брони в ресурспаке располагаются по адресу res/armor
</p>
</div> 
<h3> Создание блоков </h3>
<p>После регистрации ID для блока, создается сам блок на этом ID. На одном ID может быть создано несколько вариаций блока, каждая из которых обладает своим именем и текстурой, разные вариации одного блока в мире будут иметь один ID, но разные значения metadata, подробнее об этом будет позднее. Для создания блоков используется модуль Block.
</p><p>Метод Block.createBlock("строковый ID", [вариация1, вариация2, ...]) - создает блок и все его вариации на ранее зарегистрированном ID, если вариация 1, то просто создает данный блок.
</p><p>Каждая вариация в массиве имеет формат
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">{
    name: &quot;имя вариации&quot;, 
    texture: [
        [&quot;текстура 1&quot;, &lt;номер текстуры 1&gt;], 
        [&quot;текстура 2&quot;, &lt;номер текстуры 2&gt;], 
        [&quot;текстура 3&quot;, &lt;номер текстуры 3&gt;], 
        [&quot;текстура 4&quot;, &lt;номер текстуры 4&gt;], 
        [&quot;текстура 5&quot;, &lt;номер текстуры 5&gt;], 
        [&quot;текстура 6&quot;, &lt;номер текстуры 6&gt;]
    ], 
    inCreative: true/false //(добавлять ли данную вариацию блока в креатив)
}</syntaxhighlight></pre>
</p><p>Если текстур указано меньше, чем 6, то последняя из них будет дублирована несколько раз, чтобы дополнить их кол-во до 6.
</p><p><b>Пример</b>:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">IDRegistry.genBlockID(&quot;testBlock&quot;); // регистрация
Block.createBlock(&quot;testBlock&quot;, [
     {name: &quot;test block&quot;, texture: [[&quot;planks&quot;, 0], [&quot;planks&quot;, 0], [&quot;planks&quot;, 0], [&quot;planks&quot;, 0], [&quot;planks&quot;, 0], [&quot;planks&quot;, 0]], inCreative: true}
]); // создание простого блока на ID &quot;testBlock&quot; с текстурой досок на всех сторонах, будет добавлен в креатив</syntaxhighlight></pre>
</p>
<div class="mw-parser-output"><div class="mw-parser-output">
<h4> Создание блоков с поворотом </h4>
<p>Метод Block.createBlockWithRotation -&#160;&#160;принимает те же аргументы, что и Block.createBlock, но для каждой вариации блока создает 4 вариации, которые реализуют поворот, блок, созданный этим методом, автоматически будет ставиться с нужным поворотом.
</p>
</div> </div> 
<h3> Создание предметов </h3>
<p>После регистрации ID предмета, создается сам предмет на этом ID. Предметы могут быть разных типов: обычный, броня, еда и кидаемый, для каждого из них существует свой метод. Для создания предметов используется модуль Item. Каждый предмет имеет текстуру, которая задается в формате {name: "имя текстуры", meta: &lt;номер текстуры&gt;}, если номер текстуры 0, его можно не указывать.
</p><p>Item.createItem("строковый ID", "имя предмета", текстура, параметры) - создает обычный предмет на ранее зарегистрированном строковом ID, с данным именем, текстурой и параметрами.
</p><p>Параметры имеют формат, если вы не хотите изменять значения по умолчанию, просто не пишите их:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">{
     isTech: false, // если true, не добавляет предмет в креатив
     stack: 64 // размер стака
} </syntaxhighlight></pre>
</p><p><b>Пример</b>:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="JavaScript">IDRegistry.genItemID(&quot;testItem&quot;);
Item.createItem(&quot;testItem&quot;, &quot;test item&quot;, {name: &quot;stick&quot;, meta: 0}, {}); // создаем обычный предмет на ID testItem с текстурой палки и стандартными параметрами</syntaxhighlight></pre>
</p>
<h4> Создание еды </h4>
<p>Item.createFoodItem("строковый ID", "имя предмета", текстура, параметры) - создает съедобный предмет на ранее зарегистрированном строковом ID, с данным именем, текстурой и параметрами.
</p><p>Параметры имеют формат, если вы не хотите изменять значения по умолчанию, просто не пишите их:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">{
     isTech: false,// если true, не добавляет предмет в креатив
     stack: 64, // размер стака
     food: 1 // восполнение здоровья едой
}</syntaxhighlight></pre>
</p>
<h4> Создание кидаемого предмета </h4>
<p>Item.createThrowableItem("строковый ID", "имя предмета", текстура, параметры) - создает кидаемый предмет на ранее зарегистрированном строковом ID, с данным именем, текстурой и параметрами.
</p><p>Параметры имеют формат, если вы не хотите изменять значения по умолчанию, просто не пишите их:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">{
     isTech: false, // если true, не добавляет предмет в креатив
     stack: 64 // сколько предметов будет в одном стаке, максимум 64.
}</syntaxhighlight></pre>
</p>
<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">
<p><b>Пример</b>:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="JavaScript">IDRegistry.genItemID(&quot;throwableItem&quot;);&amp;nbsp;
Item.createThrowableItem(&quot;throwableItem&quot;, &quot;Throwable Item&quot;, { name: &quot;throwable_item&quot;, meta: 0}, {})
</syntaxhighlight></pre>
</p>
</div> </div> </div> </div> </div> </div> 
<h4> Создание брони </h4>
<pre>Item.createArmorItem(&amp;quot;строковый ID&amp;quot;, &amp;quot;имя предмета&amp;quot;, текстура, параметры) - создает предмет брони на ранее зарегистрированном строковом ID, с данным именем, текстурой и параметрами.</pre>
<p>Параметры имеют формат, если вы не хотите изменять значения по умолчанию, просто не пишите их:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">{
     isTech: false, // если true, не добавляет предмет в креатив
     armor: 1, // количество добавляемой брони в шкале защиты
     type: &lt;обязательное значение&gt;, // тип предмета &quot;helmet&quot;/&quot;chestplate&quot;/&quot;leggings&quot;/&quot;boots&quot;
     texture: &lt;обязательное значение&gt;, // текстура модели данной брони
     durability: 1 // прочность брони
}</syntaxhighlight></pre>
</p>
<div class="mw-parser-output"><div class="mw-parser-output">
<p><b>Пример брони</b>:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">IDRegistry.genItemID(&quot;myHelmet&quot;); // регистрируем ID шлема
IDRegistry.genItemID(&quot;myChestplate&quot;); // регистрируем ID нагрудника
IDRegistry.genItemID(&quot;myLeggings&quot;); // регистрируем ID понож
IDRegistry.genItemID(&quot;myBoots&quot;); // регистрируем ID ботинок

Item.createArmorItem(&quot;myHelmet&quot;, &quot;Helmet&quot;, {name: &quot;helmet&quot;}, {type: &quot;helmet&quot;, armor: 2, durability: 149, texture: &quot;armor/lay_1.png&quot;}); // создаём шлем с ID myHelmet
Item.createArmorItem(&quot;myChestplate&quot;, &quot;Chestplate&quot;, {name: &quot;chestplate&quot;}, {type: &quot;chestplate&quot;, armor: 6, durability: 216, texture: &quot;armor/lay_1.png&quot;}); // создаём нагрудник с ID myChestplate
Item.createArmorItem(&quot;myLeggings&quot;, &quot;Leggings&quot;, {name: &quot;leggings&quot;}, {type: &quot;leggings&quot;, armor: 5, durability: 203, texture: &quot;armor/lay_2.png&quot;}); // создаём поножи с ID myLeggings
Item.createArmorItem(&quot;myBoots&quot;, &quot;Boots&quot;, {name: &quot;boots&quot;}, {type: &quot;boots&quot;, armor: 2, durability: 176, texture: &quot;armor/lay_1.png&quot;}); // создаём ботинки с ID myBoots
</syntaxhighlight></pre>
</p>
</div> </div> </div>
</div>
@@ Строка 32: / Строка 32: @@
     name: "имя вариации",
      texture: [
-        ["название1", индекс1], // bottom
+        ["текстура 1", <номер текстуры 1>],
-        ["название2", индекс2], // top
+        ["текстура 2", <номер текстуры 2>],
-        ["название3", индекс3], // back
+        ["текстура 3", <номер текстуры 3>],
-        ["название4", индекс4], // front
+        ["текстура 4", <номер текстуры 4>],
-        ["название5", индекс5], // left
+        ["текстура 5", <номер текстуры 5>],
-        ["название6", индекс6]  // right
+        ["текстура 6", <номер текстуры 6>]
-    ],
+    ],
     inCreative: true/false //(добавлять ли данную вариацию блока в креатив)
 }</syntaxhighlight>