wtf is adaptive-music-godot?

This project is an addon for the Godot 4 game engine that adds adaptive music, meaning background music that changes smoothly to match what is happening in a game instead of just looping the same track. It works using two mechanisms that are both kept locked to the same beat and tempo. The first is layering: several audio stems from one piece of music, like a calm ambient bed, bass, drums, and a lead melody, all play together at once, and you blend how loud each layer is using a single intensity value from zero to one, so the music can morph smoothly from calm to intense with no jarring cut. The second is sections: separate groups of layers, like a normal gameplay theme and a boss fight theme, that you can switch between, and the switch always happens on the next musical bar line so the two pieces of music never clash rhythmically even though they may sound very different. To use it, you either copy the addon's files into your Godot project's addons folder or add the repository as a git submodule, then enable it from the project's plugin settings. After that, a class called AdaptiveMusicPlayer becomes available that you add to your game as a node. You set a tempo, define one or more named sections, add audio layers to each section with the intensity range where they fade in and out, then call functions during gameplay to start a section, change the intensity, or transition to a different section. The README explains that for this to sound right, all the layers within one section need to be the same tempo, length, and starting position, since they are meant to be one recording split into separate audio files, and it gives a specific technique for looping those layers without an audible seam. Different sections can be entirely different pieces of music as long as they share a tempo, so the bar based transitions stay musical. The project is released under the MIT license and was built for and used in a real game called PULSE//ZERO by the same studio.