Technik

DJ-Pult mit Voice Chat

Kennzeichnung wie in CLAUDE.md: [A] Anforderung, [V] Vorschlag, [T] technische Annahme, [F] offene Frage.

[A] E50: Eigene Tracks am DJ-Pult über Simple Voice Chat sind optional erwünscht; außerhalb des Zeltes soll die Musik leiser sein.

Was die Mod macht

Ist Simple Voice Chat (SVC) auf Server und Clients installiert, gilt am DJ-Pult:

Wer an einem eingeschalteten DJ-Pult steht (bis 2,5 Blöcke vom Pult) und den Livestream-Modus eingeschaltet hat, ist DJ. Beim Herantreten ohne Livestream-Modus erscheint ein Hinweis mit dem Knopf [Livestream einschalten]; ein- und ausschalten geht auch mit /schuetzenfest livestream. Ohne Livestream-Modus bleibt der Voice-Chat am Pult normal und die Musik läuft weiter (vorher hielt schon ein Geräusch im Mikrofon in Pultnähe die Musik an).
Im Zelt (unter Zeltplane oder Zeltdach, bis 36 Blöcke vom Pult) hört jeder den DJ überall gleich laut, auch ganz hinten im großen Festzelt (E94).
Draußen kommt der DJ vom Pult und von bis zu vier Lautsprechern im Zelt und wird mit dem Abstand leiser, bis 48 Blöcke weit. Direkt vor dem Zelt ist es also etwas leiser als drinnen (E50, E94).
Sobald wirklich Ton ankommt, sieht der DJ „Du bist live“. Kommt die Meldung nicht, siehe Fehlersuche unten.
Solange der DJ ins Mikrofon spielt, macht die eingebaute Partymusik Pause (E84). Etwa zwei Sekunden nach dem letzten Ton läuft der Pult-Titel wieder an. Der Ehrentanz wird nicht unterbrochen.
Live-Musik zählt fürs Zeltbarometer wie die eingebaute Musik.
Im SVC-Menü gibt es die eigene Lautstärke-Kategorie DJ-Pult. Wem es zu laut ist, der dreht nur das Pult leiser.
Der DJ hört sich selbst nicht verzögert aus den Lautsprechern.
Flüstern bleibt privat und geht nicht über die Lautsprecher. Wer in einer SVC-Gruppe ist, spricht weiter nur mit der Gruppe; zum Auflegen die Gruppe verlassen.
Während Großem Zapfenstreich und letztem Lied ist das Pult gesperrt, das gilt auch fürs Mikrofon.

Ohne SVC ändert sich nichts. Die Mod lädt die SVC-Anbindung nur, wenn SVC da ist.

[T] Alles wird auf dem Server entschieden: Wer DJ ist, prüft der Server anhand der Position. Der Client schickt nur wie immer sein Mikrofon an SVC.

Einrichten

Simple Voice Chat für Minecraft 26.3 / Fabric herunterladen (ab 2.6) und in den mods-Ordner von Server und allen Spielern legen.
Auf einem eigenen Server den UDP-Port von SVC freigeben (Standard 24454), siehe die SVC-Anleitung zum Server-Setup. Im Einzelspieler oder per LAN-Welt ist nichts zu tun.
Im Spiel mit V das Voice-Chat-Menü öffnen, Mikrofon wählen und testen.
DJ-Pult einschalten (Rechtsklick), davor stellen, sprechen. Fertig.

Musik streamen, z. B. von Tidal

Die Mod streamt selbst nichts und bringt keine fremde Musik mit (CLAUDE.md). Der Trick ist ein virtuelles Audiokabel: Es macht aus der Musik-App ein „Mikrofon“, das SVC dann über das Pult abspielt.

Virtuelles Audiokabel installieren: - Windows: VB-Audio Virtual Cable (kostenlos) - macOS: BlackHole (kostenlos) - Linux: mit PipeWire/PulseAudio eine Null-Senke anlegen, z. B. pactl load-module module-null-sink sink_name=dj; als Mikrofon dann „Monitor of dj“ wählen.
In der Musik-App (Tidal, Spotify, eigene MP3s …) als Ausgabe CABLE Input bzw. BlackHole wählen. Unter Windows geht das auch pro App: Einstellungen → System → Sound → Lautstärkemixer.
In Minecraft mit V → Einstellungen von SVC: - Mikrofon: CABLE Output bzw. BlackHole bzw. „Monitor of dj“ - Aktivierung: Sprachaktivierung mit niedriger Schwelle (oder Push-to-Talk dauerhaft halten) - Rauschunterdrückung aus, sonst klingt Musik blechern - Mikrofonverstärkung so einstellen, dass es nicht übersteuert
Selbst mithören: Unter Windows bei CABLE Output → Eigenschaften → Abhören „Dieses Gerät als Wiedergabequelle verwenden“ anhaken; unter macOS ein Multi-Output-Gerät aus BlackHole und Lautsprechern anlegen.
Ans eingeschaltete DJ-Pult stellen und die Musik starten.

