mxTune Mod Wiki

mxTune is a specialized music utility mod designed for Minecraft versions 1.12.2 and 1.16.5. It enables players to play complex musical compositions using MML (Music Macro Language), a text-based music notation format popular in games like Mabinogi and ArcheAge. The mod supports a wide array of instruments, from classical pianos to modern electric guitars, and features a robust 'JAM' system for synchronized group performances.

In version 1.16.5, the mod introduced 'Music Venues,' which allow players to define specific areas in the world where music is contained, preventing sound bleed and creating dedicated performance spaces. Whether you are a solo bard or looking to start a full 16-piece orchestra with friends, mxTune provides the tools necessary for high-quality in-game musical expression.

mxTune adds a vast collection of musical instruments. Each instrument has a unique sound profile and can be used to play specific parts of an MML song. In 1.12.2, some instruments like the Piano could be placed as blocks, while in 1.16.5, all instruments are handheld items.

Instrument List

The mod includes several utility items and blocks to facilitate music creation and performance.

Key Items

• Music Paper: The base item used to write music. Right-clicking with this item opens the MML Editor.
• Sheet Music: Created from Music Paper. It stores the MML code and can be inserted into instruments. In 1.16.5, Sheet Music can store up to 16 parts for a single song.
• Instrument Case: A storage item specifically designed to hold multiple musical instruments.
• Music Venue Tool: Used to define the cuboid boundaries of a Music Venue.
• Conductor's Baton: Used to manage JAM sessions and synchronize players.

Key Blocks

• Band Amp: A block that allows for automated multi-instrument play. It features 12 slots for instruments and is compatible with redstone and hoppers.
• Spinet Piano: A placeable version of the piano that players can sit at to perform.
• Music Venue: Not a physical block, but a defined volume in the world that acts as a sound enclosure. Players inside cannot hear mxTune music from outside, and vice versa.

MML (Music Macro Language)

mxTune uses the MML format for all music. A valid MML string must start with MML@ and end with a semicolon ;. The mod includes a real-time MML parser that highlights syntax errors in red, preventing players from saving broken sheet music.

Solo Performance

1. Prepare Music: Right-click Music Paper to open the editor, paste your MML code, and click 'Done' to create Sheet Music.
2. Load Instrument: Hold an instrument, then Sneak + Right Click to open its internal inventory. Place the Sheet Music into the slot.
3. Play: Hold the loaded instrument in your main hand and Right Click to start playing. Your character will be locked in place during the performance. Press ESC to stop.

JAM Sessions (Group Play)

JAM sessions allow multiple players to play different parts of the same song in perfect synchronization.

• Joining a JAM: In 1.16.5, a player joins a JAM by holding an instrument and Right-Clicking the group leader.
• PIN Protection: Leaders can set a 4-digit PIN to restrict who can join their session.
• Capacity: 1.12.2 supports up to 8 players, while 1.16.5 supports up to 16 players/parts.

Music Venues

Using the Music Venue Tool, players can define 'Audio Islands.' These are cuboid regions that isolate mxTune audio. This is particularly useful for servers where multiple bands might be playing in close proximity, as it prevents the music from overlapping and causing noise pollution.

Crafting recipes for mxTune are designed to be accessible but thematic, often requiring precious metals for brass instruments or strings for guitars.

Note: Recipes may vary slightly between 1.12.2 and 1.16.5. It is recommended to use JEI (Just Enough Items) to view exact patterns in-game.

The mod provides several administrative and utility commands:

• /mxtune stop: Immediately stops all mxTune music currently playing for the player.
• /mxtune reload: Reloads the mod's configuration and soundfont data.
• /mxtune help: Displays a list of available sub-commands and their usage.
• /mxtune venue remove [ID]: (Admin only) Removes a specific music venue by its ID.

mxTune features extensive configuration options found in the mxtune-client.toml and mxtune-server.toml files.

Client Settings

• HUD Position: Adjust the X and Y coordinates of the music status display.

• Volume: Independent volume slider for mxTune audio (linked to the vanilla 'Music' or 'Records' category depending on version).

• Mute Options:

  • Mute Others: Hear only your own music.
  • Blacklist/Whitelist: Filter music from specific players.
  • Mute All: Disables all mxTune audio.

• Max JAM Size: Limits the number of players that can join a single group (default 8 or 16).

• Sound Distance: Configures how far away other players can hear an instrument being played.

• Venue Limits: Sets the maximum number of venues a single player can create.

mxTune utilizes a custom MIDI-based sound engine that operates alongside the standard Minecraft sound system. It uses high-quality soundfonts to ensure that instruments sound realistic.

• Mobs: This mod does not add any new mobs or creatures to the game.
• Biomes/Dimensions: This mod does not add new biomes, dimensions, or world structures.
• Compatibility: Works with most major mods; however, performance may be impacted if many players are playing high-part-count MML files simultaneously in the same chunk.