Plans configuration data schema

plans

This part of the configuration file is best left auto-generated from within the Server Manager.

Your server installation includes the /ServerManager web application with which you use configuration files to generate game sessions to which your players/users can connect. After you've created a game session, you'll find an 'Export with Current Plans' button in the ServerManager when viewing that game session. Pressing this button will export all plans created on this game session in a new configuration file and offer that file for immediate download.

This page thus only serves as a reference / check for all the data that the Server Manager auto-generates.

"plans": [
     {
       "plan_id": 1,
       "plan_country_id": 1,
       "plan_name": "NS_ENERGY_STARTING_PLAN_GREEN",
       "plan_gametime": -1,
       "plan_type": "1,0,0",
       "plan_alters_energy_distribution": 0,
       "layers": [],
       "grids": [],
       "fishing": [],
       "messages": [],
       "restriction_settings": []
     }
]

Field	Type	Description
plan_id	int	Unique identifier of the plan
plan_country_id	int	Unique identifier of the country/team to which this plan belongs. 1 being the administrator user, 2 being the region manager user. See also the datamodel > countries documentation.
plan_name	string	Name of the plan, as shown in the game client's plan list.
plan_gametime	int	Simulated month set as this plan's implementation date. Setting this to -1 turns this plan into a so-called 'starting plan', i.e. a plan defined during the Setup state of the simulation, being basically the month before the official starting month/year as defined in datamodel.
plan_type	string	A comma-separated list of exactly three integer representations of booleans. The first integer/boolean represents whether or not this plan involves the CEL energy simulation. The second integer/boolean represents whether or not this plan involves the MEL ecosystem simulation, as it affects the fishing fleets' country effort divisions. The third integer/boolean represents whether or not this plan involves the SEL shipping simulation.
plan_alters_energy_distribution	int	An integer representation of a boolean to indicate whether the plan includes a change to country-specific energy expectancies, relevant to the CEL energy simulation.
layers	object[]	List of layers for which geometry was added, altered or removed, as part of this plan. Explained further below in a separate paragraph.
grids	object[]	List of energy grid (orchestrated by the CEL energy simulation) that were created, altered or removed, as part of this plan. Explained further below in a separate paragraph.
fishing	object[]	List of fishing fleets' country-specific effort divisions that were altered by this plan. Explained further below in a separate paragraph.
messages	object[]	List of messages specific to this plan that were sent around by different users. Explained further below in a separate paragraph.
restriction_settings	object[]

