IBREALISTIC

Minecraft 版本： 1.21.3 1.21.4

平台： fabric

标签： cursed game-mechanics transportation

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](https://modrinth.com/mod/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 `) - **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](https://ibreal.kanorto.ru) - [GitHub Repository](https://github.com/Kanorto/IBREALISTIC) - [Releases & Downloads](https://github.com/Kanorto/IBREALISTIC/releases) - [Changelog](https://github.com/Kanorto/IBREALISTIC/blob/main/CHANGELOG.md) --- > ? **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](https://modrinth.com/mod/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. --- ## ? Ссылки - [Сайт](https://ibreal.kanorto.ru/) - [GitHub репозиторий](https://github.com/Kanorto/IBREALISTIC) - [Релизы и загрузки](https://github.com/Kanorto/IBREALISTIC/releases) - [Журнал изменений](https://github.com/Kanorto/IBREALISTIC/blob/main/CHANGELOG.md) --- > ? IBRealistic — соло-проект на чистом энтузиазме. GitHub Copilot помогает со всем — от физической математики до миграций баз данных — но каждое дизайн-решение, каждая функция и каждая гонка рождены человеком.