Presets

Erweiterte Voreinstellungen

Migration alter Java-Befehls-Presets

Die Migration alter Java-Befehls-Presets ist jetzt ein vollständiger erweiterter Arbeitsablauf statt einer vorgefertigten Befehlsnotiz. Verwenden Sie dieses Preset, wenn ein altes Command Pack von älteren Java-Beispielen in die aktuelle NBTForge-Ausgabe überführt werden muss. Die Migration beginnt mit der Absicht hinter dem Gegenstand oder der Entität und nicht mit blindem Ersetzen von Zeichenketten, wodurch sich der fertige Befehl leichter prüfen lässt. Der Artikel hält die Einrichtungsfelder, die Ausgabeprüfung, die Platzierung im Project und die Ergebniserfassung zusammen, sodass sich der Befehl leicht prüfen lässt, bevor er Teil einer Karten-Einrichtung, eines Ereignis-Auslösers oder eines wiederverwendbaren Befehlspakets wird. Die Prüfoberfläche sollte den importierten alten Befehl, die neu aufgebaute moderne Ausgabe und den Unterschied zwischen beiden anzeigen. So wird die Syntax-Migration zu einem kontrollierten Arbeitsablauf statt zu einer riskanten einzeiligen Bearbeitung.

Preset-Ergebnis

Ein Migrations-Workflow, der die alte Java-Gegenstandsabsicht in die aktuelle Komponentenausgabe samt Prüfhinweisen umwandelt.

Ausgabe

Hinweise zur Migration von der Vorgängerversion auf die aktuelle Version

Legacy command intent: named sword with lore, sharpness, unbreakable, and custom marker.
Modern rebuild: /give @p minecraft:diamond_sword[custom_name={text:"Legacy Blade",color:"gold",italic:false},lore=[{text:"Migrated component item",color:"gray",italic:false}],enchantments={"minecraft:sharpness":5},unbreakable={},custom_data={legacy_item:1}] 1
Review: compare old NBT fields to current components before replacing the saved Project entry.
Too long for Minecraft chat

The longest command line is 259 characters, 3 over the 256-character chat input limit. Pasting it into chat can truncate the line and make Minecraft report a syntax error even when the generated command is valid.

  • Use a Command Block: run /give @s command_block, place it, then paste this command into the block command field.
  • Use a .mcfunction for a reusable datapack: save the line without the leading slash at saves/<world>/datapacks/<pack>/data/<ns>/function/<name>.mcfunction with a minimal pack.mcmeta, run /reload, then run /function <ns>:<name>. Do not paste .mcfunction content into chat.

Preset-Screenshot

Beginnen Sie mit den erweiterten Steuerelementen, die den Preset-Zustand definieren.
Der zweite Screenshot hebt die Einrichtung oder den begleitenden Befehl hervor, der das Verhalten gegenüber dem Spieler verändert.
Der Ausgabe-Screenshot hält den letzten Befehl oder das letzte Befehlspaar sichtbar, bevor es in das Project gelangt.

Preset erstellen

  1. Fügen Sie die Absicht des alten Befehls ein oder dokumentieren Sie sie.
  2. Wählen Sie das aktuelle NBTForge-Modul aus, das zur Befehlsfamilie passt.
  3. Erstellen Sie den Gegenstand, die Entität oder die Datenpaket-Ressource aus den Feldern neu.
  4. Vergleichen Sie die alte NBT-Ausgabe und die moderne Ausgabe im Diff.
  5. Speichern Sie den migrierten Befehl als eigenen Project-Eintrag.
  6. Ersetzen Sie den alten Befehl erst, nachdem die neue Ausgabe getestet wurde.

Warum dieses erweiterte Preset in das Project gehört

Verwenden Sie dieses Preset, wenn ein altes Command Pack von älteren Java-Beispielen in die aktuelle NBTForge-Ausgabe überführt werden muss. Die Migration beginnt mit der Absicht hinter dem Gegenstand oder der Entität und nicht mit blindem Ersetzen von Zeichenketten, wodurch sich der fertige Befehl leichter prüfen lässt.

