Perfectly_Docked_Ships_lua

PerfectlyDockedShips

This mod teleports your ship to a saved dock spot using keybinds, and on world load
it auto-fixes any ship the game spawned in the wrong place.

Requires

- UE4SS installed in your Windrose folder

Install

1. Drop the `PerfectlyDockedShips_legacy` folder into
   `Windrose\R5\Binaries\Win64\ue4ss\Mods\`
2. Add `PerfectlyDockedShips_legacy : 1` to `Mods\mods.txt`
3. Launch the game.

Build an anchor (the trifecta)

Place these three pieces within 50 cm:

- Pier pile (the wooden dock pillar)
- Wall torch, can cycle through 7 colors and "off" (normal torch color)
- Flag (any flag mesh - sets the water direction)

All three must be within ~50 cm of each other.
I personally place the torch on the pier and the flag on top. Flag MUST be
positioned with the curve side out towards the water perpenDICular to the water.
Alternatively if you place the flag you can check it by entering the delete
build menu it'll pop up a flat flag pointed in the specific direction point
this perpendicular to water.

Bind a ship

1. Walk right up to your torch. VERY VERY CLOSE (basically touching it).
2. Press F3 to cycle the torch's color.
   (Cycle order: BLACK -> WHITE -> RED -> ORANGE -> GREEN -> BLUE -> PURPLE -> OFF (normal torch color))
3. Pilot the ship you want bound - even one second at the helm is
   enough. Meaning go to the helm and press E once, can then exit immediately.
4. Stand near the dock.
5. Press F1. Ship is now bound to that dock. can check by pressing F2 should
   teleport immediately to the pier pile.

You can delete the flag after binding - the mod saved the water
direction at bind time. Pile and torch must stay; the flag is
optional once bound.

Small boat (starter "Boat")

Same as above, but use a candlestick instead of a wall torch.
AKA Candlestick + Flag + Pier Pile
50 cm. F1 binds. F2 summons.

Summon

Press F2 from anywhere in the world. The bound ship teleports to its dock
with the correct positioning (yaw for you nerds)

Auto-summon on game launch

Every world load, the mod checks each docked ship. If a ship is more
than ~2 m off its summon spot it auto-summons. Ships already in
place are left alone. Fires once per launch, then silent until you
press F2 manually.

Keybinds

- F1 - Bind currently-piloted ship to the dock you're standing at
- F2 - Summon the piloted/last-piloted ship to its bound dock
- F3 - Cycle the nearest torch's color (and OFF)
- F4 - Developer only hot reloads the code (if you paranoids care about why its in the code)

Saved data

- `bindings.lua`     -- ship name -> color
- `lamp_bindings.lua` -- color -> dock geometry

Both regenerate as you bind. Safe to delete if you want to start
over.

Also muted code in the script for wharf binding and injecting code into the
wharf workbench. Planned future update to bind ships at wharf and summon
from wharf. Until the full non-Lua release of this mod.