mineprogramming wiki - Вклад участника [ru]

InnerCore/Модуль GameObject

2017-07-07T21:15:14Z

93.124.107.25: Created page with "<div>Игровые объекты - расширение к Updatable Objects. В отличии от обновляемые объектов, игровые полность..."

<div>Игровые объекты - расширение к Updatable Objects. В отличии от обновляемые объектов, игровые полностью сохраняются, могут создавать свои экземпляры и отвечать на сигналы-события.</div>
=== <br/> <br/> Классы игровых объектов ===

<br/> Чтобы игровой обьект появился в мире, нужно обьявить его класс.
<pre>
var goblin = new GameObject("goblin", {
//здесь нужно прописать все обработчики событий
});</pre>

<br/> Конструктор GameObject создает новый класс игрового объекта.<br/> Первый аргумент - имя класса, под которым он будет доступен в некоторых обьектах.<br/> Второй аргумент - прототип класса, содержит свойства экземпляра и обработчики его событий.

 

=== <br/> Обработчики событий ===

<br/> <br/> Обработчик события - обычная функция в классе игрового обьекта. Однако самостоятельно запускаться могут только три:

#init - вызывается при deploy со всеми его аргументами, здесь можно задать начальные значения для игрового объекта.
#loaded - вызывается при загрузке сохранения, необязателен.
#update - вызывается каждый тик, содержит логику игрового объекта, обязателен.

<br/> Чтобы ваш обработчик работал, нужно вызывать его при каком-то событии:

*GameObject.callOfType(тип, событие, параметры...)
*Тип - название класса игрового объекта.
*Событие - название нужного обработчика в кавычках.
*Параметры - параметры для обработчика, может быть до 10 значений.<br/> Также существует безопасный вариант callOfTypeSafe, стопроцентно гарантирующий, что событие будет обработано всеми экземплярами этого класса, даже если в следующий тик часть будет уничтожена.
*GameObject.destroy - уничтожает экземпляр.
*GameObject.getAllByType(class) - обработывает все экземпляры класса. Возвращает список всех экземпляров.
*GameObject.deployGameObject(object, параметры для init) -  превращает произвольный объект в игровой. В объекте должны быть методы init и update.
*GameObject.registerClass(object) - превращает произвольный объект в класс игровых.

CoreEngine/Файл конфигурации

2017-07-07T21:06:29Z

93.124.107.25: Created page with " Для взаимодействия с конфигом в Core Engine существует модуль __config__. *__config__.get() - возвращает объект к..."

Для взаимодействия с конфигом в Core Engine существует модуль __config__.

*__config__.get() - возвращает объект конфига.
*__config__.load() - загружает конфиг из файла, если он еще не загружен, в противном случае ничего не делает.
*__config__.access(ключ) - возвращает значение переданного ключа конфига.
*__config__.save() - сохраняет конфиг в файл.
*__config__.clear() - очищает загруженный конфиг.
*__config__.config - объект загруженного конфига, можно использовать для его изменения.

InnerCore/Анимации

2017-07-07T21:04:12Z

93.124.107.25: Created page with " В Core Engine возможно создавать анимации текста, моделей, предметов в мире.   === Базовая анимация..."

В Core Engine возможно создавать анимации текста, моделей, предметов в мире.

 

=== Базовая анимация ===

 

Рассмотрим базовый тип анимации.

 

Создать ее можно так:

 
<pre>var ani = new Animation.Base(x, y, z);

//x, y, z - координаты</pre>

 

Однако просто анимация без настроек просто бессмыслена. Да и менять анимацию потом очень проблематично.

 

Создадим обновляемый обьект и анимацию внутри него:
<pre>//Создаем обьект

var ani_upd = {

//Задаем его координаты

x: 0,

y: 0,

z: 0,

//Обьект анимации

ani: {},

//Флажок инициализации

init: false,

//Функция инициализации анимации

init_animation: function(){

//Создаем анимацию

this.ani = new Animation.Base(this.x, this.y, this.z);

},

//Функция обновления анимации

update_animation: function(){

//Устанавливаем позицию анимации

this.ani.setPos(this.x, this.y, this.z);

},

//Обновление

update: function(){

//Если анимация не инициализирована

if (!this.init){

//Инициализировать

this.init_animation();

//Поднять флажок инициализации

this.init = true;

}

//Иначе

else{

//Обновляем анимацию

this.update_animation();

}

//Обновляем позицию анимации

this.x = Player.getPosition().x;

this.y = Player.getPosition().y+4;

this.z = Player.getPosition().z;

}

};

//При запуске в мир запускаем анимацию

Callback.addCallback("LevelLoaded", function(){

Updatable.addUpdatable(ani_upd)

});</pre>

 

Но в таком случае над вашей головой будет висеть кролик.

Чтобы настроить анимацию, нужно применить ее метод describe.
<pre>

{

…

init_animation: function(){

//Создаем анимацию

this.ani = new Animation.Base(this.x, this.y, this.z);

//Настраиваем ее

this.ani.describe({

//Здесь могут находиться настройки анимации

//Можно установить существующий рендер

// (i) Перед тем, как написать этот код, запишите где-нибудь: var NativeEntityRenderType = ModAPI.requireGlobal("EntityRenderType"); Это позволит использовать рендеры из ModPE

render: NativeEntityRenderType.pig,

//А можно установить и свой собственный

renderAPI: ваш обьект рендера,

//Текстура анимации

skin: "/mob/pig.png",

//Остальные свойства ненужны

});

//Загружаем анимацию в мир

this.ani.load();

}

…

}</pre>

 

Теперь мы можем использовать нашу анимацию и отображать ее в мире.

 

=== Предметы ===

 

Также можно создать изображение в мире предмета.

 
<pre>var ani_item = new Animation.Item(x, y, z);</pre>

 

В остальном эта анимация похожа на обычную, только настраивается она методом animation.describeItem
<pre>

ani_item.describeItem({

//Настраиваем характеристики отоюражаемого предмета

id: 280,

count: 1,

data: 0,

//Рендерим палку

//Устанавливаем размер

size: 1,

//Устанавливаем выравнивание по оси x/y/z

rotation: "x\y\z",

//Убираем неровности, если отрисовывается несколько анимаций

notRandomize: true

});</pre>

 

=== Текст ===

 

Также в мире можно отображать в мире текст:

 
<pre>var ani_txt = new Animation.Text(x, y, z);

//Настроим отображаемый текст

ani_txt.setText(text);</pre>

InnerCore/Модуль FileTools

2017-07-07T21:01:34Z

93.124.107.25: Created page with " Хотя Core Engine загружает ресурсы самостоятельно, иногда их нужно загружать из другого места или и..."

Хотя Core Engine загружает ресурсы самостоятельно, иногда их нужно загружать из другого места или из интернета, а потом в CE. Здесь пригодится FileTools. Также ручная работа с файлами полезна при создании файлов настроек.

 

Если в строке с путем не прописан корень файловой системы, то путь будет относительным от FileTools.root

 

*FileTools.mntdir - возвращает путь до хранилища смонтированных папок Linux.
*FileTools.root - возвращает папку Minecraft PE.
*FileTools.workdir - возвращает путь до папки Core Engine.
*FileTools.moddir - возвращает путь до папки с модами.
*FileTools.mkdir(path) - создает папку по указанному пути.
*FileTools.mkworkdirs() - создает рабочую папку.
*FileTools.getFullPath(path) - возвращает абсолютный путь, принимая path.
*FileTools.isExists(path) - проверяет, существует ли файл или папка на пути path.
*FileTools.WriteText(path, value, add) - записывает value по пути path, если add равен true, то добавляет value в конец файла.
*FileTools.ReadText(path) - читает строку по пути path.
*FileTools.WriteImage(path, image) - записывает изображение по пути path.
*FileTools.ReadImage(path) - читает изображение по пути path.
*FileTools.ReadTextAsset(path) - читает текст из текстурпака.
*FileTools.ReadImageAsset(path) - читает изображение из текстурпака.
*FileTools.ReadBytesAsset(path) - читает бинарное значение из текстурпака.
*FileTools.GetListOfDirs(path) - возвращает список папок по данному пути.
*FileTools.GetListOfFiles(path, [object]) - возвращает список файлов по данному пути.
*FileTools.ReadJSON(path) - читает файл JSON по данному пути.
*FileTools.WriteJSON(path, json, beautify) - пишет файл JSON json по данному пути с количеством отступов beautify.

InnerCore/Модуль Updatable

2017-07-07T20:59:53Z

93.124.107.25: Created page with " Модуль обновляемых обьектов, или Updatable - одна из важнейших технологий в CoreEngine наряду с событиям..."

Модуль обновляемых обьектов, или Updatable - одна из важнейших технологий в CoreEngine наряду с событиями. На них построены генерация, tile entity, мобы и все остальное.

 

Для того, чтобы создать обновляемый обьект, используйте метод:

 

*Updatable.addUpdatable(updatable).

 

Обновляемый обьект должен иметь метод update и желательно условие самоуничтожения.

 

С помощью управляемых обьектов можно, например, создавать обработчики некоторых событий, не создавая для этого моба или блок.

 

Важно! Для модификации извне сохраните updatable в переменную, затем укажите ее в создании обновляемого обьекта как аргумент.

 

*Updatable.removeUpdatable(updatable) - принудительно уничтожает объект.
*Updatable.isInUpdate(updatable) - проверяет, обновляется ли updatable.

 

Пример кода на свинопад с использованием Updatable:
<pre>var SubRandomHandler = {

pigfallChance: function(){

return Math.round(Math.random() * 25))

},

update: function(){

if (this.pigfallChance() == 0){

Updatable.addUpdatable(PigfallHandler);

this.remove = true;

}

}

};

