Horse Follow Toggle

Toggle permanent horse following. It uses Henry's whistling but cut off to make it distinct from the standard whistle sound.

Toggle on = 1 short whistle -> Horse whinny

Toggle off = 2 short whistles -> Horse snorring

When toggled off, the horse will stop following wherever its current target position is (if it is still moving).

Important note:

I built it for personal use and just want to share it as is. I use it alongside No Horse Teleport Enhanced (no horse marker version) in Hardcore mode. So I haven't tested it with vanilla horse teleportation, so e.g. a very long or obstructed path may or may not end in a horse teleport.

Installation:

- Extract the downloaded zip file to your KingdomComeDeliverance2\Mods folder, so the structure ends up being Mods/horse_follow_toggle/Data/.

- Open `KingdomComeDeliverance2\user.cfg` (create it if it does not exist) and add "bind f6 horse_follow" without the quotes.

Any free key works.

- If not already done right click the game in your steam library -> Properties -> add "+exec user.cfg" without the quotes to your Launch Options.

Uninstallation:

Delete the horse_follow_toggle mod folder. It should not cause trouble as the mod does not override vanilla files, replace behaviour trees, audio tables, action maps, `defaultProfile.xml` or any other shared file, so it cannot be broken by, or break, another mod through overwriting.

Here is a more detailed description by Claude:

## Features

- Toggle with any key. Bind it in `user.cfg`, press it, she follows. Press again, she stops.

- Adaptive leash. While you walk, she is re-commanded from about four metres, so she stays at

your shoulder. When you break into a sprint the mod lets the gap open before commanding, so she

gets a proper running gait instead of trotting hopelessly behind you.

- Diegetic audio feedback. Henry gives a short whistle to call her on and a double whistle to

release her; she whinnies in answer and snorts when let go.

- Auto-off when you mount. No nagging the horse while you are riding it.

- Everything is configurable in a plain text file you can edit in Notepad.

- Entirely save-safe. See the section below — this matters and it is not marketing.

### Expected harmless error in your log

On startup you will see this in the log:

'user.cfg' -> invalid configuration line: 'bind f6 horse_follow'

This is cosmetic and can be ignored. KCD2 reads `user.cfg` twice: once through the startup

config parser, which only accepts `name = value` pairs and therefore rejects a `bind`, and again

through `+exec` after the console initialises, where console syntax is valid. The second pass is

the one that works. Every `user.cfg` mod produces this error.

## Console commands

| Command | Effect |

| --- | --- |

| `horse_follow` | Toggle follow mode on/off |

| `horse_follow_status` | Print current state, distance, mode and send count to the log |

## Configuration

The script is shipped unpacked, so you can open

`Mods\horse_follow_toggle\Data\Scripts\mods\horse_follow_toggle.lua` in any text editor, change a value, and

relaunch. No unzipping or repacking.

RETRIGGER_NEAR_M  = 4,    -- leash distance while you are walking

RETRIGGER_FAR_M    = 22,    -- leash distance while you are sprinting (see Inner workings)

SPRINT_SPEED_MPS  = 3. 2,  -- above this speed you count as "moving fast"

SPEED_SMOOTHING    = 0. 35,  -- smoothing on the speed measurement; higher = twitchier

MAX_RANGE_M        = 60,    -- never command her from further than this (safety, see below)

MIN_INTERVAL_MS    = 800,  -- minimum time between commands

TICK_MS            = 250,  -- how often the mod checks

CLOSING_EPS_M      = 0. 2,  -- treat "gap shrinking faster than this" as "she is already coming"

AUTO_OFF_MOUNTED  = true,  -- switch follow off when you mount

TOGGLE_COOLDOWN_MS = 1500,  -- ignore key presses within this window of the last one

VERBOSE            = true,  -- log every command; set false for a quieter log

### Sound sequences

-- { delayMs, triggerName, playOnHorse, cutAfterMs }

{    0, "v_horse_whistle",  false, 300 },  --