IBREALISTIC

🏁 IBRealistic

Fabric-мод, превращающий лодки Minecraft в полностью симулированные раллийные машины — создан целиком на энтузиазме и с помощью ИИ.

IBRealistic — клиентский Fabric-мод для OpenBoatUtils. Он заменяет движение лодки в Minecraft профессиональной симуляцией динамики четырёхколёсного автомобиля — с настоящей физикой шин, системой повреждений, телеметрией, гонками с призраками и полной турнирной инфраструктурой.

✨ Что он делает?

IBRealistic заставляет лодки вести себя как настоящие раллийные машины. Каждый аспект вождения — сцепление, перераспределение веса, работа дифференциала, сцепление с поверхностью, погода, аэродинамика — симулируется по каждому колесу на сервере и отправляется клиенту. Ванильное поведение полностью сохраняется, когда ни один сервер не отправляет пакеты конфигурации.

🤖 Этот проект разрабатывается чисто на энтузиазме, с повсеместным использованием помощи ИИ (GitHub Copilot) — от проектирования физического движка до серверной инфраструктуры.

⚙️ Физический движок

В основе IBRealistic лежит модель динамики автомобиля с четырьмя точками контакта, работающая на частоте 80–200 Гц (4–10 подшагов за тик).

• Четырёхколёсная модель — каждое колесо (FL, FR, RL, RR) независимо рассчитывает вертикальную нагрузку, угол скольжения, боковую силу и продольную силу
• Модель шин Fiala/Brush — нелинейная боковая сила с насыщением, прогрессивным спадом, ограничением круга трения и чувствительностью к нагрузке
• Перераспределение веса — продольное (торможение/ускорение: ΔFz = m·ax·h/L) и поперечное (повороты: ΔFz = m·ay·h/T)
• Типы привода — RWD, FWD, AWD (настраиваемое распределение крутящего момента между осями)
• Дифференциалы — Open, Locked, LSD (на каждую ось, настраиваемый коэффициент блокировки)
• Аэродинамика — коэффициент прижимной силы, сопротивление, демпфирование скорости рыскания в воздухе
• Физика в воздухе — определение прыжка, потеря/восстановление сцепления при приземлении, обработка неровностей
• Самоцентрирующий момент — настраиваемая скорость возврата руля

5 пресетов машин

300+ привязок поверхностей

Каждый блок Minecraft привязан к одному из 18 типов поверхностей, у каждого свои трение, жёсткость при повороте, сопротивление качению и длина релаксации:

ASPHALT_DRY (μ=0.85) · ASPHALT_WET · GRAVEL · DIRT · MUD · SNOW · ICE · BLUE_ICE (μ=0.06) · SAND · WOOD · CONCRETE · TERRACOTTA · METAL · GLASS · WOOL · BRICK · NETHER · VEGETATION

Погодные условия

🎨 Визуал

• 4 отрисованных колеса — передние колёса поворачиваются вместе с рулём, все колёса вращаются со скоростью, задние блокируются при ручнике
• Руль — наклонён на 45°, показывает реальный угол поворота от первого лица
• Движение кузова — крен при торможении/ускорении, крен в поворотах, наклон в воздухе
• Эффекты частиц — частицы в зависимости от поверхности: гравий→дым, земля→мицелий, снег→снежинки, мокрое→брызги
• Дым из-под шин — блокировка колёс и определение дрифта (yawRate > 0.3 рад/с)
• Звуки двигателя — тон зависит от скорости; визг шин, удары, звуки поверхностей
• Визуальный подъём — модель лодки поднята на 0.25 блока, чтобы сидеть на колёсах

🔩 Система повреждений и износа

Полноценная модель механической деградации, которая вознаграждает аккуратное вождение:

• Износ шин — 4 независимые шины (0.0–1.0), сцепление падает вплоть до −30%; зависит от поверхности, скорости и стиля вождения
• Перегрев двигателя — температура растёт при полном газе дольше 30 с; потеря мощности до −50%; остывает при отпускании газа
• Повреждения кузова — от столкновений (рассчитывается сервером), 4 уровня тяжести, влияют на отзывчивость руля, мощность и максимальную скорость
• Зоны обслуживания — автоматический ремонт шин, двигателя и кузова в designated-регионах SERVICEPARK
• Индикаторы на HUD — полоски износа и индикаторы повреждений с плавным затуханием

🚩 Раллийные процедуры

Полный набор процедур в стиле WRC, встроенный в серверный плагин:

• Синхронизированный старт — цветные сообщения обратного отсчёта (🔴→🟡→✦ GO! ✦)
• Обнаружение фальстарта — движение во время отсчёта вызывает ступенчатые штрафы: 10 с → 60 с + рестарт → дисквалификация
• Контроль времени — регионы-путевые точки с допустимыми временными окнами; штрафы за ранний/поздний приезд
• Service Park — тип региона SERVICEPARK: полный авторемонт с лимитом времени и визуальным прогрессом
• Recce — режим разведки на 50% скорости с системой заметок (`/race recce note `)
• Многоэтапное ралли — полный жизненный цикл (RallyEvent → RallyStage → RallyParticipant), суперралли при сходе (+5 мин штрафа), 9 подкоманд через /rally

📡 Телеметрия

Каждая гонка записывается и проверяется:

• Клиентская запись — TelemetryFrame: 82 байта/тик, 24 поля (позиция, скорость, угол руля, износ шин, температура двигателя и т.д.)
• Локальное хранилище — файлы .ibrt в .minecraft/ibrealistic/telemetry/, сжатие GZIP
• Загрузка на сервер — передача фрагментированными пакетами после финиша
• Серверная валидация — 9 обязательных проверок + 3 статистические
• Последствие — гонка без валидной телеметрии засчитывается лишь на 20% наград

👻 Ghost Racing

Гоняй против своего лучшего круга:

• Ghost автоматически сохраняется при улучшении личного рекорда
• 3 режима отображения: LINE (траектория), BOAT (лодка-призрак), COMPETITION (полный призрак с дельтой)
• Дельта времени в реальном времени (±секунды) показывается при обгоне/отставании
• Полупрозрачный рендер с цветовой палитрой

Команды: /line · /line mode · /line count · /line info

Клиентский мод ничего не делает, пока сервер не отправит пакеты конфигурации. Ванильное поведение полностью сохраняется на серверах без IBRealistic.

🔗 Ссылки

• Наш сайт
• Репозиторий на GitHub
• Релизы и загрузки
• Список изменений

🤖 Сделано с помощью ИИ, движимо страстью. IBRealistic — сольный проект на чистом энтузиазме. GitHub Copilot помогает со всем: от математики физики до миграций базы данных — но каждое проектное решение, каждая функция и каждая гонка созданы человеком.