Редактирование:ToolLib

Внимание! Вы не авторизовались на сайте. Ваш IP-адрес будет публично видимым, если вы будете вносить любые правки. Если вы войдёте или создадите учётную запись, правки вместо этого будут связаны с вашим именем пользователя, а также у вас появятся другие преимущества.

Правка может быть отменена. Пожалуйста, просмотрите сравнение версий, чтобы убедиться, что это именно те изменения, которые вас интересуют, и нажмите «Записать страницу», чтобы изменения вступили в силу.
Текущая версия Ваш текст
Строка 1: Строка 1:
<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">ToolLib -&nbsp;Библиотека, предоставляющая универсальные типы инструментов и упрощающая создание инструментов.
+
<div class="mw-parser-output"><div class="mw-parser-output">[https://vk.com/doc-80513593_486896691 Скачать]</div> </div>
== Загрузка ==
 
 
 
{| border="1" cellpadding="1" cellspacing="1" style="width: 579px;"
 
|-
 
| style="width: 68px; text-align: center;" | '''Версия'''
 
| style="width: 81px; text-align: center;" | '''Скачать'''
 
| style="width: 305px; text-align: center;" | '''Изменения'''
 
| style="width: 100px; text-align: center;" | '''Дата выхода'''
 
|-
 
| style="width: 68px; text-align: center;" | '''23'''
 
| style="width: 81px; text-align: center;" | [https://github.com/MineExplorer/IC_Libraries/releases/tag/toollib-v23 Скачать]
 
| style="width: 305px;" | - Поддержка мультиплеера
 
| style="width: 100px; text-align: center;" | 27.12.20
 
|-
 
| style="width: 68px; text-align: center;" | '''22'''
 
| style="width: 81px; text-align: center;" | -
 
| style="width: 305px;" | - Топоры могут делать обтёсанную древесину<br/> -&nbsp;Исправления ошибок
 
| style="width: 100px; text-align: center;" | 24.08.20
 
|-
 
| style="width: 68px; text-align: center;" | '''21'''
 
| style="width: 81px; text-align: center;" | -
 
| style="width: 305px;" | - Добавлен enum&nbsp;MiningLevel
 
| style="width: 100px; text-align: center;" | 11.07.20
 
|}
 
 
 
== <br/> Документация ==
 
 
 
=== Подключение ===
 
 
 
Чтобы подключить библиотеку, необходимо расположить файл библиотеки в папку lib в корне мода&nbsp;написать следующее в начале вашего кода:
 
<syntaxhighlight lang="JavaScript">IMPORT("ToolLib");</syntaxhighlight>
 
 
 
После этого вам станет доступен весь функционал библиотеки.
 
 
 
=== Добавление инструмента ===
 
 
 
Для регистрации инструмента используется метод ToolLib.setTool(ItemID, toolMaterial, toolType)
 
<syntaxhighlight lang="JavaScript">ToolLib.setTool(ItemID.myTool, "wood", ToolType.axe);
 
</syntaxhighlight>
 
 
 
Так же вместо названия материала может напрямую быть передан объект с его свойствами.
 
 
 
Материалы инструментов регистрируются методом&nbsp;ToolAPI.addToolMaterial(toolMaterial, params), но библиотека добавляет поддержку свойства зачаровываемости.
 
<syntaxhighlight lang="JavaScript">ToolAPI.addToolMaterial("dirt", {
 
    durability: 15, // Прочность (сколько блоков можно сломать)
 
    level: 1, // Уровень инструмента - определяет, какие блоки инструмент может добыть.
 
    efficiency: 10, // Эффективность - модификатор скорости ломания блока
 
    damage: 1, // Увеличение базового урона инструмента данным материалом
 
    enchantability: 14 // Зачаровываемость, чем выше, тем более хорошие чары будут при зачаровании
 
});
 
</syntaxhighlight>
 
 
 
=== Уровни добычи ===
 
 
 
Библиотека позволяет вместо чисел использовать константы для уровней блоков и инструментов:
 
 
 
MiningLevel.STONE&nbsp;=&nbsp;1 - камень<br/> MiningLevel.IRON&nbsp;=&nbsp;2 - железная руда<br/> MiningLevel.DIAMOND&nbsp;=&nbsp;3 - алмазная руда<br/> MiningLevel.OBSIDIAN&nbsp;=&nbsp;4 - обсидиан
 
 
 
=== Стандартные типы инструментов ===
 
 
 
ToolType.sword - меч<br/> ToolType.shovel - лопата<br/> ToolType.pickaxe - кирка<br/> ToolType.axe - топор<br/> ToolType.hoe - мотыга
 
 
 
=== Создание своего типа инструментов ===
 
 
 
Тип инструмента - это объект, содержащий свойства&nbsp;и функции&nbsp;инструмента. Библиотека поддерживает все параметры инструмента, указываемые&nbsp;ToolAPI.registerTool, а также добавляет новые.&nbsp;
 
<syntaxhighlight lang="JavaScript">ToolType.myType = {
 
    enchantType: Native.EnchantType.pickaxe, //Тип чар для инструмента
 
    damage: 2, // Базовый урон инструмента
 
    blockTypes: ["dirt", "stone", "test"], // Материалы блоков, которые может ломать инструмент
 
    useItem: function(coords, item, block, player) { // Функция клика по блоку
 
       if (item.data > 0) {
 
           Entity.setCarriedItem(player, item.id, 1, item.data - 1, item.extra); // Починить инструмент на 1
 
       }
 
    }
 
} </syntaxhighlight>
 
 
 
=== Все методы ===
 
 
 
// Скоро будут добавлены
 
</div> </div> </div> </div>
 

Обратите внимание, что все добавления и изменения текста статьи рассматриваются как выпущенные на условиях лицензии GNU Free Documentation License 1.3 или более поздняя (см. Mineprogramming wiki:Авторские права). Если вы не хотите, чтобы ваши тексты свободно распространялись и редактировались любым желающим, не помещайте их сюда.
Вы также подтверждаете, что являетесь автором вносимых дополнений или скопировали их из источника, допускающего свободное распространение и изменение своего содержимого.
НЕ РАЗМЕЩАЙТЕ БЕЗ РАЗРЕШЕНИЯ МАТЕРИАЛЫ, ОХРАНЯЕМЫЕ АВТОРСКИМ ПРАВОМ!