IBREALISTIC

IBREALISTIC

OpenBoatUtils的非官方分支,原作者为o7moon。此模组为IBREAL或其他服务器添加了更多真实的拉力赛元素。

使用剧透查看你的语言。

英语翻译

🏁 IBRealistic

一个将 Minecraft 船转变为完全模拟拉力赛车的 Fabric 模组——完全凭借热情与 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(可配置前后扭矩分配)
  • 差速器——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 指示器——磨损条和损坏指示器,平滑淡出

🚩 拉力赛流程

服务器插件内置的完整 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

一个将 Minecraft 船转变为完全模拟拉力赛车的 Fabric 模组——完全凭借热情,借助 AI 创建。

IBRealistic 是一个客户端 Fabric 模组,作为 OpenBoatUtils 的附加组件运行。该模组将船的标准运动替换为专业级四轮物理模型——包含真实的轮胎物理、损坏系统、遥测、幽灵竞速以及完整的锦标赛基础设施。


✨ 模组做什么?

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 协助一切——从物理数学到数据库迁移——但每个设计决策、每个功能和每场比赛都由人类创作。