Di Library

Di Library — это компактная многофункциональная библиотека, предназначенная для сокращения повторяющихся действий при создании датапаков.

Датапак предоставляет набор готовых функций, тегов и предикатов в пространстве имен dilib, которые позволяют разработчикам использовать общие механизмы в своих проектах.

Библиотека включает в себя систему пресетов и математических функций, которые автоматически загружаются при установке через /function dilib:presets/objectives и /function dilib:presets/const.

• Настройка констант: добавляет в storage dilib:data const значения $\pi$, $\tau$, $e$, а также диапазоны чисел и степени двойки.
• Математические операции: функции для вычисления степени (power), квадратного корня (sqrt), среднего значения (avg) и единичных дробей (unit_fraction).
• Работа с сущностями и предметами: расчет урона для предметов с «неразрушимостью», выбор сущности по UUID, конвертация байтовых данных в строки для команды /item.
• Специальные эффекты: функция kill для полного удаления объектов без сохранения данных и макрос для создания взрывов без «призраков» криперов.

Разработчики могут добавлять свои функции в теги библиотеки, чтобы они автоматически запускались при определенных игровых событиях.

• Триггер меню: срабатывает при использовании /trigger menus.
• Вход в игру: срабатывает при подключении нового игрока (содержит счетчик зашедших игроков и ID текущего игрока).
• Смерть и возрождение: срабатывает при смерти или появлении игрока в мире.
• Действия игрока: отслеживание скрытности (sneaking) с фиксацией времени, прыжков, падения (с расчетом дистанции в сантиметрах) и изменения уровня.
• Изменение уровня: отслеживает текущий уровень и шаг изменения.

• Проверка новых предметов: триггеры new_item_checker и new_item_check срабатывают при появлении предметов в мире.
• Взаимодействие с предметами: позволяет изменять данные предметов, удерживаемых стойкой для брони (armor_stand).

• Смена дня: отслеживает переход к следующему дню (хранит данные о предыдущем дне и текущем шаге).
• Смена времени суток: отслеживает изменения времени внутри дня.

Библиотека предоставляет данные для различных задач совместимости и интеграции:

• Fabric Convention Tags (пространство имен c): теги для обеспечения совместимости с модами.
• Minecraft файлы (пространство имен minecraft): если вы используете встроенные функции tick/load, их необходимо добавить в соответствующие файлы тегов.
• Di Library файлы (пространство имен dilib): содержит основные теги, модификаторы предметов и предикаты.
• Retina файлы (пространство имен retina): данные для отслеживания взгляда (только для версии 1.20.2).

Если предмет имеет тег {dilib:{clear:1b}}, он будет автоматически удаляться из инвентаря игрока или из мира.

Пример использования триггера меню для отправки сообщения с кнопкой конфигурации:

tellraw @s {"text": "[Minecraft Remade]","clickEvent": {"action": "run_command","value": "/function mc_remade:tag/menu/configs/1"},"hoverEvent": {"action": "show_text","contents": "Click me to config Minecraft Remade"},"color": "green"}

Команда /function dilib:debug имеет два режима работы:

• Первый запуск: отображает частицы в маркере, уведомляет о загрузке функций и показывает действия DiLib в строке действий (action bar).
• Второй запуск: отключает все вышеуказанные функции отладки.