Technik

Königskette und Uniform

Stand: 02.11.2026. Bezug: Anforderungsmatrix S1-19 (Königskette) und S1-21 (Grund-Uniform), Asset-Backlog #13 bis #18.

Kennzeichnung: [A] Anforderung aus dem Originalkonzept, [V] Vorschlag, [T] technische Annahme, [F] offene Frage.

Was es gibt

• [A] Grund-Uniform aus Hut, Jacke, Hemd, Krawatte, Hose; Teile einzeln tragbar. Königskette in Stufe 1.
• Entschieden (E7): Slot-Belegung nach Asset-Backlog Abschnitt 4.5: jedes Teil, auch die Jacke, hat einen eigenen Platz, die Vanilla-Rüstungsplätze bleiben frei. Die Anforderungsmatrix ist daran angeglichen.
• Entschieden (E28): Alles ist craftbar. [V] Rezepte aus Vanilla-Wolle in Rüstungsform (Hut mit Feder, Jacke mit Eisennuggets als Knöpfe, Krawatte aus Faden und Wolle); Liste in docs/ANLEITUNG.md Abschnitt 11. Die Königskette hat kein Rezept, sie wird verliehen.
• [T] Die Teile haben keine Vanilla-Ausrüstungskomponente und geben keinen Rüstungsschutz (Vorschlag zu Matrix-F21). Sie passen nur in ihren eigenen Platz.

Zubehör-Bibliothek

• [T] Geprüft am 02.11.2026 über GitHub Actions (Modrinth und Maven sind aus der Cloud-Umgebung gesperrt): Für Minecraft 26.3 mit Fabric gibt es nur Trinkets Updated 4.2.1+26.3 (Fork von Patbox, MIT, Maven eu.pb4:trinkets auf maven.nucleoid.xyz). Trinkets (Original) endet bei 1.21.1, Accessories (wispforest) bei 1.21.10, Trinkets Continued bei 26.1.
• Entschieden (E6): Trinkets Updated. Spieler und Server brauchen die Mod zusätzlich (Modrinth); fabric.mod.json verlangt sie (trinkets_updated ab 4.2.1).
• Die Bibliothek wird nur in zubehoer/trinkets/TrinketsAnbindung.java angesprochen. Ein Wechsel betrifft diese Klasse, die Plätze unter src/main/resources/data/trinkets/ und die Darstellung unter assets/schuetzenfest/trinkets/.

Rüstung und Fest-Outfit (Backlog AF14)

• Entschieden (E8): Das Outfit blendet die Rüstung aus. Ein getragenes Kleidungsteil ersetzt das Bild der Rüstung im selben Körperbereich; die Hose ersetzt auch die Stiefel (schwarze Schuhe). Die Schutzwirkung der Rüstung bleibt [T]. Umgesetzt mit der Darstellungsart equipment_replace von Trinkets Updated.
• [T] Krawatte und Kette ersetzen nichts, sie liegen zusätzlich vor der Brust.
• Die Kette steht 0,1 Block vor dem Körper und damit vor der Uniformjacke (die Jacke liegt wie Rüstung 1 Pixel vor dem Körper; vorher steckte die Kette darin, Nils 03.11.2026). Geprüft durch KleidungsRessourcenTest.ketteLiegtVorDerJacke.
• [T] Hemd und Jacke ersetzen beide das Brustbild. Es ist immer nur eines zu sehen. Gewollt ist die Jacke; welches Teil gewinnt, hängt von der Reihenfolge in Trinkets ab und ist im Spiel noch nicht geprüft. Mit Jacke ist das Hemd ohnehin verdeckt; ohne Jacke („Jacken aus“, Stufe 7) zeigt sich das Hemd.

Königskette

• [A] Der neue König erhält die Kette. Kette mit Plaketten der Vorgänger.
• [V] Die Kette wird sofort verliehen (Vorschlag zu Matrix-F19, solange es keine Krönungsphase gibt).
• [V] Zu jedem Zeitpunkt gilt höchstens eine Kette: Jede Krönung beginnt eine neue Amtszeit mit fortlaufender Nummer. Die Kette trägt ihre Nummer; gilt sie nicht mehr, nimmt der Server sie dem Träger ab (Zubehör-Platz und Inventar), mit Hinweis im Chat. In Truhen bleibt eine alte Kette liegen, lässt sich aber nicht mehr anlegen.
• [V] Nur der König, dem die Kette verliehen wurde, darf sie anlegen. Geprüft auf dem Server.
• [V] Die Kette bleibt beim Tod erhalten (drop_rule: keep).
• [V] Vorgänger stehen in Stufe 1 im Tooltip, nicht als Plaketten am Modell (Backlog-Frage F6 bzw. AF6).
• [T] Ein Königstitel pro Welt, gespeichert an der Oberwelt. Mehrere Vereine mit eigenem König sind eine spätere Erweiterung.
• [T] Der Zeitpunkt der Krönung wird in realer Zeit gespeichert, bis der Festkalender entschieden ist (O8).

Schnittstelle für die Königsermittlung

ItemStack kette = Koenigswuerde.kroenen(spieler); // nur auf dem Server

Die Königsermittlung am Schießstand (Rumpffall) ruft das auf, sonst nichts: kroenen schreibt das Königsregister, legt die Kette an und verleiht den Königsorden (OrdenArt.KOENIGSSCHUSS, höchstens einmal je Fest). Server-Ansage und Feuerwerk (S1-18) gehören zum Schießstand, nicht hierher. [V] Dass der Orden an der Krawatte hängt (E40), folgt mit der Ordensspange.

