Technik

Vereinsfarben

Stand: 02.11.2026. Antwort von Nils zu Frage 22 im Fragen-Katalog: einstellbar, Standard Grün und Weiß (Eintrag in ENTSCHEIDUNGEN.md über PR #9).

Kennzeichnung: [A] Anforderung, [V] Vorschlag, [T] technische Annahme.

Einstellen

Datei config/schuetzenfest/vereinsfarben.json auf dem Server (im Einzelspieler im Spielordner). Sie wird beim ersten Start mit dem Standard angelegt:

{
  "hauptfarbe": "#2E6B3A",
  "zweitfarbe": "#EEEEE8"
}

Farben als #RRGGBB.
Gelesen wird beim Serverstart. Nach einer Änderung im laufenden Spiel: /schuetzenfest vereinsfarben neuladen (nur Operatoren). Alle Spieler sehen die neue Farbe sofort.
Ist die Datei fehlerhaft, gilt der Standard; die Datei bleibt unverändert und das Server-Log nennt den Fehler.

Was die Farben nutzt

Teil	Farbe
Schützenhut, Uniformjacke, Krawatte	Hauptfarbe [V]
Weißes Hemd, schwarze Hose, Königskette	fest, keine Vereinsfarbe [A] (Hemd weiß, Hose schwarz, Kette Gold)
Stoffdach des Schützenstands	Hauptfarbe [V], angebunden im Thread „Schießstand und Holzvogel“

Die Zweitfarbe nutzt in Stufe 1 noch kein Teil. Sie ist für Fahnen, Schärpen, Streifen und Absetzungen gedacht.

Technik

[T] Der Server ist maßgeblich (farben.VereinsfarbenServer). Er färbt Uniformteile über die Komponente dyed_color, sobald sie im Inventar oder im Zubehör-Platz liegen. Die Farbe reist damit automatisch zu allen Clients. Die Stofftexturen sind dafür in Graustufen angelegt; bei der Jacke liegen Knöpfe, Schulterstücke und Kragen auf einer zweiten, nicht eingefärbten Schicht (uniform_jacke_details.png).
[T] Für Blöcke schickt der Server die Farben beim Betreten und nach neuladen an jeden Client (VereinsfarbenPayload). Auf dem Client liefert client.farben.VereinsfarbenAnzeige.aktuell() sie für Block-Tints. Schon gezeichnete Blöcke zeigen eine geänderte Farbe erst, wenn ihr Chunk neu gebaut wird (Block setzen, neu verbinden oder F3+A); ein automatisches Neuzeichnen ist noch offen, weil der passende Aufruf in 26.3 nicht geprüft ist.
[T] Spieler können die Uniform nicht selbst umfärben: die Teile sind nicht im Tag minecraft:dyeable, und der Server setzt die Vereinsfarbe ohnehin wieder.
Eine Farbe pro Welt bzw. Server. Mehrere Vereine mit eigenen Farben sind eine spätere Erweiterung.

Schnittstelle

// Server
Vereinsfarben farben = VereinsfarbenServer.aktuell();
VereinsfarbenServer.einfaerben(stack, Vereinsfarben.Rolle.HAUPTFARBE);

// Client, z. B. Block-Tint
int rgb = VereinsfarbenAnzeige.aktuell().hauptfarbe();

Prüfen

VereinsfarbenKonfigTest: Datei anlegen, lesen, Fehler, Standard
KleidungGameTest.uniformTraegtVereinsfarbe: die Jacke bekommt die Hauptfarbe, das Hemd bleibt weiß
Von Hand: Farbe in der Datei ändern, /schuetzenfest vereinsfarben neuladen, Jacke und Hut am anderen Spieler ansehen