menu_bookDocumentation

MusicPlayer: Streaming Audio with Visualization and World-Space Positioning

calendar_today May 20, 2026 schedule ~1 min read person PatrickJr verified 50

MusicPlayer in s&box handles music tracks and streaming audio with programmatic control over playback, positioning, and visualization. For sound effects, use the Sound system instead.

Basic Playback

CSHARP

var music = MusicPlayer.Play( FileSystem.Mounted, "music/theme.ogg" );
music.Volume = 0.8f;
music.Repeat = true;

URL Streaming

CSHARP

var music = MusicPlayer.PlayUrl( "https://example.com/stream.ogg" );

World-Space Audio

By default MusicPlayer plays globally. To position it in 3D space:

CSHARP

music.ListenLocal = false;
music.Position = WorldPosition;

Audio Visualization

CSHARP

ReadOnlySpan<float> spectrum = music.Spectrum;   // 512-element FFT magnitudes
float amplitude = music.Amplitude;               // approximate loudness

Supported Formats

Opus (.ogg, .opus, .webm) — recommended
Vorbis (.ogg, .webm)
FLAC (.flac)
MP3 (.mp3)
WAV/PCM (.wav)
AAC (.mp4) — Windows only, not recommended

Use Opus for best cross-platform compatibility and quality.

link

Source

https://sbox.game/dev/doc/media/audio open_in_new

MusicPlayer: Streaming Audio with Visualization and World-Space Positioning

Basic Playback

URL Streaming

World-Space Audio

Audio Visualization

Supported Formats

auto_awesome More in Documentation

Building a Networked Radio System with 3D Audio and Sync

Input System Overview: Button Queries, Analog Input, and Escape Override

Component Interfaces: ExecuteInEditor, ICollisionListener, IDamageable in s&box