Редактирование:Модуль Entity

<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"><div class="mw-parser-output"><p>Вся работа с мобами осуществляется через модуль Entity.
</p>
<div class="mw-parser-output">
<h2> Методы для работы с сущностями в Inner Core </h2>
<h3> Получение </h3>
<ul><li>Entity.getAll() - возвращает Java-массив всех мобов в мире </li>
<li>Entity.getAllJS() - идентичен <i>Entity.getAll</i>, оставлен для совместимости </li>
<li>Entity.isExist(mob) - проверяет, существует ли сущность mob </li>
<li>Entity.getCustom(mob) - возвращает Updatable сущности mob, если она создана через MobRegistry. </li>
<li>Entity.findNearest(coords, type, maxRange) - возвращает ближайшую к координатам <i>coords </i>сущность. Если задан параметр&#160;<i>type</i>, то находит только сузностей с заданным типом. Если задан <i>maxRange</i>, то поиск будет производится в радиусе&#160;<i>maxRange.</i>&#160;Возвращает объект, содержащий уникальный идентификатор моба и расстояние до него:&#160;{entity: entity, dis: distance} </li>
<li>Entity.getAllInRange(coords, maxRange, [type]) - возвращает JS-массив сущностей с типом type в сфере с центром coords и радиусом maxRange. Если тип сущности не указан, найдёт все сущности в указанном радиусе </li></ul>
<h3> Создание и удаление </h3>
<ul><li>Entity.spawn(x, y, z, id, [skin]) - спавнит существо с типом id, координатами x, y, z и назначает ему скин skin. </li>
<li>Entity.spawnAtCoords(coords, id, skin) - то же, что и&#160;<i>Entity.spawn</i>,&#160;но позволяет задать координаты в виде объекта {x: x, y: y, z: z} </li>
<li>Entity.spawnCustom(name, x, y, z, [extra]) - спавнит сущность со строковым ID&#160;name, зарегистрированным через&#160;MobRegistry, на координатах x, y, z. Позволяет передать дополнительные данные в контроллеры сущности с помощью параметра extra </li>
<li>Entity.spawnCustomAtCoords(name, coords, [extra]) - то же, что и&#160;<i>Entity.spawnCustom,</i>&#160;но позволяет задать координаты в виде объекта {x: x, y: y, z: z} </li>
<li>Entity.remove(mob) - удаляет сущность mob из мира. </li></ul>
<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">
<h3> Работа с эффектами </h3>
<ul><li>Entity.addEffect(entity, effectId, amplifier, effectTime, [ambience], [particles]) - накладывает на сущность entity эффект с id effectId на время&#160;effectTime.&#160;amplifier - сила эффекта,&#160;ambience - внешний вид частиц (<i>true</i>/<i>false</i>) и&#160;particles - отображать ли частицы (<i>true</i>/<i>false</i>) </li>
<li>Entity.clearEffect(entity, effectId) - удаляет у сущности mob эффект id. </li>
<li>Entity.clearEffects(entity) - удаляет у сущности mob все эффекты. </li></ul>
</div> </div> </div> </div>
<h3> Здоровье моба </h3>
<ul><li>Entity.damageEntity(entity, damage, [cause], [params]) -&#160; наносит сущности entity урон в damage единиц,&#160;cause может использоваться для определения attacker события,&#160;params - объект значений bool1 и bool2, смысл которых пока неизвестен </li>
<li>Entity.healEntity(entity, damage) - лечит сущность entity на damage единиц. </li>
<li>Entity.health(entity) - возвращает объект для работы со здоровьем моба. Объект содержит следующие методы, привязанные к entity: 
<ul><li>get() - возвращает здоровье сущности </li>
<li>set() - устанавливает здоровье сущности </li>
<li>getMax() - получает максимальное&#160;возможное значение здоровья сущности </li>
<li>setMax() -&#160;устанавливает максимальное возможное значение здоровья сущности   </li></ul></li>
<li>Entity.getHealth(mob) - возвращает здоровье сущности mob. </li>
<li>Entity.setHealth(mob, hp) - устанавливает здоровье в hp единиц сущности mob. </li>
<li>Entity.getMaxHealth(mob) - возвращает максимальное количество здоровья сущности mob. </li>
<li>Entity.setMaxHealth(mob, maxhp) - устанавливает максимальное здоровье maxhp сущности mob. </li></ul>
<h3> Внешний вид моба </h3>
<ul><li>Entity.setHitbox(mob, width, height) - устанавливает сущности mob хитбокс высотой width и шириной height. </li>
<li>Entity.setSkin(mob, skin) - ставит текстуру по пути texture сущности skin. </li>
<li>Entity.setTexture(mob, texture) - ставит объект Texture в качестве текстуры для моба. На данный момент анимированные текстуры не поддерживаются.&#160; </li>
<li>Entity.getRender(mob) - возвращает <a href="InnerCore%2F%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA%20%D0%B2%D0%B0%D0%BD%D0%B8%D0%BB%D1%8C%D0%BD%D1%8B%D1%85%20%D1%80%D0%B5%D0%BD%D0%B4%D0%B5%D1%80%D0%BE%D0%B2">id рендера</a> сущности mob </li>
<li>Entity.setRender(mob, render) - устанавливает сущности mob рендер&#160;с id&#160;render. <a href="InnerCore%2F%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA%20%D0%B2%D0%B0%D0%BD%D0%B8%D0%BB%D1%8C%D0%BD%D1%8B%D1%85%20%D1%80%D0%B5%D0%BD%D0%B4%D0%B5%D1%80%D0%BE%D0%B2">Список ванильных рендеров</a> </li></ul>
<div class="mw-parser-output">
<h3> Работа с инвентарём </h3>
<ul><li>Entity.getArmorSlot(entity, slot) - возвращает объект, содержащий информацию о предмете, хранимом в указанном слоте брони&#160;slot сущности&#160;entity </li>
<li>Entity.setArmorSlot(entity, slot, id, count, data) - устанавливает в указанный слот брони&#160;slot сущности&#160;entity предмет с id, data и с количеством&#160;count&#160; </li>
<li>Entity.getCarriedItem(entity) - возвращает объект, содержащий информацию о предмете, который держит в руках сущность&#160;entity </li>
<li>Entity.setCarriedItem(entity, id, count, data) -&#160;устанавливает в руку сущности&#160;entity предмет с id, data и с количеством&#160;count&#160; </li>
<li>Entity.getDroppedItem(entity) - получает предмет, которую сущность&#160;entity&#160;дропнула </li>
<li>Entity.setDroppedItem(entity, id, count, data) - устанавливает&#160;предмет, которую сущность&#160;entity&#160;дропнула </li></ul>
</div> 
<h3> Параметры моба </h3>
<ul><li>Entity.getType(entity) - получает числовой тип моба entity </li>
<li>Entity.getAge(mob) - возвращает возраст сущности mob </li>
<li>Entity.setAge(mob, age) - устанавливает возраст age сущности mob </li>
<li>Entity.getNameTag(mob) - возвращает имя сущности mob. </li>
<li>Entity.setNameTag(mob, name) - устанавливает сущности mob имя name. </li>
<li>Entity.getProjectileItem(mob) - проверяет, является ли сущность mob снарядом, если это так, возвращает ее данные как предмета. </li></ul>
<div class="mw-parser-output"><div class="mw-parser-output">
<h3> Поведение моба </h3>
<ul><li>Entity.getMobile(mob) - получает, может ли сущность mob двигаться&#160; </li>
<li>Entity.setMobile(mob, mobile) - в зависимости от значения mobile (<i>true</i>/<i>false</i>)&#160;управляет возможностью сущности mob двигаться. </li>
<li>Entity.getSneaking(mob) - проверяет, сидит ли сущность mob. </li>
<li>Entity.setSneaking(mob, sneak) - в зависимости от значения mobile (<i>true</i>/<i>false</i>)&#160;управляет, находится ли сущность mob в присяде. </li>
<li>Entity.setFire(mob, tick, [force]) - заставляет сущность mob гореть в течении tick тиков. Последний параметр force следует всегда устанавливать в true </li></ul>
</div> 
<h3> Положение и поворот моба </h3>
<ul><li>Entity.setPosition(mob, x, y, z) - устанавливает сущность mob на координаты x, y, z. </li>
<li>Entity.getPosition(mob) - возвращает координаты сущности mob. </li>
<li>Entity.addPosition(mob, x, y, z) - относительно перемещает сущность mob на координаты x, y, z. </li>
<li>Entity.getLookAngle(mob) - возвращает угол обзора сущности mob в виде объекта {pitch: pitch, yaw: yaw}. Углы выражаются в радианах </li>
<li>Entity.setLookAngle(mob, yaw, pitch) - устанавливает сущности углы обзора yaw и pitch.&#160;Углы выражаются в радианах </li>
<li>Entity.getLookVector(mob) - возвращает вектор взгляда сущности mob&#160;в формате {x: x, y: y, z: z} </li>
<li>Entity.lookAt(entity, x, y, z) - устанавливает обзор сущности entity так, чтобы она смотрела на координаты&#160;x, y, z </li>
<li>Entity.lookAtCoords(entity, coords) - то же, что и&#160;<i>Entity.lookAt</i>, но на вход принимает координаты в формате&#160;{x: x, y: y, z: z} </li></ul>
<div class="mw-parser-output">
<h3> Движение моба </h3>
<ul><li>Entity.setVelocity(mob, velx, vely, velz) - устанавливает трехмерное ускорение velx, vely, velz сущности mob </li>
<li>Entity.getVelocity(mob) - возвращает трехмерное ускорение сущности mob в виде объекта&#160;{x: x, y: y, z: z} </li>
<li>Entity.addVelocity(mob, velx, vely, velz) - добавляет трехмерное ускорение velx, vely, velz сущности mob </li>
<li>Entity.moveToTarget(entity, target, params) - передвигает сущность entity к координатам&#160;target. Параметр params - объект следующего формата (поданы значения по умолчанию) </li></ul>
<p>&#160;
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">{
    speed: 0, // Скорость движения
    denyY: false, // Запрещено ли изменение скорости по оси Y
    jumpVel: 0 // Задаёт скорость по оси Y
}</syntaxhighlight></pre>
</p>
<ul><li>Entity.moveToAngle(mob, angle, params) - разворачивает сущность mob на угол angle. Параметр params идентичен параметру метода&#160;<i>Entity.moveToTarget</i> </li>
<li>Entity.moveToLook(mob, params) - разворачивает сущность mob в сторону взгляда.&#160;Параметр params идентичен параметру метода&#160;<i>Entity.moveToTarget</i> </li>
<li>Entity.getMovingVector(mob) - возвращает вектор движения сущности mob - объект со следующими полями: 
<ul><li>x - проекция единичного вектора скорости сущности на ось x </li>
<li>y - проекция единичного вектора скорости сущности на ось y </li>
<li>z - проекция единичного вектора скорости сущности на ось&#160;z&#160; </li>
<li>size - длина вектора скорости, численное значение скорости сущности </li>
<li>xzsize - скорость сущности в горизонтальной плоскости   </li></ul></li>
<li>Entity.getMovingAngle(mob) - возвращает угол передвижения сущности mob в формате&#160;{pitch: pitch, yaw: yaw} </li></ul>
<p><span style="display: none;">&#160;</span>
</p>
</div> 
<h3> Вспомагательные методы </h3>
<ul><li>Entity.getDistanceBetweenCoords(coords1, coords2) - возвращает расстояние между координатами в обьектах coords1 и coords2. Координаты задаются в формате&#160;{x: x, y: y, z: z} </li>
<li>Entity.getDistanceToCoords(mob, coords) - возвращает расстояние от сущности mob до координат в обьекте coords&#160;{x: x, y: y, z: z} </li>
<li>Entity.getDistanceToEntity(mob1, mob2) - возвращает расстояние между сущностями mob1 и mob2. </li>
<li>Entity.getXZPlayerDis(entity) - возвращает расстояние в горизонтальной плоскости от сущности&#160;entity до игрока </li>
<li>Entity.getLookVectorByAngle(angle) - возвращает вектор взгляда сущности в формате {x: x, y: y, z: z}, исходя из угла обзора angle, представленного в формате&#160;{pitch: pitch, yaw: yaw} </li>
<li>Entity.getLookAt(mob, x, y, z) - высчитывает угол обзора сущности, необходимый, чтобы она смотрела на координаты&#160;x, y, z. Возвращает объект формата&#160;{pitch: pitch, yaw: yaw} </li></ul>
</div> </div>
<h2> Легаси-функции, не реализованные в Inner Core </h2>
<ul><li>Entity.getExtra(mob, propetry) - возвращает значение свойства propetry сущности mob в виде строки </li>
<li>Entity.putExtra(mob, propetry, value) - записывает свойство propetry со значением value в виде строки сущности mob. </li>
<li>Entity.getExtraJson(mob, propetry) - возвращает свойство propetry сущности mob в виде JS-обьекта. </li>
<li>Entity.putExtraJson(mob, propetry, value) - записывает свойство propetry со значением value в виде JS-обьекта сущности mob. </li>
<li>Entity.getSkin(mob) - возвращает путь в текстурпаке текстуры сущности mob.&#160; </li>
<li>Entity.rideAnimal(rider, riding) - сажает сущность rider на сущность riding. </li>
<li>Entity.getRider(mob) - проверяет, всадник ли сущность mob. </li>
<li>Entity.getRiding(mob) - проверяет, сидят ли на сущности mob. </li>
<li>Entity.getTarget(mob) - возвращает цель сущности mob. </li>
<li>Entity.setTarget(attaker, victim) - ставит сущности attacker цель victim. </li>
<li>Entity.getMovingAngleByPositions(pos1, pos2) - не реализована </li>
<li>Entity.getInventory(mob, [object], [object]) - возвращает инвентарь сущности mob.&#160; </li></ul>
</div> </div> </div> </div> </div> </div>
</div>
@@ Строка 5: / Строка 5: @@
 == Методы для работы с сущностями в Inner Core ==
