ToolAPI — различия между версиями
| Строка 1: | Строка 1: | ||
ToolAPI - это API, позваляющий регистрировать инструменты и добываемые ими блоки. | ToolAPI - это API, позваляющий регистрировать инструменты и добываемые ими блоки. | ||
| + | <div class="mw-parser-output"> | ||
=== Добавление инструмента === | === Добавление инструмента === | ||
| Строка 9: | Строка 10: | ||
// Действие при атаке | // Действие при атаке | ||
onAttack: function(item, victim, attacker) { | onAttack: function(item, victim, attacker) { | ||
| − | return true; // возврат true предотвращает | + | return true; // возврат true предотвращает повреждение инструмента |
} | } | ||
| − | // Действие при | + | // Действие при разрушении блока |
onDestroy: function(item, coords, block, player) { | onDestroy: function(item, coords, block, player) { | ||
return true; | return true; | ||
} | } | ||
| − | // Расчёт времени | + | // Расчёт времени разрушения блока инструментом |
calcDestroyTime: function(toolData, coords, block, params, destroyTime, enchantData) { | calcDestroyTime: function(toolData, coords, block, params, destroyTime, enchantData) { | ||
return 0; | return 0; | ||
| Строка 30: | Строка 31: | ||
enchantability: 14 // Зачаровываемость, чем выше, тем более хорошие чары будут при зачаровании | enchantability: 14 // Зачаровываемость, чем выше, тем более хорошие чары будут при зачаровании | ||
});</syntaxhighlight> | });</syntaxhighlight> | ||
| + | </div> | ||
=== Регистрация блоков === | === Регистрация блоков === | ||
Версия 17:33, 27 декабря 2020
ToolAPI - это API, позваляющий регистрировать инструменты и добываемые ими блоки.
Добавление инструмента
Для регистрации инструмента используется метод ToolAPI.registerTool(id, toolMaterial, blockMaterials, params)
toolMaterial - название материала инструмента или объект его описания
blockMaterials - массив с типами блоков, которые может добыть инструмент
params - дополнительные параметры и функции инструмента
ToolAPI.registerTool(ItemID.myPickaxe, "wood", ["stone"], {
damage: 1, // Базовый урон инструмента,
brokenId: 0, // Id предмета, который установится вместо инструмента при ломании
isWeapon: false, // Является ли инструмент оружием (влияет на уменьшение прочности)
// Действие при атаке
onAttack: function(item, victim, attacker) {
return true; // возврат true предотвращает повреждение инструмента
}
// Действие при разрушении блока
onDestroy: function(item, coords, block, player) {
return true;
}
// Расчёт времени разрушения блока инструментом
calcDestroyTime: function(toolData, coords, block, params, destroyTime, enchantData) {
return 0;
}
}
Для регистрации нового материала инструментов используется метод ToolAPI.addToolMaterial(toolMaterial, params)
ToolAPI.addToolMaterial("dirt", {
durability: 15, // Прочность (сколько блоков можно сломать)
level: 1, // Уровень инструмента - определяет, какие блоки инструмент может добыть.
efficiency: 10, // Эффективность - модификатор скорости ломания блока
damage: 1, // Урон от материала (складывается с базовым уроном)
enchantability: 14 // Зачаровываемость, чем выше, тем более хорошие чары будут при зачаровании
});
Регистрация блоков
Для регистрации блока используется метод ToolAPI.registerBlockMaterial(BlockID, blockMaterial, level);
blockMaterial - материал блока.
level - уровень добычи
ToolAPI.registerBlockMaterial(BlockID.myBlock, "stone", 1);
Уровни добычи блоков из майнкрафта:
1 - камень
2 - железная руда
3 - алмазная руда
4 - обсидиан
По умолчанию доступны следующие материалы:
"stone" - каменный,
"wood" - деревянный,
"dirt" - земляной,
"plant" - растения,
"fibre" - паутина,
"unbreaking" - неломаемый
Для регистрации материала блока используется метод ToolAPI.addBlockMaterial(blockMaterial, breakingMultiplier);
blockMaterial - название материала.
breakingMultiplier - модификатор времени ломания блока при добыче без подходящего инструмента.
ToolAPI.addBlockMaterial("test", 3);