Version 1.1.0

Version 1.1.0 adds support for Beat Saber 1.16.1 as well as the following features:

• You can now disable Folders & Categories as well as Playlist Management entirely in the Mod Settings Menu
• Difficulties can now be highlighted after adding songs to the playlist
• The default text only cover image can be selected when changing playlist cover image
• CustomArchiveURL: A way to have mirror download links for playlist songs, more info in the wiki

The following bugs are fixed:

• Fixed bug where folders may position in front of the Level List and block it in multiplayer
• Fixed bug where the song downloader would download the same song multiple times if multiple copies exist in the playlist (thanks Pitatochu for letting me know of this!)
• Improved transparency of PlaylistLib types so other mods can be more compatible with PlaylistManager

Version 1.0

Welcome to Version 1.0

Before you begin:

• Make sure ALL the dependencies listed in the README (SongCore, BeatSaverSharp, BeatSaberMarkupLanguage, SiraUtil) are all up to date and are using the latest versions on ModAssistant. EXCEPT BeatSaberPlaylistsLib which has an updated version newer than ModAssistant included in this zip file (Version 1.2.1). Please do this or the mod will not show up ingame.
• If you use EnhancedStreamChat, please download the latest versions from the BSMG discord in the #pc-mods channel. If you use SongBrowser, download the latest version from their GitHub page. They include bug fixes and better compatibility with this version of PlaylistManager so you will experience issues if you don't grab their latest versions.

Still with me? Let's talk features!

What's New?

PlaylistManager has a new look!

As soon as you open the Custom Songs tab in the game, you should see a new menu at the bottom that let's you filter playlists by the following categories (in this order):

• All playlists and music packs: This shows the custom levels and WIP levels folders that you've made in addition to all playlists you have, just like it does now.
• All music packs: This only shows any custom levels and WIP levels folders that you've made which is how the game would show without PlaylistManager installed.
• All playlists: This only shows all playlists
• Folders: All your playlists organized in folders. This is explained in the next section.

There is also a new logo that replaces the previous logo used when creating playlists. Both the logo and all the icons were made by Interz, thank you for making them!

Folders

PlaylistManager 1.0 brings with it the ability to organize playlists in folders. You can create, rename, delete and create playlists in folders, all ingame! These folders correspond to any folders that you've created in the "Playlists" folder in your Beat Saber install directory. Feel free to use this feature to organize playlists by category, or keep playlists from old tournaments in a different folder. Speaking of which...

Difficulty Highlighting

Ever practiced for a tournament and found it annoying to switch between the game and an excel sheet to find out which difficulties are meant to be played? This feature is for you: with difficulty highlighting you can see specific difficulties that the author of the playlist meant for you to play. BeatKhana has this feature already set up so if you sync some of your tournament playlists, you should see the difficulties highlighted. Additionally when adding a song to a playlist, you are also able to add the difficulty with it ingame and it would be highlighted when you open the playlist. This should make sharing the exact maps and difficulties you want to share a lot more easier, even if you have no experience editing .json files. Speaking of sharing...

Details View

This feature was one of the most requested features for the mod. PlaylistManager 1.0 brings with it the ability to edit the title and author of the playlist (no description editing yet since the ingame keyboard is not really cut for editing long lines). You are also able to view the description and turn off duplicate songs which would restrict only one copy of each map in a playlist (you can also turn off duplicates by default in the mod settings for future playlists). That's not all you can also edit the cover image of playlists. First, you will need to add your images to Playlists\CoverImages folder. Then you will be able to select them ingame and change the cover image of existing playlists.

And More...

A lot of miscellaneous small changes have been made to improve the quality of life for this mod. Here are some highlights:

• The add to playlist button is now accessible from inside a playlist too. This way you can select a song from inside a playlist and add it to another one.
• The add to playlist menu is also structured by folders and does not dismiss after adding a song to the playlist. This way you don't need to reopen and scroll if you want to add the same song to multiple playlists.
• When downloading songs to a playlist, the playlist will not get unselected after the download is complete
• The scroll view buttons for playlists are better positioned
• Whenever there is an error for some interactions such as deleting, a popup will also be displayed ingame and the details of this error would be stored in the logs. This should make it much more clear if something goes wrong