var PigfallHandler = {

pigPower: 40,

pigfallTime: 6000,

pigDiapason: 200,

checkSecondPigPosition: function(){

return {

x: Math.round(Math.random() * this.pigDiapason) + Player.getPosition().x,

y: 80 + Math.round(Math.random() * 46),

z: Math.round(Math.random() * this.pigDiapason + Player.getPosition().z

};

},

spawnPig: function(){

let pos = this.checkSecondPigPosition();

Entity.spawn(12, pos.x, pos.y, pos.z);

},

pigChance: function(){

if (Math.round(Math.random() * this.pigPower + 1) == 0){

return true;

}

},

update: function(){

if (this.pigChance){

this.spawnPig();

this.pigfallTime--;

this.pigDiapason = this.pigfallTime / this.pigPower;

if (this.pigfallTime % 120){

this.pigPower--;

};

};

if (this.pigfallTime <= 0){

Updatable.addUpdatable(SubRandomHandler);

this.remove = true;

};

}

};

Callback.addCallback("LevelLoaded",function(){

Updatable.addUpdatable(SubRandomHandler)

});</pre>

InnerCore/Модуль ModAPI

2017-07-07T20:57:22Z

93.124.107.25: Created page with " Core Engine имеет модуль для обмена объектами API между различными модами - ModAPI, обмен API осуществляет..."

Core Engine имеет модуль для обмена объектами API между различными модами - ModAPI, обмен API осуществляется с помощью методов регистрации и публикации API и с помощью методов его получения.

 

Чтобы сделать объект API доступным для других модов используется метод ModAPI.registerAPI("имя API", объект API) - после вызова этого метода, остальные моды смогут получить объект API по данному имени.

 

Чтобы получить объект API нужно добавить специальное событие на имя объекта API, который требуется получить. Событие используется потому, что моды загружаются в произвольном порядке и неизвестно, зарегистрирован ли данный API на момент загрузки мода, который в нем нуждается, даже если мод, который регистрирует, присутсвует.

Для этого используется такой метод:
<pre>ModAPI.addAPICallback("имя API", function(api){

// api является объектом api, зарегистрированным под данным именем

})</pre>

 

Это событие произойдет 1 раз после добавления, при этом если API уже зарегистрирован, то событие произойдет сразу после добавления, иначе оно будет ожидать регистрации.

В этом событии вы можете произвести какие-то действия, связанные с работой с данным API, например при получении ThaumAPI (api таумкрафта), добавить предметам вашего мода аспекты. Если событие не произойдет, значит таумкрафт не установлен и аспекты регистрировать не надо.

 

 

=== Использование событий в скрипте-лаунчере ===

Если мод не может работать без какого-то объекта API (например это дополнение к какому-то моду), то разумно будет сделать так, что мод запускается по событию регистрации данного API и сразу передать ему объект API.

 

К примеру вот код лаунчера мода, который является дополнением к таумкрафту и которому обязателен ThaumAPI:

 
<pre>ModAPI.addAPICallback("ThaumAPI", function(api){

// по событию регистрации ThaumAPI запустить основной мод

Launch({

ThaumAPI: api // в качестве дополнительного значения при запуске под именем ThaumAPI передать полученный объект api

});

});</pre>

 

 

=== Другие методы ModAPI ===

*ModAPI.requireAPI("имя API") - отдает объект API по данному имени, если он зарегистрирован. Несовершенен, потому что порядок загрузки неизвестен. Лучше используйте ModAPI.addAPICallback.
*ModAPI.getModByName("имя мода") - отдает объект мода, отвечающий за его файлы и загрузку, если мод загружен. Несовершенен, потому что порядок загрузки неизвестен. Лучше используйте ModAPI.addModCallback.
*ModAPI.addModCallback("имя мода", function(mod){  <br/>   // mod является объектом мода<br/> }) - добавляет событие, которое произойдет при загрузке мода под данным именем, которому будет передан объект мода. Аналогичен по действию ModAPI.addAPICallback, только для модов.
*ModAPI.isModLoaded("имя мода") - проверяет, загружен ли мод с этим именем. Актуальна в в событиях PostLoaded и ModsLoaded, которые происходят после загрузки всех модов.
*ModAPI.requireGlobal("имя переменной или исполняемая строка") - возвращает переменную с данным именем из самого Core Engine, если передана исполняемая строка, выполняет ее в пространстве имен Core Engine и возвращает результат, при возникновении ошибки возвращает null и пишет ошибку в лог. Может быть использована для получения скрытых модулей или значений ModPE (они могут работать некорректно).

InnerCore/Динамичный интерфейс

2017-07-07T20:53:58Z

93.124.107.25: Created page with " Как упоминалось в уроках ранее, объект описания интерфейса можно изменять, пока интерфейс откр..."

Как упоминалось в уроках ранее, объект описания интерфейса можно изменять, пока интерфейс открыт и изменения тут же будут отображаться в интерфейсе. Больше всего это подходит для элементов, которые должны появляться/изменяться/исчезать только в каких-то определенных условиях (например кнопка, которая появляется, только если в слоте есть предмет)

===   ===

=== Получение объекта описания ===

По скольку интерфейс всегда открывается для контейнера, то контейнер имеет метод получения объекта описания интерфейса для динамичного изменения. Этот метод - getGuiContent() - упоминался в прошлой главе и теперь будет разобран подробнее.

 

Формат объекта описания можно посмотреть в предыущих главах, там же говорится, что динамичными (т.е. изменения которых тут же отобразятся в интерфейсе), являются только части, отвечающие за фон и за элементы - drawing и elements, но не параметры самого интерфейса (заголовок, размер и т.п)

 

И так, предположим мы получили объект описания:
<pre>var content = container.getGuiContent();</pre>

 

Теперь, чтобы изменить в нем фон, мы можем просто присвоить drawing новое значение:
<pre>content.drawing = [

{type: "background", color: android.graphics.Color.RED}

] // мы удалили все прошлые команды и теперь рисуем просто красный фон</pre>

 

С элементами все несколько иначе, чтобы что-то сделать с элементом, нужно обратиться к нему по его имени: content.elements["имя элемента"], после чего с ним можно сделать 3 разных действия:

 

1. Приравнять новому элементу - если элемент с данным именем уже существовал, то старый будет полностью заменен на новый, если элемента не было, то будет просто создан новый элемент

2. Изменить какое-то значение - элемент  с данным именем будет изменен потому что какой то его параметр был изменен.

3. Приравнять null - элемент с данным именем будет удален

 

ПРИМЕР #1: (изменение параметров)
<pre>// код ниже при старте откроет интерфейс с 1 кнопкой, при нажатии на которую она будет перемещаться вниз

var testUIScreen = new UI.StandartWindow({

standart: {

header: {

text: {

text: "TEST UI"

}

},

inventory: {

standart: true

},

background: {

standart: true

}

},

drawing: [],

elements: {

"test_button": {type: "button", bitmap: "close_button_up", x: 400, y: 100, scale: 8, clicker: { // самая обычная кнопка с именем test_button

onClick: function(container){ // функция короткого нажатия, все параметры кроме первого опущены за ненадобностью

var content = container.getGuiContent(); // получаем объект описания, по скольку кнопку можно нажать только с открытым интерфейсом, то он точно определен

content.elements["test_button"].y += 10; // немного сдвигаем кнопку вниз, добавляя 10 к координате y

}

}

}

}

});

// открыть интерфейс

UI.testUI(testUIScreen);</pre>

 

ПРИМЕР #2: (удаление и создание)
<pre>// после нажатия на кнопку, удаляет ее и создает текст о том, что она удалена

var testUIScreen = new UI.StandartWindow({

standart: {

header: {

text: {

text: "TEST UI"

}

},

inventory: {

standart: true

},

background: {

standart: true

}

},

drawing: [],

elements: {

"test_button": {type: "button", bitmap: "close_button_up", x: 400, y: 100, scale: 8, clicker: { // самая обычная кнопка с именем test_button

onClick: function(container){ // функция короткого нажатия, все параметры кроме первого опущены за ненадобностью

var content = container.getGuiContent(); // получаем объект описания, по скольку кнопку можно нажать только с открытым интерфейсом, то он точно определен

content.elements["test_button"] = null; // удаляем кнопку

content.elements["new_element"] = {type: "text", text: "button removed", x: 400, y: 50, width: 200, height: 50}; // создаем текст о том, что она удалена

}

}

}

}

});

// открыть интерфейс

UI.testUI(testUIScreen);</pre>

 

ПРИМЕР #3: (полная замена + изменение фона)
<pre>// после нажатия на кнопку, удаляет ее и создает текст о том, что она удалена, а так же делает фон красным

var testUIScreen = new UI.StandartWindow({

standart: {

header: {

text: {

text: "TEST UI"

}

},

inventory: {

standart: true

},

background: {

standart: true

}

},

drawing: [],

elements: {

"test_button": {type: "button", bitmap: "close_button_up", x: 400, y: 100, scale: 8, clicker: { // самая обычная кнопка с именем test_button

onClick: function(container){ // функция короткого нажатия, все параметры кроме первого опущены за ненадобностью

var content = container.getGuiContent(); // получаем объект описания, по скольку кнопку можно нажать только с открытым интерфейсом, то он точно определен

content.elements["test_button"] = {type: "text", text: "button removed", x: 400, y: 50, width: 200, height: 50}; // заменяем элемент кнопки на текст о том, что она удалена

content.drawing = [

{type: "background", color: android.graphics.Color.RED}

]; // мы удалили все прошлые команды и теперь рисуем просто красный фон

}

}

}

}

});

// открыть интерфейс

UI.testUI(testUIScreen);</pre>

 

ПРИМЕР #4: (tile entity):
<pre>// добавляет tile entity интерфейс с кнопкой, которая медленно опускается, пока интерфейс открыт

var testUIScreen = new UI.StandartWindow({

standart: {

header: {

text: {

text: "TEST UI"

}

},

inventory: {

standart: true

},

background: {

standart: true

}

},

drawing: [],

elements: {

"test_button": {type: "button", bitmap: "close_button_up", x: 400, y: 100, scale: 8, clicker: { // самая обычная кнопка с именем test_button

onClick: function(container){/* ничего не делаем при клике */}

}

}

}

});

Прототип tile entity:

{

// ...

getGuiScreen: function(){ // функция получения интерфейса - отдаем наш интерфейс

return testUIScreen;

},

tick: function(){

var content = this.container.getGuiContent(); // пытаемся получить объект описания

if (content){ // если получить удалось

content.elements["test_button"].y += .3; // медленно сдвигаем кнопку вниз

}

}

// ...

}</pre>

InnerCore/Контейнеры

2017-07-07T20:50:39Z

93.124.107.25: Created page with " Контейнер - это объект, позволяющий хранить предметы в слотах, осуществлять операции с ними и т..."

Контейнер - это объект, позволяющий хранить предметы в слотах, осуществлять операции с ними и так же обладающий методами для интеграции с любым интерфейсом, который открыт для этого контейнера. Произвольный контейнер может быть открыт как любой интерфейс, при этом он будет привязан ко всем слотам интерфейса.

 

Каждый объект tile entity в мире по умолчанию обладает контейнером, который автоматически сохраняется и для которого открывается интерфейс, отданый при выполнении события getGuiScreen. Подробнее об этом в уроке по tile entity и ниже.

 

Все специальные контейнеры, такие как инвентарь игрока или сундука наследуют все методы базового контейнера.

 

=== Методы ===

Создание нового контейнера:
<pre>var container = new UI.Container();</pre>

 

Обращение к встроенному контейнеру внутри tile entity: this.container

 

=== Работа со слотами ===

*getSlot("имя слота") - возвращает объект слота с данным именем, если такого слота нет, создает пустой слот на этом имени и возвращает его. Слот это объект вида {id: id предмета, count: кол-во предмета, data: data предмета}. К слотам интерфейса привязываются слоты с такими же именами, как и у элементов этих слотов в интерфейсе.

 

Пример:
<pre>//интерфейс tile entity задается так:

{

// ...

elements: {

// ...

"test_slot": {type: "slot", x: 400, y: 400, size: 100} // самый обычный слот с именем test_slot

}

}</pre>

 

А прототип tile entity имеет событие клика предметом по нему:
<pre>{

// ...

click: function(id, count, data, coords){

var slot = this.container.getSlot("test_slot"); // получаем объект слота, который привязан к слоту test_slot в интерфейсе

slot.id = id; slot.count = count; slot.data = data; // устанавливаем в слот тот предмет, которым тапнули по блоку tile entity

return false;

}

}</pre>

 

Таким образом каждый раз, когда мы будем тапать предметом по блоку данного tile entity, то в слоте test_slot будет лежать тот же самый предмет, что и в руке.

 

*setSlot("имя слота", id, кол-во, data) - устанавливает переданный предмет в слот с данным именем. Краткая запись того, что было показано в примере.
*clearSlot("имя слота") - очищает слот с данным именем
*validateSlot("имя слота") - если кол-во или id предмета нулевое или отрицательное, очищает слот. Быстрое исправление некорректных значений слота (пустой слот с кол-вом больше 0, предмет существует, однако его кол-во 0)
*validateAll() - вызывает метод validateSlot для всех слотов
*dropAt(x, y, z) - очищает контейнер и дропает все, что содержалось в нем на данных координатах ввиде предметов
*refreshSlots() - ничего не делает в стандартном контейнере, для контейнеров инвентаря блоков и мобов обновляет данные о слотах в контейнере
*applyChanges() - ничего не делает в стандартном контейнере, для контейнеров инвентаря блоков и мобов сохраняет изменения, которые были произведены на контейнере

 

 

=== Работа с интерфейсом ===

*openAs(объект интерфейса любого типа) - открывает данный объект интерфейса и привязывается к нему
*isOpened() - возвращает, открыт ли этот контейнер для какого-то интерфейса
*close() - если открыт для какого-то интерфейса, закрывает его
*getGuiContent() - если открыт для какого-то интерфейса, возвращает объект описания данного интерфейса, который можно изменять для динамичного изменения интерфейса. Не работает, если контейнер открыт для группы окон.
*getGuiScreen()  - если открыт для какого-то интерфейса, возвращает объект этого интерфейса.
*getElement("имя элемента") - если в интерфейсе, для которого открыт данный контейнер, есть элемент с данным именем возвращает его. ВНИМАНИЕ! Это не тот объект элемента, который задается в объекте описания!
*requireElement("имя элемента", "тип элемента") - аналогичен getElement, но если элемент имеет тип, отличающийся от данного, то вернет null.
*setScale("имя элемента шкалы", заполненность 0-1) - если шкала с данным именем существует, устанавливает ее значение на данное, при этом 0 - пустая шкала, 1 - полная
*setScaleAsLiquid("имя элемента шкалы", строковый id жидкости, заполненность 0-1) - если шкала с данным именем существует, устанавливает ее, как шкалу жидкости, меняя текстуру на текстуру жидкости с данным строковым id, при этом размер шкалы не меняется.
*setText("имя элемента текста", строка) - если элемент текста с данным именем существует, меняет его содержание на переданную строку
*setTextSize("имя элемента текста", размер) - если элемент текста с данным именем существует, меняет его размер
*setTextColor("имя элемента текста", цвет) - если элемент текста с данным именем существует, меняет его цвет
*setTextShadow("имя элемента текста", значение тени) - если элемент текста с данным именем существует, меняет его тень

InnerCore/Многопоточность

2017-07-07T20:49:53Z

93.124.107.25: Created page with " Для управления потоками существует модуль Threading. *Threading.initThread(name, func, priority) - создает поток с имен..."

Для управления потоками существует модуль Threading.

*Threading.initThread(name, func, priority) - создает поток с именем name, выполняющий функцию name с приоритетом priority.
*Threading.getThread(name) - возвращает поток с именем name.

InnerCore/Модуль Debug

2017-07-07T20:49:18Z

93.124.107.25: Created page with " *Debug.addParticle(x, y, z, id, vx, vy, vz, data) - создает отладочные частицы, аргументы аналогичны Particles.addParticle. *Debug..."

*Debug.addParticle(x, y, z, id, vx, vy, vz, data) - создает отладочные частицы, аргументы аналогичны Particles.addParticle.
*Debug.message(message) - пишет отладочное сообщение message в чат.
*Debug.warning(message) - пишет тревожное сообщение message в чат.
*Debug.error(message) - пишет сообщение об ошибке message в чат.

InnerCore/Модуль Translation

2017-07-07T20:48:18Z

93.124.107.25:

*Translation.addTranslation(original, lang) - создает перевод lang для строки original.
*Translation.getLanguage() - возвращает текущий язык игры.
*Translation.translate(original) - переводит строку, если имеется перевод на текущий язык.
*Translation.translateItem(name) - переводит название предмета name.
*Translation.translateAllItems() - переводит названия всех предметов.

 

Формат обьекта lang:
<pre>{

//префикс языка:переведенная строка

}</pre>

 

InnerCore/Модуль Translation

2017-07-07T20:47:42Z

93.124.107.25: Created page with " *Translation.addTranslation(original, lang) - создает перевод lang для строки original.   Формат обьекта lang: <pre>{ //пр..."

*Translation.addTranslation(original, lang) - создает перевод lang для строки original.

 

Формат обьекта lang:
<pre>{

//префикс языка:переведенная строка

}</pre>

*Translation.getLanguage() - возвращает текущий язык игры.
*Translation.translate(original) - переводит строку, если имеется перевод на текущий язык.
*Translation.translateItem(name) - переводит название предмета name.
*Translation.translateAllItems() - переводит названия всех предметов.

InnerCore/Модуль Logger

2017-07-07T20:45:20Z

93.124.107.25: Created page with " Для взаимодействия с логом существует модуль Logger. Если log не указан, то используется основной...."

Для взаимодействия с логом существует модуль Logger.

Если log не указан, то используется основной.

*Logger.wipe(log) - стирает лог с именем log.
*Logger.buffer - текущий лог.
*Logger.message(log, message) - пишет в лог log сообщение message.
*Logger.flush(log) - пишет текущий лог в log.
*Logger.formatLog(log) - форматирует лог log.
*Logger.showAsDialog(title, paragraf) - выводит текущий лог в окно с именем title.
*Logger.Log(msg, prefix, log) - записывает сообщение msg с префиксом prefix в лог log.
*Logger.LogError(error, log) - записывает ошибку error в лог log.

InnerCore/Модуль Game

2017-07-07T20:43:46Z

93.124.107.25: Created page with " Для взаимодействия с игрой в общем используется модуль Game. *Game.prevent() - отменяет поведения игры в..."

Для взаимодействия с игрой в общем используется модуль Game.

*Game.prevent() - отменяет поведения игры в контексте.
*Game.message(msg) - пишет сообщение msg в чат.
*Game.tipMessage(msg) - пишет сообщение msg над инвентарем.
*Game.dialogMessage(message, title) - пишет сообщение msg в диалог с заголовком title.
*Game.setDifficulty(difficulty) - устанавливает сложность difficulty.
*Game.getDifficulty() - возвращает сложность.
*Game.getMinecraftVersion() - возвращает версию игры.
*Game.getEngineVersion() - возвращает версию движка.
*[Game.selectLevel(name)] - запускает уровень level.
*Game.setCamera(entity) - переключает камеру игрока на существо entity.
*Game.setTickingSpeed(speed) - устанавливает скорость игры в speed тиков в секунду.

InnerCore/Броня

2017-07-07T20:32:53Z

93.124.107.25: Created page with " Чтобы создать элемент брони, используется метод: <pre>Item.createArmorItem(uid, name, {name: texture_name}, {type: armor_type, armor:..."

Чтобы создать элемент брони, используется метод:
<pre>Item.createArmorItem(uid, name, {name: texture_name}, {type: armor_type, armor: armor_points, durability: damage, texture: texture_armor});

//uid - строковый id предмета

//name - название предмета

//texture_name - текстура предмета

//armor_type - строковой тип брони

//armor_points - количество единиц защиты

//damage - прочность брони

//texture_armor - путь в текстурпаке до текстуры брони на игроке</pre>

 

В большинстве случаев этого метода достаточно, но иногда требуется создать особое поведение брони, когда она надета.

 

Чтобы задать особое поведение элементу брони, используется метод Armor.registerFuncs:

*Armor.registerFuncs(строковый ид, обьект поведения брони)

 

Сам обьект поведения брони выглядит так:
<pre>{

tick: function(slot, inventory, index){

//slot - слот, в котором надета броня

//inventory - инвентарь игрока

//index - номер слота, в котором надета броня

}

//Также здесь могут находиться вспомогательные функции и поля, к которым внутри обьекта нужно обращаться через this

}</pre>

 

Также можно задать поведение броне при ударе игрока мобом:

*Armor.hurtCallback("строковый id", обьект поведения брони)

InnerCore/Модуль Player

2017-07-07T20:30:08Z

93.124.107.25: Created page with " Для взаимодействия с игроком существует модуль Player. *Player.get() - возвращает игрока как сущность д..."

Для взаимодействия с игроком существует модуль Player.

*Player.get() - возвращает игрока как сущность для работы с ним с помощью модуля Entity.
*Player.getNameForEnt(player) - возвращает имя игрока как сущности player.
*Player.getName() - возвращает имя игрока.
*Player.getDimension() - возвращает id измерения, в котором находится игрок.
*Player.isPlayer(mob) - проверяет, является ли сущность mob игроком.
*Player.getPointed() - возвращает обьект, на который смотрит игрок.
*Player.getInventory(mob, [object], [object]) - возвращает инвентарь игрока как сущности mob.
*Player.getCarriedItem() - возвращает предмет, который держит игрок.
*Player.setCarriedItem(id, count, data) - заставляет игрока держать предмет с id, count, data.
*Player.decreaseCarriedItem(count) - удаляет count предметов из руки игрока.
*Player.setPosition(x, y, z) - ставит игрока на координаты x, y, z.
*Player.getPosition() - возвращает координаты игрока.
*Player.addPosition(x, y, z) - смещает игрока на координаты x, y, z.
*Player.setVelocity(velx, vely, velz) - ставит игроку трехмерное ускорение velx, vely, velz.
*Player.getVelocity() - возвращает трехмерное ускорение игрока.
*Player.addVelocity(velx, vely, velz) - добавляет игроку трехмерное ускорение velx, vely, velz.
*Player.experience() - возвращает состояние опыта игрока.
*Player.getExperience() - возвращает опыт игрока.
*Player.setExperience(exp) - устанавливает exp опыта игроку.
*Player.addExperience(exp) - добавляет exp опыта игроку.
*Player.level() - возвращает состояние уровня игрока.
*Player.getLevel() - возвращает уровень игрока.
*Player.setLevel(lvl) - ставит lvl уровень игроку.
*Player.addLevel(lvl) - добавляет lvl уровней игроку.
*Player.flying() - возвращает состояние полета игрока.
*Player.getFlyingEnabled() - проверяет, может ли летать игрок.
*Player.setFlyingEnabled(fly?) - устанавливает возможность игрока летать.
*Player.getFlying() - проверяет, летит ли игрок.
*Player.setFlying(fly?) - устанавливает состояние полета игрока.
*Player.exhaustion() - возвращает состояние истощения игрока.
*Player.getExhaustion() - возвращает истощение игрока.
*Player.setExhaustion(exh) - задает игроку exh единиц истощения.
*Player.hunger() - возвращает состояние сытости игрока.
*Player.getHunger() - возвращает сытость игрока.
*Player.setHunger(hnr) - задает hnr единиц сытости игрока.
*Player.saturation() - возвращает состояние насыщения игрока.
*Player.getSaturation() - возвращает насыщение игрока.
*Player.setSaturation(sat) - задает sat единиц насыщения игроку.
*Player.health() - возвращает состояние здоровья игрока.
*Player.getHealth() - возвращает здоровье игрока.
*Player.setHealth(hp) - задает hp единиц здоровья игроку.
*Player.score() - возвращает состояние счета игрока.
*Player.getScore() - возвращает счет игрока.

InnerCore/Модуль Entity

2017-07-07T20:27:19Z

93.124.107.25: Created page with " Вся работа с мобами осуществляется через модуль Entity.   *Entity.getAll() - возвращает Java-массив всех..."

Вся работа с мобами осуществляется через модуль Entity.

 

*Entity.getAll() - возвращает Java-массив всех мобов в мире.
*Entity.getAllJS() - возвращает JavaScript-массив всех мобов в мире.
*Entity.getExtra(mob, propetry) - возвращает значение свойства propetry сущности mob в виде строки.
*Entity.putExtra(mob, propetry, value) - записывает свойство propetry со значением value в виде строки сущности mob.
*Entity.getExtraJson(mob, propetry) - возвращает свойство propetry сущности mob в виде JS-обьекта.
*Entity.putExtraJson(mob, propetry, value) - записывает свойство propetry со значением value в виде JS-обьекта сущности mob.
*Entity.addEffect(mob, id, duration, level, [boolean], [boolean]) - ставит сущности mob эффект id продолжительностью duration, уровня level.
*Entity.clearEffect(mob, id) - удаляет у сущности mob эффект id.
*Entity.clearEffects(mob) - удаляет у сущности mob все эффекты.
*Entity.damageEntity(mob, hp) -  наносит сущности mob урон в hp единиц.
*Entity.healEntity(mob, hp) - лечит сущность mob на hp единиц.
*Entity.getType(a) - возвращает числовой тип сущности mob.
*Entity.setHitbox(mob, width, height) - устанавливает сущности mob хитбокс высотой width и шириной height.
*Entity.isExist(mob) - проверяет, существует ли сущность mob.
*Entity.spawn(id, x, y, z, [extra]) - спавнит существо с типом id, координатами x, y, z и назначает ему extra-свойства.
*Entity.spawnCustom(name, x, y, z, [extra]) - то же, что и Entity.spawn, но спавнит сущностей со строковым ид name, созданных через MobRegistry.
*Entity.remove(mob) - удаляет сущность mob из мира.
*Entity.getCustom(mob) - возвращает прототип сущности mob, если она создана через MobRegistry.
*Entity.getAge(mob) - возвращает возраст сущности mob.Entity.setAge(mob, age) - устанавливает возраст age сущности mob.
*Entity.getSkin(mob) - возвращает путь в текстурпаке текстуры сущности mob.
*Entity.setSkin(mob, texture) - ставит текстуру по пути texture сущности mob.
*Entity.getRender(mob) - возвращает id рендера сущности mob.
*Entity.setRender(mob, render) - устанавливает рендером с id render сущности mob.
*Entity.rideAnimal(rider, riding) - сажает сущность rider на сущность riding.
*Entity.getNameTag(mob) - возвращает имя сущности mob.
*Entity.setNameTag(mob, name) - устанавливает сущности mob имя name.
*Entity.getTarget(mob) - возвращает цель сущности mob.
*Entity.setTarget(attaker, victim) - ставит сущности attacker цель victim.
*Entity.setMobile(mob, mobile?) - в зависимости от значения mobile? управляет возможностью сущности mob двигаться.
*Entity.getSneaking(mob) - проверяет, ползет ли сущность mob.
*Entity.setSneaking(mob, sneak?) - разрешает или запрещает сущности mob ползти.
*Entity.getRider(mob) - проверяет, всадник ли сущность mob.
*Entity.getRiding(mob) - проверяет, сидят ли на сущности mob.
*Entity.setFire(mob, tick) - заставляет сущность mob гореть в течении tick тиков.
*Entity.getHealth(mob) - возвращает здоровье сущности mob.
*Entity.setHealth(mob, hp) - устанавливает здоровье в hp единиц сущности mob.
*Entity.getMaxHealth(mob) - возвращает максимальное количество здоровья сущности mob.
*Entity.setMaxHealth(mob, maxhp) - устанавливает максимальное здоровье maxhp сущности mob.
*Entity.setPosition(mob, x, y, z) - устанавливает сущность mob на координаты x, y, z.
*Entity.getPosition(mob) - возвращает координаты сущности mob.Entity.addPosition(mob, x, y, z) - относительно перемещает сущность mob на координаты x, y, z.
*Entity.setVelocity(mob, velx, vely, velz) - устанавливает трехмерное ускорение velx, vely, velz сущности mob.
*Entity.getVelocity(mob) - возвращает трехмерное ускорение сущности mob.
*Entity.addVelocity(mob, velx, vely, velz) - добавляет трехмерное ускорение velx, vely, velz сущности mob.
*Entity.getDistanceBetweenCoords(coords1, coords2) - возвращает расстояние между координатами в обьектах coords1 и coords2.
*Entity.getDistanceToCoords(mob, coords) - возвращает расстояние от сущности mob до координат в обьекте coords.
*Entity.getDistanceToEntity(a, b) - возвращает расстояние между сущностями mob1 и mob2.
*Entity.getLookAngle(mob) - возвращает угол обзора сущности mob.
*Entity.setLookAngle(mob, jaw, pitch) - устанавливает сущности углы обзора jaw и pitch.
*Entity.getLookVector(mob) - возвращает вектор взгляда сущности mob.
*Entity.getLookAt(mob, x, y, z) - возвращает угол обзора сущности mob на координаты x, y, z.
*Entity.lookAt(a, b, c, d) - устанавливает обзор сущности mob на координаты x, y, z.
*Entity.moveToTarget(mob1, mob2, params) - передвигает сущность mob1 к сущности mob2 с настройками params.
*Entity.moveToAngle(mob, angle, params) - передвигает сущность mob на угол angle с настройками params.
*Entity.moveToLook(mob, params) - перемещает сущность mob в направлении взгляда с настройками params.
*Entity.getMovingVector(mob) - возвращает вектор движения сущности mob.
*Entity.getMovingAngle(mob) - возвращает угол передвижения сущности mob.
*Entity.findNearest(x, y, z) - возвращает ближайшую к координатам x, y, z сущность.
*Entity.getAllInRange(coords, type, maxRange) - возвращает JS-массив сущностей с типом type в сфере с центром coords и радиусом maxRange.
*Entity.getInventory(mob, [object], [object]) - возвращает инвентарь сущности mob.
*Entity.getProjectileItem(mob) - проверяет, является ли сущность mob снарядом, если это так, возвращает ее данные как предмета.

InnerCore/Модуль World

2017-07-07T20:23:17Z

93.124.107.25:

Вся работа с миром осуществляется через модуль World.

 

 

=== Работа с блоками ===

*World.setBlock(x, y, z, id, metadata) - устанавливает блок с данным ID и metadata на координаты x, y, z
*World.setFullBlock(x, y, z, fullTile) - принимает объект со значениями id, data, устанавливает блок с данным ID и metadata на координаты x, y, z
*World.getBlock(x, y, z) - возвращает объект со значениями id, data, которые передают ID и metadata на координатах x, y, z
*World.getBlockID(x, y, z) - возвращает объект со значениями id, data, которые передают ID и metadata блока на координатах x, y, z
*World.getBlockID(x, y, z) - возвращает id блока на координатах x, y, z
*World.getBlockData(x, y, z) - возвращает metadata блока на координатах x, y, z
*World.destroyBlock(x, y, z, drop) - уничтожает блок на координатах x, y, z, если drop истенен, то дропает его

 

 

=== Работа с tile entity и контейнерами ===

*World.getTileEntity(x, y, z) - возвращает объект tile entity на координатах x, y, z, или null, если его нет
*World.addTileEntity(x, y, z) - если блок на координатах x, y, z является блоком tile entity и не активирован, то активирует его и возвращает созданный объект tile entity
*World.removeTileEntity(x, y, z) - если на координатах x, y, z есть tile entity, уничтожает его.
*World.getConteiner(x, y, z) - если на координатах x, y, z находится сундук, печь или tile entity, возвращает его контейнер, если это печь или сундук, то контейнер обладает методами refreshSlots()/applyChanges()

 

 

=== Работа с окружением ===

*World.getThreadTime() - возвращает номер такта основного потока со входа в мир
*World.getWorldTime() - возвращает игровое время в тиках
*World.setWorldTime() - устанавливает игровое время в тиках
*World.setDayMode(isDay) - заставляет солнце передвигаться в дневную позицию, если isDay истинно, иначе в ночную
*World.setNightMode(isNight) - заставляет солнце передвигаться в ночную позицию, если isNight истинно, иначе в дневную
*World.getWeather() - возвращает объект с данными о погоде, rain - уровень дождя, thunder - уровень грозы
*World.setWeather(weather) - устанавливает погоду по объекту с данными о погоде, rain - уровень дождя, thunder - уровень грозы

 

 

=== Другие методы ===

*World.drop(x, y, z, id, count, data) - дропает предмет [id, count, data] на координаты x, y, z и возвращает его
*World.explode(x, y, z, power, fire) - создает взрыв на координатах x, y, z мощности power, если fire истинно, поджигает все в области взрыва
*World.getBiome(x, z) - отдает числовой ID биома на координатах x, z
*World.getBiomeName(x, z) - отдает название биома на координатах x, z
*World.getGrassColor(x, z) - отдает цвет травы на координатах x, z ввиде одного числа
*World.setGrassColor(x, z, color) - устанавливает цвет травы на координатах x, z ввиде одного числа
*World.getGrassColorRGB(x, z) - отдает цвет травы на координатах x, z ввиде объекта, содержащего три компоненты цвета r, g, b, каждая от 0 до 255
*World.setGrassColorRGB(x, z, rgb) - устанавливает цвет травы на координатах x, z ввиде объекта, содержащего три компоненты цвета r, g, b, каждая от 0 до 255
*World.canSeeSky(x, y, z) - отдает true, если из точки x, y, z видно небо, иначе false
*World.playSound(x, y, z, "name", volume) - проигрывает стандартный звук "name" на координатах x, y, z с громкостью volume от 0 до 100
*World.playSoundAtEntity(entity, "name", volume) - проигрывает стандартный звук "name" на координатах данного моба entity с громкостью volume от 0 до 100

InnerCore/Модуль World

2017-07-07T20:23:02Z

93.124.107.25:

Вся работа с миром осуществляется через модуль World.

 

 

=== Работа с блоками ===

*World.setBlock(x, y, z, id, metadata) - устанавливает блок с данным ID и metadata на координаты x, y, z
* 
*World.setFullBlock(x, y, z, fullTile) - принимает объект со значениями id, data, устанавливает блок с данным ID и metadata на координаты x, y, z
* 
*World.getBlock(x, y, z) - возвращает объект со значениями id, data, которые передают ID и metadata на координатах x, y, z
* 
*World.getBlockID(x, y, z) - возвращает объект со значениями id, data, которые передают ID и metadata блока на координатах x, y, z
* 
*World.getBlockID(x, y, z) - возвращает id блока на координатах x, y, z
* 
*World.getBlockData(x, y, z) - возвращает metadata блока на координатах x, y, z
* 
*World.destroyBlock(x, y, z, drop) - уничтожает блок на координатах x, y, z, если drop истенен, то дропает его

 

 

=== Работа с tile entity и контейнерами ===

*World.getTileEntity(x, y, z) - возвращает объект tile entity на координатах x, y, z, или null, если его нет
*World.addTileEntity(x, y, z) - если блок на координатах x, y, z является блоком tile entity и не активирован, то активирует его и возвращает созданный объект tile entity
*World.removeTileEntity(x, y, z) - если на координатах x, y, z есть tile entity, уничтожает его.
*World.getConteiner(x, y, z) - если на координатах x, y, z находится сундук, печь или tile entity, возвращает его контейнер, если это печь или сундук, то контейнер обладает методами refreshSlots()/applyChanges()

 

 

=== Работа с окружением ===

*World.getThreadTime() - возвращает номер такта основного потока со входа в мир
*World.getWorldTime() - возвращает игровое время в тиках
*World.setWorldTime() - устанавливает игровое время в тиках
*World.setDayMode(isDay) - заставляет солнце передвигаться в дневную позицию, если isDay истинно, иначе в ночную
*World.setNightMode(isNight) - заставляет солнце передвигаться в ночную позицию, если isNight истинно, иначе в дневную
*World.getWeather() - возвращает объект с данными о погоде, rain - уровень дождя, thunder - уровень грозы
*World.setWeather(weather) - устанавливает погоду по объекту с данными о погоде, rain - уровень дождя, thunder - уровень грозы

 

 

=== Другие методы ===

*World.drop(x, y, z, id, count, data) - дропает предмет [id, count, data] на координаты x, y, z и возвращает его
*World.explode(x, y, z, power, fire) - создает взрыв на координатах x, y, z мощности power, если fire истинно, поджигает все в области взрыва
*World.getBiome(x, z) - отдает числовой ID биома на координатах x, z
*World.getBiomeName(x, z) - отдает название биома на координатах x, z
*World.getGrassColor(x, z) - отдает цвет травы на координатах x, z ввиде одного числа
*World.setGrassColor(x, z, color) - устанавливает цвет травы на координатах x, z ввиде одного числа
*World.getGrassColorRGB(x, z) - отдает цвет травы на координатах x, z ввиде объекта, содержащего три компоненты цвета r, g, b, каждая от 0 до 255
*World.setGrassColorRGB(x, z, rgb) - устанавливает цвет травы на координатах x, z ввиде объекта, содержащего три компоненты цвета r, g, b, каждая от 0 до 255
*World.canSeeSky(x, y, z) - отдает true, если из точки x, y, z видно небо, иначе false
*World.playSound(x, y, z, "name", volume) - проигрывает стандартный звук "name" на координатах x, y, z с громкостью volume от 0 до 100
*World.playSoundAtEntity(entity, "name", volume) - проигрывает стандартный звук "name" на координатах данного моба entity с громкостью volume от 0 до 100

InnerCore/Модуль World

2017-07-07T20:22:41Z

93.124.107.25:

Вся работа с миром осуществляется через модуль World.

 

 

=== Работа с блоками ===

*World.setBlock(x, y, z, id, metadata) - устанавливает блок с данным ID и metadata на координаты x, y, z
* 
*World.setFullBlock(x, y, z, fullTile) - принимает объект со значениями id, data, устанавливает блок с данным ID и metadata на координаты x, y, z
* 
*World.getBlock(x, y, z) - возвращает объект со значениями id, data, которые передают ID и metadata на координатах x, y, z
* 
*World.getBlockID(x, y, z) - возвращает объект со значениями id, data, которые передают ID и metadata блока на координатах x, y, z
* 
*World.getBlockID(x, y, z) - возвращает id блока на координатах x, y, z
* 
*World.getBlockData(x, y, z) - возвращает metadata блока на координатах x, y, z
* 
*World.destroyBlock(x, y, z, drop) - уничтожает блок на координатах x, y, z, если drop истенен, то дропает его

 

 

=== Работа с tile entity и контейнерами ===

*World.getTileEntity(x, y, z) - возвращает объект tile entity на координатах x, y, z, или null, если его нет
* 
*World.addTileEntity(x, y, z) - если блок на координатах x, y, z является блоком tile entity и не активирован, то активирует его и возвращает созданный объект tile entity
* 
*World.removeTileEntity(x, y, z) - если на координатах x, y, z есть tile entity, уничтожает его.
* 
*World.getConteiner(x, y, z) - если на координатах x, y, z находится сундук, печь или tile entity, возвращает его контейнер, если это печь или сундук, то контейнер обладает методами refreshSlots()/applyChanges()

 

 

=== Работа с окружением ===

*World.getThreadTime() - возвращает номер такта основного потока со входа в мир
*World.getWorldTime() - возвращает игровое время в тиках
*World.setWorldTime() - устанавливает игровое время в тиках
*World.setDayMode(isDay) - заставляет солнце передвигаться в дневную позицию, если isDay истинно, иначе в ночную
*World.setNightMode(isNight) - заставляет солнце передвигаться в ночную позицию, если isNight истинно, иначе в дневную
*World.getWeather() - возвращает объект с данными о погоде, rain - уровень дождя, thunder - уровень грозы
*World.setWeather(weather) - устанавливает погоду по объекту с данными о погоде, rain - уровень дождя, thunder - уровень грозы

 

 

=== Другие методы ===

*World.drop(x, y, z, id, count, data) - дропает предмет [id, count, data] на координаты x, y, z и возвращает его
*World.explode(x, y, z, power, fire) - создает взрыв на координатах x, y, z мощности power, если fire истинно, поджигает все в области взрыва
*World.getBiome(x, z) - отдает числовой ID биома на координатах x, z
*World.getBiomeName(x, z) - отдает название биома на координатах x, z
*World.getGrassColor(x, z) - отдает цвет травы на координатах x, z ввиде одного числа
*World.setGrassColor(x, z, color) - устанавливает цвет травы на координатах x, z ввиде одного числа
*World.getGrassColorRGB(x, z) - отдает цвет травы на координатах x, z ввиде объекта, содержащего три компоненты цвета r, g, b, каждая от 0 до 255
*World.setGrassColorRGB(x, z, rgb) - устанавливает цвет травы на координатах x, z ввиде объекта, содержащего три компоненты цвета r, g, b, каждая от 0 до 255
*World.canSeeSky(x, y, z) - отдает true, если из точки x, y, z видно небо, иначе false
*World.playSound(x, y, z, "name", volume) - проигрывает стандартный звук "name" на координатах x, y, z с громкостью volume от 0 до 100
*World.playSoundAtEntity(entity, "name", volume) - проигрывает стандартный звук "name" на координатах данного моба entity с громкостью volume от 0 до 100

InnerCore/Модуль World

2017-07-07T20:21:40Z

93.124.107.25: Created page with " Вся работа с миром осуществляется через модуль World. === Работа с блоками === *World.setBlock(x, y, z, id, metadata)..."

Вся работа с миром осуществляется через модуль World.

=== Работа с блоками ===

*World.setBlock(x, y, z, id, metadata) - устанавливает блок с данным ID и metadata на координаты x, y, z
* 
*World.setFullBlock(x, y, z, fullTile) - принимает объект со значениями id, data, устанавливает блок с данным ID и metadata на координаты x, y, z
* 
*World.getBlock(x, y, z) - возвращает объект со значениями id, data, которые передают ID и metadata на координатах x, y, z
* 
*World.getBlockID(x, y, z) - возвращает объект со значениями id, data, которые передают ID и metadata блока на координатах x, y, z
* 
*World.getBlockID(x, y, z) - возвращает id блока на координатах x, y, z
* 
*World.getBlockData(x, y, z) - возвращает metadata блока на координатах x, y, z
* 
*World.destroyBlock(x, y, z, drop) - уничтожает блок на координатах x, y, z, если drop истенен, то дропает его

 

 

=== Работа с tile entity и контейнерами ===

*World.getTileEntity(x, y, z) - возвращает объект tile entity на координатах x, y, z, или null, если его нет
* 
*World.addTileEntity(x, y, z) - если блок на координатах x, y, z является блоком tile entity и не активирован, то активирует его и возвращает созданный объект tile entity
* 
*World.removeTileEntity(x, y, z) - если на координатах x, y, z есть tile entity, уничтожает его.
* 
*World.getConteiner(x, y, z) - если на координатах x, y, z находится сундук, печь или tile entity, возвращает его контейнер, если это печь или сундук, то контейнер обладает методами refreshSlots()/applyChanges()

 

 

=== Работа с окружением ===

*World.getThreadTime() - возвращает номер такта основного потока со входа в мир
*World.getWorldTime() - возвращает игровое время в тиках
*World.setWorldTime() - устанавливает игровое время в тиках
*World.setDayMode(isDay) - заставляет солнце передвигаться в дневную позицию, если isDay истинно, иначе в ночную
*World.setNightMode(isNight) - заставляет солнце передвигаться в ночную позицию, если isNight истинно, иначе в дневную
*World.getWeather() - возвращает объект с данными о погоде, rain - уровень дождя, thunder - уровень грозы
*World.setWeather(weather) - устанавливает погоду по объекту с данными о погоде, rain - уровень дождя, thunder - уровень грозы

 

 

=== Другие методы ===

*World.drop(x, y, z, id, count, data) - дропает предмет [id, count, data] на координаты x, y, z и возвращает его
*World.explode(x, y, z, power, fire) - создает взрыв на координатах x, y, z мощности power, если fire истинно, поджигает все в области взрыва
*World.getBiome(x, z) - отдает числовой ID биома на координатах x, z
*World.getBiomeName(x, z) - отдает название биома на координатах x, z
*World.getGrassColor(x, z) - отдает цвет травы на координатах x, z ввиде одного числа
*World.setGrassColor(x, z, color) - устанавливает цвет травы на координатах x, z ввиде одного числа
*World.getGrassColorRGB(x, z) - отдает цвет травы на координатах x, z ввиде объекта, содержащего три компоненты цвета r, g, b, каждая от 0 до 255
*World.setGrassColorRGB(x, z, rgb) - устанавливает цвет травы на координатах x, z ввиде объекта, содержащего три компоненты цвета r, g, b, каждая от 0 до 255
*World.canSeeSky(x, y, z) - отдает true, если из точки x, y, z видно небо, иначе false
*World.playSound(x, y, z, "name", volume) - проигрывает стандартный звук "name" на координатах x, y, z с громкостью volume от 0 до 100
*World.playSoundAtEntity(entity, "name", volume) - проигрывает стандартный звук "name" на координатах данного моба entity с громкостью volume от 0 до 100

InnerCore/Жидкости и работа с ними

2017-07-07T20:16:29Z

93.124.107.25: Created page with " Жидкости в Core Engine представлены как некоторый материал, который может храниться в tile entity или нап..."

Жидкости в Core Engine представлены как некоторый материал, который может храниться в tile entity или наполнять предмет, но при этом не может быть в мире. Т.е. жидкости могут содержаться только в каких нибудь tile entity (например бочка) или предметах (например ведро).

 

Core Engine позволяет регистрировать новые жидкости, имеющие название и текстуру, предметы содержащие эти жидкости, а так же дает всем tile entity встроенный объект для хранения и работы с жидкостями, аналогичный контейнеру для хранения предметов и отображения слотов.

 

Стандартные жидкости - молоко, лава и вода и их текстуры уже зарегистрированы, как и предметы, содержащие их, их строковые id:

*water - вода
*milk - молоко
*lava - лава

 

 

=== Регистрация жидкости ===

LiquidRegistry.registerLiquid("строковый id", "название", [массив имен текстур в интерфейсе]) - регистрирует жидкость под данным строковым id и с данным названием и задает ей варианты текстур интерфейса, которые задаются как массив строковых имен текстур. Текстур интерфейса может быть несколько для того, чтобы при использовании их в шкалах различных размеров, Core Engine подбирал лучшее отношение сторон и изменял размер под размер шкалы (жидкость может быть использована другими модами с другим интерфейсом). Если вы хотите задать только одну текстуру для жидоксти, просто напишите ["имя текстуры"].

 

*LiquidRegistry.isExists("строковый id") - проверяет существование жидкости с данным строковым id.
*LiquidRegistry.getLiquidName("строковый id") - отдает имя жидкости по id или null, если такой жидкости нет

 

=== Регистрация предметов ===

*LiquidRegistry.registerItem("строковый id", {id: id пустого предмета, data: data пустого предмета}, {id: id полного предмета, data: data полного предмета}) - регистрирует предмет, содержащий жидкость с данным строковым id в 2 состояниях - пустой и полный. После регистрации предмет будет доступен для методов наполнения и опустошения.
*LiquidRegistry.getEmptyItem(id, data) - принимает на вход id и дату полного предмета, возвращает объект формата {id: id пустого предмета, data: data пустого предмета, liquid: строковый id жидкости, которая содержалась в полном предмете}, если это не предмет, заполненный какой то жидкостью, возвращает null
*LiquidRegistry.getItemLiquid(id, data) - принимает на вход id и дату полного предмета, возвращает строковый id жидкости, которая в нем содержится, если это не предмет, заполненный какой то жидкостью, возвращает null
*LiquidRegistry.getFullItem(id, data, "строковый id") - принимает на вход пустой предмет и строковый id жидкости, возвращает объект формата {id: id полного предмета, data: data полного предмета}, если предмет не является предметом, который может содержать жидкость, или такая жидкость не существует, вернет null

 

 

=== Хранилище жидкости ===

Объект хранилища жидкости позволяет хранить жидкости и оперировать с ними. Каждый объект tile entity по умолчанию имеет объект хранилища жидкости (this.liquidStorage), которые привязаны к нему, так же его можно создать командой new LiquidRegistry.Storage() - новый объект хранилища.

 

Методы объекта хранилища жидкости:

*updateUiScale("имя элемента ui", "строковый id", контейнер) - устанавливает для данного контейнера шкалу с данным именем, как шкалу жидкости с данным строковым id, изменяя текстуру на текстуру жидкости и значение на ее объем относительно лимита. Если параметр контейнер не передан, а хранилище привязано к tile entity, то будет использован контейнер этого tile entity.
*hasDataFor("строковый id") - проверяет, есть ли в нем данные для данной жидкость
*setLimit("строковый id", лимит в ведрах) - устанавливает конкретной жидкости лимит количества в ведрах, если вместо строкового id передан null, устанавливает данный лимит для всех жидкостей
*getLimit("строковый id") - возвращает лимит данной жидкости в ведрах
*setAmount("строковый id", объем в ведрах) - устанавливает объем данной жидкости в ведрах, без проверки лимита
*getAmount("строковый id") - возвращает кол-во данной жидкости в ведрах
*getRelativeAmount("строковый id") - возвращает кол-во данной жидкости, деленное на лимит для данной жидкости (используется для шкал интерфейса)
*getLiquidStored("строковый id") - возвращает строковый id первой жидкости, которая содержится в данном хранилище и кол-во которой больше 0, подходит для  работы с хранилищем, в котором хранится 1 тип жидкости, а так же сочитается с методом getLiquid
*isFull("строковый id") - возвращает true, если кол-во данной жидкости равно ее лимиту (заполнена ли она до предела), если аргумент не передан, проверяет, заполненны ли все жидкости в хранилище до предела.
*isEmpty("строковый id") - возвращает true, если кол-во данной жидкости равно 0 (пустота), если аргумент не передан, проверяет, все ли жидкости в хранилище на 0.
*addLiquid("строковый id", объем в ведрах) - добавляет данный объем данной жидкости в хранилище, возвращает объем лишней жидкости (которая не уместилась в лимит)
*getLiquid("строковый id", объем в ведрах) - забирает данный объем данной жидкости из хранилища, возвращает объем, который удалось забрать (если жидкости меньше требуемого кол-ва, то отдает не переданный объем, а меньше). Если жидкости в хранилище не хватает и хранилище привязано к tile entity будет вызвано событие requireMoreLiquid в tile entity.

InnerCore/Рецепты

2017-07-07T20:11:46Z

93.124.107.25: Created page with "<div class="b-pageLayout b-pageLayout__xs" data-layout="xs" id="pageLayout"><div class="b-pageContent m-pageContent__withoutLeft m-pageContent__withoutRight" i..."

<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 позволяет добавлять рецепты, которые могут работать как угодно, что сильно расширит вохможности в этой области.

 

=== Рецепты верстака ===

Рецепты верстака бывают 2х типов: форменные и бесформенные, первый тип требует того, чтобы предмет был выложен на верстаке в какой то определенной форме, второй требует лишь соблюдения присутсвия и кол-ва предметов в сетке крафта, но не требует порядка. Особенностью форменных рецептов является то, что если рецепт занимает область меньше, чем 3х3, то он может быть выложен в любой области верстака для его выполнения.

 

Для добавления форменных рецептов используется функция Recipes.addShaped({id: id результата, count: кол-во результата, data: data результата}, форма рецепта, определение предметов, функция выполнения, префикс) - в обычном рецепте последние 2 параметра можно и нужно опустить, о них будет рассказано позже.

 

Форма рецепта задается массивом строк, которые соответсвуют строкам в форме рецепта, где каждый символ означает предмет, а пробел - отсутсвие предмета.

Разъяснение предметов это массив, в котором данные идут в порядке ['символ1', id1, data1, 'символ2', id2, data2, ...], и так для всех символов, которые использовались в форме рецепта, кроме пробела. Если data предмета не важна (к примеру вы хотите, чтобы в рецепте использовались доски любого типа), то вместо нее напишите -1.

 

Пример рецепта:
<pre>Recipes.addShaped({id: 264, count: 1, data: 0}, [

"ax",

"xa",

"ax"

], ['x', 265, 0, 'a', 266, 0]);

/*

добавит рецепт алмаза, который создается из 3 железных и 3 золотых слитков в таком порядке:

ax

xa

ax

x - железо

a - золото

*/</pre>
<div>Плохой пример рецепта:<span id="cke_bm_157E" style="display: none"> </span></div> <pre>Recipes.addShaped({id: 264, count: 1, data: 0}, [

"ax ",

"xa ",

"ax "

], ['x', 265, 0, 'a', 266, 0]);

// Как можно заметить, длина строки в данном случае 3, а не 2 и рецепт можно будет создать только, если выложить нужную структуру в левой части верстака, в прошлом же примере ненужные слоты были обрезаны и рецепт был шириной в 2, а не в 3, потому его можно было выложить как в правой части, так и в левой. То же самое касается кол-ва строк, их может быть меньше 3, если столько не нужно.</pre>

 

Пример:
<pre>Recipes.addShapeless({id: 264, count: 1, data: 0}, [{id: 265, data: 0}, {id: 265, data: 0}, {id: 265, data: 0}, {id: 266, data: 0}, {id: 266, data: 0}, {id: 266, data: 0}]); // добавит рецепт алмаза, который создается из 3 железных и 3 золотых слитков, однако их можно выложить в любом порядке.

</pre>

 

 

*Recipes.deleteRecipe({id: id результата, count: кол-во результата, data: data результата}) - удаляет все рецепты для данного предмета.
*Recipes.replaceWithShaped({id: id результата, count: кол-во результата, data: data результата}, форма рецепта, определение предметов, функция выполнения, префикс) - аналогична Recipes.addShaped, но удаляет все остальные рецепты для этого предмета.
*Recipes.replaceWithShapeless({id: id результата, count: кол-во результата, data: data результата}, форма рецепта, определение предметов, функция выполнения, префикс) - аналогична Recipes.addShapeless, но удаляет все остальные рецепты для этого предмета.
*Recipes.addShapeless({id: id результата, count: кол-во результата, data: data результата}, [{id: id1, data: data1}, {id: id2, data: data2}, ...], функция выполнения, префикс) - добавление бесформенных рецептов.

 

 

=== Рецепты печи ===

Для добавления рецепта печи используется метод Recipes.addFurnace(id сырья, id результата, data результата, префикс, блокировка) - для обычного рецепта параметры префикс и блокировка не нужны.

 

Пример:
<pre>Recipes.addFurnace(265, 264, 0); // переплавка железа в алмаза</pre>

 
</div> </div>

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

2017-07-07T20:02:09Z

93.124.107.25:

<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 позволяет настраивать их и добавлять различные события для конкретного блока или предмета.

 

=== Специальные типы блоков ===

Чтобы создать блок с параметрами, которые отличаются от стандартных (свечение, модель), используются специальные типы блоков. Регистрируются они с помощью функции Block.createSpecialType(объект характеристик) - функция принимает объект характеристик, которые нужно изменить и отдает специальный тип блока с этими характеристиками.

 

Специальный тип, созданный этой функцией передается в функцию Block.createBlock и Block.createBlockWithRotation третим параметром, чтобы блок был создан для данного специального типа. На 1 специальном типе может быть создано суммарно до 16 вариаций различных блоков.

 

Все характеристики, их значения по-умолчанию и разъяснение:
<pre>{

base: 20, // блок из MCPE, который будет взят за основу в создании блока, могут быть скопированы некоторые свойства и материал

opaque: false, // непрозрачность, если true, то внутри блока мобы будут получать урон, а так же места соприкосновения этого блока с другими не будут отрисованы

rendertype: 0, // тип модели, не работает в 0.15.7 и выше

renderlayer: 4, // тип рендера, 4 означает, что прозрачные части будут отрисованы прозрачными, а не черными

destroytime: 1, // не работает в 0.15.0 и выше, время ломания блока

redstoneconsumer: true, // будет ли происходить событие изменения редстоун-сигнала для этого блока

lightopacity: 1, // непрозрачность для света, сколько света будет поглощаться при прохождении через этот блок, 0 - полностью прозрачен, 15 - полностью непрозрачен

lightlevel: 0, // свечение блока, 0 - нет свечения, 15 - максимальное свечение

explosionres: 2, // взрывоустойчивость

color: [0xFFFFFF] // цвет для каждой стороны в формате 0xRRGGBB, если в массиве 1 элемент, то цвет будет установлен для всего блока

}

</pre>

Пример создания специального типа блока и самого блока:

 
<pre>var BLOCK_TYPE_LOW_LIGHT = Block.createSpecialType({ // блок этого типа будет абсолютно прозрачен для света и сам будет слабо светиться

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]]}

], BLOCK_TYPE_LOW_LIGHT); // создаем блок на данном специальном типе