Die Prüfoberfläche sollte den importierten alten Befehl, die neu aufgebaute moderne Ausgabe und den Unterschied zwischen beiden anzeigen. So wird die Syntax-Migration zu einem kontrollierten Arbeitsablauf statt zu einer riskanten einzeiligen Bearbeitung. Ein kopierter Befehl ist nur dann nützlich, wenn die umgebenden Annahmen sichtbar sind: Selektorbereich, Weltzustand, Reihenfolge innerhalb des Pakets und die genaue Ausgabe, die in Minecraft eingefügt wird. Behandeln Sie dieses Preset als Prüfpunkt, an dem sich diese Details kontrollieren lassen, bevor der Befehl NBTForge verlässt.

Die Galerie ist um diese Prüfung herum aufgebaut. Der erste Screenshot zeigt den Zustand der Workbench, der zweite Screenshot ruft das Feld- oder Begleitmodul auf, das das Verhalten gegenüber dem Spieler verändert, und der Ausgabe-Screenshot hält den Befehl oder das Befehlspaar sichtbar. Wenn das Preset ein sichtbares Ergebnis liefert, bestätigt der Screenshot im Spiel dieselbe Idee in einer wiederherstellbaren Testwelt, anstatt sich auf ein generisches Overlay zu verlassen.

Tests und Bereichsprüfungen

Manche alten NBT-Ideen lassen sich auf moderne Komponenten abbilden, andere werden in `custom_data` aufgenommen und einige erfordern ein völlig anderes Design. Bauen und testen Sie jede Befehlsfamilie einzeln neu, anstatt eine globale Textersetzung durchzuführen.

Führen Sie den ersten Smoke-Test mit einem engen Selektor und einem sauberen Weltzustand durch. Befehle für Umgebung, Hilfsfunktionen, Routing und Rückmeldungen können harmlos aussehen, wirken sich aber häufig auf jeden Spieler oder die ganze Welt aus. Bestätigen Sie, dass der Befehl nur den beabsichtigten Zustand ändert, und speichern Sie dann die genaue Ausgabe neben den Einrichtungs- oder Folgezeilen, die erklären, warum sie existiert.

Wenn der Befehl Teil einer Funktionsdatei oder einer Befehlsblock-Kette wird, testen Sie das kopierte Artefakt und nicht nur den Live-Zustand der Workbench. So erkennen Sie veraltete Selektoren, eine falsche Befehlsreihenfolge, fehlende Einrichtungszeilen und Effekte, die nur deshalb zu funktionieren schienen, weil ein vorheriger Test einen Zustand hinterlassen hat.

  • Halten Sie die Selektoren eng, bis das gesamte Paket geprüft ist.
  • Platzieren Sie die Welt-Einrichtung vor begegnungsspezifischen Überschreibungen.
  • Speichern Sie Rückmeldungsbefehle neben der Zustandsänderung, die sie auslöst.

Wohin als Nächstes?

Migrieren Sie jeweils einen gespeicherten Project-Eintrag und behalten Sie die alte Ausgabe bei, bis der neue Befehl einen Test in einer sauberen Welt besteht.

Für die gegenstandsspezifische Migration vergleichen Sie die Anleitung zum Java-1.20.4-Gegenstands-NBT-Preset und die Anleitung zum Java-1.21-Gegenstandskomponenten-Preset.

FAQ

Kann ich diesen erweiterten Befehl in den Chat einfügen?

Für einen Smoke-Test mit einem einzelnen Befehl in der Regel ja, sofern der Selektor sicher und die Zeile kurz ist. Für wiederholbares Kartenverhalten speichern Sie ihn im Project und kopieren Sie die geordnete Paket- oder Funktionsausgabe.

Warum beschränkt sich der Nachweis bei diesem Preset auf die Galerie der Benutzeroberfläche?

Dieses Preset erzeugt JSON, Projektorganisation oder einen Prüf-Workflow statt eines sichtbaren Objekts in der Welt. Der nützliche Nachweis ist der Zustand der Workbench, die Ausgabe und die Platzierung im Project.

Was sollte ich prüfen, bevor ich dieses Preset teile?

Prüfen Sie den Selektorbereich, die Befehlsreihenfolge, die Zielversion und ob der Befehl zur Einrichtung, zur Begegnungslogik, zur Rückmeldung oder zur Bereinigung gehört. Diese Kategorien entscheiden, wo er in einem Project-Paket platziert wird.

Ablauf öffnen

Starte im passenden Advanced Arbeitsbereich und passe die Preset-Felder für deine Welt an.