Andrew's Datapack Utils - утилиты для датапаков в Майнкрафт

Andrew's Datapack Utils (сокращённо ADPU) - это мод для Minecraft, который добавляет целый набор команд, упрощающих создание продвинутых датапаков. Если вы когда-нибудь сталкивались с ограничениями ванильных датапаков - например, невозможностью менять данные игрока через /data или считать сложные математические выражения - этот мод решает эти проблемы.

Мод работает на Fabric, NeoForge, Forge и Paper (для Paper пока в разработке, с некоторыми ограничениями). Поддерживает последние версии Minecraft, а для старых версий можно запросить отдельную сборку (но в рамках данного обзора считаем, что актуальная версия - 1.21+).

Основные возможности

Калькулятор и математика

• /aputils calc <add|sub|mul|div|power|sqrt|...> - выполняет базовые математические операции. Отлично сочетается с /execute store result и макросами функций датапаков.
• /aputils calc distance <pos1> <pos2> - считает расстояние между двумя точками.
• /aputils calc distance entities <selector1> <selector2> - расстояние между двумя сущностями.

Редактирование данных игрока

В ванильном Майнкрафте нельзя использовать /data или /execute store result entity для изменения данных игрока - команда выдаёт ошибку Unable to modify player data. ADPU снимает это ограничение. Теперь вы можете менять, например, health, food, attributes и другие NBT-теги игрока. Но не всё так просто: некоторые поля (Motion, Pos) всё равно не изменяются - для них используйте /aputils velocity или /tp.

Важно: на Paper эта функция недоступна из-за отсутствия миксинов. Вместо неё разработчик готовит команду /aputils manipulate, которая будет работать на всех загрузчиках.

Управление скоростью (velocity)

• /aputils velocity <x y z> [add|set|multiply] - позволяет менять скорость сущности, в том числе игрока. В отличие от изменения NBT, эта команда отправляет пакет клиенту, поэтому игрок сразу видит изменение движения. Требует уровня разрешений 2.

Другие полезные команды

• /aputils attack_cooldown <player> - выводит процент восстановления атаки игрока. Удобно для кастомных боевых систем.
• /aputils despawn <entities> [force] - удаляет сущность без вызова событий смерти (просто исчезает). Если force не указан, команда не сработает, если в выборку попадают игроки. Требует уровня 2, с force - уровня 4.
• /aputils check_damage <entity> [type] - проверяет, получила ли сущность урон в текущем тике. Можно указать тип урона. Работает начиная с Minecraft 1.21.2.
• /aputils pathfind <entity> <xyz> [speed] или /aputils pathfind <entity> entity <target> [speed] - заставляет моба идти к указанной точке или сущности, используя ванильный поиск пути. Скорость по умолчанию - 1. Не работает с дельфинами, но работает с рыбами.
• /aputils target <entity> <target> - принудительно меняет цель моба (агрессивных мобов). Игнорирует обычные условия (дистанция, режим игры). Не работает с драконом Края.

Определение установки мода

Датапаки могут проверить, установлен ли ADPU, с помощью команды /aputils heartbeat - она всегда возвращает 1 в /execute store result. А /aputils version возвращает 1 для NeoForge и 0 для Fabric.

Известные проблемы

• Команда /aputils velocity каждый раз выводит в консоль сообщение The new velocity is (x, y, z). Это баг, который исправят в следующем обновлении.

Совместимость и установка

Мод можно включать в любые сборки без дополнительного разрешения. Работает на Fabric, NeoForge, Forge. Для Paper сейчас разрабатывается порт, который не будет поддерживать редактирование данных игрока и проверку урона из-за архитектурных ограничений, но получит альтернативную команду /aputils manipulate для управления здоровьем, голодом и т.п.

Для кого этот мод?

Andrew's Datapack Utils - настоящая находка для создателей датапаков и карт. Если вы пишете продвинутые функции, хотите делать кастомные механики боя, управления мобами или сложные вычисления - этот мод избавит вас от костылей и ограничений. На серверах с датапаками ADPU станет незаменимым инструментом.

Скачайте Andrew's Datapack Utils и расширьте возможности ваших датапаков в Майнкрафт!