With repentogon all of this is obsolete, as it supports playing music jingles without stopping floor/room music, though it's still nice to have for people who aren't using repentogon.


It is now possible to have custom jingles in soundtracks that do not overwrite other music or jingles that are playing, this is available for the 4 treasure room jingles, the secret room discover jingle, the devil and angel room open jingles and the strange door jingle.

For this to work you need Repentance and the Repentance version of the music callback API mod.


Your soundtrack mod will need a folder in the resources folder called 'sfx', inside that sfx folder you need to make a folder with the same name as the folder in your music folder, the jingles will need to be in that folder and all be .wav files not .ogg.

You will also need a 'sounds.xml' file in the content folder that points to the wav files, similar to the music.xml file referencing the ogg files, the naming of the sound entries must follow the same rules as the music xml, with the soundtrack name and then the track type name.
e.g.
<sound name="Antibirth Secret Room Find (jingle)">
<sample weight="1" path="Secret room (no bass).wav" />
</sound>


It is possible for 1 sound xml entry to have multiple sound effects by using multiple files per sound effect ID, the game should pick one at random when the sound effect is triggered.
e.g.
<sound name="Antibirth Treasure Room Entry (jingle) 1">
<sample weight="1" path="Item Room 1.wav" />
<sample weight="1" path="Item Room 2.wav" />
<sample weight="1" path="Item Room 3.wav" />
</sound>


Keep in mind it is possible for the devil and angel room appear sounds to play at the same time (duality item) so if you don't want them overlapping just don't bother giving them sfx.


You can check the files of this mod for reference.