[themrwho]

Dark Waters Kiel Canal AutoPilot
by the themrwho, v.0.11 04/03/2021

Overview
This is a helper (AutoHotkey) script designed to be used with Dark Waters mega mod for the Silent Hunter 4 game. Script plays back a number of mouse clicks and keyboard key presses to assist the Uboat captain in easily setting up a navigation waypoint route from just outside Brunsbutel port to the Kiel naval docks.

Script requires some initial one-time only (setup) requirements such as the installation of AutoHotkey [macro programming software] on your computer.
In addition, some operational requirements will need to be met each time you wish to use the script such as launching script, setting up initial waypoint, zooming the map to a certain level and so on.
Attached PDF document is intended to explain prerequisites, operational considerations, known issues and so on.

Demo Video
There is a demonstration video on Vimeo (https://vimeo.com/519521836):



As there is no in-video remarks, here is a brief explanation on what’s happening on the video:
* Ship is returning from a patrol, moving east towards Brunsbutel; the last manually set waypoint is 15 KM out and exactly south of Brunsbutel harbor.
* After some (mostly unnecessary) tweaking, map alignment is set correctly (as shown in the video and in the screenshot below) matching what the script expects.
* At 00m:16s mark ALT+8 hotkey is pressed; script takes over, starts zooming out and manually placing waypoints & dragging map to the ‘next screen’.
* At 01m:005s mark script ends its execution.
* I take over, manually drag the map to inspect the automatically plotted route, I am satisfied with the result and make no manual changes.
* From 01m:34s mark onward, I am just following the Uboat sometimes in External View sometimes in map view.
(Note: Please ignore the accidental submerge/surface etc. after 10+ years of silent hunter I know the basic controls actually but the sleep deprivation!)

Download
I do not seem to have the ability to upload files here on Subsim.com Forums - as an alternative file repository, I have uploaded it to GitLab.com, here: https://gitlab.com/themrwho/dark-wat...anal-autopilot
On that page, you can download the entire repository as a single ZIP archive by clicking on the DOWNLOAD button (down pointing arrow next to blue CLONE button) then choosing "zip" download option.

How to Use
More detailed instructions are in the documentation but here is a Quick Summary:
1) Place the "DarkWaters_Kiel_Canal_AutoPilot.ahk" file anywhere on your computer. Double click on it to run it. It will go to system tray & will start listening for keystrokes when SilentHuter4 window is active.
2) Place the 'JGSME mod directory' (which can be found once the ZIP is extracted, under 'JGSME_mod_directory' > 'Dark Waters Kiel Canal AutoPilot Hotkeys') into your standard JGSME MODS directory. This will add few (two, so far) necessary custom keybindings.
3) Activate the JGSME mod.
4) Launch & enjoy.

Documentation
Also on the GitLab, in PDF and ODT formats.

Thanks!


---

Update Log
2021-03-05: Added the missing "JGSME mod directory" to the GitLab repo. ( Here is a direct commit link to see what changed: https://gitlab.com/themrwho/dark-wat...2688f078d9ed0f ). Update post below: https://www.subsim.com/radioroom/sho...94&postcount=4

2021-03-07 Update: Good news! At the GitLab repo, in the documentation (PDF/ODT) there is only one 'Known Issue' listed, "Script is not 100% reliable". (In other words not all "click"s register, so sometimes script misses an add-waypoint operation). With further testing I have managed to eliminate this completely. Based on two days worth of testing, script's current success rate in add-waypoint operation is 100%. Further details in the Update Post below: https://www.subsim.com/radioroom/sho...52&postcount=5