Angepasstes Chatnachrichtenformat

Mit dem angepassten Chatnachrichtenformat kann das Format von Chatnachrichten in Datenpaketen angepasst werden.

Herkunft[]

minecraft.jar: Das originale Chatnachrichtenformat stehen in minecraft.jar.
- data: Die Standard-Weltdaten.
  - minecraft: Die Minecraft-Standard-Weltdaten.
    - chat_type: Die Chatnachrichtenformate.
      - chat.json: Das Chatnachrichtenformat für normale Chatnachrichten.
      - emote_command.json: Das Chatnachrichtenformat für Chatnachrichten vom Befehl /me.
      - msg_command_incomming.json: Das Chatnachrichtenformat für ankommende Chatnachrichten vom Befehl /msg.
      - msg_command_incomming.json: Das Chatnachrichtenformat für abgesendete Chatnachrichten vom Befehl /msg.
      - say_command.json: Das Chatnachrichtenformat für Chatnachrichten vom Befehl /say.
      - team_msg_command_incomming.json: Das Chatnachrichtenformat für ankommende Chatnachrichten vom Befehl /teammsg.
      - teammsg_command_outgoing.json: Das Chatnachrichtenformat für ankommende Chatnachrichten vom Befehl /teammsg.

Funktionsweise[]

Mit dem Chatnachrichtenformat lassen sich die angezeigten Chatnachrichten im Chat sowie der Text der Sprachausgabe anpassen. Dazu gibt man die Beschriftungsvariable einer Übersetzung sowie die Reihenfolge an, in der der Absender, die Nachricht und gegebenenfalls das Team in die Platzhalter der Übersetzung eingesetzt werden sollen. Aufgrund der Tatsache, dass für das angepasste Chatnachrichtenformat Übersetzungen verwendet werden, müssen die Clients ein passendes Ressourcenpaket mit der zugehörigen Übersetzung installiert haben, wenn man Chatnachrichten modifiziert, weil es in der Regel keinen Sinn macht, eine bestehende Übersetzung zu nehmen.

Wenn man das angepasste Chatnachrichtenformat während des Spiels verändert, müssen alle Clients das Spiel neu betreten, damit die Änderung bei ihnen Wirkung zeigt.

Änderbarkeit[]

Die Original-Chatformatdaten gehören zu den Standard-Weltdaten und werden mit Datenpaketen geändert.

Die Chatformatdaten haben den Dateityp .json (JavaScript Object Notation), sind aber ganz normale Textdateien, die mit jedem Texteditor gelesen und verändert werden können.

Um ein Chatformat zu ändern, platziert man die entsprechende Datei mit dem richtigen Namen im richtigen Ordner. Das bedeutet, man muss nicht alle Chatformatdaten kopieren, sondern nur die, die man verändert hat. Im Minimalfall ist das nur eine einzige Datei. Beispiel:

.minecraft/saves/Name des Weltordners/datapacks/Name des Datenpakets/data/minecraft/chat_types/chat.json

Nach dem nächsten Spielstart werden die geänderten Chatformatdaten angewendet. Im Beispiel ändert sich das Format für normale Chatnachrichten.

Das Hinzufügen neuer Chatformatdaten ist nicht möglich, da im Spiel keine neuen Arten von Chatnachrichten hinzugefügt werde können, für die das neue Chatnachrichtenformat anwendbar wäre.

Datenstruktur[]

Grundstruktur[]

Die namenlose Haupteigenschaft.
- chat: Die Chatformatdaten des Chats.
- narrator: Die Chatformatdaten der Sprachausgabe.

Chatformatdatenstruktur[]

- parameters: Die Platzhalter für die Übersetzung in der gewünschten Reinfolge. Möglich sind:
  • sender für den Absender der Nachricht,
  • content für die vom Absender geschriebene Nachricht und
  • target für den Teamnamen beim Befehl /teammsg
- translation_key: Die Beschriftungsvariable der Übersetzung.

Beispiel[]

Die Datei chat.json für normale Chatnachrichten sieht so aus:

{
"chat": {
  "parameters": [
    "sender",
    "content"
  ],
  "translation_key": "chat.type.text"
},
"narration": {
  "parameters": [
    "sender",
    "content"
  ],
  "translation_key": "chat.type.text.narrate"
}

Für den angezeigten Chat lautet die Beschriftungsvariable für die Übersetzung "chat.type.text", die als Inhalt "<%s> %s" hat. "%s" sind dabei die Platzhalter. Da "parameters" als ersten Eintrag "sender" und als zweiten "content" hat, wird in den ersten Platzhalter der Absendername und in den zweiten der von ihm geschriebene Text eingesetzt. Schreibt oyo123 also "Hallo!" in den Chat, sieht das so aus: <oyo123> Hallo!
Für die Sprachausgabe lautet die Beschriftungsvariable "chat.type.text.narrate", die "%s sagt %s" als Inhalt hat. Auch hier wird als erster Platzhalter der Absender und als zweiter die Nachricht eingetragen, sodass die Sprachausgabe beim obigen Beispiel "oyo123 sagt Hallo!" sagt.

Geschichte[]

Versionsgeschichte der Java Edition

Vollversion 1.19.3 (22w42a)	Angepasstes Chatnachrichtenformat hinzugefügt.