Grapnel

Превращает удочку в многофункциональный крюк-кошку! Мод добавляет три новых зачарования, которые полностью меняют игру с удочкой — с её помощью можно пересекать рельеф, взбираться на высоту и даже раскачиваться, как Человек-паук. Богатые настройки позволяют подогнать использование крюка под свой стиль игры.

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

🎣 Зачарование «Крюк-кошка»

• Эффект: когда поплавок зацепится за блок, сущность или стену (если включена соответствующая настройка), повторный клик правой кнопкой подтягивает игрока к поплавку.
• Механика подтягивания: сила подтягивания зависит от уровня зачарования и расстояния между поплавком и игроком. Чем выше уровень, тем быстрее подтягивает, чем больше расстояние — тем сильнее тяга.
• Амортизация падения: первое приземление после использования крюка не наносит урон от падения (можно отключить в настройках).
• Расход прочности: каждое подтягивание расходует прочность удочки (кроме творческого режима). Вероятность расхода зависит от уровня зачарования «Прочность» — чем выше уровень, тем меньше тратится прочности.

💪 Зачарование «Прочность лески»

• Эффект: усиливает леску и заметно увеличивает дальность заброса. Чем выше уровень зачарования, тем длиннее может быть леска и тем больше расстояние срабатывания при подтягивании удочки.
• На практике: это фактически увеличивает максимальную дальность полёта поплавка, позволяя зацепиться за более далёкие блоки или сущности.
• В связке с крюком: чем выше уровень «Прочности лески», тем больше эффективная дальность крюка — вместе они работают ещё лучше.

🧗 Зачарование «Раскачивание» (настраиваемое)

• Эффект: когда крюк зацепится за стену, леска начинает постоянно тянуть игрока, позволяя раскачиваться вокруг точки крепления, как на качелях.
• Физика: система в реальном времени рассчитывает тангенциальную скорость и потенциальную энергию гравитации, автоматически компенсирует сопротивление воздуха, создавая движение, близкое к настоящему маятнику.
• Столкновения: при ударе о стену игрока отбрасывает в обратную сторону с потерей части кинетической энергии — так он не застревает в стене, а раскачивание выглядит естественнее.

🧱 Зацеп за стены (настраиваемое)

• Если включено: поплавок при попадании в блок застревает на его поверхности так же, как цепляется за сущность, и не падает.
• Где пригодится: можно прицелиться в стену, чтобы поплавок надёжно закрепился, а затем подтянуть себя к нему или начать раскачиваться с зачарованием «Раскачивание».
• Визуально: поплавок фиксируется в координатах точки попадания и висит на стене, пока вы не смотаете удочку или не сломается блок.

⚙️ Гибкая настройка

Все ключевые механики можно изменить через файл конфигурации или команды в игре — под разные запросы игроков. У нового зачарования «Раскачивание» тоже есть тонкие физические параметры:

📦 Повышенная прочность удочки

В ванилле прочность удочки всего 64 — для часто используемого крюка этого совершенно недостаточно. Мод повышает базовую прочность удочки до 384 (как в Bedrock Edition).

🎮 Команды в игре

Администраторы или игроки с правами OP могут менять настройки на лету командой /grapnel_settings (на сервере):

/grapnel_settings enableFallingBuffer [true/false]   # Включить/выключить амортизацию падения
/grapnel_settings grapnelCheck [true/false]          # Включить/выключить проверку зацепа крюка
/grapnel_settings grabWall [true/false]              # Включить/выключить зацеп удочки за стены

Без аргументов команда покажет текущие значения настроек. Физические параметры зачарования «Раскачивание» пока меняются только через конфиг мода.

Детали зачарований

Редкость зачарований: все три — сокровищные зачарования, их нельзя получить на столе зачарований. В луте и торговле они встречаются с умеренной вероятностью.

Совместимость и зависимости

• Загрузчик: NeoForge
• Версии игры: Minecraft 1.21.1 / 1.21.11 / 1.21.2 / 1.21
• Зависимости: обязательных нет, просто положите в папку mods.
• Мультиплеер: после установки на сервере все настройки контролирует сервер, клиенту тоже нужно установить мод, чтобы зайти.

Обзор

Превращает удочку в многофункциональный крюк-кошку! Мод добавляет три новых зачарования, которые полностью меняют игру с удочкой — пересекайте рельеф, взбирайтесь на высоту или раскачивайтесь, как Человек-паук. Богатые настройки позволяют подогнать использование крюка под свой стиль игры.

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

🎣 Зачарование «Крюк-кошка»

