Описание
# SoundPixel-Mod
SoundPixel-Mod is a **Fabric client mod** that receives and plays custom audio streamed by [SoundPixel-Plugin](https://modrinth.com/plugin/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+**