Peterwolf's Wind & Sails

1.0.2

⛵ 4.5m Sport Sailboat (Sloop Rig with Jib)

• Extended racing hull: Measures 4.5 blocks in length (+1.5 blocks longer than standard sailboat) while preserving the 1.5-block beam for nimble maneuvering.
• Sleek white racing aesthetic: Finished in a crisp white racing gelcoat with dark navy and azure competition stripes, low-drag wave-piercing bow, and open racing transom.
• Perfect symmetrical hull texturing: Fixed UV coordinates so both port and starboard walls share identical, crisp competition stripes and shading.
• Solid mast and mainsail textures: Eliminated all transparent texture gaps on the light aluminium mast and high-aspect mainsail for a flawless solid finish.
• Tall light aluminium mast: Extended by an additional block (+3 blocks taller than classic boat, ~7.0m total mast height reaching Y=-118) with a slimmer 2x2 profile, clean masthead without truck cap, and solid anodized aluminium finish.
• Extended high-aspect racing sails: Both the mainsail and jib have been enlarged and reproportioned to fit the taller mast (mainsail now reaches Y=-114 with a sleek fat-head profile, and jib reaches up to Y=-94 on the forestay).
• Higher boom: Boom gooseneck mounted half a block higher (Y=6.0) for increased cockpit clearance and optimal high-aspect sail geometry.
• Dual-sail rig (Mainsail & Jib):
  • Working headsail (jib) articulated to the bow forestay, swinging to leeward alongside the mainsail.
  • Both mainsail and jib respond to wind trim and furl cleanly together when furled (X key).
  • Slot aerodynamic effect between mainsail and jib adds ~18% enhanced sail drive and higher top speed.
  • Clean mast line when furled: When sails are furled, the jib is completely stowed away and invisible, eliminating any visual clutter or "second mast" appearance.
• Spawn with furled sails: Both classic and sport sailboats now build and spawn with their sails folded/furled by default, allowing players to board and unfurl sails when ready.
• Crafting recipe & item: Crafted from planks, white wool, and an iron ingot (pw_wind_n_sails:sport_sailboat).

🧑‍✈️ Authentic Helmsman Posture (Facing Inward to Center)

• Default gunwale seating: On both boats, the helmsman sits naturally on the windward gunwale bench rather than dead center on the floor.
• Torso faces inward to boat center: Fixed player torso orientation so that the sailor's chest, torso, and legs are always turned 90° inward toward the center of the cockpit (on both port and starboard sides), exactly like real dinghy sailors.
• Consistent across sitting & standing: Whether seated in default posture, hiking out (Space), or standing on the gunwale (double Space), the body stays turned inward toward the sail and cockpit while the head freely rotates with mouse look. Applicable to both sailboats.

💨 Wind Setting Commands & Manual Override Fix

• Persistent manual wind override: Fixed an issue where /windsails wind set <strength> was immediately overwritten in the very next tick by the natural daily weather simulation. Setting the wind now activates a manual override that stays locked until reset.
• Instant client synchronization: Setting or resetting wind immediately broadcasts updates to all connected players (WindManager.syncAll), updating HUDs, water arrows, sails, and flagpoles with zero delay.
• Flexible command syntax: Added multiple intuitive aliases and shortcuts:
  • /windsails wind set <strength> [direction]
  • /windsails wind <strength> [direction]
  • /windsails set <strength> [direction]
  • /wind set <strength> [direction] or /wind <strength> [direction]
  • /setwind <strength> [direction]
  • /windsails wind reset or /wind reset (restores natural daily weather progression).
• Singleplayer accessibility: Commands to modify wind are now always available in singleplayer worlds for testing without needing cheats/OP enabled.

🏝️ Smart Shore Dismounting

• Automatic dry land landing: When dismounting the sailboat (Shift / Dismount), the system automatically scans surrounding blocks within a ~4.5 block radius for safe, dry land (shores, riverbanks, sandy beaches, piers, docks).
• No more unwanted water landings: Players will no longer be ejected directly into the water beside the boat when a shoreline is nearby.
• Safety verification (DismountHelper): Validates head clearance, floor height, solid dry footing, and complete absence of water (FluidTags.WATER) and hazards (e.g. lava, cactus).
• Graceful open-water fallback: When far out in open water with no shore in range, players safely dismount onto the boat's gunwale.

🧭 Automatic Wind HUD & Water Arrows on Boarding / Exit

• Auto-enable on boarding: Boarding any sailboat now automatically turns on the top wind telemetry HUD (WindHudOverlay) and enables the selected wind arrows on water surfaces.
• Auto-close on exit: Dismounting the sailboat immediately hides the wind HUD and disables the water arrows, restoring natural visuals when stepping onto the shore.
• TAB toggles arrows anywhere: The TAB key allows toggling wind arrows ON or OFF at any time, even when walking on land or outside the boat.

🌊 Sleek Wind Arrows & Dedicated Style Command

• Refined, thinner arrow geometry: Arrow ribbons and chevrons are now ~3x thinner and significantly sleeker, avoiding clutter on the water surface while keeping flow lines and gusts distinct and readable.
• Style selection command (/windarrow / /windsails arrow): Select your preferred arrow aesthetic directly via command:
  • /windarrow <1..5 or name>: 1 (seafoam white), 2 (bright cyan), 3 (warm amber gold), 4 (soft sky blue), 5 (dark water shadow).
  • Supports full tab auto-completion in chat.
• TAB key toggles ON/OFF: Pressing TAB now strictly toggles your selected arrow style ON or OFF, rather than cycling through every style sequentially.

⛵ Diagonal Sailing & Hull Collision (Oriented Bounding Box / SAT)

• Eliminated diagonal phantom block collisions: Removed the previous inflated bounding box (which grew to over 3.18m × 3.18m on diagonals), which caused solid shore blocks that never touched the physical hull to halt the boat.
• Oriented Bounding Box (Separating Axis Theorem): Replaced with a precise, yaw-rotated hull collision model (3.0m length, 1.4m width) featuring forward bow taper (bow taper).
• Smooth wall sliding: Sailboats now glide and slide smoothly along shores, canals, and riverbanks instead of abrupt full stops.
• Stem, stern & gunwale protection: The bow stem and stern transom are strictly prevented from penetrating land blocks, and rudder turning near walls stops before embedding the hull.

🪢 Lead Towing & Mooring (Lead / Leashable)

• Attach lead to bow: Right-clicking the sailboat with a Lead (Items.LEAD) does not mount the boat; instead, it hooks the lead directly to the bow stem (Vec3(0.0, 0.45, 1.45)).
• Towing across water: Players walking along docks, swimming, or riding horses can tow the sailboat across water. The bow naturally turns toward the line of tension, smoothly pulling the boat with hydrodynamic drag and inertia.
• Riding with lead disables towing: If you hold a lead attached to the boat and board it as a passenger, towing pull and self-torque are completely disabled. The boat stays still and won't move from the seated player until you step out onto the shore!
• Dock mooring to fence posts: When tied to a fence post on docks/piers, the boat stays securely in place on the water and is no longer dragged onto the dock or pulled toward the post. Horizontal drift is gently dampened so the moored boat rests naturally at its berth.
• Detaching: Right-clicking a leashed boat (with a lead, empty hand, or while sneaking) unties the lead (dropLeash) with the untying sound.