# Music<\/p>\n
Music is a server-side Fabric mod that streams URL music through Simple Voice Chat. It is built for shared server music with queues, saved playlists, YouTube playlist import, player targeting, personal opt-out, and YouTube OAuth support through Lavaplayer\/youtube-source.<\/p>\n
## Features<\/p>\n
– Streams music through Simple Voice Chat static audio channels.
\n– Supports YouTube, YouTube Music, YouTube playlist links, and other Lavaplayer-supported remote sources.
\n– Expands pasted YouTube playlist links into individual songs.
\n– Shows title, creator, requester, duration, queue position, and playback diagnostics.
\n– Cleans YouTube topic-channel creator names, so `Artist – Topic` displays as `Artist`.
\n– One shared server-wide music stream.
\n– Global queue with skip, repeat, and shuffle.
\n– Persistent saved playlists.
\n– Forward\/backward seeking by seconds.
\n– Player targeting and exclusion controls.
\n– Player self-service `\/music leave` and `\/music join`.
\n– Simple Voice Chat “Music” volume category for personal client volume.
\n– Global server volume control.<\/p>\n
## Requirements<\/p>\n
– Fabric Loader.
\n– Simple Voice Chat installed on the server.
\n– Simple Voice Chat installed on clients that want to hear the stream.
\n– A Minecraft version supported by the mod file you install.<\/p>\n
This mod controls music on the server, but players only hear it through their Simple Voice Chat connection.<\/p>\n
## Installation<\/p>\n
1. Install Fabric Loader on the server.
\n2. Install Simple Voice Chat on the server.
\n3. Install this mod in the server `mods` folder.
\n4. Players who want to hear the stream must install Simple Voice Chat on their clients.
\n5. Start the server and run `\/music help`.<\/p>\n
## Quick Start<\/p>\n
“`text
\n\/music now
\n\/music play https:\/\/www.youtube.com\/watch?v=VIDEO_ID 10
\n\/music queue add https:\/\/music.youtube.com\/watch?v=NEXT_VIDEO_ID
\n\/music queue add https:\/\/www.youtube.com\/playlist?list=PLAYLIST_ID
\n\/music queue list
\n“`<\/p>\n
If YouTube asks for login or blocks playback, complete the OAuth device login shown in the server log.<\/p>\n
## How It Works<\/p>\n
1. A player runs `\/music play`, queues a URL, or starts a saved playlist.
\n2. Lavaplayer loads the URL.
\n3. YouTube links are handled by `youtube-source`.
\n4. The mod sends encoded audio frames into a Simple Voice Chat static audio channel.
\n5. Selected listeners hear the same stream.<\/p>\n
There is one active global stream per server. Starting a new track with `\/music play` replaces current playback and clears the runtime queue.<\/p>\n
## YouTube OAuth<\/p>\n
YouTube may block automated playback clients. This mod supports YouTube OAuth through `youtube-source`.<\/p>\n
Config file:<\/p>\n
“`text
\nconfig\/music.json
\n“`<\/p>\n
Important fields:<\/p>\n
“`json
\n{
\n “youtubeOAuthEnabled”: true,
\n “youtubeOAuthRefreshToken”: “”,
\n “youtubeOAuthSkipInitialization”: false
\n}
\n“`<\/p>\n
First login flow:<\/p>\n
1. Start the server. The YouTube login is global for the server, not per player. Keep `music.json` private because it can contain an OAuth refresh token. Using a secondary YouTube account is recommended.<\/p>\n ## Commands<\/p>\n Run:<\/p>\n “`text ### Everyone<\/p>\n “`text – `\/music leave` opts the player out of the music stream. ### Playback<\/p>\n All players:<\/p>\n “`text Behavior:<\/p>\n – `\/music play ### Queue<\/p>\n All players:<\/p>\n “`text Everyone can view:<\/p>\n “`text Queue behavior:<\/p>\n – The runtime queue is not saved after server restart. Example output:<\/p>\n “`text ### Saved Playlists<\/p>\n All players:<\/p>\n “`text Playlist behavior:<\/p>\n – Playlists are saved in `config\/music-playlists.json`. Example:<\/p>\n “`text ### Targeting<\/p>\n All players:<\/p>\n “`text Targeting order:<\/p>\n 1. Connected Simple Voice Chat clients. Personal opt-out always wins. `\/music target all` does not force opted-out players to listen.<\/p>\n Examples:<\/p>\n “`text ## Config Files<\/p>\n Main config:<\/p>\n “`text Stores YouTube OAuth settings, repeat\/shuffle settings, target filters, exclusions, and player opt-outs.<\/p>\n Playlist config:<\/p>\n “`text Stores saved playlist names and track entries.<\/p>\n Example playlist shape:<\/p>\n “`json Use commands instead of editing playlist files while the server is running.<\/p>\n ## URL Support<\/p>\n Good candidates:<\/p>\n – Normal YouTube watch links. Less reliable:<\/p>\n – Spotify page links. Unsupported URLs should fail with a chat error instead of crashing the server.<\/p>\n ## Command Access<\/p>\n All players can use every `\/music` command, including commands that change server playback state:<\/p>\n – Play, stop, pause, resume, skip, forward, backward. Self-service and view commands:<\/p>\n – `\/music help` ## Troubleshooting<\/p>\n ### Music Says Playing, But Nobody Hears It<\/p>\n Run:<\/p>\n “`text Check:<\/p>\n – Simple Voice Chat is connected. ### YouTube Says Sign In Or Bot Check<\/p>\n Enable OAuth in `config\/music.json`, restart, then run:<\/p>\n “`text Complete the device login shown in the server log. After that, `youtubeOAuthRefreshToken` should be saved.<\/p>\n ### Queue Names Show As Loading Or Unknown<\/p>\n Metadata is loaded asynchronously. Wait a few seconds and run:<\/p>\n “`text If metadata still shows unknown, Lavaplayer could not resolve metadata for that URL. The mod will still try to play the URL when its turn starts.<\/p>\n ### A Player Does Not Hear Music After Target All<\/p>\n Check if the player opted out:<\/p>\n “`text The player can rejoin with:<\/p>\n “`text Personal opt-out has priority over target filters.<\/p>\n ## Notes<\/p>\n – This mod does not download songs to disk. Add music function for Simple Voice Chat mod<\/p>\n","protected":false},"featured_media":140748,"template":"","meta":{"_minecraft_slug":"simple-voice-chat-music-addon","_minecraft_project_id":"80mTZkWg","_minecraft_author":"rjiangame","_minecraft_license":"MIT","_minecraft_downloads":473,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simple-voice-chat-music-addon.zip","_minecraft_size_bytes":1014483070,"_minecraft_version_count":30,"_minecraft_updated_at":"2026-05-16T13:17:17.490301Z","_minecraft_date_created":"2026-05-05T19:38:40.783888Z","_minecraft_date_modified":"2026-05-06T09:18:27.212405Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simple-voice-chat-music-addon","_minecraft_icon_attachment_id":140748,"_minecraft_imported_at":"2026-06-08T08:33:57+00:00","_minecraft_import_hash":"a278292148e89e1f87e21ac595cb3498","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,97,867,92],"mod_loader":[99],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-140747","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-fabric","mod_category-social","mod_category-utility","mod_loader-fabric","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n2. Run `\/music play
\n3. Check the server log for the Google device login code.
\n4. Complete the login in a browser.
\n5. The refresh token is saved to `config\/music.json`.<\/p>\n
\n\/music help
\n\/music help queue
\n\/music help playlist
\n\/music help target
\n\/music help volume
\n“`<\/p>\n
\n\/music help
\n\/music now
\n\/music queue list
\n\/music leave
\n\/music join
\n“`<\/p>\n
\n– `\/music join` removes the personal opt-out.
\n– Personal volume is controlled with the Simple Voice Chat client “Music” slider.<\/p>\n
\n\/music play
\n\/music play
\n\/music stop
\n\/music pause
\n\/music resume
\n\/music skip
\n\/music forward
\n\/music backward
\n\/music volume <1-100>
\n\/music repeat off
\n\/music repeat one
\n\/music repeat queue
\n\/music shuffle on
\n\/music shuffle off
\n“`<\/p>\n
\n– `\/music play
\n– `\/music play
\n– `\/music forward
\n– `\/music backward
\n– `\/music repeat one` repeats the current track.
\n– `\/music repeat queue` loops through the queue.
\n– `\/music shuffle on` chooses queued tracks randomly.<\/p>\n
\n\/music queue add
\n\/music queue remove
\n\/music queue clear
\n\/music skip
\n“`<\/p>\n
\n\/music queue list
\n“`<\/p>\n
\n– `\/music queue add
\n– `\/music queue add
\n– Queue metadata loads in the background, so a new item can briefly show as `title loading`.
\n– YouTube creator names ending in ` – Topic` are displayed without that suffix.
\n– If metadata fails, the URL remains queued and playback can still try it.<\/p>\n
\n[Music] Queue:
\n1. Song Title – Creator Name | 3:22 | requested by PlayerName | added 16:21:05
\n2. title loading: https:\/\/www.youtube.com\/watch?v=… | requested by PlayerName
\n“`<\/p>\n
\n\/music playlist list
\n\/music playlist create
\n\/music playlist delete
\n\/music playlist show
\n\/music playlist add
\n\/music playlist remove
\n\/music playlist play
\n\/music playlist queue
\n“`<\/p>\n
\n– Playlist names are single words.
\n– `\/music playlist add
\n– `\/music playlist add
\n– `\/music playlist play
\n– `\/music playlist queue
\n\/music playlist create lobby
\n\/music playlist add lobby https:\/\/www.youtube.com\/watch?v=SONG_1
\n\/music playlist add lobby https:\/\/www.youtube.com\/playlist?list=PLAYLIST_ID
\n\/music playlist play lobby
\n“`<\/p>\n
\n\/music target all
\n\/music target only
\n\/music exclude add
\n“`<\/p>\n
\n2. Include filter if set.
\n3. Exclude filter.
\n4. Player personal opt-out from `\/music leave`.<\/p>\n
\n\/music target all
\n\/music target only Steve
\n\/music target add Alex
\n\/music exclude add Steve
\n\/music exclude clear
\n“`<\/p>\n
\nconfig\/music.json
\n“`<\/p>\n
\nconfig\/music-playlists.json
\n“`<\/p>\n
\n{
\n “playlists”: {
\n “lobby”: [
\n {
\n “url”: “https:\/\/www.youtube.com\/watch?v=SONG_1”,
\n “title”: “Song Title”,
\n “creator”: “Creator Name”,
\n “requestedByName”: “server”,
\n “durationMillis”: 202000
\n }
\n ]
\n }
\n}
\n“`<\/p>\n
\n– YouTube Music watch links.
\n– YouTube and YouTube Music playlist links.
\n– Direct audio file URLs supported by Lavaplayer.
\n– Some direct video URLs with extractable audio.<\/p>\n
\n– Private or age-restricted videos.
\n– Region-blocked videos.
\n– YouTube links blocked by bot detection.<\/p>\n
\n– Queue add\/remove\/clear.
\n– Playlist create\/delete\/add\/remove\/play\/queue.
\n– Target and exclude filters.
\n– Repeat, shuffle, global volume.<\/p>\n
\n– `\/music now`
\n– `\/music queue list`
\n– `\/music leave`
\n– `\/music join`<\/p>\n
\n\/music now
\n\/music target show
\n“`<\/p>\n
\n– The voice target\/listener count is not `0`.
\n– The player did not run `\/music leave`.
\n– The player is not excluded by `\/music exclude`.
\n– The client Simple Voice Chat “Music” slider is not at `0%`.
\n– The global volume is not too low.<\/p>\n
\n\/music play
\n“`<\/p>\n
\n\/music queue list
\n“`<\/p>\n
\n\/music target show
\n“`<\/p>\n
\n\/music join
\n“`<\/p>\n
\n– YouTube playback can still fail if YouTube blocks a client or changes player behavior.
\n– YouTube topic-channel authors are cleaned for display; for example, `Artist – Topic` becomes `Artist`.
\n– OAuth improves YouTube reliability but should use a secondary YouTube account.
\n– Server-side per-player volume is not implemented; use the Simple Voice Chat client “Music” slider for personal volume.<\/p>\n","protected":false},"excerpt":{"rendered":"