</pre>

 

 

=== Функция дропа (ломания) ===

К конкретному блоку можно привязать функцию дропа, которая выполняется при ломании блока с данным id. Делается это с помощью функций Block.registerDropFunction("строковый id блока", функция дропа) и Block.registerDropFunctionForID(числовой id блока, функция дропа)

 

Функция дропа имеет такой формат:
<pre>function(coords, id, data, diggingLevel, toolLevel){

// coords - объект, содержащий координаты разрушенного блока - {x: , y: , z: } - coords.x, coords.y, coords.z

// id, data - id и data блока, id всегда совпадает с тем, на который была зарегистрирована функция и нужно, если одинаковая функция регистрируется на разные блоки

// diggingLevel - уровень ломания блока, где рука или инструмент другого типа - 0. Если же инструмент совпадает с материалом блока, то уровень будет равен уровню инструмента

// toolLevel - уровень инструмента в руке, не зависит от самого блока

// если блок что то дропает, эта функция должна вернуть массив из предметов, которые надо дропнуть, каждый предмет имеет формат [id, count, data]

}</pre>

 

Пример:
<pre>Block.registerDropFunction("testBlock", 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]]; // дропнуть сам блок и алмаз

});</pre>

 

 

=== Функция установки ===

К конкретному блоку можно привязать функцию установки, которая выполняется при установке блока с данным id. Если функция зарегистрирована, то вместо стандартной установки блока на потенциальные координаты вызовется она, а из руки отнимется 1 блок. Делается это с помощью функций Block.registerPlaceFunction("строковый id блока", функция установки) и Block.registerPlaceFunctionForID(числовой id блока, функция установки).

 