-<div class="mw-parser-output">
 === Получение ===
@@ Строка 12: / Строка 11: @@
 *Entity.isExist(mob) - проверяет, существует ли сущность mob
 *Entity.getCustom(mob) - возвращает Updatable сущности mob, если она создана через MobRegistry.
-*Entity.findNearest(coords, type, maxRange) - возвращает ближайшую к координатам ''coords ''сущность. Если задан параметр&nbsp;''type'', то находит только сущностей с заданным типом. Если задан ''maxRange'', то поиск будет производится в радиусе&nbsp;''maxRange.''&nbsp;Возвращает объект, содержащий уникальный идентификатор моба и расстояние до него:&nbsp;{entity: entity, dis: distance}
+*Entity.findNearest(coords, type, maxRange) - возвращает ближайшую к координатам ''coords ''сущность. Если задан параметр&nbsp;''type'', то находит только сузностей с заданным типом. Если задан ''maxRange'', то поиск будет производится в радиусе&nbsp;''maxRange.''&nbsp;Возвращает объект, содержащий уникальный идентификатор моба и расстояние до него:&nbsp;{entity: entity, dis: distance}
 *Entity.getAllInRange(coords, maxRange, [type]) - возвращает JS-массив сущностей с типом type в сфере с центром coords и радиусом maxRange. Если тип сущности не указан, найдёт все сущности в указанном радиусе
-</div>
 === Создание и удаление ===
@@ Строка 118: / Строка 116: @@
 <span style="display: none;">&nbsp;</span>
 </div>
-<div class="mw-parser-output">
+=== Вспомагательные методы ===
-=== Вспомогательные методы ===
 *Entity.getDistanceBetweenCoords(coords1, coords2) - возвращает расстояние между координатами в обьектах coords1 и coords2. Координаты задаются в формате&nbsp;{x: x, y: y, z: z}
@@ Строка 127: / Строка 124: @@
 *Entity.getLookVectorByAngle(angle) - возвращает вектор взгляда сущности в формате {x: x, y: y, z: z}, исходя из угла обзора angle, представленного в формате&nbsp;{pitch: pitch, yaw: yaw}
 *Entity.getLookAt(mob, x, y, z) - высчитывает угол обзора сущности, необходимый, чтобы она смотрела на координаты&nbsp;x, y, z. Возвращает объект формата&nbsp;{pitch: pitch, yaw: yaw}
 </div> </div>
-</div>
 == Легаси-функции, не реализованные в Inner Core ==