Fred's Hotkeys

[center][left][color=#dd7e6b][size=6][b]FredHotkeys[/b][/size][/color][/left]
[left]Configurable keyboard shortcuts for equipment, horse care, and other useful actions in Red Dead Redemption 2[/left]
[/center]

[color=#dd7e6b][size=5][b]Overview[/b][/size][/color]
FredHotkeys adds configurable keyboard shortcuts for actions that normally require navigating the weapon wheel, item wheel, satchel, or contextual menus.

The mod is designed to preserve the game's normal animations and inventory behavior wherever possible. Hotkeys can be configured individually, shared between tap and hold actions, disabled without removing them from the configuration file, and reloaded while the game is running.

[color=#dd7e6b][size=5][b]Features[/b][/size][/color]
[list]
[][b]Equip binoculars - [/b]Default key: Y (press)[/]
[][b]Equip fishing rod - [/b]Default key: O (press)[/]
[][b]Equip lasso - [/b]Default key: 6 (press)[/]
[][b]Equip lantern - [/b]Default key: T (hold)[/]
[][b]Equip throwing knives - [/b]Default key: 6 (hold)[/]
[][b]Equip fire bottles - [/b]Default key: 9 (hold)[/]
[][b]Equip dynamite - [/b]Default key: 9 (press)[/]
[][b]Toggle bandana - [/b]Default key: 0 (press)[/]
[][b]Check pocket watch - [/b]Default key: Y (hold)[/]
[][b][b]Brush your mounted horse -[/b][/b] Default key: N (hold)[/]
[][b][b]Feed your mounted horse[/b] using a configurable food-priority list (carrots at the top!) - [/b]Default key: N (press)[/]
[][b][b]Swap primary and off-hand sidearms[/b] while holstered - [/b]Default Key: K (press)[/]
[][b]Drop the currently held weapon (careful with accidental discharges!) - [/b]Default Key: K (hold) [/]
[][b][b]Tap and hold actions may share the same key[/b][/b][/]
[][b][b]Reload the configuration in-game[/b] without restarting RDR2 - [/b]Default key: F11 (press)[/]
[/list][b][size=5][b][color=#dd7e6b]Installation[/color][/b][/size][/b]
[list=1]
[]Copy [b][b]FredHotkeys.asi[/b] [/b]into the main Red Dead Redemption 2 folder.[/]
[]Copy [b][b]FredHotkeys.ini[/b] [/b]into the same folder.[/]
[]Start the game.[/]
[/list][b][color=#dd7e6b][size=5][b]Configuration[/b][/size][/color]
[/b]Open [b]FredHotkeys.ini [/b]in a text editor.
Each action has its own section:

[code]
[Binoculars]
Key=89
Trigger=Press
HoldTimeMs=500[/code][b]
Key
[/b]Uses [url=https://cherrytree.at/misc/vk.htm]Windows virtual-key codes[/url]. 
Setting the value of a key to 0, disables the hotkey.
[b]
[b]Trigger[/b][/b]
Either Press or Hold[b]

[b]HoldTimeMs[/b]
[/b]Controls how long a Hold action must be held before it activates, in milliseconds. (1000ms =  1 second)
[b]
[size=5][b][color=#dd7e6b]Shared Tap and Hold Keys[/color][/b][/size]
[/b]One Press action and one Hold action may share the same key.
Example:
[code][Binoculars]
Key=89
Trigger=Press
HoldTimeMs=500

[PocketWatch]
Key=89
Trigger=Hold
HoldTimeMs=500[/code]
With this setup:
[list]
[]Tap Y to equip binoculars.[/]
[]Hold Y for half a second to inspect the pocket watch.[/]
[/list]Two Press actions cannot share the same key, and two Hold actions cannot share the same key.

[b][color=#dd7e6b][size=5][b]Reloading the Configuration[/b][/size][/color]
[/b]The default reload key is F5.
After editing and saving the INI file, press the reload key in-game. The updated configuration will be validated and applied immediately.

[b][color=#dd7e6b][size=5][b]Horse Feeding Priority[/b][/size][/color]
[/b]The Feed Horse action checks the configured food entries from top to bottom and uses the first available item.
Example:
[code][FeedHorse]
Key=78
Trigger=Press
HoldTimeMs=500
Food=CONSUMABLE_HAYCUBE
Food=CONSUMABLE_HERB_COMMON_BULRUSH
Food=CONSUMABLE_CARROT[/code]
Repeated "Food=" entries are supported.
The exact item names in the included INI should be kept unless you know the internal item names used by the game.
[b]
[size=5][b][color=#dd7e6b]Troubleshooting[/color][/b][/size]
[/b][b]Nothing happens when I press a key[/b]
[list]
[]Confirm that the action's Key value is not 0.[/]
[]Confirm that [General] Enabled is 1.[/]
[]Check whether the action uses Press or Hold.[/]
[]Check for a configuration error in FredHotkeys.log.[/]
[]Make sure another program or mod is not consuming the same key.[/]
[/list]
[b]The configuration will not reload[/b]
[list]
[]Save the INI before pressing the reload key.[/]
[]Check the log for an invalid key, trigger, duplicate binding, or unknown setting.[/]
[]The previous configuration remains active after a failed reload.[/]
[/list]
[b]Swap Sidearms does nothing[/b]
[list]
[]Holster all drawn weapons.[/]
[]Make sure both sidearm holsters contain weapons.[/]
[]Enable Debug and check the GUID and attach-point messages in the log.[/]
[/list]
[b]Drop Held Weapon does nothing[/b]
[list]
[]A weapon must be actively held.[/]
[]Some mission or scripted states may prevent normal weapon dropping.[/]
[]Enable Debug and check whether the held weapon GUID was resolved.[/]
[/list]
[b]A throwable hotkey equips a revolver instead[/b]
[list]
[]The requested throwable is probably empty. RDR2 may fall back to an available sidearm.[/]
[/list][b]
[size=5][b][color=#dd7e6b]Known Limitations[/color][/b][/size][/b]
[list]
[]Sidearms must be holstered before they can be swapped.[/]
[]Both sidearm holsters must contain a valid weapon.[/]
[]Drop Held Weapon prefers the primary hand while dual-wielding.[/]
[]Dropped guns may occasionally fire when they hit the ground.[/]
[]Some actions may be blocked during missions, cutscenes, menus, scripted interactions, death, arrest, or other restricted game states.[/]
[]Vanilla weapon fallback behavior may occur when requested ammunition is unavailable.[/]
[/list][b][size=5][b][color=#dd7e6b]Reporting Issues[/color][/b][/size]
[/b]When reporting issues, please include:
[list]
[]The action used[/]
[]The relevant INI section[/]
[]Whether the issue is consistent or intermittent[/]
[]What the player was doing at the time[/]
[]Whether the weapon was drawn or holstered[/]
[]The relevant section of FredHotkeys.log with Debug enabled[/]
[]A list of other weapon, inventory, input, or equipment mods installed[/]
[/list]
[b][size=5][b][color=#dd7e6b]Enjoy![/color][/b][/size][/b]