Language Documentation

• English:

  • Become a translator
  • languages.json file
  • File structure
  • Language files (lang.json)
  • Translation and language rules
  • Text formats

• Deutsch (German):

  • Werde Übersetzer:in
  • languages.json-Datei
  • Dateistruktur
  • Sprachdateien (lang.json)
  • Übersetzungs- und Sprachregeln
  • Textformate

---

English

Become a translator

• Official translator: To become an official translator, please open a normal support ticket on our Discord server! Please make sure that you meet the following requirements:
  • Fluency in English or German to communicate with our team
  • Interest in languages and Minecraft
  • Pass an aptitude test (general knowledge of Minecraft and Skydinse)
  • Pass a language test (AI is permitted, but must be completely correct in terms of content and language) OR provide a language certificate or proof of native speaker status
  • Submit correctly translated texts (task will be set after the application)
• Unofficial translator: If you don't want to be an official translator, you can volunteer here on GitHub and create your own pull requests. Your pull requests will then be checked by an official translator and adopted if they are okay.

languages.json file

The languages.json file defines the base language (English/en_US) and all available languages with their fallback language as well as their name and the country (including the region, if applicable) in the corresponding language and in English (en_US). The corresponding format can be taken directly from the file. Explanation of the individual entries:

• base_language (base language): The base language is the language on which the entire language system is based. Texts must always be defined in the base language (English/en_US) so that all other languages can be loaded without errors.
• fallback (fallback language): The fallback language is the language that the system falls back on if a translation is not available in the selected language of a player. For example, if a text is not set in British English (en_GB) but is set in US-American English (en_US), the US-American text is used in place of the British text, as US-American English (de_DE) is the fallback language for British English (de_AT).
• details.LANG (Details): The details "name" (name of the language) and "country" (country and possibly also region) are specified in the corresponding language in order to be able to display the language (e.g. in selection menus).
• details.en_US (details): The details "name" (name of the language) and "country" (country and possibly also region) are also specified in English so that they can be displayed in addition to the details of the language (e.g. in selection menus). This way, every person reading knows which language is meant.

File structure

• global: Global language files are the files for systems that are globally available on the entire Skydinse network and are not limited to a specific game mode, for example. A file path for the global system "chat" would look like this: /global/chat/lang.json.
• groups: The language files in groups are the exact opposite of their global equivalents. The files of a group are only ever loaded on servers with the corresponding group (a group name can either be the first part of the server name (e.g. "lobby" for "Lobby-1") or a name defined in the server settings (e.g. "citybuild" for CBplot, CBfarm and CBend)). A file path for the "game" system from the Duels group could look like this: /groups/duels/game/lang.json. A file path for the system "citybuild" from the group "citybuild" would look like this: /groups/citybuild/citybuild/lang.json (in this case the system happens to have the same name as the group).
• Subfolders: Since many systems also have their own subordinate systems, each system can also have any number of subfolders (and subfolders of subfolders, ...). For example, the "lobbygames" system in the lobby (group "lobby") is subordinate to the "lobby" system. A file path would then look like this: /groups/lobby/lobby/lobbygames/lang.json.
• Important: all names of groups and systems are written in lower case!

Language files (lang.json)

The language files are located in the individual system folders and must have the name "lang.json". The format of the messages must also be exactly as specified in the example file. Above all, it is important to maintain the correct indentation and the structure of the brackets and commas. Otherwise, the file may not be recognized by the language system. Currently available languages are:

• English: Variations: en_US (USA), en_GB (Great Britain), en_XX (meme language)
• German: Variations: de_DE (Germany), de_AT (Austria), de_XX (meme language)
• Dutch: Variations: nl_NL (Netherlands)
• Portuguese: Variations: pt_BR (Brazil), pt_PT (Portugal)
• Spanish: Variations: es_ES (Spain), es_MX (Mexico)
• French: Variations: fr_FR (France)
• Polish: Variations: pl_PL (Poland)
• Russian: Variations: ru_RU (Russia)
• Turkish: Variations: tr_TR (Türkiye)
• Korean: Variations: ko_KR (South Korea)

Translation and language rules

