About this page

On this page you'll be able to look up the meaning and opportunities of all the variables (potentially) contained in an MSP Challenge session configuration JSON file. Similar explanations can found in the Configuration Editor application that we ship with the full platform installer. Should some of the documentation on this page be wrong or incomplete, then we encourage you to update it yourself. Just make sure you're logged in and click on Edit Source to get started. Thank you!

This page follows the structure of the configuration file to the letter. This means that you should be able to recognize and find all of the headers on this page (e.g. 'metadata', 'datamodel') within any of the MSP Challenge JSON configuration files we ship.

Configuration schema version covered by this documentation: 1.1.x

metadata

The main object for all things metadata, i.e., data about this data.

Field Type Description
date_modified string Date with format dd/mm/yyyy representing the date the configuration file was last modified
data_model_hash string A string that's unique to the configuration content, auto-generated by the MSP Challenge Configuration Editor (shipped with the Windows full platform installer).
errors int Always 0. The idea was that this variable could store errors in the configuration content. Not implemented.
editor_version string Version number of the MSP Challenge Configuration Editor software by which the particular configuration file was generated.
config_version string Version number of the configuration schema adopted in the particular configuration file.

datamodel

The main object for everything that's *not* metadata, but just actual content.

Field Type Description
restrictions object[], with keys Documented on this separate restrictions page.
plans object[] Documented on this separate plans page.
CEL object Documented on this separate CEL page.
SEL object Documented on this separate SEL page.
MEL object Documented on this separate MEL page.
meta object Documented on this separate meta page.
expertise_definitions object[] Documented on this separate expertise_definitions page.
objectives object[] Documented on this separate objectives page.
edition_name string Name that the client should show when a session created with this configuration file has been created on the server, e.g. 'North Sea edition'
edition_colour string Colouring of the MSP Challenge logo/icon accompanying the edition name, as shown by the client.
edition_letter string Letter of to add into the MSP Challenge logo/icon accompanying the edition name, as shown by the client.
region string name of the region (must be the same as the name of the folder on geoserver
projection string PROJ.4 formatted string representing the projection system that should be used with the geodata referenced under meta and obtained from the GeoServer.
start int start year
end int end year
era_total_months int Total number of months in each era. There are always four eras between the start and end year.
era_planning_months int how many months of the era are taken up by the planning period
era_planning_realtime int duration (seconds) that the planning period takes
countries string what layer (referenced under meta) contains the planning regions?
minzoom int Minimum camera zoom-in level. At present believed to be not implemented. The minimum zoom-in level is determined by the _PLAY_AREA geometry provided under meta.
maxzoom int Maximum camera zoom-in level.
user_admin_name string Name of the administrator user in the game. This user has all rights, including the right to plan and (dis)approve plans on behalf of all countries/teams, and to manipulate the simulations.
user_region_manager_name string Name of the region manager user in the game. This user has the right to plan and (dis)approve plans on behalf of all countries/teams.
user_admin_color string Hexadecimal colour code of the administrator user (last two digits representing transparency).
user_region_manager_color string Hexadecimal colour code of the region manager user (last two digits representing transparency).
team_info_base_url string the base URL used by the logo button in the top-left corner to open the Knowledge Base on a specific page. This will bring the user to the info page about their country/team.
restriction_point_size float size of the restriction area around points
wiki_base_url string the base URL for all media and layer_media references under meta. Basically the base of the Knowledge Base website in use for this particular configuration.
windfarm_data_api_url string the base URL for communicating with the wind farm API as developed and maintained by Deltares, the Netherlands. Currently only in use in the North Sea Digitwin configuration.
This page was last edited on 11 April 2024, at 13:21. Content is available under GPLv3 unless otherwise noted.