BlockReel-Texturen

Was macht BlockReel-Texturen?

Arbeite im BlockReel-Ordner. Lege jedes Set in work/textures/<name>/ (gitignoriert) oder films/<name>/textures/ ab. Der Ordner spiegelt assets/minecraft/textures/ (block/…, item/…). Kopiere niemals Game-Texturen; nur Originale (das Demo-Set des Repos ist CC0).

1. Briefing (höchstens eine kurze Frage)

Lege fest: Thema (z. B. pastelliger Cartoon, düsteres Mittelalter, verschneit), Auflösung (16x Standard, 32x oder 64x), welche Blöcke und Items (Standard: ein Starterset von ~25: Stein, Bruchstein, Erde, Gras oben/seitlich, Bretter, Stamm, Laub, Sand, Glas, Wasser, Lava, Ziegel, Obsidian, Glowstone, Schnee, Wolle, Erze/Metallblöcke, TNT, plus 1–2 Items) und die Java-Zielversion (wird für das Pack-Format benötigt; nachfragen, falls unbekannt).

2. Recherche (Web), geschrieben in research.md mit Links

• Offizielle Texturdateinamen für die Zielversion: Die Namen sind der Vertrag; ein falscher Name wird lautlos ignoriert. Prüfe das Minecraft Wiki: Resource Pack und die Dateiliste der Version (der Nutzer kann den eigenen Client-.jar öffnen, assets/minecraft/textures/, um die Namen aufzulisten; kopiere niemals die Dateien).
• Animierte Texturen: Ein vertikaler Streifen-PNG plus eine Beiladungsdatei <name>.png.mcmeta, z. B. water_still.png.mcmeta: { "animation": { "frametime": 3, "interpolate": true } }; optional width, height (Bildgröße) und frames. Jeder Frame muss gleich groß sein und das Bild muss eine ganze Anzahl von Frames enthalten (Quelle: die Resource-Pack-Seite des Wikis).
• Naht-Konventionen: Blocktexturen sind quadratisch; sie wiederholen sich, daher müssen Kanten überlappen. Die Oberseiten von Geländeblöcken wiederholen sich am meisten.
• Das Pack-Format für die Version des Nutzers: Minecraft Wiki: Pack-Format, die Spalte resource pack. Zitiere die Version und die Nummer und den Link in deiner Antwort. Seit 25w31a (Java 1.21.9) verwendet das Wiki laut Wiki min_format / max_format anstelle von pack_format. Rate niemals die Nummer. Versionen mit einer Dezimalzahl (wie 97.1) werden von core/pack.py nicht unterstützt (wie man sie in pack.mcmeta schreibt, wurde nicht bestätigt); informiere den Nutzer.
• Stilreferenzen für das Thema (Paletten, wie andere mit Naht-Rauschen umgehen). Nur Prinzipien.

3. Paletten- und Stilplan für das GESAMTE Set

Bevor etwas gezeichnet wird: ein globaler Palettenplan (eine Grundfarbe pro Material, jede eine 4-Ton-Rampe mit leichtem Farbstich: skin.ramp), die Stilregeln (gebänderte flache Töne vs. weiche Verläufe, Umrandungen oder nicht, wie viele Ein-Pixel-Akzente pro Kachel) und die Rausch-Skalierung (wie groß Klumpen relativ zur Kachel sind). Jede Textur folgt den gleichen Regeln; das macht ein Set aus.

4. Generieren oder malen

• Per Code (bevorzugt für Kacheln): Beginne mit examples/texture-pack-demo/make_textures.py (geseedet, durch Konstruktion nahtlos: umlaufendes Rauschen, umlaufende Voronoi-Zellen, versetzte Bretter, Fasen, animierte Streifen). Ändere PLAN und die Muster.
• Von Hand, Pixel für Pixel, für Heldentexturen (Item-Symbole, Erze).
• Seiten-Texturen (grass_block_side), Glas und Metallblöcke haben von Natur aus Rahmen; sie sind nicht nahtlos.