Функция установки имеет такой формат:
<pre>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: }

}</pre>
<div>Пример:<span id="cke_bm_170E" style="display: none"> </span></div> <pre>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

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); // над ним установим алмазный блок

});

</pre>

 

=== Установка формы ===

Блоку с конкретным id и data можно установить форму, отличную от кубической. Для этого используется функция Block.setBlockShape(числовой id, {x: , y: , z: }, {x: , y: , z: }, data) - принимает id блока, координаты начала и координаты конца, а так же, если вы хотите сделать это для конкретной вариации блока, то определите последний параметр. Координаты в блоке могут быть от 0 до 1, стандартный блок имеет форму (0, 0, 0) - (1, 1, 1)

 
<pre>Block.setBlockShape(BlockID.testBlock, {x: 0.2, y: 0, z: 0.2}, {x: 0.8, y: 1, z: 0.8}) // установить всем вариациям форму столба</pre>

 

=== Установка свойств предмета ===

Для установки свойств предметов используется функция Item.describeItem("строковый id", объект описания).

 

Все параметры в объекте описания, их стандартные значения и описание:
<pre>{

category: 0, // категория в креативе

enchant: {value: 0, type: 0}, // тип зачарования

toolRender: false, // рендер в руке, как инструмент

maxDamage: 0, // максимальный дамаг предмета (шкала прочности)

stackByData: false, // стакается по data

properties: {}, // родной объект параметров MCPE

useAnimation: 0 // анимация использозвания

}</pre>

 

