06133345-1930-4a4e-a575-57b9b10520af
Overview
This mod adds a full-featured but unobtrusive music player that lets you play any music track or list of tracks in the game at any time. Features include:
- UI toggle via hotkey or on-screen button
- Next, Prev, Play / Stop buttons and hotkeys
- Dropdown track list
- Text search for both track names and IDs
- Adding to playlist via button, hotkey, or right-click in list
- Shuffle playlist via hotkey
- Clear playlist via button
- On-screen notification when changing tracks
Usage
Hide / Show
To open and close the player UI, either press the hotkey (default NumPad 0) or click on the circle that sits between the weather and season icons in the top right of the screen:
The UI doesn't replace the active menu unless you open the search box.
Basic Functions
The Play / Stop button will show the play symbol when music is not playing, and the stop symbol when music is playing.
The only exception to this is when the game is playing music that wasn't initiated by the player, then it will show the play button and pressing play will set the current playing song as the override song, preventing the game from switching music.
Once the play button is pressed, the mod will begin to play through the list of tracks or playlist, preventing the game from changing music itself.
Pressing the stop button allows the game to play and switch music as it would without the mod installed.
Track List
Hold down the mouse over the track name to open a dropdown menu with all tracks in the game.
Drag the mouse up or down to scroll through the list. Let go of the mouse to switch to the highlighted track.
While holding down the mouse, right click on a track to add it to the playlist.
You can limit tracks to those you have already discovered in the config.
Track Search
Click on the search icon to open a text box that offers suggestions.
Click on a suggestion to switch tracks.
Right click on a suggestion to add it to the playlist.
Hot Keys
Default hotkeys are:
- Prev: Left Arrow
- Next: Right Arrow
- Shuffle Playlist: Up Arrow
- Pause / Resume: Down Arrow
- Stop: End
- Add to playlist: Control + F
- Toggle UI: NumPad 0
Play List
Without any tracks added to the playlist, hotkeys will act as though all in-game songs are on the playlist.
If any tracks are added to the playlist, hotkeys like next, prev, etc. will use the custom playlist.
Playlists are tied to individual characters and saved when the game is saved at night.
Technical
Requires SMAPI.
Implements a
Generic Mod Config Menu interface to change config settings in-game.
Code is at
https://github.com/aedenthorn/StardewValleyMods.
A list of all my mods for Stardew Valley is available at
https://www.nexusmods.com/stardewvalley/articles/895.