layers

    "layers": [
         {
           "layer_id": 89,
           "name": "NS_Wave_Farms",
           "layer_editing_type": "sourcepolygon",
           "geometry": [
             {
               "geometry_id": 9127,
               "FID": "08b3e76d-f60e-424a-af12-a82f343634b2",
               "geometry_persistent": 1682,
               "geometry": "[[3607758.75,4075406.75],[3609889.75,4075645.75],[3608873.25,4070194.0],[3606851.75,4070554.75]]",
               "data": {
                 "value": "0",
                 "Type_1": "Turbine 30 MW/km2",
                 "Name": "Wave farms",
                 "starttime": "2008",
                 "Title": "Wave farms"
               },
               "country": 3,
               "type": "0",
               "base_geometry_info": {
                 "geometry_id": 9127,
                 "geometry_mspid": 6647,
                 "geometry_persistent": 1682
               },
               "cable": {
                 "start": {
                   "geometry_id": 9136,
                   "geometry_persistent": 9136
                 },
                 "end": {
                   "geometry_id": 9180,
                   "geometry_persistent": 9180
                 },
                 "coordinates": "[3607758.75,4075406.75]"
               },
               "energy_output": [
                 {
                   "maxcapacity": 32265329,
                   "active": 1
                 }
               ]
             },
             ...
           ]
           "warnings": [],
           "deleted": [
             {
               "geometry_id": 8111,
               "geometry_mspid": 0,
               "base_geometry_info": {
                 "geometry_id": 8111,
                 "geometry_mspid": 17279,
                 "geometry_persistent": 8111
               }
             }
           ]
         },
         ...

Field	Type	Description
layer_id	int	Original unique layer identifier.
name	string	Name of the layer, originally derived from when the server used the meta > layer_name definition to create the session from which this plan was subsequently exported.
layer_editing_type	string	See above and meta > layer_editing_type.
geometry	object[]	A list of geometry that are involved in this layer of this plan.
→ geometry_id	int	Original unique geometry identifier.
→ FID	string	Original unique geometry FID string (if it was available when the server obtained the layer data from GeoServer to create the session from which this plan was subsequently exported).
→ geometry_persistent	int	Original unique identifier of the geometry from which this geometry might have been derived. When a user makes a plan and adds new geometry to it, there is no pre-existing geometry from which this new geometry is derived. In that case the geometry_persistent and geometry_id values are identical. When a user makes a plan and alters existing geometry in it, there is pre-existing geometry from which this new geometry is derived. In that case the geometry_persistent refers to the original, pre-existing geometry, and the geometry_id is (still) the unique identifier of this planned alteration to the geometry.
→ geometry	string	GeoJSON coordinates of the geometry (point, line, polygon) at hand, based on the projection system at hand.
→ data	object	Any geometry data properties / variables. Can literally be anything, it depends on what was stored at and thus imported from GeoServer when the server first created the session from which this plan was subsequently exported.
→ country	int	Unique identifier of the country/team which owns this geometry. The country/team identifier should of course still exist in this configuration file. See datamodel > countries.
→ type	string	String representation of the integer identifying the type layer type to which this geometry belongs. The layer type should of course still exist in this configuration file. See meta > layer_type.
→ base_geometry_info	object	References to identifiers that persist between sessions created by a single configuration file, allowing the server software to map geometries properly to each other again when this plan is imported upon session creation.
→ → geometry_id	int	Original unique geometry identifier. Is not necessarily the exact same every time a session is created.
→ → geometry_mspid	int	Original unique geometry MSP identifier. Is always the exact same every time a session is created. If empty, then the server knows that this geometry is newly created by this plan.
→ → geometry_persistent	int	Original unique identifier of the geometry from which this geometry might have been derived. Is not necessarily the exact same every time a session is created. See also previous geometry_persistent remark.
→ cable	object	Keep null if this geometry is not a energy cable of which the CEL energy simulation should be aware for its grid calculations.
→ → start	object	References to the geometry that serves as the starting connection point for this cable geometry. E.g. a wind farm polygon.
→ → → geometry_id	int	Geometry_id of said starting connection point.
→ → → geometry_persistent	int	Geometry_persistent of said starting connection point. See also previous point about this variable's relation to geometry_id.
→ → end	object	References to the geometry that serves as the ending connection point for this cable geometry. E.g. a landing station / socket point.
→ → → geometry_id	int	Geometry_id of said ending connection point.
→ → → geometry_persistent	int	Geometry_persistent of said ending connection point. See also previous point about this variable's relation to geometry_id.
→ → coordinates	string	GeoJSON coordinate of the point that represents the start of the energy connection. Required by the CEL energy simulation to do its calculations.
→ energy_output	object[]	Maximum capacity of this geometry.
→ → maxcapacity	int	Maximum capacity expressed in Watt.
→ → active	int	Whether this maximum capacity is the active one. Always 1 in this plan configuration context.
warnings	object[]	Always empty as of v4.0.2. Previously any plan warnings listed here would be imported, but it was deemed unnecessary and risky to continue, as all warnings are generated by the client, not the server.
deleted	object[]	Any pre-existing geometry that this plan is deleting.
→ geometry_id	int	Geometry_id of the geometry marked for deletion. Is not necessarily the exact same every time a session is created.
→ geometry_mspid	int	Geometry MSP id of the geometry. Bit confusing in this context.
→ base_geometry_info	object	References to identifiers that persist between sessions created by a single configuration file, allowing the server software to map geometries properly to each other again when this plan is imported upon session creation.
→ → geometry_id	int	Geometry_id of the geometry marked for deletion.
→ → geometry_mspid	int	Geometry MSP id of the geometry.
→ → geometry_persistent	int	Geometry identifier of the geometry from which the concerned geometry was derived. See also earlier geometry_persistent remark.

grids

    "grids": [
         {
           "grid_id": 1,
           "grid_persistent": 1,
           "name": "Red-Orange Inter 2",
           "active": 1,
           "energy": [
             {
               "country": 4,
               "expected": 0
             },
             {
               "country": 7,
               "expected": 0
             }
           ],
           "removed": [],
           "sockets": [
             {
               "geometry": {
                 "geometry_id": 9167,
                 "geometry_persistent": 9167
               }
             },
             {
               "geometry": {
                 "geometry_id": 9169,
                 "geometry_persistent": 9169
               }
             }
           ],
           "sources": [
             {
               "geometry": {
                 "geometry_id": 9129,
                 "geometry_persistent": 1684
               }
             }
           ]
         },
         ...
       ]

Field	Type	Description
plan_id
plan_country_id
plan_name
plan_gametime
plan_type
plan_alters_energy_distribution

fishing

"fishing":

Field	Type	Description
plan_id
plan_country_id
plan_name

messages

   "messages": [
         {
           "country_id": 1,
           "user_name": "Admin",
           "text": "Changed the plans status to: Design",
           "time": 1600163971.3005
         }
       ],

Field	Type	Description
plan_id
plan_country_id
plan_name
plan_gametime

restriction_settings

"restriction_settings":

Field	Type	Description
plan_id
plan_country_id
plan_name
plan_gametime

Back to the main configuration data schema page.