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

<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&#95;_xs" data-layout="xs" id="pageLayout"><div class="b-pageContent m-pageContent&#95;_withoutLeft m-pageContent&#95;_withoutRight" id="pageContent"><p>Кроме создания простейших блоков и предметов, Core Engine позволяет настраивать их и добавлять различные события для конкретного блока или предмета.
</p>
<div class="mw-parser-output"><div class="mw-parser-output">
<h3> Специальные типы блоков </h3>
<p>Чтобы создать блок с параметрами, которые отличаются от стандартных (свечение, модель), используются специальные типы блоков. Регистрируются они с помощью функции Block.createSpecialType(объект характеристик) - функция принимает объект характеристик, которые нужно изменить и отдает специальный тип блока с этими характеристиками.
</p><p>Специальный тип, созданный этой функцией передается в функцию Block.createBlock и Block.createBlockWithRotation третим параметром, чтобы блок был создан для данного специального типа. На одном специальном типе может быть создано суммарно до 16 вариаций различных блоков.
</p><p>Все характеристики, их значения по-умолчанию и разъяснение:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">{
     base: 20, // блок из MCPE, который будет взят за основу в создании блока, могут быть скопированы некоторые свойства и материал
     solid: true, // является ли блок твёрдым
     rendertype: 0, // тип модели
     renderlayer: 4, // тип рендера, 1: прозрачный, 2: непрозрачный,   4: прозрачный, но исчезает вдали
     destroytime: 1, // время ломания блока, время уничтожения зависит от используемого инструмента, -1: неразрушимый.
     explosionres: 2, // взрывоустойчивость
     lightopacity: 1, // непрозрачность для света, сколько света будет поглощаться при прохождении через этот блок, 0 - полностью прозрачен, 15 - полностью непрозрачен
     lightlevel: 0, // свечение блока, 0 - нет свечения, 15 - максимальное свечение
     translucency: 0, // полупрозрачность, число от 0 до 1, влияет на наложение теней на блок. При 1 нет теней и блок выглядит ярче остальных.
     renderallfaces: true // отрисовывает все стороны прозрачных блоков
}
</syntaxhighlight></pre>
</p>
<h4> Пример: </h4>
<p>Пример создания специального типа блока и самого блока:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">Block.createSpecialType(&quot;weak_light&quot;, { // блок этого типа будет абсолютно прозрачен для света и сам будет слабо светиться
     lightlevel: 11,
     lightopacity: 0
});
IDRegistry.genBlockID(&quot;testBlock&quot;); // регистрация id
Block.createBlock(&quot;testBlock&quot;, [
     {name: &quot;test block&quot;, texture: [[&quot;obsidian&quot;, 0], [&quot;obsidian&quot;, 0], [&quot;obsidian&quot;, 0], [&quot;obsidian&quot;, 0], [&quot;obsidian&quot;, 0], [&quot;obsidian&quot;, 0]]}
], &quot;weak_light&quot;); // создаем блок на данном специальном типе</syntaxhighlight></pre>
</p>
</div> </div> 
<h3> Функция дропа (ломания) </h3>
<p>К конкретному блоку можно привязать функцию дропа, которая выполняется при ломании блока с данным id. Делается это с помощью функций Block.registerDropFunction("строковый id блока", функция дропа) и Block.registerDropFunctionForID(числовой id блока, функция дропа)
</p><p>Функция дропа имеет такой формат:
<pre class="fck_mw_syntaxhighlight"><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></pre>
</p><p>Пример:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">Block.registerDropFunction(&quot;testBlock&quot;, function(coords, id, data, diggingLevel, toolLevel){
     return [[id, 1, data], [264, 1, 0]]; // дропнуть сам блок и алмаз
});

