Ritchie's Projectile Library

Мод Ritchie's Projectile Library для Minecraft 1.20.1

Ritchie's Projectile Library (RPL) — это библиотека для разработчиков модов, предоставляющая инструменты для создания реалистичной физики полёта снарядов, оптимизированной системы загрузки чанков и визуальных эффектов для оружия. Библиотека использует тег ritchiesprojectilelib:precise_motion для передачи детализированных данных о движении сущностей клиентам, что позволяет моделировать сложные траектории. Также она включает систему вибрации экрана (screen shake) для имитации отдачи и стрельбы, а также механизм взрывных волн (bursts) для симуляции осколков и картечи без создания избыточного количества сущностей. RPL также предоставляет гибкую систему чанк-лоадинга, которая автоматически управляет загрузкой чанков вдали от игрока, снижая нагрузку на процессор при использовании оружия с большой дальностью поражения.

Физика полёта и визуальные эффекты

Библиотека предоставляет инструменты для реализации реалистичной физики полёта снарядов, заменяя упрощённую линейную анимацию на детализированные траектории с учётом гравитации и сопротивления воздуха. Для этого используется тег сущностей ritchiesprojectilelib:precise_motion, который заставляет сервер отправлять клиентам более подробные данные о позиции и движении объектов. Кроме того, RPL реализует эффект вибрации экрана (screen shake), который автоматически применяется к модификациям, использующим библиотеку. Это особенно полезно для модов с оружием, позволяя визуально передать отдачу при выстреле или ударные волны от артиллерийских снарядов без необходимости писать отдельную логику для каждого эффекта.

Оптимизированная система взрывов и чанк-лоадинг

Для симуляции взрывов и стрельбы картечью (дробовик) библиотека использует механизм взрывных волн (bursts). Это позволяет создавать эффекты разлетающихся осколков и картечи, не создавая тысячи отдельных сущностей, что критически важно для производительности на больших дистанциях. Также RPL включает продвинутую систему чанк-лоадинга, специально ориентированную на моды с дальним оружием. Она автоматически загружает только те части чанков, которые необходимы для полёта снаряда, и отгружает неиспользуемые части, даже если они были помечены как force-loaded. Это позволяет запускать снаряды на огромные расстояния без постоянного удержания в памяти всех чанков между точкой выстрела и точкой попадания, минимизируя нагрузку на процессор.

Добавление репозитория Maven

Для интеграции библиотеки в проект необходимо сначала добавить её репозиторий в блок `repositories` файла сборки. Убедитесь, что группа `com.rbasamoyai` включена в содержимое репозитория, так как это важно для корректного поиска артефактов.

Зависимость для ForgeGradle (1.18.2–1.20.1)

При использовании сборки на базе ForgeGradle добавьте следующую строку в блок `dependencies`. Обратите внимание, что параметр `transitive` должен быть установлен в `false`, чтобы избежать конфликтов версий зависимостей.

Зависимость для Loom (Fabric/Architectury)

Для проектов, использующих Loom (включая Fabric и Architectury), используйте метод `modImplementation`. Если вы используете Architectury, выберите соответствующий платформенный артефакт (`common`, `forge` или `fabric`). Для чистого Fabric используйте только `fabric`.

Формат артефактов и версии

Артефакты библиотеки имеют следующий формат: ritchiesprojectilelib- -mc. - -build. . Здесь — версия самой библиотеки, — версия Minecraft, — загрузчик (forge, fabric или common), а — номер сборки. Актуальные версии и истории сборок можно найти в истории действий GitHub репозитория разработчика.

Связанные материалы

• Fabric API — похожий мод
• Cloth Config API — похожий мод
• YetAnotherConfigLib (YACL) — похожий мод
• Fabric Language Kotlin — похожий мод
• Just Enough Items (JEI) — похожий мод

Автор: realRobotix · Лицензия: MIT