Spear Core: универсальная библиотека копейного боя для Minecraft
Если вы когда-нибудь пытались собрать мод на копья с нуля, то знаете, сколько боли скрывается за простым «ткнуть и поехать вперёд». Движение, фазы зарядки, проверка попаданий, ИИ мобов — всё это приходится писать заново. Spear Core решает именно эту проблему: это общая библиотека, на которой держатся копейные моды автора Lyingice. И самое интересное — она открывает дорогу в копейный бой даже тем, кто не пишет на Java.
Что такое Spear Core и зачем он нужен
Spear Core — это не отдельный мод с новым оружием, а фундамент. Внутри собраны все механики, которые нужны настоящему копью: движение с учётом скорости, обнаружение попаданий, фазы зарядки и поведение мобов. Библиотека поддерживает Minecraft 1.20.1 на Forge 47.3.0+ и Minecraft 1.21.1 на NeoForge 21.1+. Устанавливать её нужно и на клиент, и на сервер — иначе механики просто не синхронизируются.
Кому это вообще надо? Игрокам — почти никогда: копейные моды, которые зависят от библиотеки, подтягивают её сами. Авторам сборок — для собственного оружия через скрипты. Мододелам — как готовую базу, чтобы не изобретать велосипед с нуля.
KubeJS: своё копьё без единой строки Java
Пять строк — и у вас настоящее копьё
Главная фишка Spear Core — первоклассная поддержка KubeJS. Авторы сборок могут зарегистрировать собственное копьё прямо из скрипта, не трогая сам мод. Всё, что нужно, — указать тип предмета spearcore:spear, и KubeJS создаст предмет на базе копейного класса библиотеки. Дальше настраивается буквально всё: прочность, урон, множитель урона при разгоне, скорость атаки, зачаровываемость, четыре фазы зарядки, дальность, хитбокс, толчок вперёд, отбрасывание, сбивание наездника, множитель дистанции для мобов и звуки. Что не указали — берётся от железного копья.
И это не «почти копьё», а полноценное оружие: уколы, разгон, анимации от первого и третьего лица, зачарования и ИИ мобов работают одинаково. Если скрипт сломается, библиотека продолжит работать без ошибок и просто не загрузит проблемный код. Версии KubeJS подбираются под игру: 2101.x для 1.21.1 и 2001.x для 1.20.1. Полные таблицы параметров и разбор частых ошибок лежат в файле kjs-guide.md в репозитории — он двуязычный, так что разберётся и новичок.
Что ещё даёт библиотека разработчикам
- Базовый класс копья. Наследуйтесь — и получите уколы, зарядку и многофазные окна: замах, сбивание наездника, отбрасывание, урон.
- Интерфейс скоростной проверки. Реализуйте UseSpearSpecialEntity на своём мобе, и он подключится к правилу «чем быстрее движешься, тем сильнее бьёшь». Нужная скорость, дальность и множитель урона настраиваются.
- Утилиты попаданий и отбрасывания. Проверка сущностей вдоль линии взгляда и обработка импульса атакующего после удара.
- ИИ мобов с копьём. Универсальная цель: сближение, зарядка, рывок, отход.
- Рывок. Общая реализация толчка вперёд при уколе.
Если вы собираете свой модпак и не хотите возиться с ручной установкой зависимостей, обратите внимание на лаунчер foxygame.net: в его каталоге дополнений Spear Core находится за пару кликов, а версии Forge и NeoForge подбираются автоматически под вашу сборку. Для тех, кто предпочитает ставить всё вручную, порядок простой: сначала загрузчик нужной версии, затем сам мод, затем зависимые копейные моды в папку mods.
Как установить Spear Core
Отдельно библиотеку ставят в основном разработчики и любопытные игроки. Процесс стандартный: скачайте Spear Core для Minecraft подходящей версии — 1.20.1 с Forge или 1.21.1 с NeoForge, — поместите файл в папку mods и не забудьте продублировать его на сервере. Запускайте игру через профиль нужного загрузчика. Если библиотека нужна только как зависимость, ничего делать не придётся: копейный мод притащит её сам.
Перед установкой проверьте совместимость KubeJS, если планируете писать скрипты: несовпадение ветки — самая частая причина, по которой регистрация предмета молча не срабатывает.
Итог
Spear Core — редкий пример библиотеки, которая полезна сразу трём аудиториям: игрокам она не мешает, авторам сборок даёт копья без программирования, а мододелам — готовый фундамент с движением, попаданиями и ИИ. Если вам нужен копейный бой в Minecraft без месяцев разработки, начните именно отсюда. Лицензия MIT, исходники открыты, так что экспериментировать безопасно.