Ambient Music Player + Music Controller

Important note on version 1.3.0 this verions includes a new feature, of making playlists like a music app, but since it uses the Ambient Player system, to play your musics, you need to know how to use it, so for that I updated the Tutorial screen for the mod and also added a new section to it Playlists read it it will tell you how it works.

and also since it uses the same system I just made the config screen for the ambient manager to allow you to have two versions of its configurations, because its same config type I couldnt set default values for the playlist mode version, this means you have to config it yourself, for example disabling the noise check or shuffle mode.

Version:1.2.0 Date: 4/23/2026

for any bug you incounter please put it in the comments I will try to help

I fixed a lot of bugs didn't add new features, but fixed some features that wasn't working here are some of the things I did:

1. fixed the screen crash when no ambient musics added to the config folder.

2. made the mixins better and more compatible and less greedy.

3. fixed events delay issues, now you can set min and max of any event and it will work, although you may have to open a world first.

4. the ambiant player will no longer interfere in the main menu, when its enabled

5. added a new depencency to the mod.

6. fixed the issue when modded biomes didn't use the custom min and max delay.

---

this is a music controller aimed to make the entire game musics customizable, using custom config menus and screens to control the musics and sound events, there other mods doing the same thing but none of them provide a straight easy to change pass to config a music without dealing with their SoundEvents, while this mod is full controll of the games music system.

it also comes with an Ambient Music Player which adds another music system into the game dynamically without breaking minecraft's music manager, while both can work at the same time without interfering each other, with many option to decide which will take more time than the other.

the player has so many settings, it's almost a full ambient player system, which listens for silence and in game actions related to sounds to play an ambeint.

check image section for the screens.

some information about the WolrdEvents:

• Exploring: activates when holding a full mapped paper.
• Undergound: is below y -10.
• Deep Darkness: is basically checking for screen brightness so it activates when in a cave or a dark area, night, warden, and so on.

they also have priority dimention comes first then player state which is very restrict they never become true unless you are doing them, then ocean then underground, after that is weather rain and thunder, then for the biome and world states, then day time which uses minecraft default timings.

Compatibilty

I have added three mixins two of them can be disabled without breaking the mod.

to disable these mixins to remove conflicts, first open the mod's jar file using a zip opener then, inside open musicontroller_k.mixins.json inside you have:

"client": [
"MusicManagerMixin",
"SoundEngineAccessorMixin",
"SoundManagerAccessorMixin",
"SubtitleOverlayMixin",
"ToastInstanceMixin"
]

• "SubtitleOverlayMixin" can be removed: the feature for disabling sound subtitles will be disabled, yes I know there is an option for this in the game already but for me it never worked.
• "ToastInstanceMixin" you can remove this as well, when minecraft shows a toast it makes a sound I used this mixin to disable this sound for my MusicToast instance, so if you remove it, it only re-add the sound, and that's it.

Accessor never cause any troubles, for the MusicManagerMixin this is important it cant be removed and it will cause crash.

---

The reason I made this mod is because I needed it and I couldn't really find one to let me do what I can do now with this mod.

I also make other mods for personal uses but they are always fully configurable so anyone can use them for their personal use as well, and I mainly work and play on 1.20.1, minecraft is really hard to work with, because of all the versions and platforms, but in any case anyone needed this mod for another version, I can only do it for money or if it get support here, because here by uploading a mod you never make anything out of it, while they take months to create which is not fun.