ControllerChords

\# Controller Chords

\\If you do not have enough controller buttons, now you do.\\

Controller Chords lets your Xbox-style controller "press" keyboard keys for you, so you can use keyboard-only mods without ever touching the keyboard.

\---

\## Start here: what this mod actually does

A lot of great Valheim mods are triggered by a keyboard key. Maybe a mod zooms when you press C, or drinks water when you press E. That's fine on a keyboard, but a controller only has so many buttons, and most are already doing something.

\\Controller Chords is a translator.\\ It sits quietly in the background and waits for you to press a controller button. When you do, it tells the game \"the player just pressed this keyboard key"\ — and your other mod reacts as if you really had.

One important thing to understand up front:

\\On its own, this mod does nothing you can see.\\ It has no menu and no visible effect. Its whole job is to feed key presses to your \other\ mods. So you set it up once to match the mods you already have, and from then on your controller can do things that used to need a keyboard.

Think of it like a universal remote: the remote doesn't play the movie, it just sends the right signal to the thing that does.

\---

\## The three ways it can help you

There are three styles of mapping. You can use any mix of them, and you only set up the ones you need.

\### 1. One button -> one key (the simplest)

Press a single controller button, and it sends one keyboard key.

\Example:\ press \\Y\\, and the game acts as if you pressed \\E\\. If you have a "drink water" mod bound to E, now \\Y\\ drinks water.

You can also choose \\Hold\\ for this. With Hold turned on, the key stays pressed for as long as you hold the button, and lets go when you do. That's needed for mods where you \hold\ a key (like a "hold to zoom" key).

\### 2. Two buttons together -> one key (a "chord")

Hold one button and press a second one. Together they send a key.

\Example:\ hold \\RB\\ and tap \\A\\, and the game acts as if you pressed \\Left Control\\.

This is handy when you've run out of spare buttons. Holding \\RB\\ turns your four face buttons (A, B, X, Y) into four \new\ actions, without losing what those buttons normally do on their own.

\### 3. A button -> a mouse scroll-wheel "notch"

Some mods use the \\mouse scroll wheel\\ to zoom or cycle through options — something a controller can't normally do. This lets a button act like one click of the scroll wheel.

\Example:\ a button can "scroll up" to zoom in, or "scroll down" to zoom out.

\---

\## Installing the mod

1\. Install \\BepInExPack Valheim\\ (the standard mod loader most Valheim mods need).

2\. Put ControllerChords.dll in this folder:

  BepInEx/plugins/ControllerChords/

3\. Start Valheim once, then quit. This creates the settings file you'll edit.

4\. Open the settings file:

  BepInEx/config/marc.valheim.controllerchords.cfg

You can edit that file in any text editor (Notepad is fine), or use the in-game \\Configuration Manager\\ mod if you have it.

\---

\## How to change what your buttons do

When you open the settings file you'll see it's split into labelled sections like \[SingleButton 01], \[Scroll 01], and \[Chord 01]. Each section is one mapping. To set one up, you fill in a few plain settings.

Here is what every setting means, in normal words:

| Setting | What it means |

| --- | --- |

| \\Enabled\\ | Turn this mapping on (true) or off (false). |

| \\Button\\ | The controller button you press. |

| \\Modifier\\ | The button you hold \first\ (for chords and gated scrolls). |

| \\TargetKey\\ | The keyboard key you want it to send. This must match the key your other mod uses. |

| \\HoldMode\\ | true = hold the key down while you hold the button. false = a quick tap. |

| \\Direction\\ (scroll only) | In = scroll up (usually zoom in). Out = scroll down (usually zoom out). |

The button names you can use are: A, B, X, Y, DPadUp, DPadDown, DPadLeft, DPadRight, LB, RB, LT, RT, LeftStick, RightStick, Back, Sta