MiX Boat Helm 1.5.6

What it does
  Turns the steering wheel of a player-built boat into a helm for the whole boat.
  Sit at the wheel and:
    W        start every motor, lower every sail and raise the anchors
    S        while moving: stop the motors and raise the sails (after 0.45 s, in case a second
             S follows)
    S twice  while moving, or S once while stopped: reverse. Sails are turned round and the
             motors run astern
    Ctrl     drop all anchors, or raise them if most are down
  A key hint shows at the bottom of the screen while you sit at the wheel. /helm opens a panel
  with the same controls as buttons plus motor, sail, anchor and fuel buttons.
  Motors are topped up with low grade fuel from boxes on the boat, and fuel burn is scaled by
  FuelBurnMultiplier (0.5 = half the normal burn) when the motors start.
  It only works on player-built boats (the ones with a steering wheel, motors, sails and anchors).

  Server settings it changes: when it loads it runs these server commands, which apply to every
  player boat on the server:
    playerboat.velocitymax 15
    playerboat.dragbyangle_maxdrag 2.2
    playerboat.dragbyangle_mindrag 0.65
    playerboat.dragbyangle_maxcontrib 50
  On unload it puts all four values back to what they were before it loaded, and every boat
  motor goes back to its normal fuel burn. Reloading the plugin does not change the burn further.
  Setting Enabled to false skips these commands.

Install
  Drop plugins/MixBoatHelm.cs into carbon/plugins (Carbon) or oxide/plugins (Oxide).

Commands
  /helm, /boathelm   Open the helm panel. Works while sitting at the wheel, standing on the boat,
                     or looking at it within 6 m.
  /helm close        Close the panel.
  mixboathelm.ui <action>   Console command used by the panel buttons; can also be typed in the
                     F1 console or bound to a key (in game only). Actions:
                       forward (go, fwd), reverse (rev, back), stop,
                       motors on, motors off, sails down, sails up,
                       anchor (toggle), anchor down, anchor up,
                       fuel (move fuel from the boat's boxes into the motors now),
                       debug (list the motors, sails and anchors found), refresh, close
  All commands and the helm keys need mixboathelm.use or mixboathelm.admin, or server admin.

Permissions
  mixboathelm.use     Use the helm keys, the panel and the console command. Given to the default
                      group every time the plugin loads, so all players have it.
  mixboathelm.admin   Same as mixboathelm.use in this version.

Config highlights  (carbon/configs/MixBoatHelm.json)
  Enabled                          true   Master switch.
  FuelBurnMultiplier               0.5    Fuel burn compared with normal (0.05 to 5).
  AutoBalanceFuel                  true   Top up motors from low grade fuel on the boat.
  PullFuelFromBoatStorage          true   Allow fuel to be taken from boxes on the boat.
  OnlyEmergencyFuelWhileUnderway   true   While moving, only top up motors under 15 fuel.
  KeepEnginesAliveWhileUnderway    true   Restart a motor that stops while moving.
  RequireBuildingAuth              false  Driver must be able to build where the boat is, or be
                                          authorised on a cupboard on or near the boat.
  UseDuckForAnchor                 true   Ctrl at the wheel toggles the anchors.
  ReverseDoubleTapSeconds          0.45   Time allowed for the second S press.
  OpenPanelOnMountWheel            false  Open the panel on sitting at the wheel.

Tested
  Tested alone on Carbon 2.0.259.0 with Rust build 25454815 on 2026-09-28; runs without the rest of the MiX Server Pack.

Feedback
  Questions, bugs and ideas: MixMods Discord, discord.gg/MZCdmvFrQ, message B1.

Licence
  Free to run and change on your own servers. See LICENCE.txt.
