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

Внимание! Вы не авторизовались на сайте. Ваш IP-адрес будет публично видимым, если вы будете вносить любые правки. Если вы войдёте или создадите учётную запись, правки вместо этого будут связаны с вашим именем пользователя, а также у вас появятся другие преимущества.

Правка может быть отменена. Пожалуйста, просмотрите сравнение версий, чтобы убедиться, что это именно те изменения, которые вас интересуют, и нажмите «Записать страницу», чтобы изменения вступили в силу.
Текущая версия Ваш текст
Строка 1: Строка 1:
<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="b-pageLayout b-pageLayout__xs" data-layout="xs" id="pageLayout"><div class="b-pageContent m-pageContent__withoutLeft m-pageContent__withoutRight" id="pageContent">
+
<div class="b-pageLayout b-pageLayout__xs" data-layout="xs" id="pageLayout"><div class="b-pageContent m-pageContent__withoutLeft m-pageContent__withoutRight" id="pageContent">
Кроме создания простейших блоков и предметов, Core Engine позволяет настраивать их и добавлять различные события для конкретного блока или предмета.
+
{| class="b-pageContent__layout"
<div class="mw-parser-output"><div class="mw-parser-output">
+
|-
<div class="mw-parser-output">
+
| class="b-pageContent__side" |
 +
{| id="internal_wrapper"
 +
|-
 +
| class="b-pageContent__side m-pageContent__side__middle" id="pageContentMiddle" | <div class="b-workZone m-workZone__withoutSideNav" id="workZone" style="height: auto">
 +
{| class="b-workZone__layout"
 +
|-
 +
| class="b-workZone__side m-workZone__side__article" id="workZone_article" | <div class="b-workZone__content" id="workZone_article__content"><div class="b-article" id="article" style="height: auto"><div class="b-article__preWrapper" style="height: auto"><div class="b-article__wrapper" style="height: auto;  min-height: 0px"><div class="b-article__innerWrapper" id="description_on_page_placeholder" style="height: auto"><div class="description_on_page"><div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Кроме создания простейших блоков и предметов, Core Engine позволяет настраивать их и добавлять различные события для конкретного блока или предмета.</div>  
 
=== Специальные типы блоков ===
 
=== Специальные типы блоков ===
 +
<div class="b-pageLayout b-pageLayout__xs" data-layout="xs" id="pageLayout"><div class="b-pageContent m-pageContent__withoutLeft m-pageContent__withoutRight" id="pageContent">
 +
{| class="b-pageContent__layout"
 +
|-
 +
| class="b-pageContent__side" |
 +
{| id="internal_wrapper"
 +
|-
 +
| class="b-pageContent__side m-pageContent__side__middle" id="pageContentMiddle" | <div class="b-workZone m-workZone__withoutSideNav" id="workZone" style="height: auto">
 +
{| class="b-workZone__layout"
 +
|-
 +
| class="b-workZone__side m-workZone__side__article" id="workZone_article" | <div class="b-workZone__content" id="workZone_article__content"><div class="b-article" id="article" style="height: auto"><div class="b-article__preWrapper" style="height: auto"><div class="b-article__wrapper" style="height: auto;  min-height: 0px"><div class="b-article__innerWrapper" id="description_on_page_placeholder" style="height: auto"><div class="description_on_page"><div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Чтобы создать блок с параметрами, которые отличаются от стандартных (свечение, модель), используются специальные типы блоков. Регистрируются они с помощью функции Block.createSpecialType(объект характеристик) - функция принимает объект характеристик, которые нужно изменить и отдает специальный тип блока с этими характеристиками.</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Специальный тип, созданный этой функцией передается в функцию Block.createBlock и Block.createBlockWithRotation третим параметром, чтобы блок был создан для данного специального типа. На 1 специальном типе может быть создано суммарно до 16 вариаций различных блоков.</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Все характеристики, их значения по-умолчанию и разъяснение:</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr"><div class="b-pageLayout b-pageLayout__xs" data-layout="xs" id="pageLayout"><div class="b-pageContent m-pageContent__withoutLeft m-pageContent__withoutRight" id="pageContent">
 +
{| class="b-pageContent__layout"
 +
|-
 +
| class="b-pageContent__side" |
 +
{| id="internal_wrapper"
 +
|-
 +
| class="b-pageContent__side m-pageContent__side__middle" id="pageContentMiddle" | <div class="b-workZone m-workZone__withoutSideNav" id="workZone" style="height: auto">
 +
{| class="b-workZone__layout"
 +
|-
 +
| class="b-workZone__side m-workZone__side__article" id="workZone_article" | <div class="b-workZone__content" id="workZone_article__content"><div class="b-article" id="article" style="height: auto"><div class="b-article__preWrapper" style="height: auto"><div class="b-article__wrapper" style="height: auto;  min-height: 0px"><div class="b-article__innerWrapper" id="description_on_page_placeholder" style="height: auto"><div class="description_on_page"><pre class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr"><span class="code">{</span>
  
Характеристики блока указывается в методах&nbsp;Block.createBlock и Block.createBlockWithRotation третьим параметром.&nbsp;Чтобы не повторять их для каждого блока, можно зарегистрировать специальный тип методом&nbsp;Block.createSpecialType(название, объект характеристик) и использовать название спец. типа.
+
<span class="code">    base: 20, // блок из MCPE, который будет взят за основу в создании блока, могут быть скопированы некоторые свойства и материал</span>
  
Все характеристики, их значения по умолчанию и разъяснение:
+
<span class="code">     opaque: false, // непрозрачность, если true, то внутри блока мобы будут получать урон, а так же места соприкосновения этого блока с другими не будут отрисованы</span>
<syntaxhighlight lang="Javascript">{
 
     base: 0, // блок из MCPE, который будет взят за основу в создании блока, могут быть скопированы некоторые свойства и материал
 
     solid: false, // является ли блок твёрдым
 
     rendertype: 0, // тип модели
 
     renderlayer: 4, // тип рендера, 1: прозрачный, 2: непрозрачный, 4: прозрачный, но исчезает вдали
 
     destroytime: 1, // время ломания блока, время уничтожения зависит от используемого инструмента, -1: неразрушимый.
 
    explosionres: 3, // взрывоустойчивость
 
     friction: 0.6, // коэффициент скольжения
 
     lightopacity: 1, // непрозрачность для света, сколько света будет поглощаться при прохождении через этот блок, 0 - полностью прозрачен, 15 - полностью непрозрачен
 
     lightlevel: 0, // свечение блока, 0 - нет свечения, 15 - максимальное свечение
 
    translucency: 1, // полупрозрачность, число от 0 до 1, влияет на наложение теней на блок. 0 - нормальные тени, 1 - нет теней и блок выглядит ярче остальных.
 
     renderallfaces: true, // отрисовывает все стороны прозрачных блоков,
 
     mapcolor: 0, // цвет блока на карте
 
     sound: "default" // тип звука для блока
 
}
 
</syntaxhighlight>
 
  
==== Пример: ====
+
<span class="code">    rendertype: 0, // тип модели, не работает в 0.15.7 и выше</span>
  
Пример создания специального типа блока и самого блока:
+
<span class="code">     renderlayer: 4, // тип рендера, 4 означает, что прозрачные части будут отрисованы прозрачными, а не черными</span>
<syntaxhighlight lang="Javascript">Block.createSpecialType("weak_light", { // блок этого типа будет абсолютно прозрачен для света и сам будет слабо светиться
 
     lightlevel: 11,
 
     lightopacity: 0
 
});
 
IDRegistry.genBlockID("testBlock"); // регистрация id
 
Block.createBlock("testBlock", [
 
     {name: "test block", texture: [["obsidian", 0], ["obsidian", 0], ["obsidian", 0], ["obsidian", 0], ["obsidian", 0], ["obsidian", 0]]}
 
], "weak_light"); // создаем блок на данном специальном типе</syntaxhighlight>
 
</div>
 
  
 +
<span class="code">    destroytime: 1, // не работает в 0.15.0 и выше, время ломания блока</span>
 +
 +
<span class="code">    redstoneconsumer: true, // будет ли происходить событие изменения редстоун-сигнала для этого блока</span>
 +
 +
<span class="code">    lightopacity: 1, // непрозрачность для света, сколько света будет поглощаться при прохождении через этот блок, 0 - полностью прозрачен, 15 - полностью непрозрачен</span>
 +
 +
<span class="code">    lightlevel: 0, // свечение блока, 0 - нет свечения, 15 - максимальное свечение</span>
 +
 +
<span class="code">    explosionres: 2, // взрывоустойчивость</span>
 +
 +
<span class="code">    color: [0xFFFFFF] // цвет для каждой стороны в формате 0xRRGGBB, если в массиве 1 элемент, то цвет будет установлен для всего блока</span>
 +
 +
<span class="code">}</span></pre>
 +
<div class="b-pageLayout b-pageLayout__xs" data-layout="xs" id="pageLayout"><div class="b-pageContent m-pageContent__withoutLeft m-pageContent__withoutRight" id="pageContent">
 +
{| class="b-pageContent__layout"
 +
|-
 +
| class="b-pageContent__side" |
 +
{| id="internal_wrapper"
 +
|-
 +
| class="b-pageContent__side m-pageContent__side__middle" id="pageContentMiddle" | <div class="b-workZone m-workZone__withoutSideNav" id="workZone" style="height: auto">
 +
{| class="b-workZone__layout"
 +
|-
 +
| class="b-workZone__side m-workZone__side__article" id="workZone_article" | <div class="b-workZone__content" id="workZone_article__content"><div class="b-article" id="article" style="height: auto"><div class="b-article__preWrapper" style="height: auto"><div class="b-article__wrapper" style="height: auto;  min-height: 0px"><div class="b-article__innerWrapper" id="description_on_page_placeholder" style="height: auto"><div class="description_on_page"><div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Пример создания специального типа блока и самого блока:</div> <pre class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">
 +
<span class="code">var BLOCK_TYPE_LOW_LIGHT = Block.createSpecialType({ // блок этого типа будет абсолютно прозрачен для света и сам будет слабо светиться</span>
 +
 +
<span class="code">    lightlevel: 11,</span>
 +
 +
<span class="code">    lightopacity: 0</span>
 +
 +
<span class="code">});</span>
 +
 +
 +
<span class="code">IDRegistry.genBlockID("testBlock"); // регистрациа id</span>
 +
 +
 +
<span class="code">Block.createBlock("testBlock", [</span>
 +
 +
<span class="code">    {name: "test block", texture: [["obsidian", 0], ["obsidian", 0], ["obsidian", 0], ["obsidian", 0], ["obsidian", 0], ["obsidian", 0]]}</span>
 +
 +
<span class="code">], BLOCK_TYPE_LOW_LIGHT); // создаем блок на данном специальном типе</span></pre>
 +
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div>
 
=== Функция дропа (ломания) ===
 
=== Функция дропа (ломания) ===
 +
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">К конкретному блоку можно привязать функцию дропа, которая выполняется при ломании блока с данным id. Делается это с помощью функций Block.registerDropFunction("строковый id блока", функция дропа) и Block.registerDropFunctionForID(числовой id блока, функция дропа)</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Функция дропа имеет такой формат:</div> <pre class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr"><span class="code">function(coords, id, data, diggingLevel, toolLevel){</span>
 +
 +
<span class="code">    // coords - объект, содержащий координаты разрушенного блока - {x: , y: , z: } - coords.x, coords.y, coords.z</span>
 +
 +
<span class="code">    // id, data - id и data блока, id всегда совпадает с тем, на который была зарегистрирована функция и нужно, если одинаковая функция регистрируется на разные блоки</span>
  
К конкретному блоку можно привязать функцию дропа, которая выполняется при ломании блока с данным id. Делается это с помощью функций Block.registerDropFunction("строковый id блока", функция дропа) и Block.registerDropFunctionForID(числовой id блока, функция дропа)
+
<span class="code">    // diggingLevel - уровень ломания блока, где рука или инструмент другого типа - 0. Если же инструмент совпадает с материалом блока, то уровень будет равен уровню инструмента</span>
 +
 
 +
<span class="code">    // toolLevel -  уровень инструмента в руке, не зависит от самого блока</span>
 +
 
 +
<span class="code">    </span>
 +
 
 +
<span class="code">    // если блок что то дропает, эта функция должна вернуть массив из предметов, которые надо дропнуть, каждый предмет имеет формат [id, count, data]</span>
 +
 
 +
<span class="code">}</span>
  
Функция дропа имеет такой формат:
 
<syntaxhighlight lang="Javascript">function(coords, id, data, toolLevel, enchantData, item, region) {
 
     // coords - объект, содержащий координаты разрушенного блока - {x: , y: , z: } - coords.x, coords.y, coords.z
 
     // id, data - id и data блока
 
     // toolLevel - уровень инструмента в руке
 
     // enchantData - зачарования инструмента
 
    // item - предмет в руке
 
     // если блок что-то дропает, эта функция должна вернуть массив из предметов, которые надо дропнуть, каждый предмет имеет формат [id, count, data] или [id, count, data, ExtraData]
 
}</syntaxhighlight>
 
  
 
Пример:
 
Пример:
<syntaxhighlight lang="Javascript">Block.registerDropFunction("testBlock", function(coords, id, data, diggingLevel, toolLevel){
 
     return [[id, 1, data], [264, 1, 0]]; // дропнуть сам блок и алмаз
 
});
 
  
// Полный аналог предыдущей функции, но с числовым id
+
<span class="code">Block.registerDropFunction("testBlock", function(coords, id, data, diggingLevel, toolLevel){</span>
Block.registerDropFunctionForID(BlockID.testBlock, function(coords, id, data, diggingLevel, toolLevel){
+
 
     return [[id, 1, data], [264, 1, 0]]; // дропнуть сам блок и алмаз
+
<span class="code">    return [[id, 1, data], [264, 1, 0]]; // дропнуть сам блок и алмаз</span>
});</syntaxhighlight>
+
 
 +
<span class="code">});</span>
 +
 
 +
 
 +
<span class="code">// Полный аналог предыдущей функции, но с числовым id</span>
 +
 
 +
<span class="code">Block.registerDropFunctionForID(BlockID.testBlock, function(coords, id, data, diggingLevel, toolLevel){ </span>
 +
 
 +
<span class="code">    return [[id, 1, data], [264, 1, 0]]; // дропнуть сам блок и алмаз</span>
 +
 
 +
<span class="code">});</span></pre>
 +
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div>  
  
 
=== Функция установки ===
 
=== Функция установки ===
 +
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">К конкретному блоку можно привязать функцию установки, которая выполняется при установке блока с данным id. Если функция зарегистрирована, то вместо стандартной установки блока на потенциальные координаты вызовется она, а из руки отнимется 1 блок. Делается это с помощью функций Block.registerPlaceFunction("строковый id блока", функция установки) и Block.registerPlaceFunctionForID(числовой id блока, функция установки).</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Функция установки имеет такой формат:</div> <pre class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr"><span class="code">function(coords, item, block){</span>
 +
 +
<span class="code">    // coords - объект, содержащий координаты блока, на который было произведено нажатие - {x: , y: , z: } - coords.x, coords.y, coords.z</span>
 +
 +
<span class="code">    // coords.relative - объект, содержащий потенциальные координаты установки - {x: , y: , z: } - coords.relative.x, coords.relative.y, coords.relative.z</span>
 +
 +
<span class="code">    // item - объект, содержащий предмет в руке игрока - {id: , count: , data: } - item.id, item.count, item.data</span>
 +
 +
<span class="code">    // block - блок, на который было произведено нажатие.</span>
 +
 +
<span class="code">    </span>
 +
 +
<span class="code">    // если функция произвела установку основного блока на координаты, отличающиеся от coords.relative, то она должна вернуть их в формате {x: , y: , z: }</span>
 +
 +
<span class="code">}</span></pre>
 +
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Пример:</div> <pre class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr"><span class="code">Block.registerPlaceFunction("testBlock", function(coords, item, block){</span>
 +
 +
<span class="code">    World.setBlock(coords.relative.x, coords.relative.y, coords.relative.z, item.id, item.data); // установим наш блок</span>
 +
 +
<span class="code">    World.setBlock(coords.relative.x, coords.relative.y + 1, coords.relative.z, item.id, item.data); // над ним установим алмазный блок</span>
  
К конкретному блоку можно привязать функцию установки, которая выполняется при установке блока с данным id. Если функция зарегистрирована, то вместо стандартной установки блока на потенциальные координаты вызовется она, а из руки отнимется 1 блок. Делается это с помощью функций Block.registerPlaceFunction("строковый id блока", функция установки) и Block.registerPlaceFunctionForID(числовой id блока, функция установки).
+
<span class="code">});</span>
  
Функция установки имеет такой формат:
 
<syntaxhighlight lang="Javascript">function(coords, item, block){
 
     // coords - объект, содержащий координаты блока, на который было произведено нажатие - {x: , y: , z: } - coords.x, coords.y, coords.z
 
     // coords.relative - объект, содержащий потенциальные координаты установки - {x: , y: , z: } - coords.relative.x, coords.relative.y, coords.relative.z
 
     // item - объект, содержащий предмет в руке игрока - {id: , count: , data: } - item.id, item.count, item.data
 
     // block - блок, на который было произведено нажатие.
 
  
     // если функция произвела установку основного блока на координаты, отличающиеся от coords.relative, то она должна вернуть их в формате {x: , y: , z: }
+
<span class="code">// Полный аналог предыдущей функции, но с числовым id</span>
}</syntaxhighlight>
 
<div>Пример:<span id="cke_bm_170E" style="display: none">&nbsp;</span></div> <syntaxhighlight lang="Javascript">Block.registerPlaceFunction("testBlock", function(coords, item, block){
 
     World.setBlock(coords.relative.x, coords.relative.y, coords.relative.z, item.id, item.data); // установим наш блок
 
     World.setBlock(coords.relative.x, coords.relative.y + 1, coords.relative.z, item.id, item.data); // над ним установим алмазный блок
 
});
 
  
// Полный аналог предыдущей функции, но с числовым id
+
<span class="code">Block.registerPlaceFunctionForID(BlockID.testBlock, function(coords, item, block){</span>
Block.registerPlaceFunctionForID(BlockID.testBlock, function(coords, item, block){
 
     World.setBlock(coords.relative.x, coords.relative.y, coords.relative.z, item.id, item.data); // установим наш блок
 
     World.setBlock(coords.relative.x, coords.relative.y + 1, coords.relative.z, item.id, item.data); // над ним установим алмазный блок
 
});</syntaxhighlight>
 
  
 +
<span class="code">    World.setBlock(coords.relative.x, coords.relative.y, coords.relative.z, item.id, item.data); // установим наш блок</span>
 +
 +
<span class="code">    World.setBlock(coords.relative.x, coords.relative.y + 1, coords.relative.z, item.id, item.data); // над ним установим алмазный блок</span>
 +
 +
<span class="code">});</span></pre>
 +
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div>
 
=== Установка формы ===
 
=== Установка формы ===
 +
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Блоку с конкретным id и data можно установить форму, отличную от кубической. Для этого используется функция Block.setBlockShape(числовой id, {x: , y: , z: }, {x: , y: , z: }, data) - принимает id блока, координаты начала и координаты конца, а так же, если вы хотите сделать это для конкретной вариации блока, то определите последний параметр. Координаты в блоке могут быть от 0 до 1, стандартный блок имеет форму (0, 0, 0) - (1, 1, 1)</div> <pre class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Block.setBlockShape(BlockID.testBlock, {x: 0.2, y: 0, z: 0.2}, {x: 0.8, y: 1, z: 0.8}) // установить всем вариациям форму столба</pre>
 +
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div>
  
Блоку с конкретным id и data можно установить форму, отличную от кубической. Для этого используется функция Block.setBlockShape(числовой id, {x: , y: , z: }, {x: , y: , z: }, data) - принимает id блока, координаты начала и координаты конца, а так же, если вы хотите сделать это для конкретной вариации блока, то определите последний параметр. Координаты в блоке могут быть от 0 до 1, стандартный блок имеет форму (0, 0, 0) - (1, 1, 1)
+
=== Установка свойств предметов ===
<syntaxhighlight lang="Javascript">Block.setBlockShape(BlockID.testBlock, {x: 0.2, y: 0, z: 0.2}, {x: 0.8, y: 1, z: 0.8}) // установить всем вариациям форму столба</syntaxhighlight>
+
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Для установки свойств предметов используется функция Item.describeItem("строковый id", объект описания).</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Все параметры в объекте описания, их стандартные значения и описание:</div> <pre class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">
 +
  category: 0, // категория в креативе</span>
  
=== Установка свойств предмета ===
+
  enchant: {value: 0, type: 0}, // тип зачарования</span>
  
Для установки свойств предметов используются следующие функции:
+
  toolRender: false, // рендер в руке, как инструмент</span>
  
 +
  maxDamage: 0, // максимальный дамаг предмета (шкала прочности)</span>
 +
 +
  stackByData: false, // стакается по data</span>
 +
 +
  properties: {}, // родной объект параметров MCPE</span>
 +
 +
  useAnimation: 0 // анимация использозвания</span>
 +
 +
</pre>
 +
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Функции - аналоги параметров:</div>
 
*Item.setCategory(id, category) - аналог параметра category  
 
*Item.setCategory(id, category) - аналог параметра category  
 
*Item.setEnchantType(id, enchant, value) - аналог параметра enchant  
 
*Item.setEnchantType(id, enchant, value) - аналог параметра enchant  
Строка 102: Строка 179:
 
*Item.setProperties(id, props) - аналог параметра properties  
 
*Item.setProperties(id, props) - аналог параметра properties  
 
*Item.setUseAnimation(id, animType) - аналог параметра useAnimation  
 
*Item.setUseAnimation(id, animType) - аналог параметра useAnimation  
 
+
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Функции - получение параметров:</div>
Функции - получение параметров:
 
 
 
 
*Item.getName(id, data, encode) - отдает имя предмета или блока с данным id и data, если encode true, то возвращает его в формате item.имя.name или block.имя.name  
 
*Item.getName(id, data, encode) - отдает имя предмета или блока с данным id и data, если encode true, то возвращает его в формате item.имя.name или block.имя.name  
 
*Item.getMaxDamage(id) - отдает максимальный дамаг предмета  
 
*Item.getMaxDamage(id) - отдает максимальный дамаг предмета  
Строка 111: Строка 186:
 
*Item.isValid(id, data) - возвращает, существует ли данный предмет  
 
*Item.isValid(id, data) - возвращает, существует ли данный предмет  
 
*Item.isNativeItem(id) - возвращает, является ли этот предмет предметом из MCPE, а не из модов  
 
*Item.isNativeItem(id) - возвращает, является ли этот предмет предметом из MCPE, а не из модов  
 +
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div>
  
==== Категории предметов (не работают) ====
+
=== Функция использования предмета ===
 +
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">К конкретному предмету можно привязать функцию использования, которая выполняется при использовании предмета с данным id. Делается это с помощью функций Item.registerPlaceFunction("строковый id предмета", функция использования) и Item.registerPlaceFunctionForID(числовой id предмета, функция использования).</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Функция использования имеет такой формат:</div> <pre class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr"><span class="code">function(coords, item, block){</span>
  
&nbsp;
+
<span class="code">     // coords - объект, содержащий координаты блока, на который было произведено нажатие - {x: , y: , z: } - coords.x, coords.y, coords.z</span>
<syntaxhighlight lang="Javascript"> DECORATION = 2;//декоративный предмет(?)
 
  FOOD = 4;//еда
 
  INTERNAL = 0;//(?)
 
  MATERIAL = 1;//материал
 
  TOOL = 3;//инструмент</syntaxhighlight>
 
  
=== Функция использования предмета ===
+
<span class="code">    // coords.relative - объект, содержащий потенциальные координаты установки блока - {x: , y: , z: } - coords.relative.x, coords.relative.y, coords.relative.z</span>
 +
 
 +
<span class="code">    // item - объект, содержащий предмет в руке игрока - {id: , count: , data: } - item.id, item.count, item.data</span>
  
К конкретному предмету можно привязать функцию использования, которая выполняется при использовании предмета с данным id. Делается это с помощью функций Item.registerUseFunction("строковый id предмета", функция использования) и Item.registerUseFunctionForID(числовой id предмета, функция использования).
+
<span class="code">    // block - блок, на который было произведено нажатие.</span>
  
Функция использования имеет такой формат:
+
<span class="code">}</span></pre>
<syntaxhighlight lang="Javascript">function(coords, item, block){
+
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div>
     // coords - объект, содержащий координаты блока, на который было произведено нажатие - {x: , y: , z: } - coords.x, coords.y, coords.z
 
     // coords.relative - объект, содержащий потенциальные координаты установки блока - {x: , y: , z: } - coords.relative.x, coords.relative.y, coords.relative.z
 
     // item - объект, содержащий предмет в руке игрока - {id: , count: , data: } - item.id, item.count, item.data
 
     // block - блок, на который было произведено нажатие.
 
}</syntaxhighlight>
 
  
 
=== Функция броска предмета ===
 
=== Функция броска предмета ===
 +
<div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">К конкретному предмету можно привязать функцию, которая выполняется при разбивании брошенного предмета с данным id. Делается это с помощью функций Item.registerThrowableFunction("строковый id предмета", функция разбивания) и Item.registerThrowableFunctionForID(числовой id предмета, функция разбивания).</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">&nbsp;</div> <div class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr">Функция разбивания имеет такой формат:</div> <pre class="p" style="text-align: left;  text-indent: 0px;  margin-left: 0px;  direction: ltr"><span class="code">function(projectile, item, target){</span>
 +
 +
<span class="code">    // projectile - entity кинутого предмета</span>
 +
 +
<span class="code">    // target - объект, содержащий координаты цели, а так же entity цели, если она является мобом - {x: , y: , z: } - target.x, target.y, target.z и target.entity</span>
 +
 +
<span class="code">    // item - объект, содержащий предмет, который был брошен - {id: , count: , data: } - item.id, item.count, item.data</span>
 +
 +
<span class="code">}</span></pre>
 +
</div> </div> </div> </div> </div> </div>
 +
|}
 +
</div>
 +
|}
 +
 +
|}
 +
</div> </div> </div> </div> </div> </div> </div> </div>
 +
|}
 +
</div>
 +
|}
 +
 +
|}
 +
</div> </div> </div> </div> </div> </div> </div> </div> </div>
 +
|}
 +
</div>
 +
|}
  