Gleichzeitig reden und Musik geht mit einem Mischpult-Programm wie Voicemeeter (Windows): Mikrofon und Musik dort zusammenführen und den Ausgang als SVC-Mikrofon wählen.

Hinweis zum Recht: Tidal, Spotify und andere Dienste erlauben in ihren Nutzungsbedingungen meist nur das private Hören. Musik an andere Spieler weiterzugeben kann dagegen verstoßen und urheberrechtlich eine öffentliche Wiedergabe sein. Auf einem privaten Server mit Freunden ist das die Entscheidung des Server-Betreibers; auf öffentlichen Servern besser eigene oder freie Musik nehmen.

Bessere Klangqualität

SVC ist für Sprache gebaut. Für Musik hilft eine Einstellung auf dem Server in config/voicechat/voicechat-server.properties:

codec=AUDIO

Danach den Server neu starten. AUDIO stellt den Opus-Codec auf Musik statt Sprache um (Standard ist VOIP). Im Einzelspieler liegt die Datei im Weltordner unter serverconfig bzw. im config-Ordner des Spiels.

[T] Stereo geht nicht: SVC überträgt jede Quelle mono. Das ist eine Grenze von SVC, nicht der Mod. Wer Musik in voller Qualität will, legt eigene .ogg-Titel über ein Ressourcenpaket ans Pult (E91).

Fehlersuche

Problem	Lösung
Keine Meldung „Du stehst am DJ-Pult“	Pult einschalten (Rechtsklick), näher ran (höchstens 2,5 Blöcke), SVC auf dem Server installiert?
Meldung kommt, aber nie „Du bist live“	Im SVC-Menü (V) prüfen: verbunden, nicht stumm, Mikrofon = CABLE Output/BlackHole, Pegelanzeige bewegt sich; nicht in einer SVC-Gruppe; nicht flüstern
Musik bricht in leisen Stellen ab	Sprachaktivierung: Schwelle ganz nach unten, oder Push-to-Talk-Taste festhalten
Klingt blechern oder pumpt	Rauschunterdrückung und automatische Verstärkung in SVC aus, Server auf `codec=AUDIO`
Zu laut oder zu leise	Jeder Spieler stellt im SVC-Menü die Kategorie DJ-Pult selbst ein; der DJ regelt die Mikrofonverstärkung
Hinten im Zelt nichts zu hören	Steht dort ein Dach aus Zeltplanen? Ohne Dach gilt die Stelle als draußen

Audioplayer-Addon

Das Addon AudioPlayer (braucht SVC) spielt hochgeladene Lieder von Schallplatten in der Jukebox, ganz ohne virtuelles Kabel. Es ist unabhängig vom Pult:

AudioPlayer auf Server und Clients installieren.
Ein Lied hochladen, z. B. /audioplayer url <Link zur MP3> oder als Datei in den Ordner audio_player_data des Servers legen.
Eine Schallplatte in die Hand nehmen und /audioplayer apply <id> eingeben.
Die Platte in eine Jukebox neben dem DJ-Pult legen.

[T] Die Jukebox spielt dann von ihrer eigenen Position, nicht über die Zelt-Lautsprecher; die eingebaute Partymusik macht dafür keine Pause. Die Platte über die Lautsprecher laufen zu lassen bräuchte die AudioPlayer-Schnittstelle und ist nicht gebaut.

Technik

festabend/DjMikrofon: kennt SVC nicht. Der Server-Thread legt einmal pro Sekunde fest, wer DJ ist und wo Pult und Lautsprecher stehen.
festabend/voicechat/DjPultVoicechatPlugin: SVC-Plugin über den Fabric-Entrypoint voicechat. Fängt die Mikrofon-Pakete eines DJs ab und schickt sie über je einen ortsgebundenen Kanal pro Pult, DJ und Lautsprecher.
build.gradle: voicechat-api nur compileOnly aus maven.maxhenkel.de; fabric.mod.json nennt SVC unter suggests, nicht unter depends.

Offen

~~Frage 78~~: beantwortet, E84 (Partymusik pausiert).
Ausprobiert ist das Zusammenspiel mit einem echten SVC-Client noch nicht; die Build-Tests prüfen nur die Regeln ohne SVC.