Ritchie's Projectile Library - библиотека для работы со снарядами в Minecraft

Ritchie's Projectile Library (сокращённо RPL) - это мод-библиотека для Fabric и Forge, которая даёт мододелам мощные инструменты для создания реалистичных и производительных снарядов, пуль, ракет, осколков и всего, что летает в Minecraft. Разработана rbasamoyai и переиспользуется в его проектах.

Зачем это вообще нужно? Ванильный Майнкрафт не рассчитан на снаряды, летящие на сотни блоков, или на десятки осколков после взрыва. Всё это начинает дико лагать, либо работает криво. RPL решает именно эти проблемы - даёт нормальную синхронизацию, подгрузку чанков и эффекты без тормозов.

Что даёт RPL

• Точное движение - тег #ritchiesprojectilelib:precise_motion для сущностей, которые должны передавать клиентам более детальные данные о позиции и скорости. Полезно для артиллерии, снайперок и ракет.
• Умный чанклоадинг - система, которая загружает только нужные чанки для дальних и быстрых снарядов. Не грузит всё подряд, а подгружает порциями, освобождая форслоаженные регионы, когда они больше не нужны. Сервер не ляжет от десятка дальнобойных пушек.
• Эффект тряски экрана - для модов про огнестрел и артиллерию. Всё просто: выстрелил из здоровенной пушки - экран тряхануло, погружение сразу выше.
• Проектайл-взрывы - возможность эффективно симулировать осколочные взрывы, дробь из дробовика, шрапнельные снаряды без создания сотен отдельных сущностей. По сути - один снаряд рождает кучу мелких без нагрузки на сервер.

Как подключить к своему моду

Если ты мододел и хочешь заюзать RPL, всё стандартно. Сначала добавь репозиторий:

repositories {
    //...
    maven { url = "https://maven.realrobotix.me/master/"
        content { includeGroup("com.rbasamoyai") } }
}

Формат артефакта такой:

ritchiesprojectilelib-<rpl_version>+mc.<minecraft_version>-<rpl_platform>-build.<rpl_build_number>

где rpl_version - версия RPL, minecraft_version - версия Майнкрафт, platform - Forge или Fabric (или common), а build_number - номер сборки.

Пример для ForgeGradle (Minecraft 1.18.2-1.20.1):

implementation fg.deobf("com.rbasamoyai:ritchiesprojectilelib:<rpl_version>+mc.<minecraft_version>-forge-build.<rpl_build_number>") { transitive = false }

Для Fabric (Loom / Architectury):

modImplementation("com.rbasamoyai:ritchiesprojectilelib:<rpl_version>+mc.<minecraft_version>-fabric-build.<rpl_build_number>") { transitive = false }

Если используешь Architectury - подставь common или forge в зависимости от сабпроекта.

Кому это пригодится

Мод полигональный, не для рядового игрока. Библиотека для тех, кто пишет свои моды про оружие, технику или магию с продвинутой баллистикой. Если ты делаешь, скажем, пак артиллерии или мод с физикой пуль - RPL сэкономит кучу времени и убережёт сервер от лагов.

Сборки модов вроде Wagers of Industrial Warfare уже активно её используют. Если хочешь нормальную стрельбу с нормальной производительностью - смотри в сторону этой библиотеки.

Короче, это как раз тот случай, когда мелкая утилита решает большую проблему. Если ваш мод стреляет, летает или взрывается - Ritchie's Projectile Library обязателен к подключению.