Controller Chords 0.2.0

Play Valheim — and your mods — with just the controller.

• On-screen keyboard. Whenever the game wants text while you're on the controller, an Xbox-style keyboard pops up: signs, map markers, portal tags, chat, the console, character / world names, server passwords, and text boxes in mod menus (the F1 Configuration Manager included).
• Controller cursor for mod menus. While the Configuration Manager is open the left stick moves the mouse, A clicks, the right stick scrolls and B closes it.
• Combos for mod hotkeys. Hold one or two buttons and press another to "press" a keyboard key for any mod — climbing, fishing extras, zoom, bandages… Record and set them up in game, with the controller.

Quick start

1. Load into the world with the controller in hand.
2. Hold LB, press Menu → the mod config menu (F1 Configuration Manager) opens with a controller cursor.
3. Press Y → the combo editor opens.
4. Y again adds a combo: hold the buttons you want (e.g. hold LB, press X) and let go, then pick what it presses from the list of hotkeys your mods use.

Combo 01 ships set up for the climbing mod: hold LB + RB to climb (it holds the climbing mod's ClimbKey for as long as you hold both bumpers).

On-screen keyboard

Button	Does
D-pad / left stick	Move around the keys
A	Type the highlighted key
X	Backspace (hold to repeat)
Y	Space
LB / RB	Move the text cursor
LT	Shift (press twice for caps lock) · left stick click = caps lock
RT	Letters → symbols → accented letters (á é í ó ú…)
View	Number pad
Menu	Done (same as pressing Enter)
B	Cancel (puts the old text back)

Number-only boxes (and mod settings that hold a number) open on the number pad. Touching the real keyboard closes the on-screen one and leaves the text box ready for normal typing.

Combo editor

Button	Does
D-pad / stick	Pick a row; left/right picks a column (On · Combo · Presses · Mode)
A	Edit the highlighted cell
Y	Add a combo
X	Delete (press twice)
LB / RB	Change the mode
B	Close

Modes

• Hold (default) — the key is held for as long as you hold the combo. Works for ordinary hotkeys and for hold-to-use keys like climbing.
• Tap — a short key press however long you hold the combo.
• Toggle — press once to hold the key down, press again to let it go.

Presses can follow another mod's hotkey setting ("Valheim Climbing Mod › ClimbKey"). If you later change that mod's key, the combo follows it. You can also pick any key yourself, with Shift / Ctrl / Alt.

While a combo's first buttons are held, its last button doesn't also do its normal game action (LB + Y won't open the inventory), and the held buttons stop acting until you let go (holding LB for a combo won't keep you sprinting). Both can be turned off in "2 - Combos".

System shortcuts

Setting	Default
Open mod config menu	LB + Menu
Open combo editor	— (or press Y in the config menu)
Controller cursor on/off	— (for other mouse-only mod windows)

Config menu (F1)

Every combo slot appears as "Combo 01" … with Record and Choose… buttons, so you can also set combos up from the Configuration Manager with the controller cursor. Only slots in use (plus one empty one) are listed.

How it works

• Valheim 1.0.20 reads the controller through Unity's Input System. Controller Chords reads it the same way, and while one of its panels is open it switches on Valheim's own "virtual keyboard open" state, which makes the game ignore the controller (the same thing Valheim does for the Steam Deck keyboard).
• Combo keys are added to Input.GetKey/GetKeyDown/GetKeyUp and ZInput.GetKey/GetKeyDown/GetKeyUp, which covers mods using BepInEx KeyboardShortcut, KeyCode settings, Unity's Input class or Valheim's ZInput. Key-down lasts exactly one frame (and one physics step for mods that poll in FixedUpdate).
• Text goes back into Valheim's fields exactly as if you'd typed it and pressed Enter, so signs, map markers, chat and passwords react normally.
• The controller cursor uses real Windows mouse events, so any mouse-only mod window works with it.

Limits

• Mods that only listen to Valheim's own button actions (the fishing mod uses Use / Alt Place, which already have controller buttons) don't need combos.
• Mods reading Keyboard.current from the Input System directly won't see combo keys.
• Combos are local only; nothing is saved to the world or sent over the network.

Build

dotnet build -c Release

Output: bin\ControllerChords.dll. The project references the game's DLLs in C:\Program Files (x86)\Steam\steamapps\common\Valheim (override with -p:ValheimDir=...).