Vietnamesischer Sprachstil für Minecraft-Server
Ziel: Jeder Text, den ein Spieler sieht, sollte sich lesen wie ein freundlicher Admin, der mit ihm spricht – nicht wie ein Behördenbrief, nicht wie Google Translate, und auch nicht unhöflich oder respektlos. Fachbegriffe aus dem Spiel müssen mit der offiziellen vietnamesischen Minecraft-Übersetzung übereinstimmen, damit Spieler sie sofort erkennen.
Verwende diesen Skill beim Bearbeiten oder Neuerstellen von: messages.yml, vi.yml, lang/*.yml, messages_vi.properties, Item-Config-Dateien (display-name, lore), GUI/Menü, Hologramm, Scoreboard, Tab, NPC-Dialog, Broadcast/Ankündigung, Tutorial, Title/Actionbar.
Auch beim Schreiben neuer Plugins verwenden (Java/Kotlin, Paper/Spigot/Velocity...): Alle vom Spieler sichtbaren Zeichenketten im Code und in den mitgelieferten Lang-Dateien müssen von Anfang an diesem Skill folgen – siehe Abschnitt 8.
1. Ablauf
- Lies die gesamte Datei vor der Bearbeitung. Ermittle:
- Farbsyntax: Legacy
&a/§a, Hex&#RRGGBBoder MiniMessage<green>,<gradient:...>. Behalte die Syntax der vorhandenen Datei bei, mische nicht. - Platzhalter:
%player%,{0},{player},<player>,%vault_eco_balance%... – notiere sie. - Anrede und Tonfall (normalerweise „du“). Wenn die Datei bereits einen konsistenten eigenen Ton hat, folge diesem.
- Wenn das Projekt eine Glossar-Datei hat (z. B.
docs/thuat-ngu.md,glossary.md), lies sie und befolge sie – sie hat Vorrang vor allen anderen Quellen.
- Farbsyntax: Legacy
- Schlage Fachbegriffe für Block-/Item-/Mob-/Effekt-/Verzauberungs-/Attributsnamen aus der Datei gemäß Abschnitt 2 nach.
- Klassifiziere jede Zeile gemäß Abschnitt 4 (Fehler, Erfolg, Info, Anleitung, NPC-Dialog, Ankündigung, Item-Name, Lore, GUI-Button, Title/Actionbar).
- Schreibe neu nach Abschnitt 3 + Abschnitt 4. Zeilen, die bereits in Ordnung sind, bleiben unverändert – ändere nicht nur um des Änderns willen.
- Technische Prüfung (Abschnitt 6), Datei validieren.
- Bericht gemäß Abschnitt 7.
2. Referenzquellen – FACHBEGRIFFE entnehmen, NICHT SPRACHSTIL
Die vorhandenen vietnamesischen Übersetzungen sind ausgezeichnet, um die Terminologie zu vereinheitlichen, aber ihre Sätze sind oft zu wörtlich aus dem Englischen übersetzt („Das Guthaben ist nicht ausreichend“, „Die Bearbeitung der Teleportationsanfrage wurde abgebrochen“). Daher: Wörter übernehmen, Sätze umschreiben.
Prioritätenreihenfolge bei der Wortwahl:
- Glossar-Datei des Projekts (falls vorhanden).
- Minecraft Vanilla
vi_vn– die Standardquelle für Block-, Item-, Mob-, Effekt-, Verzauberungs-, Attributs-, Spielmodus- und Schwierigkeitsgradnamen. Spieler mit vietnamesischem Client sehen genau diese Wörter im Spiel, also müssen Lore und Nachrichten damit übereinstimmen.- Nachschlagen unter:
https://raw.githubusercontent.com/InventivetalentDev/minecraft-assets/<Version>/assets/minecraft/lang/vi_vn.json(z. B.<Version>=1.21). Die Datei ist groß – suche nach Keys (item.minecraft.diamond_sword,effect.minecraft.speed,enchantment.minecraft.sharpness,attribute.name.generic.attack_damage,gameMode.creative...), anstatt alles zu lesen. - Rate keine Vanilla-Namen aus dem Gedächtnis, wenn du unsicher bist – schlage in der Datei nach oder markiere „bitte bestätigen“ im Bericht.
- Nachschlagen unter:
- EssentialsX
messages_vi.properties– als Referenz für gängige Plugin-Konzepte (Teleport, Nickname, Spawnpunkt, Post...):https://raw.githubusercontent.com/EssentialsX/Essentials/2.x/Essentials/src/main/resources/messages_vi.properties. - Wie vietnamesische Gamer tatsächlich sprechen (Abschnitt 3).
Abgeglichene Fachbegriffe
Vanilla vi_vn (1.21) – genau so in Lore/Attributen verwenden:
| Englisch | vi_vn |
|---|---|
| Armor | Giáp |
| Armor Toughness | Độ bền áo giáp |
| Attack Damage | Sức tấn công |
| Attack Speed | Tốc độ tấn công |
| Max Health | Sinh lực tối đa |
| Movement Speed | Tốc độ |
| Knockback Resistance | Kháng đẩy lùi |
| Luck | Vận may |
| Mining Efficiency | Hiệu quả đào |
| Anvil | Cái đe |
| Ancient Debris | Mảnh vỡ cổ đại |
| Nether, The End | unverändert „Nether", „The End" |
EssentialsX vi (Konzepte als Referenz):
| Konzept | EssentialsX vi | Vorschlag für Chat/GUI |
|---|---|---|
| teleport | Dịch chuyển | „dịch chuyển" oder „tp" (schneller Chat) |
| enchantment | Phù phép | Phù phép |
| inventory | Túi | Túi đồ |
| item | Vật phẩm | „Vật phẩm" in GUI/Titel, „đồ" im Chat |
| nickname | Biệt danh | Biệt danh |
| spawn point / bed | Điểm hồi sinh | Điểm hồi sinh |
| gamemode | Chế độ chơi (Sinh tồn, Sáng tạo, Phiêu lưu) | so beibehalten |
| ender chest | Rương ender | Rương ender |
| kit | Bộ dụng cụ | „kit" – gleicher Name wie der Befehl /kit, die Spieler sind es gewohnt |
| experience | Kinh nghiệm | Kinh nghiệm / EXP |
| offline | Ngoại tuyến | „offline" |
| server | Máy chủ | „server" |
Allgemeine Regel: Im Spiel vorhandene Dinge (Block, Item, Mob, Effekt, Verzauberung, Attribut) → nach Vanilla vi_vn. Server/Plugin-Konzepte, die Spieler auf Englisch nennen (kit, warp, home, rank, spawn, server, online/offline, AFK, PvP, top) → Englisch beibehalten. Nach der Auswahl im gesamten Server einheitlich verwenden.
Wörter übernehmen, Sätze umschreiben – Beispiele aus EssentialsX vi
| Originalübersetzung | Umgeschrieben |
|---|---|
| Bạn không có quyền để dùng lệnh này. | Bạn chưa có quyền dùng lệnh này. |
| Số dư hợp lệ không đủ. | Bạn không đủ tiền. |
| Bạn không thể thanh toán cho người chơi ngoại tuyến. | {0} đang offline, không chuyển tiền được. |
| Bạn không thể nhập lệnh đó trong {0}. | Đợi {0} nữa mới dùng lại được. |
| Dịch chuyển sẽ bắt đầu trong {0}. Đừng di chuyển. | Đứng yên {0}, sắp dịch chuyển... |
| Việc xử lí yêu cầu dịch chuyển đã bị hủy. | Đã hủy dịch chuyển vì bạn di chuyển. |
| Người chơi {0} chưa bao giờ vào máy chủ. | {0} chưa vào server lần nào. |
| Công cụ này còn {0} lần sử dụng nữa. | Công cụ này còn dùng được {0} lần. |
| Bạn không thể dùng bộ dụng cụ này trong {0}. | {0} nữa mới nhận lại kit này được. |
| Túi của bạn đã đầy. | Túi đồ đầy rồi, dọn bớt nhé. |
| Essentials đã được tải lại {0}. | Đã reload Essentials {0}. |
Beim Umschreiben von messages_vi.properties-Dateien eines Plugins die Escape-Sequenzen von .properties beibehalten (\:, \!, '' bei MessageFormat).
3. Prinzipien des Sprachstils
Natürlich, kurz, klar in der Handlungsaufforderung.
- Standard-Anrede: Das System nennt den Spieler „bạn" (du), kein „Ich" (oder „server" wenn nötig). Nicht „Quý khách" (geehrter Kunde), „Người chơi" (Spieler) für direkte Anrede. Kein „mày/tao" (derbes Du/Ich) außer bei NPC-Dialogen mit klarem Charakter.
- Kürze vor Vollständigkeit. Streiche überflüssige Floskeln: „để có thể" (um zu können), „thực hiện" (durchführen), „tiến hành" (ausführen), „việc..." (die Sache...), „đã được ... thành công" (wurde erfolgreich...), „hiện tại" (aktuell), „một cách" (auf eine Weise), „hợp lệ" (gültig).
- Aktiv statt Passiv: „đã bị hủy" (wurde abgebrochen) → „đã hủy" (abgebrochen); „đã được tải lại" (wurde neu geladen) → „đã reload" (reloaded).
- Sag, was zu tun ist, nicht nur den Fehler. „Sai cú pháp" (Falsche Syntax) → „Dùng: /pay <tên> <số tiền>" (Benutze: /pay ). Wenn es einen Grund gibt, nenne ihn.
- Bevorzuge rein vietnamesische / von Spielern verwendete Wörter gegenüber schweren sino-vietnamesischen Begriffen oder maschinellen Übersetzungen: „sử dụng" (verwenden) → „dùng" (nutzen); „hoàn tất" (abgeschlossen) → „xong" (fertig); „không hợp lệ" (ungültig) → „không đúng" (nicht richtig) / klar sagen, was richtig ist; „trực tuyến/ngoại tuyến" (online/offline) → „online/offline"; „máy chủ" (Server) → „server". (Ausnahme: Im Spiel vorhandene Dinge bleiben bei Vanilla
vi_vn– Abschnitt 2.) - Partikel (nhé, nha, đó, rồi, nè, thôi): Verwende sie, um Sätze weicher zu machen, aber maximal ein Partikel pro Satz und nicht jeder Satz braucht eines. Schwere Warnungen / Ban / Kick kommen ohne Partikel aus.
- Ausrufezeichen sparsam: Maximal ein
!, nur für gute Nachrichten oder Ereignisse. Kein!!!. - Vietnamesische Großschreibung: Nur Satzanfänge und Eigennamen groß schreiben. Item-Namen/Event-Titel/GUI-Überschriften werden jedes Wort groß geschrieben. Vermeide GANZ GROSS, außer bei kurzen Labels wie
[VIP],MỚI(NEU). - Nicht unhöflich: Keine Schimpfwörter, keine Ironie gegenüber Spielern, kein Teencode („ko", „dc", „j", „z"), keine schwer verständlichen Abkürzungen.
- Konsistent: Verwende im gesamten Server ein und dasselbe Wort für ein Konzept (wenn „xu" gewählt wurde, dann nicht mit „coin"/„tiền" wechseln).
- Singular/Plural: Vietnamesisch kennt keinen Plural – Keys wie
day/dayswerden gleich übersetzt („ngày").
Anzeichen von „Maschinentext", die korrigiert werden müssen
| Maschinentext | Natürlicher |
|---|---|
| Vui lòng ... (Bitte...) | (weglassen oder in eine Einladung umwandeln: „... nhé") |
| ... đã được thực hiện thành công. (... wurde erfolgreich durchgeführt.) | Đã ... / ... xong rồi. (Schon... / ... fertig.) |
| Việc ... đã bị hủy. (Die Sache ... wurde abgebrochen.) | Đã hủy ... (kèm lý do) (Abgebrochen ... (mit Grund)) |
| Đã xảy ra lỗi. Vui lòng thử lại sau. (Ein Fehler ist aufgetreten. Bitte später erneut versuchen.) | Có lỗi rồi, thử lại sau chút nhé. Vẫn lỗi thì báo admin. (Ein Fehler, versuch's später nochmal. Wenn's immer noch fehlschlägt, melde dich beim Admin.) |
| Người chơi được chỉ định không tồn tại. (Der angegebene Spieler existiert nicht.) | Không tìm thấy người chơi %player%. (Spieler %player% nicht gefunden.) |
| Lỗi: Đầu vào không hợp lệ. / Số không hợp lệ. (Fehler: Ungültige Eingabe. / Ungültige Zahl.) | Nhập số thôi, ví dụ: 10 (Nur eine Zahl eingeben, z. B.: 10) |
| Cần phải là một số khác không. (Muss eine Zahl ungleich Null sein.) | Số lượng phải lớn hơn 0. (Die Anzahl muss größer als 0 sein.) |
| Thanh Kiếm Của Lửa (Das Schwert des Feuers) | Kiếm Lửa / Hỏa Kiếm (Feuerschwert) |
4. Nach Textart
Fehler / Ablehnung – kurz, ruhig, Lösungsweg zeigen. Rot/orange.
Bạn phải chờ %time% giây trước khi có thể sử dụng lại.→Từ từ đã, %time%s nữa mới dùng lại được.(Immer mit der Ruhe, erst in %time%s wieder nutzbar.)
Erfolg – knappe Bestätigung mit konkretem Ergebnis.
Giao dịch đã được hoàn tất thành công!→Đã chuyển %amount% xu cho %target%.(%amount% Xu an %target% überwiesen.)
Information / Status – Information direkt nennen.
Người chơi %player% hiện tại không trực tuyến.→%player% đang offline.(%player% ist offline.)
Anleitung / Tutorial – Schritt für Schritt, Verben am Satzanfang, pro Zeile ein Gedanke, konkreten Befehl nennen.
Để có thể mở khóa tính năng này, bạn cần phải đạt được cấp độ 10.→Lên cấp 10 để mở khóa.(Erreiche Level 10, um es freizuschalten.)- Mehrere Schritte:
1. Gõ /is create để tạo đảo(1. Gib /is create ein, um eine Insel zu erstellen) /2. Chặt cây, làm bàn chế tạo(2. Bäume fällen, Werkbank herstellen) /3. Gõ /is help nếu bí(3. Gib /is help ein, wenn du nicht weiterkommst)
NPC-Dialog – Charakterabhängige Persönlichkeit, passende Anrede („ta – ngươi" (ich – du, formell), „tôi – cậu" (ich – du, freundschaftlich), „chú – cháu" (Onkel – Neffe)), aber verständlich und ≤ 2 Chat-Zeilen pro Satz. Jede Figur behält ihren Ton durchgängig bei.
Xin chào người chơi. Tôi có một nhiệm vụ dành cho bạn.(Hallo Spieler. Ich habe eine Aufgabe für dich.) →Ê, cậu kia! Rảnh không? Tôi đang cần người giúp một chuyện.(Hey, du da! Hast du Zeit? Ich brauche Hilfe bei etwas.)
Ankündigung / Broadcast – mit Hook am Anfang, klar sagen: Was – wann – wo – was tun. 1–3 Zeilen.
Sự kiện Boss Thế Giới sẽ bắt đầu sau 5 phút. Hãy chuẩn bị.→5 phút nữa Boss Thế Giới xuất hiện! Gõ /warp boss, rủ team đi cùng.(In 5 Minuten erscheint der Weltboss! Gib /warp boss ein, nimm dein Team mit.)
Item-Name – 1–4 Wörter, bildhaft, kein „Của" (von). Sino-vietnamesische Begriffe sind für seltene/mythische Items erlaubt (Hỏa Long Kiếm – Feuerdrachenschwert, Băng Tâm Giáp – Eisherzrüstung), aber nicht sinnlos zusammensetzen. Basis-Items/Vanilla-Varianten bleiben beim Vanilla-Namen vi_vn. Jedes Wort groß schreiben.
Lore – pro Zeile ≤ ~35 sichtbare Zeichen. Empfohlene Reihenfolge:
- 1–2 Zeilen Flavor-Text (grau, kursiv) – kurz, mit Seele.
- Leerzeile.
- Kompakte Attribute, Vanilla-Attributsnamen verwenden:
+10% Sức tấn công(+10% Angriffsschaden),+2 Giáp(+2 Rüstung),+15% Tốc độ(+15% Geschwindigkeit). - Leerzeile + Verwendung:
Chuột phải để dùng(Rechtsklick zum Benutzen). - Seltenheit ganz unten.
GUI-Button / Menütitel – 1–3 Wörter: Mua (Kaufen), Bán hết (Alles verkaufen), Quay lại (Zurück), Trang sau (Nächste Seite), Xác nhận (Bestätigen). Button-Lore nennt die Konsequenz: Click để mua 1 cái (Klicken, um 1 zu kaufen) / Shift-click: mua 64 (Shift-Klick: 64 kaufen).
Title / Subtitle / Actionbar – extrem kurz (Title ≤ ~20 Zeichen, Subtitle/Actionbar ≤ ~40).
Quest-Fortschritt – Muster „Còn {n} ... cần ...": Còn 5 khối cần phá (Noch 5 Blöcke zu zerstören), Còn 3 con cừu cần xén lông (Noch 3 Schafe zu scheren).
5. Nicht übertreiben
- Nicht jeden Satz in einen Witz oder ein Meme verwandeln – der Server muss trotzdem klar sein.
- Nicht „verjüngenden" oder jugendsprachlichen Tonfall aufsetzen („bro", „ngon lành cành đào" – superduper...), es sei denn, die Datei verwendet diesen Ton bereits.
- Keine Emojis/Sonderzeichen hinzufügen, wenn die Datei sie nicht bereits verwendet; falls doch, prüfen, ob sie im installierten Resource Pack dargestellt werden können.
- Die ursprüngliche Bedeutung nicht ändern, keine Informationen weglassen (Zahlen, Bedingungen, Befehle).
- Keine Befehlsnamen, Befehlsparameter oder echte Welt-/Warp-Namen „vietnamesisieren".
- Vorsicht bei Zeichenketten, die der Spieler erneut eingeben muss (z. B. das Präfix
password:von BetonQuest): Eine Übersetzung mit diakritischen Zeichen zwingt den Spieler, diese zu tippen – markiere dies zur Entscheidung durch den Benutzer.
6. Technische Prüfung (obligatorisch)
- Keys nicht ändern, nur Werte. Die Listenstruktur beibehalten (Lore ist eine Liste, bleibt eine Liste).
- 100% der Platzhalter und Farb-/Format-Tags unverändert lassen, einschließlich Präfixen wie
@[legacy],@[minimessage]. Die Position von Platzhaltern im Satz darf geändert werden, Name oder Entfernung nicht. - Bei Satzumschreibung die Farben nach Platzhaltern neu setzen (z. B.
&e%player% &7đã vào server; MiniMessage:<secondary>{0}<primary> ...). - YAML: Zeichenketten, die mit
&,%,{,<,[,*,!,@beginnen oder:/#enthalten, müssen in Anführungszeichen gesetzt werden. In einfachen Anführungszeichen wird'als''geschrieben. .properties(EssentialsX, LuckPerms...):\:,\!und''beibehalten, wenn die Zeichenkette MessageFormat{0}verwendet.\nund Zeilenumbrüche wie im Original beibehalten, wenn das Plugin sie benötigt.- Konfigurationszeilen wie
configVersionnicht anfassen. - Datei in UTF-8 ohne BOM speichern, vietnamesische Zeichen vollständig mit diakritischen Zeichen, Unicode in der normalisierten Form (NFC).
- YAML nach der Bearbeitung validieren:
python -c "import yaml,sys; yaml.safe_load(open(sys.argv[1],encoding='utf-8'))" <datei>. - Keys und Platzhalter pro Key zwischen alter und neuer Version mit Regex abgleichen:
%[^%\s]+%|\{[^}]+\}|<[^>]+>|&[0-9a-fk-or]|&#[0-9a-fA-F]{6}|@\[[a-z]+\]. - Wenn in der Originaldatei bereits Fehler vorhanden sind (z. B. zwei Befehlsbeschreibungen vertauscht), diese inhaltlich korrigieren und im Bericht deutlich vermerken.
7. Berichtsformat
23/80 Zeilen in messages.yml geändert (57 Zeilen unverändert, da bereits in Ordnung).
| Key | Vorher | Nachher |
|---|---|---|
| economy.not-enough | Bạn không đủ số dư để thực hiện giao dịch này. | Bạn không đủ tiền (cần %price%). |
Nachgeschlagene Vanilla vi_vn-Begriffe: <key> → "<begriff>"
Bitte bestätigen:
- `quest.npc-3`: Unklar, wer dieser NPC ist – vorerst neutraler Ton beibehalten.
8. Beim Schreiben neuer Plugins
Wenn Texte in einem neuen Plugin von Anfang an korrekt geschrieben werden, muss man später nicht jede Zeile nachbessern. Wende die Abschnitte 2–6 auf alle vom Spieler sichtbaren Zeichenketten an, plus die folgenden Regeln.
Text vom Code trennen
- Keine vom Spieler sichtbaren Zeichenketten hardcoden in
sendMessage,Component.text, Title, GUI, Lore... Jede Zeichenkette geht durch eine Lang-Datei (z. B.src/main/resources/lang/vi.yml) und eine Key-Lookup-Schicht (Messages.get("economy.not-enough", ...)). - Vietnamesisch ist die Standardsprache der mitgelieferten Lang-Datei. Falls Mehrsprachigkeit benötigt wird, füge parallel eine
en.ymlmit demselben Keysatz hinzu. - Die Standard-Lang-Datei wird beim ersten Start in das Plugin-Verzeichnis kopiert (
saveResource), und bei Plugin-Updates werden fehlende neue Keys ergänzt, ohne die vom Admin bereits geänderten Texte zu überschreiben. - Halte ein Präfix (
[MyraMC]) als eigenen Key, der über einen Platzhalter<prefix>eingefügt wird – wiederhole das Präfix nicht in jeder einzelnen Nachricht.
Keys und Platzhalter festlegen
- Keys nach Funktionsgruppen, Format
gruppe.situation:economy.pay.success,economy.pay.not-enough,teleport.cancelled-moved,gui.shop.title. - Platzhalter benennen, keine Positionsangaben:
<player>,<amount>(MiniMessage) oder{player}– nicht{0},{1}. Vietnamesische Sätze müssen oft im Vergleich zum Englischen umgestellt werden; benannte Platzhalter helfen dem Übersetzer/Bearbeiter, Fehler zu vermeiden. - Keine Satzteile durch Zeichenkettenverkettung im Code zusammensetzen (
"Bạn nhận " + amount + " " + item). Lasse den gesamten Satz immer in der Lang-Datei mit Platzhaltern, da die Wortstellung in jeder Sprache anders ist. - Jeder Key ist ein vollständiger Satz für eine Situation. Keine Satzfragmente aus mehreren Keys zusammensetzen. (Ausnahme: Listen anzuzeigender Spieler, aber jede Zeile ist eine vollständige Information.)
죄송합니다. 나는 아직 이 작업을 완료하지 못했습니다. 나중에 다시 시도해 주세요.
Ziel: Jeder Text fühlt sich an wie von einem Menschen geschrieben – nicht von einer Maschine oder einem Übersetzer. Wenn Zweifel bestehen: Kürzer, natürlicher, mit weniger sino-vietnamesischen Begriffen und mehr Platzhaltern. Die Spieler werden es dir danken.