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

<div class="mw-parser-output"><h1> СОЗДАНИЕ МОБОВ </h1>
<p>Для создания нового моба нужно зарегистрировать его тип с его уникальным id, по которому в последствии моб будет определяться. После создания, объект типа моба будет использоваться для описания этого типа. Для регистрации нового типа мобов используется метод
</p>
<blockquote>
<p>MobRegistry.registerEntity("name")
</p>
</blockquote> 
<p>где <b>name </b>- уникальное название данного типа мобов. Эта функция возвращает созданный ею объект типа моба. Новый моб по умолчанию не будет иметь стандартную модель, стандартными здоровьем и размерами, не будет обладать искусственным интеллектом (будет стоять на месте) и дропом. Все это ему предстоит добавить. Пример:
</p>
<blockquote>
<p>var myTestEntity = MobRegistry.registerEntity("test-entity"); // создаем тип моба под названием test-entity и сохраняем его в переменную, этот моб пока ничего не делает и имеет стандартные параметры
</p>
</blockquote> 
<p>&#160;
</p>
<h1> СПАВН МОБОВ </h1>
<p>Для спавна новых мобов в мир используется функция
</p>
<blockquote>
<p>Entity.spawnCustom("name", x, y, z) - создает моба типа name на данных координатах и возвращает объект этого моба.
</p>
</blockquote> 
<p>Пример:
</p>
<blockquote>
<p>IDRegistry.genItemID("test-entity-spawn"); // регистрируем id предмета-спавнера<br /> Item.createItem("test-entity-spawn", "spawn test entity", {name: "stick"}); // создаем предмет- спавнер<br /> Item.registerUseFunction("test-entity-spawn", function(coords, item, block){ // задаем предмету- спавнеру функцию использования<br /> Entity.spawnCustom("test-entity", coords.relative.x + .5, coords.relative.y + .5, coords.relative.z + .5); // при использовании создать моба нашего типа на координатах использования });
</p>
</blockquote> 
<p>Как результат этого кода при нажатии нашим новым предметом в любую точку, там появится моб, который будет стоять на месте и выглядеть примерно так:
</p><p><a href="https://pp.userapi.com/c638116/v638116224/49ca8/-1HCt15x470.jpg" alt="https://pp.userapi.com/c638116/v638116224/49ca8/-1HCt15x470.jpg" title="https://pp.userapi.com/c638116/v638116224/49ca8/-1HCt15x470.jpg"><img src="https://pp.userapi.com/c638116/v638116224/49ca8/-1HCt15x470.jpg" alt="-1HCt15x470.jpg"/></a>
</p>
<h1> КОНТРОЛЛЕРЫ МОБОВ </h1>
<p>Новые типы мобов в Core Engine задаются как объекты, которые обладают набором контроллеров - объектов, каждый из которых обладает набором событий и отвечающих за что- то свое. С помощью настройки и изменения этих контроллеров описывается сам тип мобов. Типы мобов имеют стандартные контроллеры, но так же можно создавать свои, однако про это будет в другой главе. Для настройки контроллера в функцию его настройки передается объект, который содержит все нужные функции и значения, которые нужно изменить в контроллере. В дальнейшей документации для стандартных контроллеров будет приводиться объект со всеми значениями, которые можно изменить, однако если какое-то из них не требуется, его можно просто не прописывать. Методам, которые вызываются <b>внутри </b>контроллера доступные следующие значения: 1. <span style="font-size:larger;"><i>this.parent</i></span> - объект моба, содержащий все контроллеры 2. <span style="font-size:larger;"><i>this.entity</i></span> - сам моб, на которого будут вызываться все операции с ним (например <span style="font-size:larger;"><i>Entity.getPosition(this.entity)</i></span>)<br /> В большинстве случаев вам не нужно будет добавлять свои контроллеры и вам достаточно будет стандартных:
</p>
<ol><li><span style="font-size:larger;"><i>Event Controller (event)</i></span> - контроллер событий - это контроллер, настрока которого позволяет добавлять функции, которые будут вызываться, когда с мобом происходит какое то событие. </li>
<li><span style="font-size:larger;"><i>Description Controller (description)</i></span> - контроллер описания - это контроллер, который позволяет описать основные параметры моба - его размеры, здоровье и дроп. </li>
<li><span style="font-size:larger;"><i>Visual Controller (visual)</i></span> - визуальный контроллер - этот контроллер загружает модели и позволяет оперировать ими меняя их и запуская анимации. Отвечает за внешний вид моба. </li>
<li><span style="font-size:larger;"><i>AI Controller (AI)</i></span> - контроллер ИИ (искусственного интеллекта) - это контроллер, который обеспечивает мобу ИИ, совмещая объекты ИИ и управляя ими. </li></ol>
<p>В скобках даны имена, по которым один контроллер может обращаться к другому через this.parent, например к визуальному контроллеру this.parent.visual.
</p>
<h1> КОНТРОЛЛЕР СОБЫТИЙ </h1>
<p>Для настройки контроллера событий используется функция
</p>
<blockquote>
<p>&lt;сущность&gt;.customizeEvents(custom)
</p>
</blockquote> 
<p>&#160;где <b>custom </b>- объект, содержащий все события, которые вам требуются. Ниже приведен объект настройки <i>(custom)</i> со всеми возможными событиями и их описанием:
</p>
<blockquote>
<p>{<br /> &#160; &#160;tick: function() {}, // вызывается каждый игровой тик для моба этого типа<br /> &#160; &#160;created: function(extra) {}, // вызывается при создании моба данного типа, extra - дополнительные данные, которые могут быть переданы в &#160; функцию спавна 5 параметром<br /> &#160;&#160;&#160;loaded: function() {}, // вызывается, когда моб загружается в мир - после создания, входа в мир или загрузки чанка, если игрок был далеко, но подошел достаточно близко<br /> &#160;&#160;&#160;unloaded: function() {}, // вызывается, когда чанк с мобом был выгружен, игрок ушел слишком далеко<br /> &#160;&#160;&#160;removed: function() {}, // вызывается, если моб уничтожен или деспавнился<br /> &#160;&#160;&#160;death: function(attacker) {}, // вызывается, если моб убит, attacker - в случае убийства мобом и игроком в него передается моб-убийца<br /> &#160;&#160;&#160;attackedBy: &#160; &#160; function(attacker) {}, // вызывается при атаке моба, attacker - атакующий<br /> &#160;&#160;&#160;hurtBy: function(attacker, amount) {}, // вызывается при получении урона, attacker определен если урон получен от моба или игрока<br /> &#160;&#160;&#160;projectileHit: function(projectile) {} // вызывается, когда в моба попадает снаряд, projectile - этот снаряд<br /> }
</p>
</blockquote> 
<p><b>Пример</b>:
</p>
<blockquote>
<p>var myTestEntity = new MobRegistry.registerEntity("test-entity");<br /> myTestEntity.customizeEvents({<br /> &#160;&#160;&#160;created: function() {<br /> &#160;&#160; &#160; &#160;Game.message("Hi!"); // при создании моба напишет "Hi!" в чат<br /> &#160;&#160;&#160;},<br /> &#160;&#160;&#160;attackedBy: function(attacker) {<br /> &#160;&#160; &#160; &#160;Game.message("Ouch, " + attacker + "!"); // при атаке моба напишет "Ouch,&#160;!" в чат<br /> &#160;&#160;&#160;},<br /> &#160;&#160;&#160;tick: function() {<br /> &#160; &#160; &#160;&#160;var position = Entity.getPosition(this.entity); // получаем позицию моба<br /> &#160;&#160; &#160; &#160;Particles.addParticle(position.x, position.y + .5, position.z, Native.ParticleType.flame, 0, 0.1, 0); // создаем на позиции моба частицу огня каждый тик &#160; &#160; }<br /> });
</p>
</blockquote> 
<h1> КОНТРОЛЛЕР ОПИСАНИЯ </h1>
<p>Для настроки контроллера описания используется функция
</p>
<blockquote>
<p>&lt;сущность&gt;..customizeDescription(custom)&#160;
</p>
</blockquote> 
<p>где <b>custom </b>- объект, содержащий все настройки описания.<br /> Ниже приведен объект <i>(custom)</i> со всеми возможными настройками и их описанием:
</p>
<blockquote>
<p>{<br /> &#160;&#160;&#160;getHitbox: function() {<br /> &#160;&#160; &#160; &#160;return {<br /> &#160;&#160; &#160; &#160; &#160;&#160;w: hitboxWidth,<br /> &#160;&#160; &#160; &#160; &#160;&#160;h: hitboxHeight<br /> &#160;&#160; &#160; &#160;}; // возвращает ширину и высоту хитбокса моба, если не задана, его размеры будут 1, 1<br /> &#160;&#160;&#160;},<br /> &#160;&#160;&#160;getHealth: function() { return maxHealth; // возвращает максимальное здоровье моба, которое задается ему при спавне, если не задана, то &#160; &#160; &#160; &#160; &#160; &#160; &#160; &#160; &#160; &#160; &#160; здоровье будет 20 единиц<br /> &#160;&#160;&#160;},<br /> &#160;&#160;&#160;getNameTag: function() { return "name tag"; // возвращает имя моба, если не задана, имени не будет<br /> &#160;&#160;&#160;},<br /> &#160;&#160;getDrop: function(attacker) { return dropArray; // возвращает массив возможного дропа при смерти, attacker - если определен, моб-убийца<br /> &#160; &#160; &#160;/* Формат дропа: массив, состоящий из возможных предметов, каждый предмет задается так:<br /> &#160; &#160; &#160; &#160; &#160;{<br /> &#160; &#160; &#160; &#160; &#160; &#160; id: id предмета: число,<br /> &#160; &#160; &#160; &#160; &#160; &#160; count: кол-во предмета: либо число, либо массив чисел (будет выбрано случайно из массива), либо объект {min: , max: } - кол-во будет &#160; &#160; &#160; &#160; &#160; &#160; &#160; &#160; &#160; &#160; &#160; &#160; &#160; &#160; &#160; &#160;выбрано&#160;между min и max, включая их<br /> &#160; &#160; &#160; &#160; &#160; &#160; data: метадата предмета, формат аналогичен count<br /> &#160; &#160; &#160; &#160; &#160; &#160;&#160;chance: шанс, число от 0 до 1 - вероятность дропа этого предмета<br /> &#160; &#160; &#160; &#160; &#160; &#160;&#160;separate: если true, то при количестве больше 1, предмет будет дропнут в виде нескольких предметов, каждый с кол-вом 1<br /> &#160; &#160; &#160; &#160; &#160;} */<br /> &#160;&#160;&#160;}<br /> }
</p>
</blockquote> 
<p><b>Пример</b>:
</p>
<blockquote>
<p>myTestEntity.customizeDescription({<br /> &#160;&#160;&#160;getDrop: function() {<br /> &#160;&#160; &#160; &#160;return [{<br /> &#160;&#160; &#160; &#160; &#160;&#160;id: 331,<br /> &#160;&#160; &#160; &#160; &#160;&#160;count: {min: 5, max: 10},<br /> &#160;&#160; &#160; &#160; &#160;&#160;separate: true, chance: 0.5<br /> &#160; &#160; &#160; &#160;},&#160;// редстоун в кол-ве от 5 до 10<br /> &#160;&#160; &#160; &#160;{<br /> &#160; &#160; &#160; &#160; &#160;id: 264,<br /> &#160;&#160; &#160; &#160; &#160;&#160;count: [1, 1, 3],<br /> &#160;&#160; &#160; &#160; &#160;&#160;separate: true, chance: 0.5<br /> &#160; &#160; &#160; }, // либо 1 либо 3 алмаза, при этом 1 выпадает в 2 раза чаще ];<br /> &#160;&#160;&#160;}<br /> });
</p>
</blockquote> 
<h1> МОДЕЛИ МОБОВ ТЕКСТУРЫ </h1>
<p>Текстуры в Core Engine задаются специальным типом объектов и используются для рендера мобов. Текстуры содержат информацию о самой текстуре, ее разрешении, масштабировании и данные для анимации. Для создания текстуры, файл этой текстуры должен присутствовать где-то в папке images в архиве ресурсов мода <b>(resources.zip по умолчанию)</b>. Чтобы создать объект текстуры нужно вызвать
</p>
<blockquote>
<p>new Texture("name")
</p>
</blockquote> 
<p>где <b>name </b>- имя текстуры в ресурсах с расширением. У объекта текстуры имеются базовые методы, которые нужны для установки разрешения текстуры:
</p>
<blockquote>
<p>&lt;текстура&gt;.setResolution(w, h) - устанавливает разрешение, w, h - высота текстуры в пикселях.<br /> &lt;текстура&gt;.setPixelScale(scale) - устанавливает масштаб пикселей (чем больше, тем больше пикселей помещается на 1 единицу модели.
</p>
</blockquote> 
<p>К примеру значение 1 = текстурам 16х16, 2 = 32х32 и т.д.). По умолчанию масштаб равен 1 (16х16).<br /> <b>Пример</b>:
</p><p>Файл bird_blue.png находится в ресурсах и имеет разрешение 128x64. Однако это текстура моба, которая будет использоваться в разрешении вдвое больше стандартного.
</p>
<blockquote>
<p>var blue_bird_texture = new Texture("bird_blue.png"); // создадим объект текстуры<br /> blue_bird_texture.setResolution(128, 64); // зададим разрешение<br /> blue_bird_texture.setPixelScale(2); // установим масштабирование
</p>
</blockquote> 
<p>Так же этот код можно записать короче, в таком формате:
</p>
<blockquote>
<p>var blue_bird_texture = new Texture("bird_blue.png").setResolution(128, 64).setPixelScale(2);
</p>
</blockquote> 
<p>Для создания анимации текстуре используется метод
</p>
<blockquote>
<p>.setAnimation(["name1", "name2", ...], delay)
</p>
</blockquote> 
<p>&#160;где <b>name1</b>, <b>name2 </b>и т.д. - имена файлов кадров анимации, которая будет проигрываться циклично, а <b>delay </b>- время показа каждого кадра в тиках, если этот параметр не указан, он будет равен 1.
</p>
<h1> РЕНДЕРЫ </h1>
<p>Рендеры мобов задают их статичную модель без текстуры, являясь набором параллелепипедов (боксов). Для создания объекта рендера нужно вызвать <span style="font-size:larger;"><i>new Render()</i></span>. Основной метод объекта рендера для его создания это метод
</p>
<blockquote>
<p>.setPart("part-name", part-data, {})
</p>
</blockquote> 
<p>где <b>part-name</b> - имя части рендера, которую надо задать, а<b>part-data</b> - объект, описывающий эту часть.<br /> Стандартный тип рендера, который тут рассматривается имеет следующие части:
</p>
<ol><li>body - тело и основная часть модели, скорее всего вся модель будет описываться через эту часть. </li>
<li>head - голова, используется, если вам важен поворот. Все последующие части используются в стандартном рендере, только если результат должен выглядеть примерно как модель игрока (плюс минус детали). </li>
<li>leftArm - левая рука </li>
<li>rightArm - правая рука </li>
<li>leftLeg - левая нога </li>
<li>rightLeg - правая нога </li></ol>
<p>Так же стоит заметить важные особенности системы координат части body:
</p>
<ol><li>&#160;Единица системы координат равна 1\16 блока и 1 пикселю текстуры 16х16 </li>
<li>&#160;Ось Y системы координат направлена вниз, остальные оси направлены в нормальных направлениях. </li>
<li>&#160;Позиция моба (его нижняя центральная точка) в этой системе координат будет находиться на координатах (0, 24, 0) </li></ol>
<p>Эта система позаимствована напрямую из MCPE без всяких конвертаций, так что она выглядит немного странно.
</p><p><b>Формат объекта описания части рендера (part-data)</b>:
</p><p>Объект представляет собой массив элементов, каждый из которых может быть боксом (параллелепипедом) или пустым объектом.
</p>
<blockquote>
<p>[<br /> &#160;&#160;&#160;Object1,<br /> &#160;&#160;&#160;Object2,<br /> &#160;&#160;&#160;...<br /> ];
</p>
</blockquote> 
<p>Бокс задается в следующем формате:
</p>
<blockquote>
<p>{<br /> &#160;&#160;&#160;type: "box", // определяет, что это бокс, а не пустой объект<br /> &#160;&#160;&#160;coords: {x: x, y: y, z: z}, // координаты центра бокса x, y, z<br /> &#160;&#160;&#160;size: {x: x, y: y, z: z}, // размер бокса (x, y, z / ширина, высота, длина),<br /> &#160;&#160;&#160;uv: {x: x, y: y} // координаты текстуры бокса x, y<br /> }
</p>
</blockquote> 
<p>Пустой объект имеет только параметр coords, все остальные значения не требуются. Кроме того любой объект может иметь параметр children, который является таким же массивом, как и сама часть, но началом его системы координат будет не (0, 0, 0), а координаты части-родителя.<br /> <b>Координаты текстур (uv)</b>:<br /> Текстура на бокс накладывается как показано на рисунке, координаты UV должны быть координатами верхнего левого угла, а размеры бокса должны совпадать с размерами прямоугольников на рисунке. Важно то, что при измененном масштабе текстуры (pixel scale) координаты должны указываться с его учетом (их нужно разделить на масштаб).<br /> <a href="https://pp.userapi.com/c638116/v638116250/55929/mFzqr8DvHOo.jpg" alt="https://pp.userapi.com/c638116/v638116250/55929/mFzqr8DvHOo.jpg" title="https://pp.userapi.com/c638116/v638116250/55929/mFzqr8DvHOo.jpg">[1</a>]
</p>
<h1> МОДЕЛИ </h1>
<p>Модели совмещают текстуру и рендер, являясь полноценной визуальной составляющей, которую можно использовать для мобов. Модель создается с помощью <span style="font-size:larger;"><i>new EntityModel();</i></span> Для задания модели используются следующие методы:
</p>
<ol><li>&#160;.setTexture(texture) - устанавливает текстуру, где texture - объект текстуры </li>
<li>&#160;.setRender(render) - устанавливает рендер, где render - объект рендера </li>
<li>&#160;.createAnimation(frames, function(frame) { ... return&#160;; }, delay) - создает анимацию модели, где frames - кол-во кадров анимации, далее идет код, который от номера кадра (от 0 до frames – 1) должен вернуть рендер для этого кадра, если ренден не возвращается, используется предыдущий кадр, delay - задержка между кадрами в тиках, если не указан, равен 1. </li></ol>
<p><b>Пример будет в главе про визуальный контроллер.</b>
</p></div>
@@ Строка 132: / Строка 132: @@
 #&nbsp;.setTexture(texture) - устанавливает текстуру, где texture - объект текстуры
 #&nbsp;.setRender(render) - устанавливает рендер, где render - объект рендера
-#&nbsp;.createAnimation(frames, function(frame) { ... return&nbsp;; }, delay) - создает анимацию модели, где frames - кол-во кадров анимации, далее идет код, который от номера кадра (от 0 до frames – 1) должен вернуть рендер для этого кадра, если рендер не возвращается, используется предыдущий кадр, delay - задержка между кадрами в тиках, если не указан, равен 1.
+#&nbsp;.createAnimation(frames, function(frame) { ... return&nbsp;; }, delay) - создает анимацию модели, где frames - кол-во кадров анимации, далее идет код, который от номера кадра (от 0 до frames – 1) должен вернуть рендер для этого кадра, если ренден не возвращается, используется предыдущий кадр, delay - задержка между кадрами в тиках, если не указан, равен 1.
 '''Пример будет в главе про визуальный контроллер.'''