use spoiler to see your lang.

English translate

🏁 IBRealistic

A Fabric mod that transforms Minecraft boats into fully simulated rally cars — built entirely on enthusiasm and AI.

IBRealistic is a client-side Fabric mod for OpenBoatUtils. It replaces Minecraft's boat movement with a professional-grade four-wheel vehicle dynamics simulation — complete with real tire physics, damage systems, telemetry, ghost racing, and full tournament infrastructure.

---

✨ What does it do?

IBRealistic makes boats behave like real rally cars. Every aspect of driving — traction, weight transfer, differential behavior, surface grip, weather, aerodynamics — is simulated per-wheel on the server and sent to the client. Vanilla behavior is fully preserved when no server sends configuration packets.

---

🤖 This project is developed purely out of enthusiasm, with AI assistance (GitHub Copilot) used throughout — from physics engine design to server infrastructure.

---

⚙️ Physics Engine

The core of IBRealistic is a four-corner vehicle dynamics model running at 80–200 Hz (4–10 substeps per tick).

• Four-wheel model — each wheel (FL, FR, RL, RR) independently calculates vertical load, slip angle, lateral force, and longitudinal force
• Fiala/Brush tire model — nonlinear lateral force with saturation, progressive falloff, friction circle constraint, and load sensitivity
• Weight transfer — longitudinal (braking/acceleration: ΔFz = m·ax·h/L) and lateral (cornering: ΔFz = m·ay·h/T)
• Drivetrain types — RWD, FWD, AWD (configurable front/rear torque split)
• Differentials — Open, Locked, LSD (per axle, configurable locking coefficient)
• Aerodynamics — downforce coefficient, drag, yaw rate damping in air
• Airborne physics — jump detection, grip loss/recovery on landing, bump handling
• Self-aligning torque — configurable steering return rate

5 Vehicle Presets

Vehicle	Drive	Mass	Character
WRC_CAR	AWD	1190 kg	Fast, planted, high downforce
GROUP_B	RWD	1100 kg	Powerful, oversteer-prone
CLASSIC_RALLY	RWD	1000 kg	Balanced, moderate power
LIGHTWEIGHT	FWD	800 kg	Nimble, understeer tendency
TRUCK	AWD	2000 kg	Heavy, high torque

300+ Surface Mappings

Every Minecraft block is mapped to one of 18 surface types, each with its own friction, cornering stiffness, rolling resistance, and relaxation length:

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

Weather Conditions

Weather	Grip	Effect
CLEAR	100%	Baseline
RAIN	70%	Slower tire response
HEAVY_RAIN	50%	Much slower response
SNOW	40%	Very low grip
FOG	95%	Visual only

---

🎨 Visuals

• 4 rendered wheels — front wheels turn with steering, all wheels spin with velocity, rear wheels lock under handbrake
• Steering wheel — tilted at 45°, displays real steering angle in first-person
• Body motion — pitch (braking/acceleration), roll (cornering), tilt (airborne)
• Particle effects — surface-dependent particles: gravel→smoke, dirt→mycelium, snow→snowflakes, wet→splash
• Tire smoke — wheel lockup and drift detection (yawRate > 0.3 rad/s)
• Engine sounds — pitch scales with speed; tire squeal, impact, surface sounds
• Visual lift — boat model raised 0.25 blocks to sit on its wheels

---

🔩 Damage & Wear System

A full mechanical degradation model that rewards careful driving:

• Tire wear — 4 independent tires (0.0–1.0), grip degrades up to −30%; influenced by surface, speed, and driving style
• Engine overheat — temperature rises under full throttle for >30s; power loss up to −50%; cools down when throttle is released
• Body damage — collision-based (server-calculated), 4 severity levels affecting steering response, power, and max speed
• Service zones — automatic repair of tires, engine, and body in designated SERVICEPARK regions
• HUD indicators — wear bars and damage indicators with smooth fade-out

---

🚩 Rally Procedures

A full WRC-style rally procedure stack built into the server plugin:

• Synchronized start — colored countdown messages (🔴→🟡→✦ GO! ✦)
• False start detection — movement detected during countdown triggers stepped penalties: 10s → 60s+restart → disqualification
• Time Controls — waypoint regions with allowed time windows; penalties for early/late arrival
• Service Park — SERVICEPARK region type: full auto-repair with time limit and visual progress
• Recce — 50% speed scouting mode with a note system (/race recce note <text>)
• Multi-stage rally — full lifecycle (RallyEvent → RallyStage → RallyParticipant), superrally on retirement (+5 min penalty), 9 subcommands via /rally

---

📡 Telemetry

Every race is recorded and validated:

• Client recording — TelemetryFrame: 82 bytes/tick, 24 fields (position, velocity, steering angle, tire wear, engine temp, etc.)
• Local storage — .ibrt files in .minecraft/ibrealistic/telemetry/, GZIP compressed
• Server upload — fragmented packet transfer after finishing
• Server validation — 9 mandatory checks + 3 statistical checks
• Consequence — a race without valid telemetry counts for only 20% of rewards

---

👻 Ghost Racing

Race against your own best lap:

• Ghost auto-saved when personal best is beaten
• 3 display modes: LINE (racing line), BOAT (ghost vehicle), COMPETITION (full ghost with delta)
• Real-time delta time (±seconds) shown when overtaking/falling behind
• Semi-transparent rendering with color palette

Commands: /line · /line mode · /line count · /line info

---

The client mod does nothing unless the server sends configuration packets. Vanilla behavior is fully preserved on servers without IBRealistic.

---

🔗 Links

• Our Website
• GitHub Repository
• Releases & Downloads
• Changelog

---

🤖 Built with AI, driven by passion. IBRealistic is a solo passion project developed entirely on enthusiasm. GitHub Copilot assists with everything from physics math to database migrations — but every design decision, every feature, and every race is human-authored.

---

Русское описание

🏁 IBRealistic

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

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

---

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

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

---

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

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

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

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

Машина	Привод	Масса	Характер
WRC_CAR	AWD	1190 кг	Быстрая, прижатая, высокий даунфорс
GROUP_B	RWD	1100 кг	Мощная, склонна к заносу
CLASSIC_RALLY	RWD	1000 кг	Сбалансированная
LIGHTWEIGHT	FWD	800 кг	Юркая, склонна к сносу
TRUCK	AWD	2000 кг	Тяжёлая, высокий момент

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

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

Погода	Сцепление	Эффект
CLEAR	100%	Базовый
RAIN	70%	Медленнее реакция шин
HEAVY_RAIN	50%	Намного медленнее
SNOW	40%	Очень низкое сцепление
FOG	95%	Только визуальный

---

🎨 Визуальная часть

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

---

🔩 Система поломок и износа

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

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

---

📡 Телеметрия

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

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

---

👻 Ghost Racing

Соревнуйтесь с собственным лучшим временем:

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

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

---

Клиентский мод ничего не делает без команд от сервера. Стандартное поведение лодок полностью сохраняется на серверах без IBRealistic.

---

🔗 Ссылки

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

---

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