Skip to content

Advanced Features

Yevhen Harasymchuk edited this page Aug 4, 2026 · 4 revisions

Advanced Features

Portable Speaker

  1. Run /mixer speaker with mixer.command.speaker.
  2. Right-click the generated speaker item to open its control GUI.
  3. Insert a custom disc and use the green control to start playback.
  4. Open the DSP controls with the amethyst-shard button.

The material and listening range are configured under portableSpeakers. Playback stops if the active speaker is dropped, moved into an unsupported inventory, placed in an item frame or armor stand, or otherwise leaves the owning player's control.

Audio Effects (DSP)

Mixer supports these effects for jukebox and portable playback:

  • Gain: changes the overall amplitude.
  • High-pass filter: removes frequencies below the cutoff.
  • Low-pass filter: removes frequencies above the cutoff.
  • Flanger: applies a modulated short delay.

Sneak and right-click a jukebox with an empty main hand to open the visual DSP manager. The same effects can be configured with /mixer dsp or through the Addon API.

Linked speaker locations

/mixer link <jukebox> adds the player's current position as a remote output for that jukebox. Once a jukebox has linked locations, new playback sessions use those locations as their audio sources. Run the command again from another position to add another output.

PlaceholderAPI

PlaceholderAPI is optional. Mixer resolves the track relevant to each player in this order: the player's portable speaker, the jukebox they are looking at within six blocks, then the nearest active jukebox within 32 blocks.

Placeholder Result
%mixer_status% playing or stopped
%mixer_current_song% Current track title
%mixer_current_artist% Current track author or artist
%mixer_current_url% URI reported by the loaded track
%mixer_source_type% portable, target_block, nearby, or none

Track-specific placeholders return an empty string when no relevant track is playing. Unknown placeholder parameters return no value.

Addons

Separate Paper plugins can register custom source protocols, manage addon lifecycle, control jukebox or portable players, inspect current tracks, and change DSP settings. See the Addon API guide.

Clone this wiki locally