<aside> 📃 TABLE OF CONTENTS

• Overview

Payment and IP

Find Available Slots and Earnings Projections Here

Submitting Slot Selections

• Content Specifications

• Technical Specifications

  • Concepts

    Start Game

    Language + Translation

  • Unity

    Example Project

  Testing

Game Design Document (GDD)

Timeline Overview

Eligibility to Take More Slots

Quarterly Game Marketplace Review

Tutorial Videos

3rd-party IP Licenses

Additional Resources

FAQ

</aside>

Legends of Learning users may speak multiple languages, and we require games to be multilingual.

This means:

1. Storing game text in a separate data file (JSON) and uploading it during game submission.
2. Subscribing and receiving a language payload during game initialization.

Important: Language selection will happen outside the game, via teacher or student settings. A game needs to handle multiple languages, but only one language will be passed in at a time.

In the StartGame payload, the language is specified. Use this to select a font.

{"languageCode": "en"}

The language payload contains keys and values for a single language. Each language must have an identical corresponding key name, and each key must have a name.

{"welcome": "myText"}

For development, you can use a multi-language file like this. Use the languageCode key from your StartGame handler to call the LanguageDefsReceived with the key, in pseudocode:

language[startKey]['languageCode'].

Unity developers can reference the Example Project's Loader.cs for more examples.

{
  "_meta": {
    "maxChars": {
       "welcome": 50
     }
   },
   "en": {
     "welcome": "Welcome"
   }, 
   "es": {
     "welcome": "Bienvenido"
   }
 }

This file is also used in game upload. The minimum required keys are:

• _meta with maxChars key/value for each language key
  • Important note: it's normal for the "_meta" section of language.json to be missing from the edited version of the file, i.e., the version of the file that you receive from the content review. Make sure you re-add this key if it is missing.
• en: English
• Optional (your native language from the list below): The translation will be added to any accepted game by our translators, usually within 1 week after approval. When this happens, you will be notified by email, and you can download the new JSON from the developer portal for submitting updates. You can find the list of supported languages and their codes below:

Testing and Quality Assurance

• Character Rendering: Please test your games to verify that all languages render correctly and that no unsupported characters appear.
• Text Overflow: Check your games to ensure the phrases do not overflow the allocated text boxes.

Here are some examples of games with rendering issues:

{
//Incorrect structure, wont play TTS
    "en": {
        "FullTutuorial": {
            "0": "Welcome",
            "1": "This is the tutorial", 
            }
// Correctly structured version, will play TTS
    "en": {
        "FullTutorial_0":"Welcome to the game!",
        "FullTutorial_1":"This is the tutorial",
        }
}

• The text used in the game should be taken from the language JSON file so that it can be translated and edited by reviewers.
• It is highly recommended that developers test text in different languages in their games to verify font and UI compatibility. I.e., check that special characters like accents and tildes render properly, and that translated text fits within your defined text areas. This can be done in the Test Harness.
• Please be careful with any placeholder text that you use for testing. If that placeholder text is kept in the game build files, and there's an error where the game doesn't properly replace the placeholder text with the correct values in the language JSON, it can be a problem for students. Any inappropriate text content, whether displayed accidentally or not, will result in an immediate ban of the studio's games on the platform.

Downloading Edited JSON File from LoL reviewers

If you download a language.json from legends and need the key order fix, use this tool locally with your source language.json file.

Locally host this from the directory you have the json-order.html file:

json-order.html

python3 -m http.server http://localhost:8000/json-order.html

Select your source language.json (your key order from your project) the target, the one downloaded from legends (with or without translation, may contain grammar, spelling, smart quote fixes)

It will reorder the legends json and save.