К конкретному предмету можно привязать функцию, которая выполняется при разбивании брошенного предмета с данным id. Делается это с помощью функций Item.registerThrowableFunction("строковый id предмета", функция разбивания) и Item.registerThrowableFunctionForID(числовой id предмета, функция разбивания).
+
|}
 +
</div> </div> </div> </div> </div> </div> </div> </div>
 +
|}
 +
</div>
 +
|}
  
Функция разбивания имеет такой формат:
+
|}
<syntaxhighlight lang="Javascript">function(projectile, item, target){
+
</div> </div>
     // projectile - entity кинутого предмета
 
     // target - объект, содержащий координаты цели, а так же entity цели, если она является мобом - {x: , y: , z: } - target.x, target.y, target.z и target.entity
 
     // item - объект, содержащий предмет, который был брошен - {id: , count: , data: } - item.id, item.count, item.data
 
}
 
</syntaxhighlight>
 
</div> </div> </div> </div> </div> </div> </div>
 

Обратите внимание, что все добавления и изменения текста статьи рассматриваются как выпущенные на условиях лицензии GNU Free Documentation License 1.3 или более поздняя (см. Mineprogramming wiki:Авторские права). Если вы не хотите, чтобы ваши тексты свободно распространялись и редактировались любым желающим, не помещайте их сюда.
Вы также подтверждаете, что являетесь автором вносимых дополнений или скопировали их из источника, допускающего свободное распространение и изменение своего содержимого.
НЕ РАЗМЕЩАЙТЕ БЕЗ РАЗРЕШЕНИЯ МАТЕРИАЛЫ, ОХРАНЯЕМЫЕ АВТОРСКИМ ПРАВОМ!