Language Modding

By packaging your levels, campaigns, or mods alongside language files, you have the ability to not only introduce new phrases into existing languages but also incorporate entirely new languages into your content.

 
 
 

Klingon.json

{
  "type" : "language",
  "name" : "Klingon",
  "code" : "kling",
  "nativeName" : "TlhIngan",
  "keys" : [
    { "Success" :  "Qapla'" },
    { "Insult" :  "petaQ"},
    { "MainMenu/Quit" :  "jegh'a'" }
  ]
}

English.json

{
  "type" : "language",
  "name" : "English",
  "code" : "en",
  "nativeName" : "English",
  "keys" : [
    { "Success" :  "Success'" },
    { "Insult" :  "You nit!"},
    { "MainMenu/Quit" :  "Quit" }
  ]
}
 
 

 
Here are two examples of languages files where the same three phrases have been translated into Klingon and English. The keys (e.g “Success”, “Insult” or “MainMenu/Quit” can now be used throughout the game in places like the map editor.

Klingon is a completely new language and will be added to the list of available languages in the options menu. English on the other hand is a pre-existing language and will simply add the new phrases.

Language files can be named anything as long as they have the .json file ending and contain "type" : "language"

 
 

Replacement keys & tags

This system allows dynamic customization of messages and dialogues based on the interacting wielder. By using replacement keys and tags, entire lines or parts of them can be tailored specifically to the wielder.

Tags

Utilize these tags in messages and dialogues:

  • {wielder-name}: Replaces with the Wielder's full name (e.g., “Vilja of Thornecliffe”).

  • {wielder-short-name}: Replaces with the Wielder's nickname or short name (e.g., “Vilja”).

  • {wielder-title}: Replaces with the Wielder's title (e.g., “Warden”).

  • {wielder-race}: Replaces with the Wielder's race (e.g., “Human”, “Undead”, “Faey”).

  • {wielder-faction}: Replaces with the Wielder's faction (e.g., “Arleon”, “Rana”).

Example Usage

Here's how these tags work in different scenarios:

Welcome {wielder-title} {wielder-short-name} of {wielder-faction}. I’ve been expecting you.

For Vilja of Thornecliff the text would look like this:

“Welcome Warden Vilja of Arleon. I’ve been expecting you”.

And for Rasc the First Rider it would look like this:

“Welcome Raider Rasc of Rana. I’ve been expecting you.”

Suffix-Keys

Use suffix-keys to create entirely distinct texts for different wielders.

Example Usage

{
  "type" : "language",
  "name" : "English",
  "code" : "en",
  "nativeName" : "English",
  "keys" : [
    { "MyKey" :  "This is the default text'" },
    { "MyKey/ViljaOfThornecliff" :  "This text will only be displayed for Vilja"},
    { "MyKey/Rasc" :  "This text will only be displayed for Rasc because he's the coolest!" }
  ]
}

In this scenario, we demonstrate the use of two suffix-keys designed for the characters Vilja and Rasc. When a message or dialogue is set up with a default key labeled “MyKey”, the system will automatically select the appropriate key for Vilja or Rasc, should either be the interacting wielder.

 

Formatting Tags

It’s possible to add certain tags to format your text. Simply wrap your text inside tags. e.g <hl>some text</hl>

  • <hl> - will highlight your text in orange

  • <positive> - will highlight your text in green, indicating something positive

  • <negative> - will highlight your text in red, indicating something negative

  • <arcana>, <chaos>, <creation>, <destruction>, <order> - will add an icon depending on the given essence

  • <amber>, <celestial>, <glimmer>, <gold>, <stone>, <wood> - will add an icon depending on the given resource

  • <note> will add a musical note before your text

  • <quote> - will add quotes around your text

  • <uppercase> - will write your text in ALL CAPS

  • <lowercase> - will write your text in lower case with no caps

  • <monospace> - will write your text with monospace spacing between letters

  • <outlined> - will write your text outlines

  • <shadowed> - will write your text shadowed

  • <i> - will make your text italic

  • <b> - will make your text bold

  • <br> - will add a line break to your text

 

Language Browser

The map editor comes with a language browser that can be used to search for specific language keys