WaterPlayer
Internet music player built into the client
Screenshots
About this Mod
WaterPlayer
🎶 Internet music player built into the client
What platforms are supported?
- YouTube
- SoundCloud
- Spotify
- Yandex Music
- Deezer
- Apple Music
- Flowery TTS
- Twitch streams
- Bandcamp
- Vimeo
- HTTP(s) links
- MP3
- FLAC
- MP3
- Matroska/WebM (AAC, Opus or Vorbis codecs)
- MP4/M4A (AAC codec)
- OGG streams (Opus, Vorbis and FLAC codecs)
- AAC streams
- Stream playlists (M3U and PLS)
Configuration
Go to the "TOP SECRET!" category, or ./config/WaterPlayer/config.json to specify tokens.
For all supported urls and queries see here
To get your Spotify clientId & clientSecret go here
*Countries code here
To get your Apple Music api token go here
To get your Yandex Music access token go here
Для игроков из РФ
WaterPlayer не будет стабильно работать с YouTube, прошу это учитывать и использовать аналоги, например: Локальные файлы или сервисы по типу Яндекс.Музыка и Bandcamp.
Если вам так нужен Ютуб, используйте разные штуки по типу GoodbyeDPI, прокси и VPN.
Working with playlists
To create/edit a playlist, you need to run the command /waterplayer playlist <name>
To load it into the queue, enter playlist:name in the track address
Screenshots
Overlay
Pause & Notice
Control & Queue
Live Track screen
Configuration
Available Versions
How to Install WaterPlayer on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.8).
Install Mod
Open the mod browser in the dashboard and search for "WaterPlayer". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.8, 1.21.7, 1.21.6 (+28 more)
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
WaterPlayer 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 (1.21.8). You can switch loaders with one click in the panel.
Is WaterPlayer compatible with fabric and quilt?
WaterPlayer officially supports fabric, quilt for Minecraft 1.21.8, 1.21.7, 1.21.6. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with WaterPlayer – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if WaterPlayer 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.
Similar Mods
![[ETF] Entity Texture Features](https://cdn.modrinth.com/data/BVzZfTc1/af683d206d50b05258d865b0d6e4aa2f2cee12f2_96.webp){kind=small}
![[EMF] Entity Model Features](https://cdn.modrinth.com/data/4I1XuqiY/6e5bbd0d06b1741bfdab6c0cfab6de8fdaf0064c_96.webp){kind=small}
Rent Modded Server
Install WaterPlayer with just one click on your server.