Potatoes-Potatoes_TNH_BGM_Loader icon

Potatoes TNH BGM Loader

PTNHBGML, aka Potatoes' Sound Loader is a loader to replace TnH background music, announcers, and Sosig voicelines.

Last updated a day ago
Total downloads 58456
Total rating 15 
Categories Music Audio Libraries
Dependency string Potatoes-Potatoes_TNH_BGM_Loader-4.0.0
Dependants 508 other mods depend on this mod

This mod requires the following mods to function

BepInEx-BepInExPack_H3VR-5.4.1101 icon

BepInEx pack for H3VR. Preconfigured and ready to use.

Preferred version: 5.4.1101
Stratum-Stratum-1.1.1 icon

A lite stage and asset management framework, designed with Thunderstore in mind.

Preferred version: 1.1.1
nrgill28-Sodalite-1.1.0 icon

Modding API and tools for H3VR code plugins

Preferred version: 1.1.0


Potatoes' Take And Hold Background Music Loader

Whoo! What a doozy for a name. For an easier name, you're welcome to use the official acronym, PTNHBGML. Much nicer.

Or Potatoes' Sound Loader.

Your choice, whichever rolls off the tongue better.

Anyway, PTNHBGML is a simple mod; and it's in the name. It loads music. It replaces your old Take And Hold background music with much nicer (insert genre of music) that you enjoy.

You can change BGMs, Announcers, and Sosig voicelines in the panel in the TnH Lobby.

Please see the wiki page on GitHub for info about making a mod using PTNHBGML!

You can read the updates on the GitHub repo!



[4.0.0] - 2023-09-27 - Soundtrack Support


  • Added support for replacing Zosig Voicelines
  • Added Soundtrack support, an alternative to Bank BGMs to allow for MAXIMUM flexibility to song modders.
  • Added support for usage of Soundtracks and PTNHBGML outside of TnH and into custom gamemodes.

[3.1.0] - 2021-12-24


  • Added variable front and back padding (Time distance between an event occuring, and the voiceline starting, and time distance between the voiceline ending, and the next queued voiceline starting, respectively) at the request of Trittyburd. To use, add a field in your announcer yamlfest front_padding = [time in seconds] and back_padding = [time in seconds]. Default is 0.2 for front_padding and 1.2 for back_padding. These fields are not necessary, and if not present, will default to the default

[3.0.0] - 2021-12-23 - Sosig Voiceline Support


  • Now supports replacement of Sosig Voicelines (Will update the wiki on details on how to later...)


  • Pretty sure there was a very minor bugfix or two in here

[2.0.1] - 2021-12-18


  • Fixed incorrect thunderstore packaging that would accidentally flatten included files, preventing display of icon and announcer snippets for default announcer and default bgm
  • Fixed bug that would make all BGM snippets play the first listed BGM when you specifically chose an announcer first then came back to the BGM screen (for the entire game- reloading the lobby and redoing would fix it)
  • Fixed accidentally applying the BGM volume to the announcer instead of the announcer volume

[2.0.0] - 2021-12-12 - Announcer Support


  • Added support for announcers to the TnH Menu


  • Fixed logging and cut down on excessive logging
  • A variety of misc. fixes

[1.5.4] - 2021-12-04


  • Now displays image of the song selected


  • Song snippets no longer play once TNH starts

[1.4.4] - 2021-10-31


  • Plays snippet of selected song (8s) of the high-combat audio when selecting a new song
  • Font size of selected song lowered to prevent text getting cut off
  • File size cut by two-thirds

[1.4.3] - 2021-10-09


  • Volume control and bank list scrolling now work again
  • Fixed third button on the list not working

[1.4.2] - 2021-10-08


  • Fixed Stratum bank files accidentally being loaded as a legacy bank
  • Prevented Stratum bank files loading if it is already in the bank list

[1.4.1] - 2021-10-08


  • Now supports stratum loading with tag tnhbankfile, plugin GUID is dll.potatoes.ptnhbgml


  • Updated to Sodalite v1.1
  • Changed panel texture

[1.4.0] - 2021-09-15


  • Panel revamped; now displays 8 songs at once
  • Panel removed from wrist menu
  • Panel now spawns by default in TnH lobby
  • Bank name now displays as BankName as opposed to MX_TAH_BankName.bank
  • Banks are now ordered alphabetically (except for default bank, which is always last)

[1.3.1] - 2021-09-12


  • Removed stratum as a dependency, as it's not being used yet.

[1.3.0] - 2021-09-10


  • Volume can now be changed in panel
  • Default TNH music can now be selected in the panel
  • PTNHBGML now remembers your last used bank, to prevent needing to change banks every launch

[1.2.0] - 2021-08-11


  • Added panel to wrist menu that allows you to change BGM in game (You cannot change BGMs mid TNH run)


  • Sodalite added as a dependency
  • Audio range has been moved from 0 - 1 to 0 - 4


  • Fixed error when no custom TNH BGM was loaded

[1.1.0] - 2021-08-11


  • Added config to audio allowing one to change volume magnitude from 0-1

[1.0.0] - 2021-08-10

Whoo! What a doozy for a name. For an easier name, you're welcome to use the official acronym, PTNHBGML. Much nicer.

Anyway, PTNHBGML is a simple mod; and it's in the name. It loads music. It replaces your old Take And Hold background music with much nicer (insert genre of music) that you enjoy.

NOTE: Because of limitations of the human ear, it can only load one BGM mod at once.

For Modders: Of course, you may wonder how to make your mod PTNHBGML compatible. First of all, actually make your music mod. You can follow Sora101TD's tutorial over here. Then, rename your .bank file to MX_TAH_[MyEpicMusicModNameHere].bank. Once you've done that, simply upload your fancy music mod as a regular Thunderstore mod. PTNHBGML should now pick it up!

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2023-9-28 4.0.0 928 Version 4.0.0 Install
2021-12-25 3.1.0 37194 Version 3.1.0 Install
2021-12-23 3.0.0 1652 Version 3.0.0 Install
2021-12-18 2.0.1 1616 Version 2.0.1 Install
2021-12-12 2.0.0 3306 Version 2.0.0 Install
2021-12-5 1.5.4 1669 Version 1.5.4 Install
2021-10-31 1.4.4 3121 Version 1.4.4 Install
2021-10-10 1.4.3 2189 Version 1.4.3 Install
2021-10-8 1.4.2 474 Version 1.4.2 Install
2021-10-8 1.4.1 157 Version 1.4.1 Install
2021-9-16 1.4.0 2013 Version 1.4.0 Install
2021-9-12 1.3.1 771 Version 1.3.1 Install
2021-9-10 1.3.0 637 Version 1.3.0 Install
2021-8-11 1.2.0 1797 Version 1.2.0 Install
2021-8-10 1.1.0 192 Version 1.1.0 Install
2021-8-10 1.0.0 740 Version 1.0.0 Install