SoundPixel-Mod

SoundPixel-Mod is a Fabric client mod that receives and plays custom audio streamed by SoundPixel-Plugin.
It works only on the client side and allows players to hear server-sent custom sounds without a resource pack.

Compatible with:

• Fabric 1.20.4
• Fabric API
• Java 17+

What it does

• Sends a compatibility handshake when joining:
• HELLO {version}
• Listens on:
• soundpixel:main
• Receives packets:
• START
• CHUNK
• STOP
• ACK optional flow supported
• Plays streamed PCM audio using Minecraft's sound engine / OpenAL
• Supports multiple simultaneous playback sessions

Main features

• Client-only
• No Fabric server required
• Streaming playback
• Per-session volume
• Stop by session, sound, or all
• Debug overlay toggle
• Automatic cleanup on disconnect

Highlights

• Works with audio streamed from the server
• No resource pack download needed
• Handles buffered PCM chunks safely
• Includes a local playback session limit to avoid client saturation
• Debug overlay can be toggled with F8

Important limits

• Does not work without SoundPixel-Plugin on the server.
• Does not add support for vanilla clients.
• Requires both Fabric Loader and Fabric API.

Requirements

• Minecraft client 1.20.4
• Fabric Loader
• Fabric API
• Java 17+

---

SoundPixel-Mod

SoundPixel-Mod es un mod cliente para Fabric que recibe y reproduce audio custom transmitido por SoundPixel-Plugin.
Funciona solo del lado del cliente y permite que los jugadores escuchen sonidos enviados por el servidor sin resource pack.

Compatible con:

• Fabric 1.20.4
• Fabric API
• Java 17+

¿Qué hace?

• Envía un handshake de compatibilidad al entrar:
• HELLO {version}
• Escucha en:
• soundpixel:main
• Recibe paquetes:
• START
• CHUNK
• STOP
• Soporte para flujo opcional ACK
• Reproduce audio PCM en streaming usando el motor de sonido / OpenAL de Minecraft
• Soporta múltiples sesiones simultáneas de reproducción

Funciones principales

• Solo cliente
• No requiere servidor Fabric
• Reproducción por streaming
• Volumen por sesión
• Detención por sesión, por sonido o global
• Overlay debug con toggle
• Limpieza automática al desconectarse

Puntos destacados

• Funciona con audio transmitido desde el servidor
• No necesita descargar resource pack
• Maneja chunks PCM bufferizados de forma segura
• Incluye un límite local de sesiones para evitar saturar el cliente
• El overlay debug puede activarse con F8

Límites importantes

• No funciona sin SoundPixel-Plugin en el servidor.
• No agrega soporte para clientes vanilla.
• Requiere Fabric Loader y Fabric API.

Requisitos

• Cliente Minecraft 1.20.4
• Fabric Loader
• Fabric API
• Java 17+