5. Prüfen (PFLICHT)

python core/tilecheck.py check block/stone.png --out stone_tiles.png   # 2×2- und 3×3-Nahtvorschau + Naht-Score
python core/tilecheck.py palette block/stone.png -k 6                  # dominante Farben
python core/tilecheck.py set textures/ --out report/                   # gesamtes Set: PROBLEME, Notizen, Kontaktbogen
python core/pack.py check textures/                                    # Namen, Größen, Animationsstreifen

Öffne die Bilder (stone_tiles.png, report/set-sheet.png) und schau sie an. PROBLEME (sichtbare Naht bei einer sich wiederholenden Textur, gemischte Größen, zu viele Farben) müssen behoben werden; Notizen (Helligkeit, Sättigung, Palettenüberlappung) sind Aufforderungen, genauer hinzusehen, keine Fehler. Gerahmte Texturen werden als Notizen gemeldet. Wiederhole mindestens einmal: Behebe, was du gesehen hast, generiere neu, schau noch einmal.

6. Vorschau in einer Szene (PFLICHT)

python tools/pack_preview.py textures/ --out pack-preview.png

Eine von der Film-Engine gerenderte Mini-Welt mit deinen Texturen: großes Gelände (Wiederholung), eine Blockgalerie, eine Hütte, ein Baum, Wasser, Lava, Glas und eine Figur als Maßstab. Achte auf: Wiederholung auf großen Flächen, Oberseiten vs. Seiten von Gras und Stämmen, Transparenz (Glas, Laub), Kontrast zwischen Nachbarn und die Stimmung im Sonnenlicht. Blöcke, die in deinem Set fehlen, werden aufgelistet (die integrierten Originale werden für sie verwendet).

7. Bauen des Packs

python core/pack.py build textures/ --name "Mein Pack" --pack-format <N> --format-version <Java-Version> \
  --format-source https://minecraft.wiki/w/Pack_format --icon pack.png --out build/
# Java 1.21.9 und neuer:  --min-format <N> --max-format <M>   anstelle von --pack-format

Der Befehl weigert sich, ohne eine Formatnummer ausgeführt zu werden (es gibt absichtlich keinen Standard). pack.mcmeta liegt im ZIP-Stammverzeichnis, und eine README.txt im Pack erfasst die Nummer, die Version und den Quellen-Link. Zitiere diesen Link in deiner Antwort.

8. Installations- und Test-Checkliste (dem Nutzer geben; DU konntest nicht im Spiel testen)

1. Kopiere die .zip-Datei in den resourcepacks-Ordner des Spiels (Optionen → Ressourcenpakete → Paketordner öffnen zeigt, wo).
2. Aktiviere es unter Optionen → Ressourcenpakete. Wenn das Spiel das Paket als inkompatibel meldet, stimmt die Formatnummer nicht mit der Spielversion überein.
3. Überprüfe in einer Kreativwelt: Erde/Stein/Bruchstein/Bretter/Stämme/Laub, Wasser- und Lava-Animation, Glas-Transparenz, TNT, einen flachen 20×20-Boden aus jedem Hauptblock (Nähte), und ein paar Items.
4. Melde alles, was das lila/schwarze Schachbrettmuster zeigt: das bedeutet einen falschen Dateinamen oder eine falsche Frame-Größe.

Regeln

• Gib niemals an, dass das Pack im Spiel funktioniert. Sage „erstellt, geprüft und in der BlockReel-Engine vorschau angezeigt".
• Lade niemals Game-Texturen hoch. Nimm sie nicht aus dem .jar des Nutzers in das Repo.
• Skins sind eine andere Sache (blockreel-skins); ein Resource Pack kann den Skin des Spielers nicht ändern.
• Modelle, Sounds, Schriften und Shader sind nicht im Umfang enthalten.