Spear Core

Lyingice's Spear Library · 长矛公共库

Библиотека-основа для всех модов на копья от этого автора: логика движения копья, определение попаданий, фазы зарядки и AI мобов вынесены отдельно, чтобы их можно было переиспользовать в модах на копья для разных версий. Авторы сборок могут не писать ни строчки на Java — достаточно скрипта KubeJS, чтобы зарегистрировать настоящее копьё.

Сначала китайский, английский ниже.

KubeJS: добавляем своё копьё скриптом (главное)

Без Java и без правок самого мода — пять строк скрипта, и у вас настоящее копьё:

StartupEvents.registry('item', event => {
    event.create('mypack:bronze_spear', 'spearcore:spear')
        .displayName('Бронзовое копьё')
        .durability(400)
        .attackDamageBonus(3)
        .texture('mypack:item/bronze_spear')
})

• Второй параметр 'spearcore:spear' — это тип предмета; только с ним предмет будет создан через класс копья из этой библиотеки.
• Все параметры настраиваются в скрипте: прочность, урон, множитель урона рывка, скорость атаки, зачаровываемость, длительность четырёх фаз зарядки, дальность атаки, хитбокс, толчок вперёд, отбрасывание, сбивание всадника, множитель дистанции для мобов, звуки… Если что-то не указать, будут использованы значения железного копья.
• Получается настоящее копьё: укол, рывок, анимации от первого и третьего лица, зачарования, AI мобов — всё работает одинаково, ничего дополнительно настраивать не нужно.
• Если скрипт не сработает, библиотека продолжит работать как обычно: без ошибок и без загрузки связанного кода.
• Версии KubeJS: 2101.x для 1.21.1, 2001.x для 1.20.1.
• Полные таблицы параметров, требования к текстурам и частые ошибки — в kjs-guide.md в репозитории (на китайском и английском).

Что ещё даёт библиотека

• Базовый класс копья: наследуйтесь — и получите укол, зарядку с рывком и окна многофазных этапов (замах / сбивание всадника / отбрасывание / урон).
• Интерфейс проверки скорости: если ваш моб реализует UseSpearSpecialEntity, он подключается к тем же правилам «чем быстрее движешься, тем сильнее бьёшь»; нужная скорость, дальность атаки и множитель урона настраиваются.
• Утилиты попадания и отбрасывания: определение сущностей вдоль линии взгляда и обработка импульса самого атакующего после попадания.
• AI использования копья для мобов: универсальный Goal для сближения, зарядки, рывка и отхода.
• Рывок: универсальная реализация продвижения вперёд при уколе.

Кому это нужно

• Игрокам: отдельно ставить не нужно — моды на копья, которые от неё зависят, подтянут её автоматически.
• Авторам сборок: чтобы добавить своё копьё, достаточно раздела про KubeJS выше — код писать не требуется.
• Авторам модов: можно поставить отдельно для разработки — чтобы делать свои копья или научить своих мобов пользоваться копьём.

Версии

Нужно ставить и на клиент, и на сервер.

Ссылки

• Исходники / сообщения об ошибках: https://github.com/lyingice/Spear-Core
• Руководство по KubeJS: kjs-guide.md в репозитории

Лицензия

MIT License

Lyingice's Spear Library · English

Общая основа для модов на копья от этого автора: урон от движения, определение попаданий, фазы зарядки и AI мобов — с полноценной поддержкой KubeJS, чтобы авторы сборок могли добавлять свои копья без написания Java.

KubeJS: добавляем своё копьё скриптом

Без Java и без правок самого мода — пять строк, и у вас настоящее копьё:

StartupEvents.registry('item', event => {
    event.create('mypack:bronze_spear', 'spearcore:spear')
        .displayName('Bronze Spear')
        .durability(400)
        .attackDamageBonus(3)
        .texture('mypack:item/bronze_spear')
})

• 'spearcore:spear' — это тип предмета; именно он заставляет KubeJS создать предмет через класс копья из этой библиотеки.
• Любая характеристика задаётся скриптом: прочность, урон, множитель урона зарядки, скорость атаки, зачаровываемость, окна четырёх фаз зарядки, дальность, хитбокс, толчок вперёд, отбрасывание, сбивание всадника, множитель дистанции для мобов, звуки… всё, что не указано, берётся от железного копья.
• В итоге получается настоящее копьё: укол, зарядка, анимации от первого и третьего лица, зачарования и AI мобов ведут себя одинаково — больше ничего настраивать не нужно.
• Если скрипт не сработает, библиотека продолжит работать: без ошибок и без загрузки этого кода.
• Версия KubeJS: 2101.x на 1.21.1, 2001.x на 1.20.1.
• Полные таблицы параметров, требования к текстурам и подводные камни: kjs-guide.md в репозитории (на китайском и английском).

Что ещё она даёт

• Базовый класс копья — наследуйтесь, и получите укол, зарядку с рывком и окна многофазных этапов (замах / сбивание всадника / отбрасывание / урон).
• Хук движения — реализуйте UseSpearSpecialEntity на своём мобе, и он подключится к тем же правилам «чем быстрее движешься, тем сильнее бьёшь»; нужная скорость, дальность и множитель урона настраиваются.
• Утилиты попадания и отбрасывания — проверка сущностей вдоль луча, а также обработка импульса самого атакующего после попадания.
• AI копья для мобов — переиспользуемый Goal: сближение, зарядка, удар и отход.
• Рывок — универсальный толчок вперёд при уколе.

Кому это нужно

• Игрокам: вручную ставить нечего — моды на копья, которые её требуют, подтянут её сами.
• Авторам сборок: чтобы добавить своё копьё, достаточно раздела про KubeJS выше — код не нужен.
• Авторам модов: ставьте её напрямую, чтобы делать свои копья или научить своих мобов пользоваться копьём.

Версии

Устанавливать и на клиент, и на сервер.

Ссылки

• Исходники / трекер задач: https://github.com/lyingice/Spear-Core
• Руководство по KubeJS: kjs-guide.md в репозитории

Лицензия

MIT License