vred's DP Lib

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

Возможности

• Компоненты данных id, weapon_id и namespace для идентификации предмета и пути к его функциям.
• Условия срабатывания для предмета в основной и второй руке, слотах брони, любой руке или броне: попадание по сущности, получение удара, убийство моба, одиночное и двойное нажатие приседания.
• Обработка левого и правого клика через сущность взаимодействия перед игроком; её можно показывать постоянно или только при приседании.
• Предметы по типу лука без стрел, с функцией при выстреле.
• Перелистываемые предметы: при выбрасывании предмета в основной руке применяется модификатор, который меняет предмет и map_id следующей страницы.
• Пользовательские снаряды с таймером rayAge и возвратом предмета владельцу.
• Пользовательские частицы на основе движущихся отображений предметов.
• Предикаты для исключения неподходящих целей, проверки идентификатора игрока и свободного места в инвентаре.

Как пользоваться

Все компоненты библиотеки указываются внутри custom_data={vred_lib:{...}}. Для предметов с обработчиками задайте weapon_id и namespace, затем создайте нужные функции по пути data/<namespace>/function/<weapon_id>/.

• При попадании: on_hit.mcfunction с компонентом on_hit_effect.
• При получении удара: entity_hit.mcfunction с entity_hit_effect.
• При убийстве: on_kill.mcfunction с on_kill.
• Для двойного приседания: double_sneak.mcfunction с double_sneak_effect.
• Для одиночного нажатия приседания: tap_sneak.mcfunction с tap_sneak_effect.
• Для кликов: left_click.mcfunction и right_click.mcfunction с interaction.
• Для лука без стрел: shot.mcfunction с weapon_type:bow.

Компоненты поведения вкладываются в ключ нужного слота: mainhand, offhand, head, chest, legs, feet, all, hand или armor. Для постоянной обработки удержания правой кнопки нужен компонент minecraft:food={nutrition:0,saturation:0,can_always_eat:1b,eat_seconds:1000000}. Такой же компонент и base_item требуются предмету с weapon_type:bow.

Требования и совместимость

Для проверки совместимости с Iron's Spells and Spellbooks используется счёт vred_lib.config у фиктивного игрока #iss_compat: значение 1 означает, что мод найден. Количество маны игрока доступно в счёте vred_lib.iss.mana.