AudioPlayer
Modby henkelmax
Put your own audio files on music discs!
Type
Mod
CurseForge Downloads
512,385
CurseForge ID
549719
Modrinth Downloads
1,275,133
Modrinth ID
SRlzjEBS
Last Updated
Jul 27, 2026
Description
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](https://www.curseforge.com/minecraft/mc-mods/simple-voice-chat) on the client and server.
For additional features check out [Audioplayer Roleplay](https://modrinth.com/mod/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](https://github.com/espebra/filebin2/)
- 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 ` 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 ""`.
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 ` 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 ` to get all audio files that contain the search text.
---
[](https://youtu.be/j8GRcYnjUp8)
[](https://youtu.be/tixidvB4Zko)


## Credits
- [MP3SPI](https://github.com/umjammer/mp3spi)
- [Simple Voice Chat](https://github.com/henkelmax/simple-voice-chat)
- [Admiral](https://github.com/henkelmax/admiral)
*Note that the files you upload to Filebin are publicly available if the upload link is disclosed!*
Compatibility
Mod Loaders
Fabric
Quilt
Game Versions
1.19
1.19.1
1.19.2
1.19.3
1.19.4
1.20
1.20.1
1.20.2
1.20.3
1.20.4
+17 more
Similar Mods
Farseek
A Scala API for Minecraft mods.
Mod
17,863,520
Hyperbox
A forge mod that adds a box that's bigger on the inside than it is on the outside
Mod
17,825,840
Fence Overhaul
Diagonal Fences in Minecraft!
Mod
17,825,016
Time in a bottle standalone
Time in a bottle (Random things) - Standalone, ported to 1.16 - 1.19
Mod
17,821,024
Structure Pool API
📚 API to inject structures into structure pools.
Mod
17,820,017
Immersive Posts
Extendable treated-wood, aluminium, steel posts and more for ImmersiveEngineering.
Mod
17,814,010
Included in Modpacks
Landscapes Reimagined Genesis
nClient
Core Optimized
EdonMe Survival
Yet Another Vanilla But Better (YAVBB)
All Simple Voice Chat Connections!
Destiny's Kitchen Sink
Train Yard
CARCHcraft
Hermitcraft Server Pack
Vanilla Plus - Slime Edition
Aetheris QoL
Cobble Lemon
Steve Fans
WhitelistSMP
VIRISMP
Drasil: Adventure Awaits
Serenor
Dutch Pet Shelter
Goonables
STEAMPUNK MC
Lukas-vanilla-pack
KindredCraft
MC++
The Better Pokeblocks Modpack
XG's OptiQoL
BeaconCraft