Функции - аналоги параметров:

*Item.setCategory(id, category) - аналог параметра category
*Item.setEnchantType(id, enchant, value) - аналог параметра enchant
*Item.setToolRender(id, enabled) - аналог параметра toolRender
*Item.setMaxDamage(id, maxdamage) - аналог параметра maxDamage
*Item.setStackedByData(id, enabled) - аналог параметра stackByData
*Item.setProperties(id, props) - аналог параметра properties
*Item.setUseAnimation(id, animType) - аналог параметра useAnimation

 

Функции - получение параметров:

*Item.getName(id, data, encode) - отдает имя предмета или блока с данным id и data, если encode true, то возвращает его в формате item.имя.name или block.имя.name
*Item.getMaxDamage(id) - отдает максимальный дамаг предмета
*Item.getMaxStack(id) - отдает размер стака
*Item.getUseAnimation(id) - отдает анимацию использования
*Item.isValid(id, data) - возвращает, существует ли данный предмет
*Item.isNativeItem(id) - возвращает, является ли этот предмет предметом из MCPE, а не из модов

 

 

=== Функция использования предмета ===

К конкретному предмету можно привязать функцию использования, которая выполняется при использовании предмета с данным id. Делается это с помощью функций Item.registerPlaceFunction("строковый id предмета", функция использования) и Item.registerPlaceFunctionForID(числовой id предмета, функция использования).

 

