Controller Button Switch
🟡 Updated this year⚠️ Install Order · 1 step
Install in this order, then this mod last — most mods fail to load without their framework and dependencies in place.
Preview
🔍 Analysis
- 👍 3.6% endorsement rate — high engagement, a strong quality signal
- 🏆 #122 of 263 Utilities mods in this game by downloads
📋 About This Mod
This mod no longer works. Valheim now uses the new Unity Input System. Please use the following mod instead:
Custom Controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Original mod description below:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This mod provides config entries for each of the keyboard and joystick buttons used in Valheim.
This mod overwrites settings set using the in-game Settings menu. They will be reset to default when you run this mod the first time.
Basic Usage
Each config setting uses the following syntax:
<KeyCodeOrAxisName>,<RepeatDelay>,<RepeatInterval>,<Inverted>
Only KeyCodeOrAxisName is required, the rest are optional.
Basically, it is easiest to follow the default config formats, just swapping entries as you like.
To return to default, just remove this mod's config file and let it be recreated.
Detailed Explanation
KeyCodeOrAxisName
There are two types of input: key code and axis.
Most input are key codes, and you can get a complete list of key code names by typing dump keycodes into the in-game console (F5), which will output them to the Player.log file.
Axis refers to certain controller inputs like D-pad, etc. You can see which axis is set to which button name in the default config file (created when you start the game with this mod).
RepeatDelay
Floating-point decimal used for keys that are expected to be held down.
RepeatInterval
Floating-point decimal used for keys that are expected to be held down.
Inverted
Used for certain controller inputs where two buttons (e.g. left and right triggers) share the same axis. See the default config for places where this is used.
Config
A config file BepInEx/config/aedenthorn. ControllerButtonSwitch.cfg is created after running the game once with this mod.
You can adjust the config values by editing this file using a text editor or in-game using the Config Manager.
To reload the config from the config file, type controllerbuttonswitch reset into the game's console (F5).
Technical
To install this mod, the easiest way is to just use Vortex, the Nexus Mods mod manager. It should take care of all dependencies.
To install manually, place the dll file in the BepInEx/plugins folder. You will need BepInEx.
Controller Button Switch is a utility mod that lets you remap any key, button, or axis in the game to a custom input. It's for players who want full control over their controller or keyboard bindings. With 45 endorsements and 1,261 downloads, it's a niche tool for those who need specific remapping options.
✨ Key Features
📊 Pros & Cons
✅ Pros
- Does exactly what it says: full remapping of every input, which is a godsend for players with unusual controllers or accessibility needs.
- Lightweight utility that doesn't bloat your load order—just drop it in and go.
- Decent download count (1,261) shows it's been tried by a fair number of players.
⚠️ Cons
- Only 45 endorsements—so while it works, it hasn't exactly set the community on fire.
- No documentation or instructions in the description, so you're on your own figuring out the UI.
- Last updated October 2025—could be outdated if the game has had patches since then.
For players who need precise input remapping, like those using non-standard controllers or with specific accessibility needs. Skip if you're happy with the default bindings—this is purely a utility, not a gameplay changer.
💡 Beginner Tips
- Since this is a utility mod, make sure to place it in your mods folder and enable it in your mod manager before launching the game.
- Test your custom bindings in a safe area first to avoid getting stuck in combat with a misconfigured button.
- If you're using a controller, check if the game has native remapping options—this mod is for when those aren't enough.
📊 Mod Details
- Game
- Valheim Mods
- Author
- aedenthorn
- Version
- 0.5.1
- Downloads
- 1,261
- Endorsements
- 45
- Category
- Utilities
- Created
- 4/25/2021
- Updated
- 10/28/2025
🔧 How to Install Valheim Mods
Download from Nexus.
📖 Full step-by-step install guide for Valheim →
Visit the official mod page for specific installation instructions for this mod.
🎮 Need cheat codes or console commands? Check ur gaming wiki for Valheim commands, item IDs, and more.
Keep browsing — more Valheim mods await