Guides / Building & Resources

Eigene Gemälde und Discs erfordern zwei Packs, und die Installation nur eines davon ist der häufigste Fehler

Das Datenpaket registriert den Inhalt; das Ressourcenpaket liefert Textur und Sound. Ein Datenpaket allein registriert, hat aber nichts zum Anzeigen. Plus die 4×4-Grenze und warum die Disclänge nicht nur kosmetisch ist.

2026-08-01

Gemälde und Musik-Discs sind beides echte Registrierungen im modernen Java, was bedeutet, dass man sie hinzufügen kann, anstatt die Vanilla-Versionen zu ersetzen. Nichts, was Sie hinzufügen, verdrängt ein bestehendes Gemälde oder eine Disc.

Der Haken ist, dass der Inhalt auf zwei verschiedene Pack-Typen aufgeteilt ist, und jeder für sich nutzlos ist.

Was wohin gehört

Das Datenpaket registriert das Objekt:

data/<ns>/painting_variant/<id>.json    asset_id, width, height, title, author
data/<ns>/jukebox_song/<id>.json        sound_event, description, length, comparator

Das Ressourcenpaket liefert, was Sie sehen und hören:

assets/<ns>/textures/painting/<id>.png
assets/<ns>/sounds/<id>.ogg
assets/<ns>/sounds.json

Installieren Sie nur das Datenpaket, und der Inhalt wird erfolgreich registriert – er existiert, /give findet ihn, und es gibt einfach keine Textur und kein Audio. Das ist ein viel verwirrenderes Ergebnis als ein direkter Fehler, und es ist der übliche Grund, warum ein benutzerdefiniertes Gemälde „nicht funktioniert hat“. Das Tool auf dieser Seite liefert beides in einem Zip, speziell damit sie nicht getrennt werden können.

Beachten Sie die beiden pack.mcmeta-Dateien. Es sind separate Packs mit separaten Identitäten; es gibt kein kombiniertes Format, das beide enthält.

Registrierungs-IDs sind strenger als Dateinamen

Eine ID darf nur a-z, 0-9, _, . und - enthalten. Alles andere führt dazu, dass das Pack nicht geladen wird – nicht nur der eine fehlerhafte Eintrag, sondern das gesamte Pack. Großbuchstaben und Leerzeichen sind die beiden Dinge, die Leute erwischen, weil beides in dem Dateinamen, den Sie hineingezogen haben, völlig normal ist.

Gemälde: 1×1 bis 4×4

Vanilla-Größen reichen von 1 × 1 bis zu 4 × 4 Blöcken, was sechzehn mögliche Formen ergibt. Eine Variante außerhalb dieses Bereichs wird trotzdem gerendert – das Spiel lehnt sie nicht ab –, aber sie kann nicht an einer Wand in der Größe aufgehängt werden, die Spieler erwarten, daher ist sie in einem normalen Bau effektiv nicht platzierbar.

Die Größe wird im JSON als width und height in Blöcken deklariert. Sie wird nicht aus der PNG-Datei abgeleitet, daher ist ein 3 × 1 Gemälde, dessen Textur quadratisch ist, eine gültige Datei, die gestreckt angezeigt wird.

Disclänge ist kein Etikett

length_in_seconds steuert zwei Dinge: das Timing des Plattenspielers und die Komparator-Rampe – das Signal, das ein Komparator von einem spielenden Plattenspieler liest, steigt über die deklarierte Dauer des Tracks an.

Eine ungenaue Länge ist also kein kosmetischer Fehler. Deklarieren Sie einen 200-Sekunden-Track als 100, und der Komparator beendet seine Rampe auf halbem Weg, was stillschweigend jede Redstone-Schaltung unterbricht, die an das Ende einer Disc gekoppelt ist. Aus genau diesem Grund liest dieses Tool die tatsächliche Dauer aus der Datei, anstatt Sie aufzufordern, sie einzugeben.

Tracks werden auch mit "stream": true in sounds.json geschrieben. Musik ist lang, und das Laden eines vollständigen Tracks in den Speicher vor dem Abspielen führt zu Rucklern – Streaming ist die richtige Standardeinstellung für alles, was Disclänge hat, und die falsche für einen kurzen Soundeffekt.

Eigene Gemälde und Schallplatten →