// Полный аналог предыдущей функции, но с числовым id
Block.registerDropFunctionForID(BlockID.testBlock, function(coords, id, data, diggingLevel, toolLevel){
     return [[id, 1, data], [264, 1, 0]]; // дропнуть сам блок и алмаз
});</syntaxhighlight></pre>
</p>
<h3> Функция установки </h3>
<p>К конкретному блоку можно привязать функцию установки, которая выполняется при установке блока с данным id. Если функция зарегистрирована, то вместо стандартной установки блока на потенциальные координаты вызовется она, а из руки отнимется 1 блок. Делается это с помощью функций Block.registerPlaceFunction("строковый id блока", функция установки) и Block.registerPlaceFunctionForID(числовой id блока, функция установки).
</p><p>Функция установки имеет такой формат:
<pre class="fck_mw_syntaxhighlight"><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: }
}</syntaxhighlight></pre>
</p>
<div>Пример:<span id="cke_bm_170E" style="display: none">&#160;</span></div> <pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">Block.registerPlaceFunction(&quot;testBlock&quot;, 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
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></pre>
<h3> Установка формы </h3>
<p>Блоку с конкретным id и data можно установить форму, отличную от кубической. Для этого используется функция Block.setBlockShape(числовой id, {x: , y: , z: }, {x: , y: , z: }, data) - принимает id блока, координаты начала и координаты конца, а так же, если вы хотите сделать это для конкретной вариации блока, то определите последний параметр. Координаты в блоке могут быть от 0 до 1, стандартный блок имеет форму (0, 0, 0) - (1, 1, 1)
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">Block.setBlockShape(BlockID.testBlock, {x: 0.2, y: 0, z: 0.2}, {x: 0.8, y: 1, z: 0.8}) // установить всем вариациям форму столба</syntaxhighlight></pre>
</p>
<h3> Установка свойств предмета </h3>
<p>Для установки свойств предметов используются следующие функции:
</p>
<ul><li>Item.setCategory(id, category) - аналог параметра category </li>
<li>Item.setEnchantType(id, enchant, value) - аналог параметра enchant </li>
<li>Item.setToolRender(id, enabled) - аналог параметра toolRender </li>
<li>Item.setMaxDamage(id, maxdamage) - аналог параметра maxDamage </li>
<li>Item.setStackedByData(id, enabled) - аналог параметра stackByData </li>
<li>Item.setProperties(id, props) - аналог параметра properties </li>
<li>Item.setUseAnimation(id, animType) - аналог параметра useAnimation </li></ul>
<p>Функции - получение параметров:
</p>
<ul><li>Item.getName(id, data, encode) - отдает имя предмета или блока с данным id и data, если encode true, то возвращает его в формате item.имя.name или block.имя.name </li>
<li>Item.getMaxDamage(id) - отдает максимальный дамаг предмета </li>
<li>Item.getMaxStack(id) - отдает размер стака </li>
<li>Item.getUseAnimation(id) - отдает анимацию использования </li>
<li>Item.isValid(id, data) - возвращает, существует ли данный предмет </li>
<li>Item.isNativeItem(id) - возвращает, является ли этот предмет предметом из MCPE, а не из модов </li></ul>
<h4> Категории предметов (не работают) </h4>
<p><pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">  DECORATION = 2;//декоративный предмет(?)
  FOOD = 4;//еда
  INTERNAL = 0;//(?)
  MATERIAL = 1;//материал
  TOOL = 3;//инструмент</syntaxhighlight></pre>
</p>
<h3> Функция использования предмета </h3>
<p>К конкретному предмету можно привязать функцию использования, которая выполняется при использовании предмета с данным id. Делается это с помощью функций Item.registerUseFunction("строковый id предмета", функция использования) и Item.registerUseFunctionForID(числовой id предмета, функция использования).
</p><p>Функция использования имеет такой формат:
<pre class="fck_mw_syntaxhighlight"><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 - блок, на который было произведено нажатие.
}</syntaxhighlight></pre>
</p>
<h3> Функция броска предмета </h3>
<p>К конкретному предмету можно привязать функцию, которая выполняется при разбивании брошенного предмета с данным id. Делается это с помощью функций Item.registerThrowableFunction("строковый id предмета", функция разбивания) и Item.registerThrowableFunctionForID(числовой id предмета, функция разбивания).
</p><p>Функция разбивания имеет такой формат:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">function(projectile, item, target){
     // 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></pre>
</p>
</div> </div> </div> </div> </div>
</div>