Jukebox for Subnautica 2

Description

Recreating the jukebox from Subnautica Below Zero, allowing you to drop any audio files you like into a folder, and use the game's pause menu coordinates to place an audio source anywhere in your game to play those audio files. The audio doesn't just play through your headphones/speakers, it acts as an in game audio source where volume drops off with distance and the sound is heavily muffled but still audible while outside your base. This was so awesome in below zero and really deserves to be in sub 2. I hope to improve the experience of using this mod and add tighter integration into the game in the near future, but for now "it just works" - todd howard. Enjoy and please feel free to give feedback it would be greatly appreciated. 

Does not work in co op, but both players should be able to independently install this and use it on their own. (Haven't tested this yet) Syncing it up does not seem like an easy task, may have to wait for an official jukebox from unknown worlds for that. 

Tested on Steam / Windows 11. Don't see why it wouldn't work on Epic, Xbox probably won't work though.

If updates break this mod I will do my best to fix it quickly.

Demo video is in progress, recording an original song first to avoid copyright so give me a bit of time

REQUIREMENTS

• Subnautica 2 (Windows, 64-bit)[/*]

• UE4SS — required. This mod will not load without it.

If you already run any Subnautica 2 mods you almost certainly have it.

If not, install UE4SS first and confirm the game still launches before adding this.[/*]

INSTALLATION

1. Close the game.

2. Extract the archive into your Subnautica 2 folder — the one containing

Subnautica2.exe. On a default Steam install that is:

C: Program Files (x86) Steam steamapps common Subnautica2The archive mirrors the game's own folder layout, so everything lands in the

right place automatically:

Subnautica2 Binaries Win64 ue4ss Mods SN2Jukebox

3. Put your music in:

Subnautica2 Binaries Win64 ue4ss Mods SN2Jukebox dlls Music MP3, WAV, OGG and FLAC all work. Tracks play in order and loop forever.

4. Tell it where to play from. This step is required. Otherwise the

jukebox stays silent, because it has no idea where you want the music.

Launch the game, stand exactly where you want the music to come from, and open

the pause menu. It shows three coordinate numbers. Write them down.

Tip: the NOA terminal is a great spot. It already talks to you, so it already

has a speaker.

Quit the game, and open this file: (make sure it's the one in the actual game folder, not in downloads or somewhere else):

Subnautica2 Binaries Win64 ue4ss Mods SN2Jukebox dlls jukebox.iniFind this line:

; ingame_position = -232783, 420413, -9877Remove the semicolon at the start, and replace the three numbers with yours.

Copy them exactly as the game showed them, in the same order.

5. Launch. A few seconds after your save loads you will hear two rising beeps.

That means the jukebox is loaded and ready.

6. Press Ctrl+Alt+J to start the music.

CONTROLS

Ctrl+Alt+J    play / pause  (this is what starts it)

Ctrl+Alt+N    next track

Ctrl+Alt+B    previous track

Ctrl+Alt+=    louder

Ctrl+Alt+-    quieter

Ctrl+Alt+R    reload jukebox.ini

The music does not start on its own. That is deliberate. If you would

rather it started automatically, set autoplay = true in jukebox.ini.

Ctrl+Alt+R re-reads the whole config while the game is running, so you can move the jukebox, change the volume, add music, or

adjust the doppler without restarting. 

WHICH FILE DO I DOWNLOAD?

Both files are identical apart from one setting.

• Doppler — the music shifts slightly in pitch as you move past it,

like a passing vehicle. [/*]

• No Doppler — the music holds a steady pitch however you move.[/*]

It is one line in jukebox.ini and you can change it while the game is running.

UNINSTALL

Delete this folder:

Subnautica2 Binaries Win64 ue4ss Mods SN2Jukebox

VIRUS SCAN

I scanned the .dll with virus total, and got these results: 

Virus Total Scan

• 2/69 flagged it as malicious[/*]

• Cynet        Malicious (score: 100)[/*]

• Microsoft    Trojan:Win32/Wacatac.C!ml[/*]

These are both generic machine learning guesses, all other scanners saw no malice in the file.

Why it gets flagged: to add a sound to the game's audio engine, the mod needs a pointer to that engine, and FMOD gives no way to ask for one. So it rewrites 12 bytes at the start of one FMOD function, catches the pointer the next time the game calls it, and immediately puts the original bytes back. It's the same technique UE4SS uses. 

SHA-256 of main.dll:

c1f32fa78b96ab46eeec917ed3c4c08c444a6a16cbe42de5283c223d9c3e6ab2