Функция использования имеет такой формат:
<pre>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 - блок, на который было произведено нажатие.

}</pre>

=== Функция броска предмета ===

К конкретному предмету можно привязать функцию, которая выполняется при разбивании брошенного предмета с данным id. Делается это с помощью функций Item.registerThrowableFunction("строковый id предмета", функция разбивания) и Item.registerThrowableFunctionForID(числовой id предмета, функция разбивания).

 

Функция разбивания имеет такой формат:
<pre>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

}</pre>
</div> </div>

InnerCore/TileEntity

2017-07-07T19:54:13Z

93.124.107.25:

<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">
Tile entity - технология, добавляемая Core Engine для быстрого создания интерактивных блоков, таких как сундук или печь, модами. Для регистрации tile entity используется модуль TileEntity. Регистрация производится с помощью привязки к какому то ID блока объекта-прототипа, который будет дополнен и клонирован для каждого tile entity в мире.

 

Регистрация прототипа происходит с помощью метода TileEntity.registerPrototype(id блока, прототип);

 

Объект прототипа обладает набором событий, областью для сохраняемых данных и контейнером, если какие то события не нужны данному типу tile entity, то их просто можно не писать. Внутри событий и методов обращения, обращаться к текущему объекту tile entity нужно через ключевое слово this.

 

Разъяснение всех элементов прототипа:

 
<pre>{

defaultValues: {

// здесь прописаны все сохраняемые поля и их значения по умолчанию, далее они будут скопированы в поле data

},

container: ..., // стандартное для всех tile entity поле, содержит объект контейнера для данного tile entity, подробнее в главе про контейнеры

liquidStorage: ..., // стандартное для всех tile entity поле, содержит объект хранилища жидкости для данного tile entity, подробнее в главе про жидкости

created: function(){

// событие, вызывается при создании tile entity

},

init: function(){

// событие, вызывается при инициализации (загрузке в мир) tile entity

},

tick: function(){

// событие, вызывается каждый тик

},

click: function(id, count, data, coords){

// событие, вызывается при нажатии на блок tile entity, если возвращает истинное значение, то предотвращает открытие интерфейса

return false;

},

destroyBlock: function(coords, player){

// событие, вызывается, когда tile entity уничтожается игроком

},

redstone: function(params){

// событие, вызывается, когда на tile entity подается сигнал redstone, или же он прекращает подачу, params.power содержит новую мощность сигнала

},

projectileHit: function(coords, projectile){

// событие, вызывается, когда кидаемый предмет разбивается о данный tile entity, coords.x, coords.y, coords.z - координаты, coords.side - сторона

},

destroy: function(){

// вызывается при попытке уничтожить объект tile entity, если возврращает истинное значение, то предотвращает уничтожение объекта (но не блока, если оно было вызвано уничтожением блока)

},

getGuiScreen: function(){

// событие, вызывается при попытке открыть интерфейс, если возвращает объект интерфейса, то он открывается для данного tile entity, подробнее в разделе про интерфейс

},

requireMoreLiquid: function(liquid, amount){

// событие, вызывается, когда из внутреннего хранилища жидкости пытаются выкачать больше жидкости типа liquid, чем там есть, на amount ведер, подробнее в главе про жидкости

},

selfDestroy: function(), // стандартный метод, уничтожает объект tile entity, учтите, что будет вызвано событие destroy

}</pre>

 