• Эффект: когда поплавок зацепится за блок, сущность или стену (если включена соответствующая настройка), повторный клик правой кнопкой подтягивает игрока к поплавку.
• Механика подтягивания: сила подтягивания зависит от уровня зачарования и расстояния между поплавком и игроком. Чем выше уровень, тем быстрее подтягивает, чем больше расстояние — тем сильнее тяга.
• Амортизация падения: первое приземление после использования крюка не наносит урон от падения (можно отключить в настройках).
• Расход прочности: каждое подтягивание расходует прочность удочки (кроме творческого режима). Вероятность расхода зависит от уровня зачарования «Прочность» — чем выше уровень, тем меньше тратится прочности.

💪 Зачарование Toughness

• Эффект: Укрепляет леску, значительно увеличивая эффективную дальность заброса. Чем выше уровень зачарования, тем дальше тянется леска и тем с большего расстояния можно подтянуть удочку.
• На практике: Эффективно увеличивает максимальную дальность полёта поплавка, позволяя зацепиться за блоки или сущности на большем расстоянии.
• Синергия с Grapnel: Более высокие уровни Toughness расширяют эффективную дальность Grapnel — вместе они дают лучший результат.

🧗 Зачарование Swing (настраиваемое)

• Эффект: После того как крючок цепляется за стену, леска оказывает непрерывную тянущую силу на игрока, позволяя раскачиваться вокруг точки крепления как маятник.
• Физическая симуляция: Система рассчитывает тангенциальную скорость и гравитационную потенциальную энергию в реальном времени, автоматически компенсируя сопротивление воздуха для реалистичного движения маятника.
• Обработка столкновений: При ударе о стену игрок отскакивает с уменьшенной кинетической энергией, что предотвращает застревание и делает раскачивание естественным.

🧱 Grab Wall (настраиваемое)

• Когда включено: Поплавок прилипает к поверхности блока при попадании, прямо как при зацепе за сущность, и не отпадает.
• Сценарии использования: Прицельтесь в стену, чтобы поплавок надёжно прикрепился, затем подтянитесь, или совместите с зачарованием Swing, чтобы начать раскачиваться.
• Визуальный эффект: Поплавок остаётся зафиксированным в точке попадания, неподвижно на стене, пока вы не подтянетесь или блок не будет разрушен.

⚙️ Настраиваемая конфигурация

Все ключевые механики можно настроить через файл конфигурации или внутриигровые команды под разные стили игры. Новое зачарование Swing также предоставляет детальные физические параметры:

📦 Увеличение прочности удочки

У ванильной удочки всего 64 прочности, что слишком мало для частого использования Grapnel. Этот мод увеличивает базовую прочность удочек до 384 (как в Bedrock Edition).

🎮 Внутриигровые команды

Администраторы или игроки с правами OP могут использовать команду /grapnel_settings для настройки конфигурации в реальном времени (на стороне сервера):

/grapnel_settings enableFallingBuffer [true/false]   # Переключить буфер падения
/grapnel_settings grapnelCheck [true/false]          # Переключить обнаружение grapnel
/grapnel_settings grabWall [true/false]              # Переключить grab wall

Запуск команды без аргументов отображает текущие значения. Параметры физики для зачарования Swing сейчас нужно изменять через конфигурационный файл мода.

---

## Подробности о зачарованиях

| Название зачарования | Макс. уровень | Как получить | Краткое описание эффекта |
|---|---|---|---|
| Grapnel | I | Лут, торговля с жителями (зачарованные книги или готовое снаряжение), снаряжение мобов при спавне | Подтягивание притягивает игрока к поплавку |
| Toughness | II | Лут, торговля с жителями (зачарованные книги или готовое снаряжение) | Увеличивает эффективную длину лески, повышая дальность Grapnel |
| Swing | I | Лут, торговля с жителями (только зачарованные книги) | После захвата стены леска оказывает непрерывное натяжение, позволяя игроку раскачиваться вокруг точки крепления |

**Редкость зачарований**: Все три зачарования — **сокровищные** и **не могут быть получены на столе зачарований**. У них умеренный шанс появиться в луте и торговле, как описано выше.

---

## Совместимость и зависимости

- **Загрузчик**: NeoForge
- **Версия игры**: Minecraft 1.21.1 / 1.21.11 / 1.21.2 / 1.21
- **Зависимости**: Нет — просто поместите мод в папку `mods`.
- **Мультиплеер**: После установки на сервере все настройки контролируются сервером. Клиенту также нужно установить мод, чтобы присоединиться.