IBREALISTIC

use spoiler to see your lang. <details> <summary>English translate</summary> # 🏁 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 (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 <text>`) - **Multi-stage rally** — full lifecycle (RallyEvent → RallyStage → RallyP