Ловушки — различия между версиями

(Created page with " Ловушки ModPE - важная часть ModPE API, позволяющая отлавливать основные события в игре. === <br/> function...")
 
 
(не показано 5 промежуточных версий этого же участника)
Строка 2: Строка 2:
 
Ловушки ModPE - важная часть&nbsp;ModPE API, позволяющая отлавливать основные события в игре.
 
Ловушки ModPE - важная часть&nbsp;ModPE API, позволяющая отлавливать основные события в игре.
  
=== <br/> function attackHook(attacker, victim) ===
+
=== attackHook ===
 +
 
 +
Параметры: (attacker, victim)
  
 
Можно юзать preventDefault()
 
Можно юзать preventDefault()
  
=== function chatHook(str) ===
+
Происходит при ударе сущностью attacker сущность victim.
 +
 
 +
=== chatHook ===
 +
 
 +
Параметр: (str)
  
 
Можно юзать preventDefault()
 
Можно юзать preventDefault()
  
=== function continueDestroyBlock(x, y, z, side, progress) ===
+
Происходит при отправлении каким-либо игроком сообщения в чат.
 +
 
 +
=== continueDestroyBlock ===
 +
 
 +
Параметры: (x, y, z, side, progress)
  
 
Можно юзать preventDefault()
 
Можно юзать preventDefault()
  
=== function destroyBlock(x, y, z, side) ===
+
Происходит каждый тик во время ломания блока с координатами x, y, z со стороны side. progress - значение с плавающей точкой от 0 до 1, показывает прогресс разрушения блока (в частях от 1). Для переведения в проценты просто умножаем на сто и округляем (при необходимости).
 +
 
 +
=== destroyBlock ===
 +
 
 +
Параметры: (x, y, z, side)
  
 
Можно юзать preventDefault()
 
Можно юзать preventDefault()
  
=== function projectileHitEntityHook(projectile, targetEntity) ===
+
Происходит при разрушении блока с координатами x, y, z со стороны side.
 +
 
 +
=== projectileHitEntityHook ===
 +
 
 +
Параметры: (projectile, targetEntity)
 +
 
 +
=== eatHook ===
  
=== function eatHook(hearts, saturationRatio) ===
+
Параметры: (hearts, saturationRatio)
  
=== function entityAddedHook(entity) ===
+
Происходит при съедании игроком еды. Параметры, вероятно, названы неправильно (надо уточнить).
  
=== function entityHurtHook(attacker, victim, halfhearts) ===
+
=== entityAddedHook ===
  
=== function entityRemovedHook(entity) ===
+
Параметр: (entity)
  
=== function explodeHook(entity, x, y, z, power, onFire) ===
+
Происходит при появлении новой сущности entity&nbsp;в мире.
 +
 
 +
=== entityHurtHook ===
 +
 
 +
Параметры: (attacker, victim, halfhearts)
 +
 
 +
=== entityRemovedHook ===
 +
 
 +
Параметр: (entity)
 +
 
 +
=== explodeHook ===
 +
 
 +
Параметры: (entity, x, y, z, power, onFire)
  
 
Можно юзать preventDefault()
 
Можно юзать preventDefault()
  
=== function serverMessageReceiveHook(str) ===
+
=== serverMessageReceiveHook ===
 +
 
 +
Параметр: (str)
  
 
Можно юзать preventDefault()
 
Можно юзать preventDefault()
  
=== function deathHook(attacker, victim) ===
+
=== deathHook ===
 +
 
 +
Параметры: (attacker, victim)
  
 
Можно юзать preventDefault()
 
Можно юзать preventDefault()
  
=== function playerAddExpHook(player, experienceAdded) ===
+
Происходит при смерти сущности victim из-за удара attacker.
 +
 
 +
=== playerAddExpHook ===
 +
 
 +
Параметры: (player, experienceAdded)
  
 
Можно юзать preventDefault()
 
Можно юзать preventDefault()
  
=== function playerExpLevelChangeHook(player, levelsAdded) ===
+
=== playerExpLevelChangeHook ===
 +
 
 +
Параметры: (player, levelsAdded)
  
 
Можно юзать preventDefault()
 
Можно юзать preventDefault()
  
=== function redstoneUpdateHook(x, y, z, newCurrent, someBooleanIDontKnow, blockId, blockData) ===
+
=== redstoneUpdateHook ===
  
=== function screenChangeHook(screenName) ===
+
Параметры: (x, y, z, newCurrent, someBooleanIDontKnow, blockId, blockData)
  
=== function newLevel() ===
+
=== function screenChangeHook ===
  
=== function startDestroyBlock(x, y, z, side) ===
+
Параметр: (screenName)
 +
 
 +
=== newLevel ===
 +
 
 +
Без параметров.
 +
 
 +
Происходит при заходе в мир.
 +
 
 +
=== startDestroyBlock ===
 +
 
 +
Параметры: (x, y, z, side)
  
 
Можно юзать preventDefault()
 
Можно юзать preventDefault()
  
=== function projectileHitBlockHook(projectile, blockX, blockY, blockZ, side) ===
+
Происходит, когда игрок начинает ломать блок с координатами x, y, z со стороны side.
  
