ToolLib — различия между версиями

Текущая версия на 00:23, 6 декабря 2021

ToolLib - Библиотека, предоставляющая универсальные типы инструментов и упрощающая создание инструментов.

Содержание

1 Загрузка
2 Документация

Загрузка[править]

Версия	Скачать	Изменения	Дата выхода
23	Скачать	- Поддержка мультиплеера	27.12.20
22	-	- Топоры могут делать обтёсанную древесину - Исправления ошибок	24.08.20
21	-	- Добавлен enum MiningLevel	11.07.20

Документация[править]

Подключение[править]

Чтобы подключить библиотеку, необходимо расположить файл библиотеки в папку lib в корне мода написать следующее в начале вашего кода:

IMPORT("ToolLib");

После этого вам станет доступен весь функционал библиотеки.

Добавление инструмента[править]

Для регистрации инструмента используется метод ToolLib.setTool(ItemID, toolMaterial, toolType)

ToolLib.setTool(ItemID.myTool, "wood", ToolType.axe);

Так же вместо названия материала может напрямую быть передан объект с его свойствами.

Материалы инструментов регистрируются методом ToolAPI.addToolMaterial(toolMaterial, params), но библиотека добавляет поддержку свойства зачаровываемости.

ToolAPI.addToolMaterial("dirt", {
    durability: 15, // Прочность (сколько блоков можно сломать)
    level: 1, // Уровень инструмента - определяет, какие блоки инструмент может добыть.
    efficiency: 10, // Эффективность - модификатор скорости ломания блока
    damage: 1, // Увеличение базового урона инструмента данным материалом
    enchantability: 14 // Зачаровываемость, чем выше, тем более хорошие чары будут при зачаровании
});

Уровни добычи[править]

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

MiningLevel.STONE = 1 - камень
MiningLevel.IRON = 2 - железная руда
MiningLevel.DIAMOND = 3 - алмазная руда
MiningLevel.OBSIDIAN = 4 - обсидиан

Стандартные типы инструментов[править]

ToolType.sword - меч
ToolType.shovel - лопата
ToolType.pickaxe - кирка
ToolType.axe - топор
ToolType.hoe - мотыга

Создание своего типа инструментов[править]

Тип инструмента - это объект, содержащий свойства и функции инструмента. Библиотека поддерживает все параметры инструмента, указываемые ToolAPI.registerTool, а также добавляет новые.

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

Все методы[править]

// Скоро будут добавлены

@@ Строка 1: / Строка 1: @@
-<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">
+<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">ToolLib -&nbsp;Библиотека, предоставляющая универсальные типы инструментов и упрощающая создание инструментов.
-ToolAPI - API позваляющий&nbsp;регистрировать инструменты.<br/> ToolLib -&nbsp;Библиотека, предоставляющая универсальные типы инструментов и содержащая несколько вспомогательных методов для работы с инструментами и блоками.
+== Загрузка ==
-{| border="1" cellpadding="1" cellspacing="1" style="width: 223px;"
+{| border="1" cellpadding="1" cellspacing="1" style="width: 579px;"
 |-
-| style="width: 83px; text-align: center;" | '''Версия'''
+| style="width: 68px; text-align: center;" | '''Версия'''
-| style="width: 127px; text-align: center;" | '''Скачать'''
+| style="width: 81px; text-align: center;" | '''Скачать'''
+| style="width: 305px; text-align: center;" | '''Изменения'''
+| style="width: 100px; text-align: center;" | '''Дата выхода'''
 |-
-| style="width: 83px; text-align: center;" | '''20'''
+| style="width: 68px; text-align: center;" | '''23'''
-| style="width: 127px; text-align: center;" | [https://drive.google.com/file/d/1obV7as1BOKHV04U6D3st6JXeSraWl54H/view?usp=sharing Скачать]
+| 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
 |}
-&nbsp;
+== <br/> Документация ==
-<div class="mw-parser-output">
-== Документация ==
 === Подключение ===
@@ Строка 24: / Строка 36: @@
 === Добавление инструмента ===
-Для регистрации инструмента используется метод ToolAPI.setTool(ItemID, toolMaterial, toolType)
+Для регистрации инструмента используется метод ToolLib.setTool(ItemID, toolMaterial, toolType)
-<syntaxhighlight lang="JavaScript">ToolAPI.setTool(ItemID.myTool, "wood", ToolType.axe);
+<syntaxhighlight lang="JavaScript">ToolLib.setTool(ItemID.myTool, "wood", ToolType.axe);
 </syntaxhighlight>
 Так же вместо названия материала может напрямую быть передан объект с его свойствами.
-Для регистрации нового материала инструментов используется метод&nbsp;ToolAPI.addToolMaterial(toolMaterial, params)
+Материалы инструментов регистрируются методом&nbsp;ToolAPI.addToolMaterial(toolMaterial, params), но библиотека добавляет поддержку свойства зачаровываемости.
 <syntaxhighlight lang="JavaScript">ToolAPI.addToolMaterial("dirt", {
-    durability: 3, // Прочность (Сколько блоков можно сломать)
+    durability: 15, // Прочность (сколько блоков можно сломать)
-    level: 1, // Уровень инструмента, влияет на блоки которые инструмент может ломать
+    level: 1, // Уровень инструмента - определяет, какие блоки инструмент может добыть.
     efficiency: 10, // Эффективность - модификатор скорости ломания блока
     damage: 1, // Увеличение базового урона инструмента данным материалом
@@ Строка 40: / Строка 52: @@
 </syntaxhighlight>
-<div class="mw-parser-output">
+=== Уровни добычи ===
-=== Регистрация блока ===
-Для регистрации блока используется метод&nbsp;ToolAPI.registerBlockMaterial(BlockID, blockMaterial, level);
+Библиотека позволяет вместо чисел использовать константы для уровней блоков и инструментов:
-<syntaxhighlight lang="JavaScript">ToolAPI.registerBlockMaterial(BlockID.myBlock, "stone", 1);</syntaxhighlight>
-Уровни блоков:<br/> 1 - камень<br/> 2 - железная руда<br/> 3 - алмазная руда<br/> 4 - обсидиан
+MiningLevel.STONE&nbsp;=&nbsp;1 - камень<br/> MiningLevel.IRON&nbsp;=&nbsp;2 - железная руда<br/> MiningLevel.DIAMOND&nbsp;=&nbsp;3 - алмазная руда<br/> MiningLevel.OBSIDIAN&nbsp;=&nbsp;4 - обсидиан
-Для регистрации материала блока используется метод&nbsp;ToolAPI.addBlockMaterial(blockMaterial, breakingMultiplier);
+=== Стандартные типы инструментов ===
-<syntaxhighlight lang="JavaScript">ToolAPI.addBlockMaterial("test", 3);</syntaxhighlight>
-<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">&nbsp;</div> </div> </div> </div> </div>
-=== Типы инструментов ===
+ToolType.sword - меч<br/> ToolType.shovel - лопата<br/> ToolType.pickaxe - кирка<br/> ToolType.axe - топор<br/> ToolType.hoe - мотыга
-Cтандартные типы:
+=== Создание своего типа инструментов ===
-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"], // Материалы блоков, которые может ломать инструмент
-    onAttack: function(item){
+    useItem: function(coords, item, block, player) { // Функция клика по блоку
-        if(item.data > Item.getMaxDamage(item.id)){
+        if (item.data > 0) {
-            item.id = item.data = item.count = 0;
+            Entity.setCarriedItem(player, item.id, 1, item.data - 1, item.extra); // Починить инструмент на 1
         }
     }
 } </syntaxhighlight>
-</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>