-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Ambience Mini adds a custom music engine to Minecraft that allows you to play custom music based on the state of the player, world, game, etc. This is done by creating (or downloading a pre-made) music pack containing the music files to play and a configuration file that tells the mod how to select music.
In the sidebar to the right, you can see the two sections of this wiki: "setup" and "gameplay".
- The "setup" section explains how to install and configure the mod, both with pre-made music packs as well as how to make your own music pack. For ease of development, you can use the online music-config editor to create or modify your music pack configurations.
- The "gameplay" section explains the basic key-bindings introduced by the mod such as reloading the music player or printing debug information to the logs, as well as how to use the area configuration system for setting up named areas/regions which can be used for music selection.
The full capabilities of the mod are, of course, explained throughout the "setup" and "gameplay" sections, but here is a rough overview.
The latest version can detect/read:
- Certain open menus (main menu, joining, disconnected, credits, paused).
- Certain world information (difficulty, dimension id, biome ids and tags).
- The time of day (day, night, dusk, dawn).
- The weather (rain, snow, thunder).
- Certain player states (health, sleeping, fishing, underwater, mounts/vehicles, potion/(de-)buff effects, elytra, and more).
- Combat state (number of fought mobs, active bosses, and whether a warden is nearby).
- Villages and ranches by counting nearby entities.
- Whether the player is in a cave based on the surrounding blocks and lighting.
- Whether the player is in auto-generated structures such as villages and strongholds. (requires server support)
- All user-defined areas/regions the player is currently located within.
Cave detection: The cave detection algorithm uses the surrounding lighting and blocks to determine how likely it is that the player is in a cave or not.
Area system: Players can define named areas using a fully client-side-based system using key bindings and menus, even when the mod is not installed on the server. With server support, areas can be shared between players.
If you need help with the mod, have feature requests, or encounter any bugs, feel free to write a message on the Ambience Mini Discord server. Bugs/features can also be reported/requested on GitHub using the issues page.