Пример регистрации прототипа:
<pre>

IDRegistry.genBlockID("testBlock");

// ...

// создаем блок

TileEntity.registerPrototype(BlockID.testBlock, {

defaultValues: {

someValue: 0 // сохраняемое значение someValue, по умолчанию 0

},

tick: function(){

// что то сделать каждый тик, к примеру выводим someValue

Debug.message(this.data.someValue);

},

click: function(id, count, data, coords){

this.data.someValue = 1; // установить значение someValue на 1

}

// остальные события не трогаем

});</pre>
</div> </div> </div> </div>

InnerCore/TileEntity

2017-07-07T19:52:13Z

93.124.107.25:

<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">
{| 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">Tile entity - технология, добавляемая Core Engine для быстрого создания интерактивных блоков, таких как сундук или печь, модами. Для регистрации tile entity используется модуль TileEntity. Регистрация производится с помощью привязки к какому то ID блока объекта-прототипа, который будет дополнен и клонирован для каждого tile entity в мире.</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">Регистрация прототипа происходит с помощью метода TileEntity.registerPrototype(id блока, прототип);</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">Объект прототипа обладает набором событий, областью для сохраняемых данных и контейнером, если какие то события не нужны данному типу tile entity, то их просто можно не писать. Внутри событий и методов обращения, обращаться к текущему объекту tile entity нужно через ключевое слово this.</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> <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">{</span>

<span class="code"> defaultValues: {</span>

<span class="code"> // здесь прописаны все сохраняемые поля и их значения по умолчанию, далее они будут скопированы в поле data</span>

<span class="code"> },</span>

<span class="code"> container: ..., // стандартное для всех tile entity поле, содержит объект контейнера для данного tile entity, подробнее в главе про контейнеры</span>

<span class="code"> liquidStorage: ..., // стандартное для всех tile entity поле, содержит объект хранилища жидкости для данного tile entity, подробнее в главе про жидкости</span>

<span class="code"> created: function(){</span>

<span class="code"> // событие, вызывается при создании tile entity</span>

<span class="code"> },</span>

<span class="code"> </span>

<span class="code"> init: function(){</span>

<span class="code"> // событие, вызывается при инициализации (загрузке в мир) tile entity</span>

<span class="code"> },</span>

<span class="code"> </span>

<span class="code"> tick: function(){</span>

<span class="code"> // событие, вызывается каждый тик</span>

<span class="code"> },</span>

<span class="code"> click: function(id, count, data, coords){</span>

<span class="code"> // событие, вызывается при нажатии на блок tile entity, если возвращает истинное значение, то предотвращает открытие интерфейса</span>

<span class="code"> return false;</span>

<span class="code"> },</span>

<span class="code"> destroyBlock: function(coords, player){</span>

<span class="code"> // событие, вызывается, когда tile entity уничтожается игроком</span>

<span class="code"> },</span>

<span class="code"> redstone: function(params){</span>

<span class="code"> // событие, вызывается, когда на tile entity подается сигнал redstone, или же он прекращает подачу, params.power содержит новую мощность сигнала</span>

<span class="code"> },</span>

<span class="code"> projectileHit: function(coords, projectile){</span>

<span class="code"> // событие, вызывается, когда кидаемый предмет разбивается о данный tile entity, coords.x, coords.y, coords.z - координаты, coords.side - сторона</span>

<span class="code"> },</span>

<span class="code"> destroy: function(){</span>

<span class="code"> // вызывается при попытке уничтожить объект tile entity, если возврращает истинное значение, то предотвращает уничтожение объекта (но не блока, если оно было вызвано уничтожением блока)</span>

<span class="code"> },</span>

<span class="code"> getGuiScreen: function(){</span>

<span class="code"> // событие, вызывается при попытке открыть интерфейс, если возвращает объект интерфейса, то он открывается для данного tile entity, подробнее в разделе про интерфейс</span>

<span class="code"> },</span>

<span class="code"> </span>

<span class="code"> requireMoreLiquid: function(liquid, amount){</span>

<span class="code"> // событие, вызывается, когда из внутреннего хранилища жидкости пытаются выкачать больше жидкости типа liquid, чем там есть, на amount ведер, подробнее в главе про жидкости</span>

<span class="code"> },</span>

<span class="code"> </span>

<span class="code"> selfDestroy: function(), // стандартный метод, уничтожает объект tile entity, учтите, что будет вызвано событие destroy</span>

<span class="code">}</span>

</pre>
<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> <pre class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">IDRegistry.genBlockID("testBlock");</span>

<span class="code">// ...</span>

<span class="code">// создаем блок</span>

<span class="code">TileEntity.registerPrototype(BlockID.testBlock, {</span>

<span class="code"> defaultValues: {</span>

<span class="code"> someValue: 0 // сохраняемое значение someValue, по умолчанию 0</span>

<span class="code"> },</span>

<span class="code"> tick: function(){</span>

<span class="code"> // что то сделать каждый тик, к примеру выводим someValue</span>

<span class="code"> Debug.message(this.data.someValue);</span>

<span class="code"> },</span>

<span class="code"> </span>

<span class="code"> click: function(id, count, data, coords){</span>

<span class="code"> this.data.someValue = 1; // установить значение someValue на 1</span>

<span class="code"> }</span>

<span class="code"> </span>

<span class="code"> // остальные события не трогаем</span>

<span class="code">});</span></pre>
</div> </div> </div> </div> </div> </div>
|}
</div>
|}

|}
</div> </div> </div> </div>

InnerCore/TileEntity

2017-07-07T19:51:33Z

93.124.107.25:

<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">
{| 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">Tile entity - технология, добавляемая Core Engine для быстрого создания интерактивных блоков, таких как сундук или печь, модами. Для регистрации tile entity используется модуль TileEntity. Регистрация производится с помощью привязки к какому то ID блока объекта-прототипа, который будет дополнен и клонирован для каждого tile entity в мире.</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">Регистрация прототипа происходит с помощью метода TileEntity.registerPrototype(id блока, прототип);</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">Объект прототипа обладает набором событий, областью для сохраняемых данных и контейнером, если какие то события не нужны данному типу tile entity, то их просто можно не писать. Внутри событий и методов обращения, обращаться к текущему объекту tile entity нужно через ключевое слово this.</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> <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"><span class="code">{</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     defaultValues: {</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          // здесь прописаны все сохраняемые поля и их значения по умолчанию, далее они будут скопированы в поле data</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     },</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     container: ..., // стандартное для всех tile entity поле, содержит объект контейнера для данного tile entity, подробнее в главе про контейнеры</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     liquidStorage: ..., // стандартное для всех tile entity поле, содержит объект хранилища жидкости для данного tile entity, подробнее в главе про жидкости</span></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"><span class="code">     created: function(){</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          // событие, вызывается при создании tile entity</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     },</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">    </span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     init: function(){</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          // событие, вызывается при инициализации (загрузке в мир) tile entity</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     },</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">    </span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     tick: function(){</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          // событие, вызывается каждый тик</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     },</span></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"><span class="code">     click: function(id, count, data, coords){</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          // событие, вызывается при нажатии на блок tile entity, если возвращает истинное значение, то предотвращает открытие интерфейса</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          return false;</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     },</span></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"><span class="code">     destroyBlock: function(coords, player){</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          // событие, вызывается, когда tile entity уничтожается игроком</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     },</span></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"><span class="code">     redstone: function(params){</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          // событие, вызывается, когда на tile entity подается сигнал redstone, или же он прекращает подачу, params.power содержит новую мощность сигнала</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     },</span></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"><span class="code">     projectileHit: function(coords, projectile){</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          // событие, вызывается, когда кидаемый предмет разбивается о данный tile entity, coords.x, coords.y, coords.z - координаты, coords.side - сторона</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     },</span></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"><span class="code">     destroy: function(){</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          // вызывается при попытке уничтожить объект tile entity, если возврращает истинное значение, то предотвращает уничтожение объекта (но не блока, если оно было вызвано уничтожением блока)</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     },</span></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"><span class="code">     getGuiScreen: function(){</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          // событие, вызывается при попытке открыть интерфейс, если возвращает объект интерфейса, то он открывается для данного tile entity, подробнее в разделе про интерфейс</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     },</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">    </span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     requireMoreLiquid: function(liquid, amount){</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          // событие, вызывается, когда из внутреннего хранилища жидкости пытаются выкачать больше жидкости типа liquid, чем там есть, на amount ведер, подробнее в главе про жидкости</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     },</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">    </span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     selfDestroy: function(), // стандартный метод, уничтожает объект tile entity, учтите, что будет вызвано событие destroy</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">}</span></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> <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"><span class="code">IDRegistry.genBlockID("testBlock");</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">// ...</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">// создаем блок</span></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"><span class="code">TileEntity.registerPrototype(BlockID.testBlock, {</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     defaultValues: {</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          someValue: 0 // сохраняемое значение someValue, по умолчанию 0</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     },</span></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"><span class="code">     tick: function(){</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          // что то сделать каждый тик, к примеру выводим someValue</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          Debug.message(this.data.someValue);</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     },</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">    </span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     click: function(id, count, data, coords){</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">          this.data.someValue = 1; // установить значение someValue на 1</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     }</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">    </span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">     // остальные события не трогаем</span></div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr"><span class="code">});</span></div> </div> </div> </div> </div> </div> </div>
|}
</div>
|}

|}
</div> </div> </div> </div>

InnerCore/TileEntity

2017-07-07T19:50:10Z

93.124.107.25: Created page with "<div class="b-pageLayout b-pageLayout__xs" data-layout="xs" id="pageLayout"><div class="b-pageContent m-pageContent__withoutLeft m-pageContent__withoutRight" i..."

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

2017-07-07T19:48:05Z

93.124.107.25:

<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">Кроме создания простейших блоков и предметов, 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"> </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"> </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>

<span class="code"> base: 20, // блок из MCPE, который будет взят за основу в создании блока, могут быть скопированы некоторые свойства и материал</span>

<span class="code"> opaque: false, // непрозрачность, если true, то внутри блока мобы будут получать урон, а так же места соприкосновения этого блока с другими не будут отрисованы</span>

<span class="code"> rendertype: 0, // тип модели, не работает в 0.15.7 и выше</span>

<span class="code"> renderlayer: 4, // тип рендера, 4 означает, что прозрачные части будут отрисованы прозрачными, а не черными</span>

<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"> </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">К конкретному блоку можно привязать функцию дропа, которая выполняется при ломании блока с данным id. Делается это с помощью функций Block.registerDropFunction("строковый id блока", функция дропа) и Block.registerDropFunctionForID(числовой id блока, функция дропа)</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> <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>

<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>

Пример:

<span class="code">Block.registerDropFunction("testBlock", function(coords, id, data, diggingLevel, toolLevel){</span>

<span class="code"> return [[id, 1, data], [264, 1, 0]]; // дропнуть сам блок и алмаз</span>

<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"> </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">К конкретному блоку можно привязать функцию установки, которая выполняется при установке блока с данным id. Если функция зарегистрирована, то вместо стандартной установки блока на потенциальные координаты вызовется она, а из руки отнимется 1 блок. Делается это с помощью функций Block.registerPlaceFunction("строковый id блока", функция установки) и Block.registerPlaceFunctionForID(числовой id блока, функция установки).</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> <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"> </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>

<span class="code">});</span>

<span class="code">// Полный аналог предыдущей функции, но с числовым id</span>

<span class="code">Block.registerPlaceFunctionForID(BlockID.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>

<span class="code">});</span></pre>
<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>
=== Установка формы ===
<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"> </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>

=== Установка свойств предметов ===
<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"> </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"> </div> <div class="p" style="text-align: left; text-indent: 0px; margin-left: 0px; direction: ltr">Функции - аналоги параметров:</div>
*Item.setCategory(id, category) - аналог параметра category
*Item.setEnchantType(id, enchant, value) - аналог параметра enchant
*Item.setToolRender(id, enabled) - аналог параметра toolRender
*Item.setMaxDamage(id, maxdamage) - аналог параметра maxDamage
*Item.setStackedByData(id, enabled) - аналог параметра stackByData
*Item.setProperties(id, props) - аналог параметра properties
*Item.setUseAnimation(id, animType) - аналог параметра useAnimation
<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>
*Item.getName(id, data, encode) - отдает имя предмета или блока с данным id и data, если encode true, то возвращает его в формате item.имя.name или block.имя.name
*Item.getMaxDamage(id) - отдает максимальный дамаг предмета
*Item.getMaxStack(id) - отдает размер стака
*Item.getUseAnimation(id) - отдает анимацию использования
*Item.isValid(id, data) - возвращает, существует ли данный предмет
*Item.isNativeItem(id) - возвращает, является ли этот предмет предметом из MCPE, а не из модов
<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>

