Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/henkelmax/audio-player
Put your own audio files on music discs!
https://github.com/henkelmax/audio-player
fabric fabric-mod minecraft mod simple-voice-chat
Last synced: 1 day ago
JSON representation
Put your own audio files on music discs!
- Host: GitHub
- URL: https://github.com/henkelmax/audio-player
- Owner: henkelmax
- Created: 2021-11-22T15:52:25.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-12-03T16:38:42.000Z (22 days ago)
- Last Synced: 2024-12-17T13:05:59.842Z (9 days ago)
- Topics: fabric, fabric-mod, minecraft, mod, simple-voice-chat
- Language: Java
- Homepage:
- Size: 689 KB
- Stars: 59
- Watchers: 2
- Forks: 21
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- Changelog: changelog.md
Awesome Lists containing this project
README
# AudioPlayer
## Links
- [CurseForge](https://www.curseforge.com/minecraft/mc-mods/audioplayer)
- [Modrinth](https://modrinth.com/mod/audioplayer)
- [Simple Voice Chat Discord](https://discord.gg/4dH2zwTmyX)
---
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.
## 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/)
- 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 a shulker box
- 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 a music disc or goat horn**
Run `/audioplayer apply ` and hold a **music disc**, **goat horn** or **head** in your main hand.
Additionally, you can add a custom name and range to the item `/audioplayer apply ""`.
It's also possible to bulk apply audio to more than one item at a time by holding a shulker box in your hand.
Starting with version `1.9.1`, 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.
**Getting the audio from an existing item**
Run `/audioplayer id` while holding a music disc, goat horn or head with custom audio in your main hand.
**Getting the audio file name from an existing item**
Run `/audioplayer name` while holding a music disc, goat horn or head with custom audio in your main hand.
---
[](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!*