TileEntity

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