xan1242 / NFS_CustomJukebox

NFS Custom Playlist Plugin

NFS Custom Jukebox Playlists

This is a plugin which overrides the built-in jukebox playlist with a custom one.

It is made with the sole purpose of simplifying access to the jukebox playlist by removing the need to edit the Attrib database (VLT)

This does NOT replace the music data itself. To modify music data, use a tool such as MPFmaster.

This is also unrelated to the XNFSMusicPlayer project. This is intended to modify the music playlist via the internal music player of the game, whereas the aforementioned project is intended to modify the music via a custom player.

Usage

1. Create a folder somewhere within the game files (by default it's "CustomPlaylists")

2. Set that path in the main ini file (PlaylistFolder) - skip if you're using the default path

3. Create an ini file (or multiples) which will contain your playlist data (or modify StockPlaylist.ini to your liking)

4. Inside the ini, define the track properties for each track (name, album, artist, index) - check PlaylistExample.ini for more and detailed info or StockPlaylist.ini as another example.

(for Pro Street) This plugin will overwrite the playlist data within the save file, which will make the playlist unusable. Follow the instructions below to fix it

Jukebox save file repairing

In case you decide that you do not want to play with the custom playlist anymore and/or have a broken playlist in the save file:

1. Place the RepairJukebox ASI inside the scripts folder

2. Load the game and the broken save file

3. Observe the playlist, it should be back to default now.

4. Save the alias to save the fixes.

This ASI doesn't do anything if CustomJukebox.asi is present, so both can be kept at the same time.

Compatibility

Currently it ONLY works for NFS Pro Street as it was built with priority (for another project).

However, as of now, the custom playlists for Most Wanted and Carbon are already figured out for another project - XNFSMusicPlayer which is basically the same thing except it also replaces the music player itself. Taking the playlist replacer out of that code will allow for this exact same functionality.

MW and Carbon are on the TODO list and are probably coming soon.

Undercover is potentially very similar.

Underground 2 is also possible, but, Pathfinder version 4 hadn't yet been fully figured out.

And lastly, Underground 1 is completely different and doesn't use Pathfinder, so this will not apply to it in the same way.