=== function modTick()<br/> <br/> function useItem(x, y, z, itemid, blockid, side, itemDamage, blockDamage) ===
+
=== projectileHitBlockHook ===
 +
 
 +
Параметры: (projectile, blockX, blockY, blockZ, side)
 +
 
 +
=== modTick ===
 +
 
 +
Без параметров.
 +
 
 +
Происходит 20 раз в ссекунду. Является основой всех таймеров в игре. Библиотека NIDE [[ModPE/Timers|Timers]]&nbsp;служит прекрасной оболочкой, позволяющей использовать различные однократные и повторяющиеся таймеры.
 +
 
 +
 
 +
=== useItem ===
 +
 
 +
Параметры: (x, y, z, itemid, blockid, side, itemDamage, blockDamage)
  
 
Можно юзать preventDefault()
 
Можно юзать preventDefault()
 +
 +
Происходит при тапе по блоку с координатами x, y, z со стороны side. Блок, по которому тапнули, имеет id = blockid, data = blockDamage. Тапнули предметом с id = itemid, data = itemDamage.
 +
 +
Пример:
 +
<syntaxhighlight lang="javascript">/*сама функция, можно недописывать последние арументы, если не нужны*/
 +
function useItem(x, y, z, blockId, itemId)
 +
{
 +
    if(blockId == 1 && itemId == 280)//если палкой тыкнуть по камню
 +
    {
 +
        setTile(x, y, z, 5);//то заментим его на доску
 +
        clientMessage("Превращение прошло успешно!");//уведомление
 +
    }
 +
}</syntaxhighlight>

Текущая версия на 21:38, 9 ноября 2017

Ловушки ModPE - важная часть ModPE API, позволяющая отлавливать основные события в игре.

attackHook[править]

Параметры: (attacker, victim)

Можно юзать preventDefault()

Происходит при ударе сущностью attacker сущность victim.

chatHook[править]

Параметр: (str)

Можно юзать preventDefault()

Происходит при отправлении каким-либо игроком сообщения в чат.

continueDestroyBlock[править]

Параметры: (x, y, z, side, progress)

Можно юзать preventDefault()

Происходит каждый тик во время ломания блока с координатами x, y, z со стороны side. progress - значение с плавающей точкой от 0 до 1, показывает прогресс разрушения блока (в частях от 1). Для переведения в проценты просто умножаем на сто и округляем (при необходимости).

destroyBlock[править]

Параметры: (x, y, z, side)

Можно юзать preventDefault()

Происходит при разрушении блока с координатами x, y, z со стороны side.

projectileHitEntityHook[править]

Параметры: (projectile, targetEntity)

eatHook[править]

Параметры: (hearts, saturationRatio)

Происходит при съедании игроком еды. Параметры, вероятно, названы неправильно (надо уточнить).

entityAddedHook[править]

Параметр: (entity)

Происходит при появлении новой сущности entity в мире.

entityHurtHook[править]

Параметры: (attacker, victim, halfhearts)

entityRemovedHook[править]

Параметр: (entity)

explodeHook[править]

Параметры: (entity, x, y, z, power, onFire)

Можно юзать preventDefault()

serverMessageReceiveHook[править]

Параметр: (str)

Можно юзать preventDefault()

deathHook[править]

Параметры: (attacker, victim)

Можно юзать preventDefault()

Происходит при смерти сущности victim из-за удара attacker.

playerAddExpHook[править]

Параметры: (player, experienceAdded)

Можно юзать preventDefault()

playerExpLevelChangeHook[править]

Параметры: (player, levelsAdded)

Можно юзать preventDefault()

redstoneUpdateHook[править]

Параметры: (x, y, z, newCurrent, someBooleanIDontKnow, blockId, blockData)

function screenChangeHook[править]

Параметр: (screenName)

newLevel[править]

Без параметров.

Происходит при заходе в мир.

startDestroyBlock[править]

Параметры: (x, y, z, side)

Можно юзать preventDefault()

Происходит, когда игрок начинает ломать блок с координатами x, y, z со стороны side.

projectileHitBlockHook[править]

Параметры: (projectile, blockX, blockY, blockZ, side)

modTick[править]

Без параметров.

Происходит 20 раз в ссекунду. Является основой всех таймеров в игре. Библиотека NIDE Timers служит прекрасной оболочкой, позволяющей использовать различные однократные и повторяющиеся таймеры.


useItem[править]

Параметры: (x, y, z, itemid, blockid, side, itemDamage, blockDamage)

Можно юзать preventDefault()

Происходит при тапе по блоку с координатами x, y, z со стороны side. Блок, по которому тапнули, имеет id = blockid, data = blockDamage. Тапнули предметом с id = itemid, data = itemDamage.

Пример:

/*сама функция, можно недописывать последние арументы, если не нужны*/
function useItem(x, y, z, blockId, itemId) 
{
    if(blockId == 1 && itemId == 280)//если палкой тыкнуть по камню
    {
        setTile(x, y, z, 5);//то заментим его на доску
        clientMessage("Превращение прошло успешно!");//уведомление
    }
}