Message to Developers

I have moved the contents of the Guides folder (which explained syncURL) over to the repo's wiki! This also includes information on new keys such as AllowDuplicates and Difficulties if you are interested in adding these features.

Special Thanks

This would be the part where I list all the bugs I fixed but honestly there are too many to list here. Instead, I will be thanking all the people who helped me fix bugs or add features:

• Thank you Eris for upgrading the Beat Saber Modding Tools for this mod as well as supporting me through the process of development.
• Thank you Halsafar for helping me improve compatibility between our mods! Thank you for being patient throughout the process of making our mods work well together.
• Thank you Kyle for helping me with finding a solution to the compatibility issues with SongBrowser!
• Thank you Zingabopp for reviewing my changes for the playlists lib.
• Thank you to all my testers: Spiza, Binter, Kuurama and Pulselane for reporting all the bugs I did not find so this mod will be as polished as it can be.
• Thank you Interz for the logo and icons once again.

Version 0.2.4

This version removes the playlist scroll patch as it is now a part of BSML. If you are having issues scrolling through playlists where they go in the opposite direction: Please download this as well as the latest version of BSML. Alternatively, both are available on ModAssistant.

Version 0.2.3

Fixed position for sync button, thanks Kuurama for letting me know!

Version 0.2.2

• Support for 1.13.4
• Fixed 1.13.4's newest playlist scrolling bug
• Fixed bug where delete doesn't work in subfolders
• Fixed bug where playlists table view scroll overflows and is hard to click
• Added a close button for the add modal

Version 0.2.1

• Fixed bug with Song Mapper names not showing in playlists (Thanks Zingabopp and Kyle for the fix)
• Added an option to adjust scroll speed in settings (Thanks Pulselane for the PR)
• Added buttons in the playlists view for scrolling
• Fixed bug where using subfolders cause problems with playlist song remove and song add

Version 0.2.0

Version 0.2.0 brings a lot of bug fixes as well as new features. This version is also pending ModAssistant approval, however if you have the older PlaylistManager, I recommend updating immediately.

What's New?

Introducing Playlist Sync

Playlist sync will allow you to sync map pools ingame from services that provide said map pools. For launch, Hitbloq and BeatKhana will be supporting this feature, however some other websites will be joining soon too. Want to add this feature to your own website that hosts playlists? I have written a guide here explaining how to get set up in 3 easy steps!
P.S. if you're wondering why your HitBloq/BeatKhana playlist isn't showing the sync button, be sure to download the latest version of the playlist from their website, the button should appear and allow syncing after that.

Other Features

• Added a Settings menu under Mod Settings to change options such as your playlist author name
• The mod now indicates if a playlist already has a song when adding it

Bug Fixes

• Added a Harmony unwrap patch so other mods can continue to interact with ingame events that require the IPreviewBeatmapLevel (thanks Dakari for the find)
• The mod now displays playlist sprites before them being viewed in the playlist view (thanks Zingabopp for the find)
• Fixed bugs related to the modal that allows it to be click-through and sometimes acts weird with changing its positions (thanks Auros for telling me how to fix)
• Fixed bug of songs not being able to be downloaded by key (thanks Freedom_Syllable for the find)
• Fixed bug where invalid characters can be written in playlist file name, causing an Exception (thanks tek for the find)
• Fixed bug (from beta of 0.2.0) where SongCore's song loading could freeze at launch (thanks Eris for letting me know it was still happening again)

I am continuing to work on more features for this mod so hope you guys look forward to it!

Version 0.1.1

Allowed other plugins to interact with the BeatSaberPlaylistsLib PlaylistManager (for refreshing songs, creating playlists, etc).

Version 0.1.0

Release Candidate for BeatMods, please report issues to me if you find any.
All features from Readme are available.

Version 0.0.5-beta

First beta with following features:

• Create playlist
• Add song to playlist
• Remove song from playlist

Please download both PlaylistLoaderLite and PlaylistManager for this mod to work.