AudioPlayer

AudioPlayer

Put your own audio files on music discs!

by
1.3M Downloads
fabricquiltadventureutility
Rent Server with this Mod

About this Mod

This server side Fabric mod enables uploading custom audio for music discs, goat horns and note blocks with heads.

This mod requires Simple Voice Chat on the client and server.

For additional features check out Audioplayer Roleplay.

IMPORTANT
This documentation is for version 2.x.x of the mod only!

Features

  • On the fly audio uploading without needing to restart the server
  • Support for mp3 and wav
  • Upload audio via a URL
  • Upload audio directly to your server
  • Upload audio via Filebin
  • Upload using a website
  • Server side only
  • No server restart needed
  • No resource pack needed
  • No changes needed on the client
  • Configurable upload limit
  • Configurable command permissions
  • Configurable audio range
  • Per-item custom audio range
  • Bulk applying audio to all items in shulker boxes, bundles and other container items
  • Configurable goat horn cooldown

Commands

Run /audioplayer to get general information on how to upload files.

Uploading audio files via URL

Run /audioplayer url "https://example.com/myaudio.mp3" where https://example.com/myaudio.mp3 is the link to your .mp3 or .wav file.

Uploading audio files directly to the server

Copy your .mp3 or .wav file to the audioplayer_uploads folder in your server.
Run /audioplayer serverfile "yourfile.mp3" where yourfile.mp3 is the name of the file you put on the server.

Uploading audio files via Filebin

Run /audioplayer filebin and follow the instructions.

Putting custom audio on an item

Run /audioplayer apply <ID> and hold a music disc, goat horn or head in your main hand.

It's also possible to bulk apply audio to more than one item at a time by holding a shulker box, bundle or other container item in your hand.

You can also apply custom audio by its original file name:
/audioplayer apply "<FILE_NAME>".
This command works with and without the file extension (like .mp3 or .wav).
Note that the file name must be unique for this to work.

Adjusting the range of an item

Run /audioplayer range <RANGE> while holding an item or container with items that have custom audio in your main hand.

Getting the audio info of an existing item

Run /audioplayer info while holding a music disc, goat horn or head with custom audio in your main hand.

Searching audio files by name

Run /audioplayer search <SEARCH_TEXT> to get all audio files that contain the search text.


Credits

Note that the files you upload to Filebin are publicly available if the upload link is disclosed!

Available Versions

[FABRIC][26.2] AudioPlayer 2.3.0+26.2release
MC 26.2fabric, quilt
June 21, 2026
[FABRIC][26.1.2] AudioPlayer 2.3.0+26.1.2release
MC 26.1, 26.1.1, 26.1.2fabric, quilt
June 21, 2026
[FABRIC][1.21.11] AudioPlayer 2.3.0+1.21.11release
MC 1.21.11fabric, quilt
June 21, 2026
[FABRIC][1.21.10] AudioPlayer 2.3.0+1.21.10release
MC 1.21.10fabric, quilt
June 21, 2026
[FABRIC][1.20.4] AudioPlayer 1.20.4-1.8.9release
MC 1.20.4fabric, quilt
March 2, 2024

How to Install AudioPlayer on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (26.2).

3

Install Mod

Open the mod browser in the dashboard and search for "AudioPlayer". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabricquilt

Minecraft Versions

26.2, 26.1.2, 26.1.1 (+25 more)

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

AudioPlayer server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.2). You can switch loaders with one click in the panel.

Is AudioPlayer compatible with fabric and quilt?

AudioPlayer officially supports fabric, quilt for Minecraft 26.2, 26.1.2, 26.1.1. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with AudioPlayer – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if AudioPlayer consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install AudioPlayer with just one click on your server.

Recommended RAM
4 GBfrom €5.2/mo
Minimum 3 GB | per 8 players
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
LicenseRef-All-Rights-Reserved
Server-side
Required

Supported Versions

26.226.1.226.1.126.11.21.111.21.101.21.91.21.81.21.71.21.6+18 more