We are in the process of transferring the hosting and maintenance responsibilities of the wiki from Chucklefish to ConcernedApe, which is why the wiki will temporarily be hosted at stardewcommunitywiki.com. Soon the official wiki will resume at stardewvalleywiki.com and will be hosted going forward by ConcernedApe. Prior to the transfer to ConcernedApe we will update this site with the date on which the transfer will occur.
Modding:Player Guide/Key Bindings
Some mods let you edit key bindings, which are controller/keyboard/mouse buttons which do something in-game. This page explains how to configure them. (This works for any mod using SMAPI's standard APIs.)
Configure a mod's bindings
- Install the mod (see player guide).
- Run SMAPI at least once with the mod to let it generate its config file.
- Edit config.json in the mod's folder with a text editor.
- Change the key options using the values below. (On Mac, make sure it doesn't change to curly quotes.)
Note that some mods may not be configurable.
Disable a mod's key binding
You can use None to disable a key binding.
Find the code for a key
Available bindings below shows all available key codes, but sometimes it's not clear which one applies (e.g. for non-English keyboards). Here's how to check:
- Launch the game.
- In the SMAPI console window, enter the test_input command.
- In the game, press the keys you want to test.
- The SMAPI console will list the codes for the keys it received.
Use key bindings on Android
You can bind physical mobile buttons, but there aren't many available. SMAPI on Android includes a Virtual Keyboard mod which lets you add on-screen buttons you can tap to send keyboard input to your installed mods.
To use the virtual keyboard:
- In-game, a keyboard icon should appear in the top-left corner of the screen.
- Tap the keyboard icon to show the configured buttons.
- Tap the button to send.
To add a new key:
- Run the game once to generate the default config.json file.
- Open the Mods/VirtualKeyboard/config.json file in a text editor.
- Add new buttons to the buttons field in the same format.
Tip: when you add a button, set its X value to the previous button + 96.
Reserved bindingsYou can't use the key bound to the chat box in multiplayer (default ).
- common keys
value description A through Z The letter keys. D0 through D9 The number keys. Down, Left,
The arrow keys. F1 through F24 The function keys. Apps The applications or menu () key, typically located next to your right key. Back The backspace (or ) key. CapsLock Theor key. Enter Theor key. Escape Thekey. LeftAlt, RightAlt Thekeys. LeftControl, RightControl Thekey. LeftShift, RightShift Theor keys. LeftWindows, RightWindows The Windows keys. OemCloseBrackets Thekey. OemComma Thekey. OemMinus Thekey. OemOpenBrackets Thekey. OemPeriod Thekey. OemPipe Thekey. OemPlus Thekey. OemQuestion Thekey on a US standard keyboard. OemQuotes Theor key on a US standard keyboard. OemSemicolon Thekey on a US standard keyboard. OemTilde Thekey on a US standard keyboard. Space The space bar. Tab
Subtract Subtract key Tab TAB key
- numeric pad
value description Numpad0 through Numpad9 The numpad number keys. Add Thenumpad key. Subtract Thenumpad key. Divide Thenumpad key. Multiply Thenumpad key. NumLock The numeric lock,, , or key.
- control keys (above arrow keys)
value description Delete Thekey. End Thekey. Insert Thekey. PageDown, PageUp Theand keys. Pause Thekey. PrintScreen Thekey. Scroll Thekey.
- uncommon keys
value description BrowserBack The browser back key. BrowserFavorites The browser favorites key. BrowserForward The browser forward key. BrowserHome The browser start and home key. BrowserRefresh The browser refresh key. BrowserSearch The browser search key. BrowserStop The browser stop key. ChatPadGreen The green ChatPad key. ChatPadOrange The orange ChatPad key. Crsel The cursor select key. Decimal The decimal key. EraseEof The erase EOF key. Execute The execute key. Exsel The execute selection key. Help The help key. Home The home key. ImeConvert The IME convert key. ImeNoConvert The IME no-convert key. Kana The Kana key on Japanese keyboards. Kanji The Kanji key on Japanese keyboards. LaunchApplication1 The Start Application 1 key. LaunchApplication2 The Start Application 2 key. LaunchMail The Start Mail key. MediaNextTrack The Next Track key. MediaPlayPause The Play/Pause Media key. MediaPreviousTrack The Previous Track key. MediaStop The Stop Media key. Oem8 Varies by keyboard. OemAuto OEM Auto key. OemBackslash The The OEM angle bracket or backslash key on the RT 102 key keyboard. OemClear The OEM clear key. OemCopy The OEM copy key. OemEnlW The OEM Enlarge Window key. PA1 The PA1 key. Play The play key. Thekey. ProcessKey The IME process key. Select The select key. SelectMedia The select media key. Separator The separator key. Sleep The computer sleep key. VolumeDown, VolumeUp The volume down/up keys. VolumeMute The volume mute keys. Zoom The zoom key.
| ControllerA, ControllerB,
|The main buttons.|
|ControllerBack||The 'BACK' button on an XBox controller.|
|ControllerStart||The 'START' button.|
|BigButton||The 'big button' on the XBox Big Button controller.|
| DPadDown, DPadLeft
|The directional pad buttons.|
|LeftShoulder, RightShoulder||The bumper (shoulder) buttons.|
|LeftStick, RightStick||The left/right thumbsticks when pressed as a button.|
| LeftThumbstickDown, LeftThumbstickLeft,
|The left thumbstick when pushed in a direction.|
|LeftTrigger, RightTrigger||The trigger buttons.|
| RightThumbstickDown, RightThumbstickLeft,
|The right thumbstick when pushed in a direction.|
|LeftStick, RightStick||The left or right thumbstick when clicked in.|
|MouseLeft||The left mouse button.|
|MouseRight||The right mouse button.|
|MouseMiddle||The middle mouse button.|
|MouseX1, MouseX2||The extended mouse buttons (varies by mouse).|
|VolumeUp, VolumeDown||The volume up/down buttons.|
These constants are part of the SMAPI input events, specifically SMAPI's SButton enum which unifies controller, keyboard, and mouse buttons.
- Controls for the game's default bindings