Nach jeder Krönung feuert Koenigswuerde.GEKROENT (Server, mit Server, König und neuer Historie). Anzeigen wie der Königstitel am Namen hängen sich dort an, statt kroenen zu ändern.

Zum Testen ohne Schießstand gibt es den Befehl /schuetzenfest koenig <spieler> (nur Operatoren). /schuetzenfest koenig ohne Argument zeigt jedem den amtierenden König.

Dorfbewohner in Uniform

• [A] Dorfbewohner tragen während der Festtage Uniform (Originalkonzept Stufe 3, docs/dorf/SCHUETZENDORF.md).
• [V] Regeln, mit dem Thread „Schützendorf“ abgestimmt (DorfUniform.bestimmen): nur während eines Fests und nur Erwachsene. Ein Präsident im Schützendorf trägt die Präsidenten-Uniform, mit goldenen Schulterstücken und Kette. Wer ein Instrument in der Hand hat, trägt die Spielmanns-Uniform mit Schwalbennestern in der Zweitfarbe. Alle übrigen im Schützendorf und alle mit Gewehr, grüner Fahne oder Instrument (Festzug) tragen die Schützen-Uniform: Jacke und Hut in der Hauptfarbe, weißes Hemd, schwarze Hose. Außerhalb der Festtage zeigt nur die Berufstextur den Präsidenten in Grün.
• [T] Der Server prüft alle 2 s die geladenen Dorfbewohner der Oberwelt und setzt das Attachment schuetzenfest:dorf_uniform. Es wird an alle Clients synchronisiert, aber nicht gespeichert. NoAI, Haupthand und Ausrüstung der Bewohner fasst die Uniform nicht an, beides steuert der Festzug.
• [T] Der Client zeichnet die Uniform als Schicht über dem Dorfbewohner-Modell (client.kleidung.DorfUniformSchicht), nach der Berufstextur. Die Texturen unter textures/entity/villager/uniform/ folgen dem UV-Layout der Vanilla-Dorfbewohnertextur. jacke und schwalbennester sind Graustufen und werden in Haupt- bzw. Zweitfarbe eingefärbt. Den Render-Zustand füllt ein kleiner Client-Mixin (LivingEntityRendererMixin), weil Fabric dafür kein Ereignis anbietet.
• Andere Teile können einen Bewohner gezielt einkleiden: DorfKleidung.anwenden(villager, DorfUniform). Die nächste Prüfung bestimmt die Uniform allerdings neu.
• Texturen: 128 × 128 aus assets_src/texturen/hd32_dorf.py (E62): Köperstoff, Hutband, Taschen, Ärmelaufschläge, Silberknöpfe, Schwalbennester mit Tressen und Fransen, goldene Schulterstücke und Amtskette. Der Hut reicht 4 Zeilen bis zur Krempe herunter, der Krempenring liegt mittig um das Kopfloch (nach dem Vanilla-Modell, hat_rim um -90° gedreht). Die Lage auf Hut, Krempe, Rock und Armen ist im Spiel noch nicht geprüft. Hexen, Dorfbewohner-Zombies und fahrende Händler bleiben ohne Uniform.

Platzhalter

Hut und Jacke haben seit PR #11 Blockbench-Prototypen (siehe docs/assets/BLOCKBENCH_PROTOTYPEN.md); die übrigen Texturen sind einfache Platzhalter. Hut als 3D-Modell mit Krempe, Lage am Kopf noch nicht im Spiel geprüft; Kette und Krawatte nur als flaches Item-Symbol vor der Brust; die Lage vor der Brust ist im Spiel noch nicht geprüft. Die Platz-Symbole im Inventar sind vorerst die von Trinkets (Hut, Halskette, Umhang, Gürtel). Die fertigen Modelle stehen im Asset-Backlog.

Prüfen

Automatisch bei ./gradlew build:

• KoenigshistorieTest: Amtszeiten, Gültigkeit, Vorgänger, Speichern und Laden
• KleidungsRessourcenTest: jedes Teil hat Modell, Textur, Namen, Platz, Tag, Darstellung und (außer der Kette) ein Rezept
• DorfUniformTest: Regeln für Dorfbewohner, Texturen vorhanden
• KleidungGameTest: Dorfbewohner bekommt und verliert die Uniform; Teile passen auf ihre Plätze; Krönung legt die Kette an; nach der nächsten Krönung gilt die alte Kette nicht mehr

Von Hand (Matrix M8, M10, M11), mit zwei Spielern:

1. ./gradlew runClient bzw. runServer starten, als Operator /schuetzenfest koenig A.
2. A trägt die Kette im Platz „Königskette“, der Tooltip zeigt „A, 1. König“.
3. /schuetzenfest koenig B: A verliert die Kette mit Chat-Hinweis, B trägt die neue, der Tooltip nennt A als Vorgänger.
4. A und B legen Uniformteile an und sehen sie gegenseitig, ohne neu zu verbinden.
5. In einem Schützendorf /schuetzendorf vorziehen: Die Bewohner tragen innerhalb von 2 s Uniform, der Präsident mit Gold, Musiker im Festzug mit Schwalbennestern. Hut, Krempe, Rock und Arme sitzen an der richtigen Stelle; nach dem Fest ist die Uniform wieder weg.