Advancement JS

Мод Advancement JS для Minecraft — расширение системы достижений

Advancement JS — это расширение для KubeJS, позволяющее создавать сложные кастомные достижения, настраивать условия их получения и награды. Мод поддерживает стандартные триггеры KubeJS, добавляет собственные механики (разрушение блоков, события боссов) и предоставляет инструменты для изменения отображения прогресса в книге достижений. Поддерживает интеграцию с Better Advancements для продвинутой верстки.

Advancement JS предоставляет мощные инструменты для модификации системы достижений Minecraft, не ограничиваясь базовыми возможностями KubeJS. Мод позволяет создавать собственные триггеры, определять сложные условия получения наград и изменять визуальное представление прогресса в интерфейсе игрока. Ключевая особенность — возможность добавлять кастомные награды, такие как эффекты, и использовать специализированные методы для управления позицией достижений в сетке.

// Создание кастомного триггера в стартовом скрипте
AdvJSEvents.trigger(event => {
    event.create("advjs:get_adv")
        .match(advancement => advancement.getId() == "minecraft:story/smelt_iron")
        .match(playerName => playerName == "Dev")
})

В отличие от стандартных событий, Advancement JS вводит собственные типы триггеров, ориентированные на игровые действия, а не только на статистику. Доступные типы включают blockDestroyed (срабатывает при разрушении блока), playerTouch (при касании сущности), bossEvent (при входе в бой с боссом) и increasedKillScore (при увеличении количества убийств). Это позволяет создавать достижения, привязанные к конкретным действиям игрока в мире, а не только к накоплению очков опыта или статистики.

// Пример кастомного триггера: разрушение блока
const destroy_dirt = TRIGGER.blockDestroyed(triggerBuilder => triggerBuilder.setBlock("dirt"));

// Пример события босса
const bossEvent = TRIGGER.bossEvent(triggerBuilder => {
    triggerBuilder.setEntity("boss");
});

Мод предоставляет гибкие методы для управления тем, как достижения отображаются в книге. Метод displayOffset позволяет сдвигать достижение и его дочерние элементы по сетке, что полезно для визуального разделения групп. Метод requireParentDone гарантирует, что достижение не появится, пока не будет выполнено родительское достижение, создавая логические цепочки. Также доступны методы для проверки выполнения других достижений: requireOthersDone и requireAnyDone.

// Добавление кастомной награды: эффект
rewardsBuilder.addEffect("absorption", 200)

// Сдвиг достижения в сетке
displayBuilder.offset(-1, 0)

// Проверка выполнения родительского достижения
childBuilder.requireParentDone()

Для пользователей, использующих мод Better Advancements, доступна специальная интеграция через событие AdvJSEvents.betterAdv. Это позволяет модифицировать положение достижений в сетке, скрывать разделители между группами и управлять видимостью элементов. Например, можно изменить координаты достижения и скрыть линии, соединяющие его с другими, создавая чистый и структурированный интерфейс.

// Интеграция с Better Advancements
AdvJSEvents.betterAdv(event => {
    event.modify("advjs:hell/child1").posX(0).posY(32).hideLines()
})

Для быстрой настройки и тестирования в Advancement JS встроенная команда /advjs. Она позволяет генерировать встроенные примеры конфигураций, демонстрируя синтаксис создания триггеров и наград. Это упрощает изучение возможностей мода и ускоряет разработку собственных механик достижений без необходимости вручную писать и отлаживать код.

Мод поддерживает удаление существующих достижений через фильтр или прямой указатель ID, а также их модификацию. При изменении достижения можно добавлять дочерние элементы, которые зависят от выполнения условий, таких как смена измерения или взаимодействие с игроком. Все изменения применяются динамически и могут быть перезагружены через стандартную команду /reload.