使用折叠框查看你的语言。
English translate
? IBRealistic
一款 Fabric 模组,将 Minecraft 中的船只转变为完全模拟的拉力赛车——完全基于热情与 AI 构建。
IBRealistic 是一款面向 OpenBoatUtils 的客户端 Fabric 模组。它将 Minecraft 原有的船只移动机制替换为专业级的四轮车辆动力学模拟——包含真实的轮胎物理、伤害系统、遥测数据、幽灵车竞速以及完整的赛事基础设施。
✨ 它做了什么?
IBRealistic 让船只表现得像真正的拉力赛车。驾驶的每一个方面——牵引力、重量转移、差速器行为、表面抓地力、天气、空气动力学——都在服务端按车轮独立模拟,并发送给客户端。当服务器未发送配置数据包时,原版行为将得到完全保留。
? 本项目纯粹出于热情开发,全程使用 AI 辅助(GitHub Copilot)——从物理引擎设计到服务器基础设施均如此。
⚙️ 物理引擎
IBRealistic 的核心是一个运行频率为 80–200 Hz(每 tick 4–10 个子步骤)的四轮车辆动力学模型。
- 四轮模型 — 每个车轮(左前 FL、右前 FR、左后 RL、右后 RR)独立计算垂直载荷、滑移角、侧向力和纵向力
- Fiala/Brush 轮胎模型 — 非线性侧向力带饱和特性、渐进式衰减、摩擦圆约束及载荷敏感性
- 重量转移 — 纵向(制动/加速:
ΔFz = m·ax·h/L)和横向(过弯:ΔFz = m·ay·h/T)
- 传动类型 — 后驱 RWD、前驱 FWD、四驱 AWD(可配置前后扭矩分配)
- 差速器 — 开放式、锁止式、限滑差速器 LSD(每轴独立,可配置锁止系数)
- 空气动力学 — 下压力系数、阻力、空中偏航阻尼
- 空中物理 — 跳跃检测、着陆时的抓地力丢失/恢复、颠簸处理
- 自回正力矩 — 可配置的转向回正速率
5 种车辆预设
| 车辆 |
驱动 |
质量 |
特性 |
WRC_CAR |
AWD |
1190 kg |
快速、贴地、高下压力 |
GROUP_B |
RWD |
1100 kg |
动力强劲、易过度转向 |
CLASSIC_RALLY |
RWD |
1000 kg |
平衡、中等功率 |
LIGHTWEIGHT |
FWD |
800 kg |
灵活、有不足转向倾向 |
TRUCK |
AWD |
2000 kg |
沉重、高扭矩 |
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°,在第一人称视角下显示实际转向角度
- 车身运动 — 俯仰(制动/加速)、侧倾(过弯)、倾斜(空中)
- 粒子效果 — 依赖表面的粒子:碎石→烟雾,泥土→菌丝体,雪→雪花,潮湿→溅射
- 轮胎烟雾 — 车轮抱死和漂移检测(偏航率 > 0.3 rad/s)
- 引擎声音 — 音调随速度缩放;轮胎尖叫、撞击声、表面摩擦声
- 视觉抬升 — 船体模型抬高 0.25 格以坐在车轮上
? 损坏与磨损系统
一套完整的机械退化模型,奖励谨慎驾驶:
- 轮胎磨损 — 4 个独立轮胎(0.0–1.0),抓地力下降最多达 −30%;受表面、速度和驾驶风格影响
- 发动机过热 — 全油门持续超过 30 秒温度升高;功率损失最多达 −50%;松开油门后冷却
- 车身损伤 — 基于碰撞(服务端计算),4 个严重程度等级,影响转向响应、功率和最高速度
- 维修区 — 在指定的
SERVICEPARK 区域内自动修复轮胎、发动机和车身
- HUD 指示器 — 磨损条和损伤指示器,带有平滑淡出效果
? 拉力赛流程
服务器插件内置了一套完整的 WRC 风格拉力赛流程栈:
- 同步发车 — 彩色倒计时消息(?→?→✦ GO! ✦)
- 抢跑检测 — 倒计时期间检测到移动会触发阶梯式处罚:10 秒 → 60 秒+重赛 → 取消资格
- 时间控制点 — 具有允许时间窗口的路标区域;提前或迟到到达将受到处罚
- 维修区 —
SERVICEPARK 区域类型:限时全自动修复及可视化进度
- 勘路 — 限速 50% 的侦察模式,附带笔记系统(
/race recce note <text>)
- 多阶段拉力赛 — 完整生命周期(RallyEvent → RallyStage → RallyParticipant),退赛超拉力赛规则(+5 分钟处罚),通过
/rally 提供 9 个子命令
? 遥测数据
每场比赛都会被记录并验证:
- 客户端录制 —
TelemetryFrame:每 tick 82 字节,24 个字段(位置、速度、转向角、轮胎磨损、发动机温度等)
- 本地存储 —
.minecraft/ibrealistic/telemetry/ 目录下的 .ibrt 文件,GZIP 压缩
- 服务器上传 — 完赛后分片数据包传输
- 服务器验证 — 9 项强制检查 + 3 项统计检查
- 后果 — 没有有效遥测数据的比赛仅获得 20% 的奖励
? 幽灵车竞速
与你自己的最佳圈速对决:
- 击败个人最佳成绩时自动保存幽灵车
- 3 种显示模式:
LINE(赛车线)、BOAT(幽灵载具)、COMPETITION(带有时间差的完整幽灵车)
- 超越或落后时实时显示时间差(±秒)
- 半透明渲染及配色方案
命令: /line · /line mode · /line count · /line info
如果服务器未发送配置数据包,客户端模组将完全不起作用。在没有 IBRealistic 的服务器上,原版行为会完整保留。
? 链接
? 由 AI 构建,以热情驱动。 IBRealistic 是一个纯粹出于热情的个人项目。GitHub Copilot 协助从物理数学到数据库迁移的所有工作——但每一项设计决策、每一个功能以及每一场比赛都由人类创作完成。
Русское описание
? IBRealistic
Fabric 模组,将 Minecraft 中的船只变成完全模拟的拉力赛车——纯靠热情与 AI 辅助打造。
IBRealistic 是一个基于 OpenBoatUtils 运行的 Fabric 客户端模组。该模组用专业的四轮物理模型取代了标准的船只移动方式——包含真实的轮胎物理、损坏系统、遥测数据、幽灵车竞速以及完整的赛事基础设施。
✨ 模组功能
IBRealistic 让船只表现得像真正的拉力赛车。驾驶的所有方面——抓地力、质量转移、差速器运作、路面、天气、空气动力学——都在服务端按每个车轮单独模拟并传输给客户端。如果服务器不发送配置数据包,船只的标准行为将被完整保留。
⚙️ 物理引擎
IBRealistic 的核心是一个四轮动态模型,运行频率为 80–200 Hz(每 tick 4–10 个子步骤)。
- 四轮模型 — 每个车轮(左前 FL、右前 FR、左后 RL、右后 RR)独立计算垂直载荷、滑移角、侧向力和纵向力
- Fiala/Brush 轮胎模型 — 带饱和度的非线性侧向力、渐进衰减、摩擦圆和载荷敏感性
- 质量转移 — 纵向(制动/加速)和横向(过弯)
- 驱动类型 — RWD(后驱)、FWD(前驱)、AWD(全驱,可自定义扭矩分配)
- 差速器 — Open(开放式)、Locked(锁止式)、LSD(限滑差速器,每轴独立,可自定义锁止系数)
- 空气动力学 — 下压力、阻力、空中偏航阻尼
- 空气物理 — 跳跃检测、着陆时的抓地力丧失/恢复
- 回正力矩 — 可自定义的方向盘回正速度
5 种车辆预设
| 车辆 |
驱动 |
质量 |
特性 |
WRC_CAR |
AWD |
1190 kg |
快速、高下压力、高抓地力 |
GROUP_B |
RWD |
1100 kg |
动力强劲、易甩尾 |
CLASSIC_RALLY |
RWD |
1000 kg |
平衡性良好 |
LIGHTWEIGHT |
FWD |
800 kg |
灵活、易推头 |
TRUCK |
AWD |
2000 kg |
沉重、高扭矩 |
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 rad/s)产生
- 音效 — 发动机(音高随速度变化)、轮胎尖叫、撞击声、路面声音
- 视觉抬升 — 船体模型抬高 0.25 个方块,仿佛站在车轮上
? 损坏与磨损系统
完整的机械退化模型——奖励谨慎驾驶:
- 轮胎磨损 — 4 条独立轮胎(0.0–1.0),抓地力下降最多 30%;取决于路面、速度和驾驶风格
- 发动机过热 — 持续全油门超过 30 秒温度上升;功率下降最多 50%;松开油门时冷却
- 车身损伤 — 服务端根据碰撞计算,4 个等级:影响转向、功率和最高速度
- 维修区 — 在
SERVICEPARK 等区域自动修复轮胎、发动机和车身
- HUD 指示器 — 带有平滑消失效果的磨损条
? 遥测数据
每场比赛都被记录并验证:
- 客户端记录 —
TelemetryFrame: 每 tick 82 字节,24 个字段(位置、速度、方向盘角度、轮胎磨损、发动机温度等)
- 本地存储 —
.minecraft/ibrealistic/telemetry/ 目录下的 .ibrt 文件,GZIP 压缩
- 上传至服务器 — 赛后分块传输数据包
- 服务端验证 — 9 项强制检查 + 3 项统计检查
- 后果 — 没有有效遥测数据的比赛仅获得 20% 的奖励
? 幽灵车竞速
与自己的最佳时间竞争:
- 打破个人纪录时自动保存幽灵车
- 3 种显示模式:
LINE(轨迹线)、BOAT(幽灵船)、COMPETITION(完整幽灵车及时间差)
- 超车/落后时实时显示时间差(±秒)
- 半透明渲染,配色方案
命令: /line · /line mode · /line count · /line info
如果服务器未发送配置数据包,客户端模组将完全不起作用。在没有 IBRealistic 的服务器上,船只的原版行为会完整保留。
? 链接
? IBRealistic — 一个纯粹出于热情的单人项目。GitHub Copilot 在从物理数学到数据库迁移的各个方面提供帮助,但每一项设计决策、每一个功能以及每一次“竞赛”均由人类完成。
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
? 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.
? Ссылки
? IBRealistic — соло-проект на чистом энтузиазме. GitHub Copilot помогает со всем — от физической математики до миграций баз данных — но каждое дизайн-решение, каждая функция и каждая гонка рождены человеком.
评论 0
登录后参与评分
还没有评论,来抢沙发吧