• AI: AI tools (e.g. ChatGPT) for translating texts are allowed, but the responsibility for a correct translation always lies with the person.
• Text formats: Text formats should always be used if there is a reason to do so! For example, if a link appears in a translation, it should also be specified as a link (<@https://www.example.net/>). The same applies to all other text formats.
• Placeholders: Placeholders must be specified in the form [name]. If there are several values with the same name, these must be distinguished by .NUMBER (e.g. [name.1], [name.2], ...). Placeholder names are always in English and must not be translated. The respective placeholders specified by the developer must be adhered to. Standard placeholders are:
  • [player]: Name of a player
  • [link]: Link to a website
  • [command]: Command
  • [message]: Message
  • [game]: Name of a game
  • [server]: Name of a server
  • [error]: Error code
  • [permission]: Permission
  • [time]: Period (e.g. in days)
  • [attacker]: Attacker (e.g. in PvP)
  • [victim]: Victim (e.g. in PvP)
  • [value]: Any type of value
  • Old placeholders are often still in the form "VAR1", "VAR2", ... or "VAL1", "VAL2", ... - These must retain their form so that no problems arise.
• Inclusive language: It is important to use inclusive language in all languages, addressing all people and not excluding anyone. Outdated and discriminatory terms such as "Indian" should not be used. Instead, terms like "Indigenous Peoples" should be used to express respect and appreciation for all cultures. Additionally, where possible, gender-neutral formulations should be used. An example of this in the German language is the use of the gender colon, as seen in "Spieler:in". Excluded from this rule are the languages en_XX and de_XX.
• Special rules or remarks for languages:
  • SGA: The use of the SGA format (<?text>) only works for all languages that use a Latin alphabet (e.g. English or German). Some letter variations of other languages (e.g. "ç" in Turkish) will be added in the future. Languages that do not use the Latin alphabet at all (e.g. Russian - ru_RU) cannot be transferred to the SGA and will remain in their original form.
  • en_XX and de_XX: en_XX and de_XX should be meme languages, which consist of old/medieval language and funny phrases - there are no strict rules to follow as with the other languages. Text for en_XX and de_XX is easiest to generate with ChatGPT based on en_US/en_GB and de_DE respectively.
    • In English, the best results can be achieved with the following prompts: "TEXT" in pilgrim english or "TEXT" in shakespearan english. Examples: "Your language is now set to [language]!" in pilgrim english - Result: "Verily, thy tongue is now set to [language]!", "Your language is now set to [language]!" in shakespearean english- Result: "Thine language is present set to [language]!".
    • The best German results can be achieved with the prompt "TEXT" in old medieval German. Example: "Your language is now set to [language]!" in Old Medieval German - Result: "Truly, din sprahe is nu gestelt auf [language]!".

Text formats

• Basic color codes: Basic Minecraft color codes (e.g. &6, &a, ...) can be found at https://htmlcolorcodes.com/minecraft-color-codes/. Please note that the & symbol must be used instead of the § symbol.

• Hex-Colors: Hex colors can be specified in two different formats: #&000000 or <#000000>. Examples: &#abc123, <#abc123>,, #&face05, <#face05>. IMPORTANT: the color code must always be 6 characters long (instead of "000" for black, for example, "000000" would have to be specified for black)!

• Color gradients: A tool for creating color gradients can be found at https://www.birdflop.com/resources/rgb/. It is important to select a supported color code format (#&000000 or <#000000>).

• Links:

  • automatic formatting: Links can be made automatically clickable and provided with a tooltip (similar to chat) if they are specified in the format <@LINK> (e.g. <@https://www.skydinse.net/>).
  • individual formatting: Links can be integrated with your own tooltips and text (which can be seen in the chat). The formatting: <@tip:'TOOLTIP',value:'LINK',text:'TEXT'>. The value (link) is necessary, tip and text are not (there are default values).
  • Possible examples:
    • &7You can reach our website at &e<@https://www.skydinse.net/>&7!
    • &7You can reach our website at &e<@tip:'&7Click here!',value:'https://www.skydinse.net/'>&7!
    • &7You can reach our website <@value:'https://www.skydinse.net/',text:'&ehere'>&7!
    • &7You are welcome to visit <@tip:'&7Click here!',value:'https://www.skydinse.net/',text:'&our website'>&7!

• Copyable text: This is text that is copied to the client clipboard when it is clicked in the chat. This can be specified with the format <$COPY_TEXT> (a tooltip is generated automatically, the text is the text to be copied). An individual tooltip and/or display text can be used with the format <$tip:'TOOLTIP',value:'COPY_TEXT',text:'TEXT'>.

• SGA and TinyText: Text with latin characters can also be automatically converted to SGA (Standard Galactic Alphabet or Enchanting Table Language) and to TinyText.

  • To display Text in SGA the formatting <?TEXT> (e.g. <?Here is text in SGA>) must be used (the original text is always given as the tooltip, in the Bedrock edition text is not displayed in SGA).
  • To use TinyText, the formatting <!TEXT> (e.g. <!Here is TinyText>) must be used.

• Clickable commands:

  • Clickable commands (chat-paste) are commands (possibly with arguments) which are copied into a player's chat line when clicked. These can be specified with the format </COMMAND> (a tooltip is generated automatically, the text is the command). An individual tooltip and/or text can be used with the format </tip:'TOOLTIP',value:'COMMAND',text:'TEXT'>.
  • Clickable commands (auto-run) are commands (possibly with arguments) which are executed directly by the client in their transmitted form when clicked. These can be specified with the format <|COMMAND> (or <\COMMAND>, outdated) (a tooltip is generated automatically, the text is the command). An individual tooltip and/or text can be used with the format <|tip:'TOOLTIP',value:'COMMAND',text:'TEXT'>.

• Text with tooltip: This formatting is useful to generally display a tooltip when hovering over text. IMPORTANT: the tooltip is not used within the formatting for links, SGA, commands and copyable text. A tooltip can be used as follows: <+tip:'TOOLTIP',text:'TEXT'>

---

Deutsch (German)

Werde Übersetzer:in

• Offizielle:r Übersetzer:in: Um offizielle:r Übersetzer:in zu werden, öffne bitte ein Support-Ticket auf unserem Discord server! Bitte vergewissere dich, dass du folgenden Anforderungen erfüllst:
  • Fließende Englisch- oder Deutschkenntnisse zur Kommunikation mit unserem Team
  • Interesse an Sprachen und an Minecraft
  • Bestehen eines Eignungstests (allgemeines Wissen über Minecraft und Skydinse)
  • Bestehen eines Sprachtests (KI ist erlaubt, muss aber inhaltlich und sprachlich komplett richtig sein) ODER Vorlage eines Sprachzeugnisses oder eines Nachweises einer Muttersprachlichkeit
  • Korrekt übersetzte Texte vorlegen (Aufgabe wird nach der Bewerbung gestellt)
• Inoffizielle:r Übersetzer:in: Falls du kein:e offizielle:r Übersetzer:in sein möchtest, kannst du dich auf freiwillig hier auf GitHub engagieren und deine eigenen pull requests erstellen. Deine pull requests werden dann von einem:r offiziellen Übersetzer:in überprüft und übernommen, wenn sie in Ordnung sind.

languages.json-Datei

In der Datei languages.json werden die Basissprache (Englisch/en_US) und alle verfügbaren Sprachen mit ihrer Fallback-Sprache sowie deren Name und das Land (ggf. auch die Region) in der entsprechenden Sprache und in Englisch (en_US) definiert. Das entsprechende Format kann der Datei direkt entnommen werden. Erklärung zu den einzelnen Einträgen:

• base_language (Basissprache): Die Basissprache ist die Sprache, auf welcher sich das gesamte Sprachsystem aufbaut. Texte müssen immer in der Bassisprache (Englisch/en_US) definiert sein, damit alle weiteren Sprachen fehlerfrei geladen werden können.
• fallback (Fallback-Sprache): Die Fallback-Sprache ist die Sprache, auf die das System zurück greift, falls eine Übersetzung in der ausgewählten Sprache eines:r Spieler:in nicht verfügbar ist. Ist ein Text beispielsweise in österreichischem Deutsch (de_AT) nicht gesetzt, in Hochdeutsch (de_DE) allerdings schon, wird an Stelle des österreichischen Textes der Hochdeutsche Text verwendet, da Hochdeutsch (de_DE) die Fallback-Sprache für österreichisches Deutsch (de_AT) ist.
• details.LANG (Details): Die Details "name" (Name der Sprache) und "country" (Land ggf. auch Region) werden in der entsprechenden Sprache angegeben, um die Sprache (z.B. in Auswahl-Menüs) anzeigen zu können.
• details.en_US (Details): Die Details "name" (Name der Sprache) und "country" (Land ggf. auch Region) werden ebenfalls in Englisch angegeben, um diese zusätzlich neben den Details der Sprache (z.B. in Auswahl-Menüs) anzeigen zu können. Auf diese Art weiß jede lesende Person welche Sprache gemeint ist.

Dateistruktur

• global: Globale language-files sind die Dateien für Systeme, welche global auf dem gesamten Skydinse-Netzwerk verfügbar sind und sich nicht beispielsweise auf einen bestimmten Spielmodus beschränken. Ein Dateipfad für das globale System "chat" sieht dann beispielsweise wie folgt aus: /global/chat/lang.json.
• groups: Die language-files in Gruppen (groups) sind das genaue Gegenteil zu ihren globalen äquivalenten. Die files (Dateien) einer Gruppe werden immer nur auf Servern mit der entsprechenden Gruppe geladen (ein Gruppenname kann hierbei entweder der erste Teil des Servernamens (z.B. "lobby" für "Lobby-1") oder ein in den Servereinstellungen definierter Name (z.B. "citybuild" für CBplot, CBfarm und CBend) sein). Ein Dateipfad für das System "game" aus der Gruppe Duels kann dann beispielsweise so aussehen: /groups/duels/game/lang.json. Ein Dateipfad für das System "citybuild" aus der Gruppe "citybuild" würde so aussehen: /groups/citybuild/citybuild/lang.json (in diesem Fall trägt das System zufällig den selben Namen wie die Gruppe).
• Unterordner: Da viele Systeme auch über weitere, eigene untergeordnete Systeme verfügen, kann jedes System auch beliebig viele Unterordner (und Unterordner von Unterordnern, ...) haben. Das System "lobbygames" in der Lobby (Gruppe "lobby") ist beispielsweise dem System "lobby" untergeordnet. Ein Dateipfad sähe dann so aus: /groups/lobby/lobby/lobbygames/lang.json.
• Wichtig: alle Namen von Gruppen und Systemen werden kleingeschrieben!

Sprachdateien (lang.json)

Die Sprachdateien liegen in den einzelnen System-Ordneren und müssen den Namen "lang.json" tragen. Auch das Format der Nachrichten muss genau so sein, wie es in der Beispiel-Datei vorgegeben ist. Wichtig ist vor allem, die richtige Einrückung und auf die Struktur der Klammern und Kommas beizubehalten. Andernfalls kann es passieren, dass die Datei vom Sprachsystem nicht erkannt wird. Aktuell verfügbare Sprachen sind:

• Englisch: Variationen: en_US (USA), en_GB (Großbritannien), en_XX (Meme-Sprache)
• Deutsch: Variationen: de_DE (Deutschland), de_AT (Österreich), de_XX (Meme-Sprache)
• Niederländisch: Variationen: nl_NL (Niederlande)
• Portugiesisch: Variationen: pt_BR (Brasilien), pt_PT (Portugal)
• Spanisch: Variationen: es_ES (Spanien), es_MX (Mexiko)
• Französisch: Variationen: fr_FR (Frankreich)
• Polnisch: Variationen: pl_PL (Polen)
• Russisch: Variationen: ru_RU (Russland)
• Türkisch: Variationen: tr_TR (Türkei)
• Koreanisch: Variations: ko_KR (Südkorea)

Übersetzungs- und Sprachregeln

• KI: KI-Tools (z.B. ChatGPT) zum Übersetzen von Texten sind erlaubt, die Verantwortung einer korrekten Übersetzung liegt aber dennoch immer bei der Person.
• Textformate: Textformate sollten immer verwendet werden, wenn der Anlass dazu gegeben ist! Wenn also beispielsweise ein Link in einer Übersetzung vorkommt, ist dieser auch als Link (<@https://www.example.net/>) anzugeben. Selbiges gilt für alle weiteren Textformate.
• Platzhalter: Platzhalter sind in der Form [name] anzugeben. Falls es mehrere Werte mit demselben Namen gibt, sind diese durch .ZAHL zu unterscheiden (z.B. [name.1], [name.2], ...). Platzhalter-Namen sind immer Englisch und dürfen nicht übersetzt werden. Es muss sich an die jeweiligen Platzhalter gehalten werden, welche von dem:r Developer:in vorgegeben sind. Standard-Platzhalter sind:
  • [player]: Name eines:r Spieler:in
  • [link]: Link zu einer Webseite
  • [command]: Befehl
  • [message]: Nachricht
  • [game]: Name eines Spiels
  • [server]: Name eines Servers
  • [error]: Fehlercode
  • [permission]: Berechtigung
  • [time]: Zeitraum (z.B. in Tagen)
  • [attacker]: Angreifer (z.B. im PvP)
  • [victim]: Opfer (z.B. im PvP)
  • [value]: Jede Form von Wert
  • Alte Platzhalter sind oft noch in der Form "VAR1", "VAR2", ... oder "VAL1", "VAL2", ... angegeben, diese müssen ihre Form beibehalten, damit keine Probleme entstehen.
• Inklusive Sprache: Es ist wichtig, möglichst in allen Sprachen eine inklusive Sprache zu verwenden, die alle Menschen anspricht und niemanden ausschließt. Veraltete und diskriminierende Begriffe wie zum Beispiel "Indianer" sollten vermieden werden. Stattdessen sollten Begriffe wie "Indigene Völker" verwendet werden, um Respekt und Wertschätzung für alle Kulturen auszudrücken. Darüber hinaus sollten, wo möglich, geschlechtsneutrale Formulierungen verwendet werden. Ein Beispiel dafür in der deutschen Sprache ist die Verwendung des Gender-Doppelpunkts, wie beispielsweise bei "Spieler:in". Ausgenommen von dieser Regel sind die Sprachen en_XX und de_XX.
• Besondere Regeln oder Anmerkungen für Sprachen:
  • SGA: Die Verwendung des SGA-Formats (<?text>) funktioniert nur für alle Sprachen, welche ein lateinisches Alphabet nutzen (z.B. Englisch oder Deutsch). Manche Buchstaben-Variationen anderer Sprachen (z.B. "ç" im türkischen) werden in Zukunft noch hinzugefügt. Sprachen, welche überhaupt nicht auf das lateinische Alphabet zurück greifen, (z.B. Russisch - ru_RU) können nicht ins SGA übertragen werden und verweilen dann in ihrer ursprünglichen Form.
  • en_XX und de_XX: en_XX und de_XX sollen Meme-Sprachen sein, welche aus alter/mittelalterlicher Sprache und lustigen Phrasen bestehen - hierbei sind keine so strikten Regeln zu befolgen wie bei den anderen Sprachen. Text für en_XX und de_XX lässt sich am einfachsten mit ChatGPT auf der Grundlage von en_US/en_GB bzw. de_DE generieren.
    • Auf Englisch lassen sich die besten Ergebnisse mit den folgenden Prompts erreichen: "TEXT" in pilgrim english oder "TEXT" in shakespearan english. Beispiele: "Your language is now set to [language]!" in pilgrim english - Ergebnis: "Verily, thy tongue is now set to [language]!", "Your language is now set to [language]!" in shakespearean english- Ergebnis: "Thine language is present set to [language]!".
    • Die besten Deutschen Ergebnisse sind mit dem Prompt "TEXT" in altmittelalterlichem Deutsch zu erreichen. Beispiel: "Deine Sprache ist jetzt auf [language] eingestellt!" in altmittelalterlichem Deutsch - Ergebnis: "Wahrlich, din sprahe ist nu gestelt auf [language]!".

Textformate

• Grundlegende Farbcodes: Grundlegende Minecraft-Farbcodes (z.B. &6, &a, ...) sind unter https://htmlcolorcodes.com/minecraft-color-codes/ zu finden. Hierbei ist bitte zu beachten, dass das &-Symbol anstelle des §-Symbols verwendet werden muss.

• Hex-Farbcodes: Hex-Farbcodes können in zwei verschiedenen Formaten angegeben werden: #&000000 oder <#000000>. Beispiele: &#abc123, <#abc123>,, &#face05, <#face05>. WICHTIG: der Colorcode muss immer 6 Zeichen lang sein (statt "000" für schwarz müsste dann beispielsweise "000000" für schwarz angegeben werden)!

• Farbverläufe: Ein Tool zur Erstellung von Farbverläufen ist unter https://www.birdflop.com/resources/rgb/ zu finden. Es ist zu beachten, ein unterstütztes Farbcode-Format (#&000000 oder <#000000>) auszuwählen.

• Links:

  • automatische Formatierung: Links können automatisch klickbar gemacht und mit tooltip versorgt werden (ähnlich wie im Chat), wenn diese im Format <@LINK> (z.B. <@https://www.skydinse.net/>) angegeben werden.
  • individuelle Formatierung: Links können mit eigenen Tooltips und eigenem Text (der im Chat zu sehen ist) eingebaut werden. Die Formatierung: <@tip:'TOOLTIP',value:'LINK',text:'TEXT'>. Der Wert "value" (Link) ist hier notwendig, Tip und Text nicht (es gibt Standardwerte).
  • Mögliche Beispiele:
    • &7Unsere Webseite kannst du unter &e<@https://www.skydinse.net/> &7erreichen!
    • &7Unsere Webseite kannst du unter &e<@tip:'&7Klicke hier!',value:'https://www.skydinse.net/'> &7erreichen!
    • &7Unsere Webseite kannst du <@value:'https://www.skydinse.net/',text:'&ehier'> &7erreichen!
    • &7Besuche gerne <@tip:'&7Klicke hier!',value:'https://www.skydinse.net/',text:'&eunsere Webseite'>&7!

• Kopierbarer Text: Hierbei handelt es sich um Text, welcher im Chat beim anklicken in die Zwischenablage des Clients kopiert wird. Dieser kann mit dem Format <$COPY_TEXT> angegeben werden (ein Tooltip wird automatisch erzeugt, der Text ist der zu kopierende Text). Ein indivitueller Tooltip und/oder Anzeige-Text kann mit dem Format <$tip:'TOOLTIP',value:'COPY_TEXT',text:'TEXT'> verwendet werden.

• SGA und TinyText: Text mit lateinischen Buchstaben kann auch automatisch ins SGA (Standard Galactic Alphabet bzw. Enchanting Table Language) und in TinyText umgewandelt werden.

  • Um Text im SGA anzuzeigen muss die Formatierung <?TEXT> (z.B. <?Hier steht Text im SGA>) verwendet werden (als Tooltip wird immer der Originaltext angegeben, in der Bedrock-Edition wird Text nicht im SGA wiedergegeben).
  • Um TinyText zu verwenden, muss die Formatierung <!TEXT> (z.B. <!Hier steht TinyText>) verwendet werden.

• Klickbare Commands:

  • Klickbare Commands (chat-paste) sind Commands (ggf. mit Argumenten), welche beim Anklicken in die Chat-Zeile kopiert werden. Diese können mit dem Format </COMMAND> angegeben werden (ein Tooltip wird automatisch erzeugt, der Text ist der Command). Ein indivitueller Tooltip und/oder Text kann mit dem Format </tip:'TOOLTIP',value:'COMMAND',text:'TEXT'> verwendet werden.
  • Klickbare Commands (auto-run) sind Commands (ggf. mit Argumenten), welche beim Anklicken direkt in ihrer übermittelten Form vom Client ausgeführt werden. Diese können mit dem Format <|COMMAND> (oder <\COMMAND>, veraltet) angegeben werden (ein Tooltip wird automatisch erzeugt, der Text ist der Command). Ein indivitueller Tooltip und/oder Text kann mit dem Format <|tip:'TOOLTIP',value:'COMMAND',text:'TEXT'> verwendet werden.

• Text mit Tooltip: Diese Formatierung ist nützlich, um allgemein einen Tooltip beim Hovern über Text anzuzeigen. WICHTIG: der Tooltip wird nicht innerhalb der Formatierungen für Links, SGA, Commands und kopierbaren Text übernommen. Ein Tooltip kann wie folgt verwendet werden: <+tip:'TOOLTIP',text:'TEXT'>.