Game Content Creation Guide


mLevel Mission Manager incorporates a new approach to managing training content.  Focusing on collecting content in a structured but flexible knowledge base, which will produce questions and answers that can work in all mLevel games.  The goal is to build knowledge bases with focused content that cover your learning objectives, and can be modified easily at a moments notice.  The analytics data is also driven off of these topics.  A Mission can be created with one topic or multiple topics.

This Guide

This document details the different elements of mLevel content and how Question Templates produce a pool of questions. Additionally, an Excel Document is attached to this article that shows several mLevel content examples.  Once your content is ready to be uploaded, save it as a .csv and directly upload it into the Mission Manager.  

For additional assistance, please contact your mLevel Account Manager or email  An hour training session should be scheduled in addition to this article.

Preparing Your Topic

Topic - A set of focused information for learning and is used to group similar content. Some examples of topics include product lines, company employees, and IT applications. Anything that consists of several examples that can be compared via attributes will make a good topic. In our topic structure to the top left cell is where we type in our Topic. In the below example the topic is "Smartphone"

Items - Items are examples of your Topic. The far left column, in green below are our items or different Smartphones.

Attributes - The qualities or properties of your items. Attributes answer the question "How are you describing your items?". Below we would ask what do we want our players to know about the different smartphones. Some characteristics or attributes include : battery, camera feature, color, display type

Values - The intersection of Items and Attributes. A Value is the true characteristic (attribute) of a certain item. Example: The iPhone 5 (Item) has a screen resolution (Attribute) of 1136 x 640 (Fact). It's okay if you have blank Value cells in your Topic. Items can also contain multiple values per cell. Separate multiple Values using pipe delimitation. The pipe symbol is found on the same key as your backslash. Ex; Camera Feature of the iPhone 5

A Mission can be built with one topic or by combining multiple topics.  See the below example of how Items, Attributes, and Values are used within a Topic:



Defining Question Templates

Once you have your Topic content setup, it's time to create your question templates. mLevel uses question templates to define the format and structure of each question presented in the games - they produce a pool of data that the Activities use.  Question templates contain the following:

  1. The question script, including both static (i.e. manually written) and dynamic (i.e. retrieved from content) parts of the question.
  2. A question template can leverage {{topic}}, {{attribute}}, {{item}} and {{value}}.  The minimum needed are either {{item}} or {{value}}.
  3. mLevel uses question templates to produce Multiple Choice questions and True False statements.

Below is an example of an actual question generated from a question template.  Notice how the dynamic content - the name of  the topic (Smartphone), the Attribute (battery), and the value (1800 mAh) - is incorporated within the static text starting with "Which" and "has a".  Depending on what data is loaded to produce a question, mLevel will know which Item(s) are correct and use the other items randomly as wrong answers.



You can determine what your answer is made of by evaluating what elements you've included in your Question Template.

If you include a Value in your Question Template, then Item would be set as the answer. Vice versa... if Item is included in your Question Template, then Value would be set as the Answer. 

Putting Questions and Content Together


Best Practices

  • Keep in mind you do not have to use the Topic or Attribute in the Question Template.
  • Items, Attributes, and Topic names must be less than 80 characters, including spaces.
  • We suggest Values are < 50 characters as well, however this not required.
  • .We suggest having 6 unique Values per Attribute (column).
  • Wrong answers or Values can be added in the very bottom row.
  • We suggest maintaining the same verb tenses and capitalization throughout the document.
  • Wrong answers (or distractors) pull from other correct values within the same column.  Make sure logical values are grouped together.
  • Where values are relevant for multiple items, word them identically and they will not be leveraged as distractors.
  • If a value needs to be explicitly excluded for a question/item combo, that value can be excluded when building the question in Mission Manager. 

How Much Content is Required?

The amount of content created for each topic is part science and little a bit of art. At a high level, there needs to be enough content to generate a random set of enough questions for the game type being played, while not too much content that players never see a repeat game question. Once you begin uploading in Mission Manager minimum questions needed will be communicated to you. You can find an overview of the various mLevel activities here: Overview of Activities

Steps To Create mLevel Content

  1. Define the topic - Topics should be focused around things that have similar and comparable properties. Smartphones have specifications and features, people have biographical information, financial products have rates and fees and charges, etc. Avoid broad topics. Also you can have more than one topic per mission. Don’t feel like you need to get everything to fit into one document.
  2. Define examples of the topic (i.e. the items) - For more concrete topics this should be straightforward: For Example, Smartphones include the iPhone 5, Galaxy S III, etc. For more abstract topics, such as a business process or company history, identifying items will be more difficult. Are the items process steps or desired outputs? Are they the key events in the company’s history? The only way to make a final decision is to build up a small set of content and manually construct questions from the data.
  3. Define the properties that define the topic (i.e. the attributes) - What is it about the topic items that you want people to learn? Is it product specifications and/or features? Dates of events? Facts about people? Keep in mind that attributes can have multiple fact values.
  4. Fill in fact values for every item attribute combination - Once the items and attributes have been defined, filling in values for each fact should be fairly straightforward.
  5. Add Question Templates - Draft question templates and proofread the questions produced. How do the questions look? Are they readable? Are they accurate? Do you see possible errors in grammar? Going through 5-6 example questions should be sufficient to validate that attribute names and fact values are appropriate. Make tweaks where necessary
  6. Create and/or collect images - mLevel allows you to tailor many elements of your Mission. mLevel will work without these images however the following locations allow for customization.
    • Mission Image
    • Topic Imagery
    • Answer Imagery (values / items imagery)
    • Level Configurations (3 locations they travel to for Fast Lane and Check Point)
  7. Get started in Mission Manager - Work with your Account Manager to schedule a training session. They will be able to assist you with login instructions and support you as you upload draft one.


Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Powered by Zendesk