Deutsch

🏠 Wiki-Startseite — 🇬🇧 English version

CopycatSign – Wiki (Deutsch)

Frei platzierbare Bild-Schilder, die als Block existieren, nicht als Entity – dadurch werden sie beim Zusammenbauen einer Create-Kontraption (z.B. ein Zug) korrekt mitgenommen, statt wie Entity-basierte Gemälde-Mods dabei zerstört/ausgestoßen zu werden. Kurz-Referenz findest du im README.

Inhalt

• Ein Schild platzieren
• Rahmenmaterial wählen
• Dicke ändern
• Position/Tiefe ändern
• Eigenes Bild hochladen
• Bereits hochgeladenes Bild wiederverwenden
• Create-Kompatibilität

Ein Schild platzieren

Im Kreativ-Tab "Copycat Sign" findest du drei Blöcke: zwei Platzhalter-Motive (nur zum Testen der Mechanik) und picture_blank – ein leeres Schild, der eigentliche Ausgangspunkt für dein eigenes Bild (siehe Eigenes Bild hochladen unten). Einfach wie jeden anderen Block platzieren.

Rahmenmaterial wählen

Ein platziertes Schild hat zwei getrennte Material-Slots:

• Rückseite: Rechtsklick auf das Schild mit einem beliebigen Block-Item in der Hauptmi.
• Kanten: Rechtsklick mit einem Block-Item in der Nebenmi (Taste F tauscht Haupt-/Nebenmi).

Jeder Klick verbraucht 1 Item, genau wie normales Platzieren. Nicht jeder Block ist als Material erlaubt – die Regeln orientieren sich an FramedBlocks: Blöcke mit eigener BlockEntity sind standardmäßig gesperrt (außer sie stehen auf einer Whitelist), nicht "solide" Blöcke (Glasscheiben, Stufen etc.) ebenso, es sei denn sie sind explizit als "frameable" markiert. Falls ein Material abgelehnt wird, bekommst du das im Chat mitgeteilt.

Dicke ändern

Ein Schild hat 4 Dicke-Stufen: sehr dünn (1px), dünn (2px, Standard), mittel (4px), dick (6px). Aktuell direkt am Blockstate gespeichert – ein Umschalter im Bild-Editor (siehe unten) ist geplant, aber noch nicht umgesetzt.

Position/Tiefe ändern

Rechtsklick mit leerer Hand (und ohne Material in der Nebenhand) schaltet zwischen 5 Tiefenpositionen innerhalb der Blockzelle durch: hinten, hinten-mitte, mitte, vorne-mitte, vorne. Kostenlos, da nur eine Umpositionierung. Die Position ist relativ zur eingestellten Dicke gespeichert, passt sich also automatisch an, wenn du die Dicke später änderst.

Wichtig: Ein leerer-Hand-Rechtsklick öffnet stattdessen den Bild-Editor, sobald das Schild schon ein eigenes Bild hat (siehe unten) bzw. wenn du gar kein Material wechseln willst – die Positions- Funktion und der Editor teilen sich die "leere Hand"-Geste, siehe nächster Abschnitt für die genaue Reihenfolge.

Eigenes Bild hochladen

Hinweis: Dieses Feature ist vollständig implementiert (Upload, Server-Speicherung, Client-Textur-Cache, Renderer, Editor-GUI), aber noch nicht in einer echten Spielsitzung komplett durchgetestet. Solltest du beim ersten Ausprobieren einen Fehler oder Absturz finden, bitte als Issue melden.

1. Rechtsklick mit leerer Hand auf ein Schild (Hauptmi UND Nebenmi müssen leer sein, sonst wird stattdessen ein Material gesetzt bzw. die Position durchgeschaltet).
2. Es öffnet sich der Bild-Editor mit einem Datei-Auswahl-Dialog. PNG oder JPEG wählen.
3. Nach der Auswahl siehst du eine lokale Vorschau. Der Hochladen-Button überträgt das Bild zum Server (Content-Addressing per SHA-256 – lädst du dasselbe Bild später nochmal hoch, wird nicht doppelt gespeichert). Maximale Dateigröße und Bildauflösung sind serverseitig konfigurierbar (CopycatSignConfig).
4. Nach erfolgreichem Upload wird das Bild automatisch auf dem Schild angezeigt.
5. Drei Regler passen Ausschnitt (Pan) und Zoom live an – jede Änderung wird sofort ans Schild gesendet, kein extra Speichern-Klick nötig.

Der Server begrenzt außerdem, wie weit du vom Schild entfernt sein darfst, während du es bearbeitest (max. 8 Blöcke).

Bereits hochgeladenes Bild wiederverwenden

Statt jedes Mal eine neue Datei hochzuladen, öffnet der Galerie-Button im Editor ein durchsuchbares Raster aller bisher hochgeladenen Bilder. Ein Klick wendet das gewählte Bild sofort an – die Vorschau aktualisiert sich direkt, aufgelöst über denselben Client-Textur-Cache, den auch die Schild-Darstellung selbst nutzt.

Create-Kompatibilität

CopycatSign-Blöcke sind normale BlockEntity-Blöcke und werden von Create beim Einsammeln in eine Kontraption (Zug, Glider, Kolben-Konstruktion, ...) wie jeder andere BlockEntity-Block ganz normal mitgenommen und mitgerendert – kein Sonderfall nötig. Create selbst ist nur eine optionale Abhängigkeit: ohne Create installiert funktionieren Platzieren, Material, Dicke, Position und Bild-Upload genauso, nur die Kontraptions-Mitnahme entfällt natürlich, wenn Create gar nicht da ist.