=== Функция использования предмета ===
<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"> </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></pre>
<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>

=== Функция броска предмета ===
<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"> </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>
|}

|}
</div> </div> </div> </div> </div> </div> </div> </div>
|}
</div>
|}

|}
</div> </div>

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

2017-07-07T19:43:54Z

93.124.107.25:

<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">Кроме создания простейших блоков и предметов, 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"> </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"> </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>

<span class="code"> base: 20, // блок из MCPE, который будет взят за основу в создании блока, могут быть скопированы некоторые свойства и материал</span>

<span class="code"> opaque: false, // непрозрачность, если true, то внутри блока мобы будут получать урон, а так же места соприкосновения этого блока с другими не будут отрисованы</span>

<span class="code"> rendertype: 0, // тип модели, не работает в 0.15.7 и выше</span>

<span class="code"> renderlayer: 4, // тип рендера, 4 означает, что прозрачные части будут отрисованы прозрачными, а не черными</span>

<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"> </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">К конкретному блоку можно привязать функцию дропа, которая выполняется при ломании блока с данным id. Делается это с помощью функций Block.registerDropFunction("строковый id блока", функция дропа) и Block.registerDropFunctionForID(числовой id блока, функция дропа)</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> <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>

<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>

Пример:

<span class="code">Block.registerDropFunction("testBlock", function(coords, id, data, diggingLevel, toolLevel){</span>

<span class="code"> return [[id, 1, data], [264, 1, 0]]; // дропнуть сам блок и алмаз</span>

<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"> </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">К конкретному блоку можно привязать функцию установки, которая выполняется при установке блока с данным id. Если функция зарегистрирована, то вместо стандартной установки блока на потенциальные координаты вызовется она, а из руки отнимется 1 блок. Делается это с помощью функций Block.registerPlaceFunction("строковый id блока", функция установки) и Block.registerPlaceFunctionForID(числовой id блока, функция установки).</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> <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"> </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>

<span class="code">});</span>

<span class="code">// Полный аналог предыдущей функции, но с числовым id</span>

<span class="code">Block.registerPlaceFunctionForID(BlockID.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>

<span class="code">});</span></pre>
<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>
=== Установка формы ===
<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"> </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>
=== Установка свойств предметов ===
<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"> </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">{</span>

<span class="code"> category: 0, // категория в креативе</span>

<span class="code"> enchant: {value: 0, type: 0}, // тип зачарования</span>

<span class="code"> toolRender: false, // рендер в руке, как инструмент</span>

<span class="code"> maxDamage: 0, // максимальный дамаг предмета (шкала прочности)</span>

<span class="code"> stackByData: false, // стакается по data</span>

<span class="code"> properties: {}, // родной объект параметров MCPE</span>

<span class="code"> useAnimation: 0 // анимация использозвания</span>

<span class="code">}</span></pre>
<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>
*Item.setCategory(id, category) - аналог параметра category
*Item.setEnchantType(id, enchant, value) - аналог параметра enchant
*Item.setToolRender(id, enabled) - аналог параметра toolRender
*Item.setMaxDamage(id, maxdamage) - аналог параметра maxDamage
*Item.setStackedByData(id, enabled) - аналог параметра stackByData
*Item.setProperties(id, props) - аналог параметра properties
*Item.setUseAnimation(id, animType) - аналог параметра useAnimation
<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>
*Item.getName(id, data, encode) - отдает имя предмета или блока с данным id и data, если encode true, то возвращает его в формате item.имя.name или block.имя.name
*Item.getMaxDamage(id) - отдает максимальный дамаг предмета
*Item.getMaxStack(id) - отдает размер стака
*Item.getUseAnimation(id) - отдает анимацию использования
* 
*Item.isValid(id, data) - возвращает, существует ли данный предмет
*Item.isNativeItem(id) - возвращает, является ли этот предмет предметом из MCPE, а не из модов
<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>

=== Функция использования предмета ===
<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"> </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></pre>
<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>

=== Функция броска предмета ===
<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"> </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>
|}

|}
</div> </div> </div> </div> </div> </div> </div> </div>
|}
</div>
|}

|}
</div> </div>

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

2017-07-07T19:43:02Z

93.124.107.25:

<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">Кроме создания простейших блоков и предметов, 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"> </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"> </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>

<span class="code"> base: 20, // блок из MCPE, который будет взят за основу в создании блока, могут быть скопированы некоторые свойства и материал</span>

<span class="code"> opaque: false, // непрозрачность, если true, то внутри блока мобы будут получать урон, а так же места соприкосновения этого блока с другими не будут отрисованы</span>

<span class="code"> rendertype: 0, // тип модели, не работает в 0.15.7 и выше</span>

<span class="code"> renderlayer: 4, // тип рендера, 4 означает, что прозрачные части будут отрисованы прозрачными, а не черными</span>

<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"> </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">К конкретному блоку можно привязать функцию дропа, которая выполняется при ломании блока с данным id. Делается это с помощью функций Block.registerDropFunction("строковый id блока", функция дропа) и Block.registerDropFunctionForID(числовой id блока, функция дропа)</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> <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>

<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>

Пример:

<span class="code">Block.registerDropFunction("testBlock", function(coords, id, data, diggingLevel, toolLevel){</span>

<span class="code"> return [[id, 1, data], [264, 1, 0]]; // дропнуть сам блок и алмаз</span>

<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"> </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">К конкретному блоку можно привязать функцию установки, которая выполняется при установке блока с данным id. Если функция зарегистрирована, то вместо стандартной установки блока на потенциальные координаты вызовется она, а из руки отнимется 1 блок. Делается это с помощью функций Block.registerPlaceFunction("строковый id блока", функция установки) и Block.registerPlaceFunctionForID(числовой id блока, функция установки).</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> <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"> </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>

<span class="code">});</span>

<span class="code">// Полный аналог предыдущей функции, но с числовым id</span>

<span class="code">Block.registerPlaceFunctionForID(BlockID.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>

<span class="code">});</span></pre>
<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> <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">Блоку с конкретным 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"> </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>

Установка свойств предметов
<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"> </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">{</span>

<span class="code"> category: 0, // категория в креативе</span>

<span class="code"> enchant: {value: 0, type: 0}, // тип зачарования</span>

<span class="code"> toolRender: false, // рендер в руке, как инструмент</span>

<span class="code"> maxDamage: 0, // максимальный дамаг предмета (шкала прочности)</span>

<span class="code"> stackByData: false, // стакается по data</span>

<span class="code"> properties: {}, // родной объект параметров MCPE</span>

<span class="code"> useAnimation: 0 // анимация использозвания</span>

<span class="code">}</span></pre>
<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>
*Item.setCategory(id, category) - аналог параметра category
*Item.setEnchantType(id, enchant, value) - аналог параметра enchant
*Item.setToolRender(id, enabled) - аналог параметра toolRender
*Item.setMaxDamage(id, maxdamage) - аналог параметра maxDamage
*Item.setStackedByData(id, enabled) - аналог параметра stackByData
*Item.setProperties(id, props) - аналог параметра properties
*Item.setUseAnimation(id, animType) - аналог параметра useAnimation
<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>
*Item.getName(id, data, encode) - отдает имя предмета или блока с данным id и data, если encode true, то возвращает его в формате item.имя.name или block.имя.name
*Item.getMaxDamage(id) - отдает максимальный дамаг предмета
*Item.getMaxStack(id) - отдает размер стака
*Item.getUseAnimation(id) - отдает анимацию использования
* 
*Item.isValid(id, data) - возвращает, существует ли данный предмет
*Item.isNativeItem(id) - возвращает, является ли этот предмет предметом из MCPE, а не из модов
<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>
=== Функция использования предмета ===
<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"> </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></pre>
<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>

=== Функция броска предмета ===
<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"> </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>
|}

|}
</div> </div> </div> </div> </div> </div> </div> </div>
|}
</div>
|}

|}
</div> </div>

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

2017-07-07T19:39:29Z

93.124.107.25: Created page with "<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">
{| 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">Кроме создания простейших блоков и предметов, 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"> </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"> </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>

<span class="code"> base: 20, // блок из MCPE, который будет взят за основу в создании блока, могут быть скопированы некоторые свойства и материал</span>

<span class="code"> opaque: false, // непрозрачность, если true, то внутри блока мобы будут получать урон, а так же места соприкосновения этого блока с другими не будут отрисованы</span>

<span class="code"> rendertype: 0, // тип модели, не работает в 0.15.7 и выше</span>

<span class="code"> renderlayer: 4, // тип рендера, 4 означает, что прозрачные части будут отрисованы прозрачными, а не черными</span>

<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"> </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">К конкретному блоку можно привязать функцию дропа, которая выполняется при ломании блока с данным id. Делается это с помощью функций Block.registerDropFunction("строковый id блока", функция дропа) и Block.registerDropFunctionForID(числовой id блока, функция дропа)</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> <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>

<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>

Пример:

<span class="code">Block.registerDropFunction("testBlock", function(coords, id, data, diggingLevel, toolLevel){</span>

<span class="code"> return [[id, 1, data], [264, 1, 0]]; // дропнуть сам блок и алмаз</span>

<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"> </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">К конкретному блоку можно привязать функцию установки, которая выполняется при установке блока с данным id. Если функция зарегистрирована, то вместо стандартной установки блока на потенциальные координаты вызовется она, а из руки отнимется 1 блок. Делается это с помощью функций Block.registerPlaceFunction("строковый id блока", функция установки) и Block.registerPlaceFunctionForID(числовой id блока, функция установки).</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> <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"> </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>

<span class="code">});</span>

<span class="code">// Полный аналог предыдущей функции, но с числовым id</span>

<span class="code">Block.registerPlaceFunctionForID(BlockID.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>

<span class="code">});</span></pre>
<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> <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">Блоку с конкретным 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"> </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>
=== Установка свойств предметов ===
<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"> </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">{</span>

<span class="code"> category: 0, // категория в креативе</span>

<span class="code"> enchant: {value: 0, type: 0}, // тип зачарования</span>

<span class="code"> toolRender: false, // рендер в руке, как инструмент</span>

<span class="code"> maxDamage: 0, // максимальный дамаг предмета (шкала прочности)</span>

<span class="code"> stackByData: false, // стакается по data</span>

<span class="code"> properties: {}, // родной объект параметров MCPE</span>

<span class="code"> useAnimation: 0 // анимация использозвания</span>

<span class="code">}</span></pre>
<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>
*Item.setCategory(id, category) - аналог параметра category
*Item.setEnchantType(id, enchant, value) - аналог параметра enchant
*Item.setToolRender(id, enabled) - аналог параметра toolRender
*Item.setMaxDamage(id, maxdamage) - аналог параметра maxDamage
*Item.setStackedByData(id, enabled) - аналог параметра stackByData
*Item.setProperties(id, props) - аналог параметра properties
*Item.setUseAnimation(id, animType) - аналог параметра useAnimation
<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>
*Item.getName(id, data, encode) - отдает имя предмета или блока с данным id и data, если encode true, то возвращает его в формате item.имя.name или block.имя.name
*Item.getMaxDamage(id) - отдает максимальный дамаг предмета
*Item.getMaxStack(id) - отдает размер стака
*Item.getUseAnimation(id) - отдает анимацию использования
* 
*Item.isValid(id, data) - возвращает, существует ли данный предмет
*Item.isNativeItem(id) - возвращает, является ли этот предмет предметом из MCPE, а не из модов
<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> <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">К конкретному предмету можно привязать функцию использования, которая выполняется при использовании предмета с данным id. Делается это с помощью функций Item.registerPlaceFunction("строковый id предмета", функция использования) и Item.registerPlaceFunctionForID(числовой id предмета, функция использования).</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> <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></pre>
<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>
=== Функция броска предмета ===
<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"> </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>
|}

|}
</div> </div> </div> </div> </div> </div> </div> </div>
|}
</div>
|}

|}
</div> </div>