# Using a Controller

*Last updated:* 2026-05-02\
\&#xNAN;*Applies to Stardew Valley:* 1.6.15+

Many mods in the collections include controller support with default button mappings. This guide covers controller setup and customization, including how to access controller settings and customize button mappings to your preferences.

***

## Controller Support

Many mods in the collections include controller support. Controller buttons can be customized through each mod's **Generic Mod Config Menu (GMCM)** settings.

***

## Accessing Controller Settings

1. Launch the game
2. From the title screen, click the **⚙️ button** to open GMCM
3. Navigate to individual mod settings to customize controller buttons

***

## Default Controller Mappings

### Convenient Inventory

* **Quickstack:** Left Stick
* **Favorite item:** Left Shoulder

### Other Mods

Controller support varies by mod. Check each mod's GMCM settings for available controller options.

***

## Customizing Controller Buttons

1. From the title screen, click the **⚙️ button** to open GMCM
2. Select the mod you want to customize
3. Look for controller/keybind settings
4. Assign your preferred buttons
5. Settings save automatically

***

## Troubleshooting

### Controller not working

* **Controller connection timing:** There is a known issue where starting with a controller connected can make input control both the game and SMAPI console. This can cause accidental console closure and crash the session. See [Known Issues: Controller Input Captured by SMAPI Console on Start-up](/svVe/troubleshooting/known-issues.md#controller-input-captured-by-smapi-console-on-start-up).
* Check that controller support is enabled in the mod's GMCM settings
* Some mods may require enabling controller support in their configuration

### Buttons not responding

* Verify controller is recognized by Windows/your system
* Check mod-specific controller settings in GMCM
* Try resetting to default and reassigning buttons

***

## See Also

* [New Player Install Instructions](/svVe/installation/index.md) - Main installation guide
* [Troubleshooting & FAQ](/svVe/troubleshooting/index.md) - For additional help
* [About the Collections](/svVe/about/index.md) - Collection-specific keybind information


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://jenna-juffuffles.gitbook.io/svVe/installation/controller.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.