Text und Übersetzungen

Wann immer Minecraft Text im Spiel anzeigt, wird dieser wahrscheinlich mit einem Component-Objekt definiert. Dieser benutzerdefinierte Typ wird anstelle eines String verwendet, um eine erweiterte Formatierung zu ermöglichen, einschließlich Farben, Fettdruck, Verschleierung und Klickereignisse. Sie ermöglichen auch einen einfachen Zugriff auf das Übersetzungssystem, so dass beliebige Elemente der Benutzeroberfläche problemlos in verschiedene Sprachen übersetzt werden können.

Wenn du schon einmal mit Datapacks oder Funktionen gearbeitet hast, siehst du vielleicht Parallelen zum JSON-Textformat, das unter anderem für Displaynamen, Bücher und Schilder verwendet wird. Wie du vermutlich denken kannst, handelt es sich dabei um eine Json-Darstellung eines Component-Objekts, welche mit Hilfe eines Component.Serializer umgewandelt werden kann.

Bei der Erstellung eines Mods ist es im Allgemeinen vorzuziehen, die Component-Objekte direkt im Code zu konstruieren und dabei nach Möglichkeit Übersetzungen zu verwenden.

Text-Literale

Der einfachste Weg, ein Component-Objekt zu erzeugen, ist die Erstellung eines Literals. Dies ist nur eine Zeichenkette, die standardmäßig ohne Formatierung angezeigt wird.

Diese werden mit den Methoden Component.nullToEmpty oder Component.literal erstellt, die beide leicht unterschiedlich funktionieren. Component.nullToEmpty akzeptiert null als Eingabe, und wird eine Component Instanz zurückgeben. Im Gegensatz dazu sollte Component.literal keine Nulleingabe erhalten, sondern einen MutableComponent zurückgeben, der eine Unterklasse von Component ist, die leicht gestylt und verkettet werden kann. Mehr darüber später.

Text literal = Component.nullToEmpty("Hello, world!");
MutableComponent mutable = Component.literal("Hello, world!");
// Keep in mind that a MutableComponent can be used as a Text, making this valid:
Text mutableAsText = mutable;

Übersetzbarer Text

Wenn du mehrere Übersetzungen für dieselbe Textzeichenfolge bereitstellen willst, kannst du die Methode Component.translatable verwenden, um auf einen Übersetzungsschlüssel in einer beliebigen Sprachdatei zu verweisen. Wenn der Schlüssel nicht existiert, wird der Übersetzungsschlüssel in ein Literal umgewandelt.

Text translatable = Component.translatable("my_mod.text.hello");

// Similarly to literals, translatable text can be easily made mutable.
MutableComponent mutable = Component.translatable("my_mod.text.bye");

Die Sprachdatei en_us.json sieht wie folgt aus:

{
  "my_mod.text.hello": "Hello!",
  "my_mod.text.bye": "Goodbye :("
}

Wenn du in der Lage sein willst, Variablen in der Übersetzung zu verwenden, ähnlich wie Todesnachrichten es erlauben, die beteiligten Spieler und Gegenstände in der Übersetzung zu verwenden, kannst du diese Variablen als Parameter hinzufügen. Du kannst so viele Parameter hinzufügen, wie du willst.

Text translatable = Component.translatable("my_mod.text.hello", player.getDisplayName());

Du kannst diese Variablen in der Übersetzung wie folgt referenzieren:

{
  "my_mod.text.hello": "%1$s said hello!"
}

Im Spiel wird %1$s durch den Namen des Spielers ersetzt, auf den du im Code verwiesen hast. Die Verwendung von player.getDisplayName() bewirkt, dass zusätzliche Informationen über die Entität in einem Tooltip erscheinen, wenn der Mauszeiger über den Namen in der Chat-Nachricht bewegt wird, im Gegensatz zur Verwendung von player.getName(), die zwar den Namen ermittelt, aber keine zusätzlichen Details anzeigt. Ähnliches kann mit ItemStacks gemacht werden, indem stack.toHoverableText() verwendet wird.

Was %1$s überhaupt bedeutet, musst du nur wissen, dass die Zahl der Variablen entspricht, die du zu verwenden versuchst. Nehmen wir an, du hast drei Variablen, die du verwendest.

Text translatable = Component.translatable("my_mod.text.whack.item", victim.getDisplayName(), attacker.getDisplayName(), itemStack.toHoverableText());

Wenn du auf den Angreifer verweisen möchtest, würdest du %2$s verwenden, weil es die zweite Variable ist, die wir übergeben haben. Ebenso bezieht sich %3$s auf den ItemStack. Eine Übersetzung mit so vielen zusätzlichen Parametern könnte wie folgt aussehen:

{
  "my_mod.text.whack.item": "%1$s was whacked by %2$s using %3$s"
}

Text serialisieren

Wie bereits erwähnt, kann Text mit dem Text Codec in JSON serialisiert werden. Weitere Informationen über Codecs findest du auf der Seite Codec.

Gson gson = new Gson();
MutableComponent mutable = Component.translatable("my_mod.text.bye");
String json = gson.toJson(ComponentSerialization.CODEC.encodeStart(JsonOps.INSTANCE, mutable).getOrThrow());

Dadurch wird JSON erzeugt, das in Datenpaketen, Befehlen und an anderen Stellen verwendet werden kann, die das JSON-Format von Text anstelle von literalen oder übersetzbarem Text akzeptieren.

Text deserialisieren

Um ein JSON-Textobjekt in eine tatsächliche Component-Klasse zu deserialisieren, ist ebenfalls der Codec zu verwenden.

String jsonString = "...";
Component deserialized = ComponentSerialization.CODEC
		.decode(JsonOps.INSTANCE, gson.fromJson(jsonString, JsonElement.class))
		.getOrThrow()
		.getFirst();

Text formatieren

Du bist vielleicht mit den Formatierungsstandards von Minecraft vertraut:

Du kannst diese Formatierungen mit Hilfe des Enum ChatFormatting auf die Klasse MutableComponent anwenden:

MutableComponent result = Component.literal("Hello World!")
  .withStyle(ChatFormatting.AQUA, ChatFormatting.BOLD, ChatFormatting.UNDERLINE);

Farbe	Name	Chat Code	MOTD Code	Hec Code
	Schwarz (black)	§0	\u00A70	#000000
	Dunkelblau (dark_blue)	§1	\u00A71	#0000AA
	Dunkengrün (dark_green)	§2	\u00A72	#00AA00
	Dunkles Aquamarin (dark_aqua)	§3	\u00A73	#00AAAA
	Dunkelrot (dark_red)	§4	\u00A74	#AA0000
	Dunkelviolett (dark_purple)	§5	\u00A75	#AA00AA
	Gold (gold)	§6	\u00A76	#FFAA00
	Grau (gray)	§7	\u00A77	#AAAAAA
	Dunkelgrau (dark_gray)	§8	\u00A78	#555555
	Blau (blue)	§9	\u00A79	#5555FF
	Grün (green)	§a	\u00A7a	#55FF55
	Aquamarin (aqua)	§b	\u00A7b	#55FFFF
	Rot (red)	§c	\u00A7c	#FF5555
	Hellviolett (light_purple)	§d	\u00A7d	#FF55FF
	Gelb (yellow)	§e	\u00A7e	#FFFF55
	Weiß (white)	§f	\u00A7f	#FFFFFF
	Zurücksetzen	§r
	Fett	§l
	Durchgestrichen	§m
	Unterstrichen	§n
	Kursiv	§o
	Verschleiert	§k