Mapdev:mapinfo.lua

mapinfo.lua Reference

Download the map blueprint

Thing are set out in sections with all relevant information for that section contained within.

variables are organised as such:

VariableName [dimensions] Required

Default: value, Description

But I dont know whats required or not.

there are FIXME's everywhere I haven't yet found information for.

Source

The engine source code which reads this file from the map is viewable here: ?

General Formatting

check Lua Documentation.

Sections

mapinfo

local mapinfo = {
   name        = "MyMap",
   shortname   = "",
   description = "",
   author      = "",
   version     = "",
   --mutator   = "deployment";
   --mapfile   = "", --// location of smf/sm3 file (optional)
   modtype     = 3, --// 1=primary, 0=hidden, 3=map
   depend      = {"Map Helper v1"},
   replace     = {},

   --startpic   = "", --// deprecated
   --StartMusic = "", --// deprecated

   maphardness     = 100,
   notDeformable   = false,
   gravity         = 130,
   tidalStrength   = 0,
   maxMetal        = 0.02,
   extractorRadius = 500.0,
   voidWater       = false,
   autoShowMetal   = true,

   smf = {
      ...
   },

   sound = {
      ...
   },

   resources = {
      ...
   },

   splats = {
      ...
   },

   atmosphere = {
      ...
   },

   grass = {
      ...
   },

   lighting = {
      ...
   },

   water = {
      ...
   },

   teams = {
      ...
   },

   terrainTypes = {
      ...
   },

   custom = {
      ...
   },
}

name [string] Required

Name of the map

shortname [string]

description [string]

The description of the map that shows in the multiplayer battleroom.

author [string]

Author of the map

version [string]

version, appended to name.

mutator [string]

?

mapfile [string]

location of smf/sm3 file (optional)

modtype [1-3] Required

1=primary, 0=hidden, 3=map

depend [?] Required

replace [?]

maphardness [?]

Default: 100, Defines how much a map will deform from impacts. Higher values mean less deformation, negative values will result in negative deformation (really funny looking)

notDeformable [0|1]

Default: 0,Setting it to 1 means that no explosions can deform the map.

gravity [?]

Default: 130, The force of gravity in units/sec^2

tidalStrength [?]

Default: 0,The amount of energy which will be given by tidal generators.

maxMetal [?]

Default: 0.02, How much metal a map square with the maximum metal value gives.

extractorRadius [?]

Default: 500, The radius of effect that a single extractor will extract from. If two radii intersect, both extractors will suffer from reduced output.

voidWater [0|1]

Default: 0, Voidwater means there will be no water plane, and all parts of the map under water will be completely transparent, to show the skybox through the map. For example, check Apophis_v2

autoShowMetal [0|1]

Default: 1, Defines wether the metal map (F4 mode) is shown automatically when a mex is queued for placement.

smf

local mapinfo = {
   ...
   smf = {
      minheight = 1000,
      maxheight = -300,
      smtFileName0 = "",
      smtFileName1 = "",
      smtFileName.. = "",
      smtFileNameN = "",
   },
   ...
}

minheight [?]

Overrides the minimum map height specified while compiling. Compile time height used if undefined

maxheight [?]

Overrides the maximum map height specified while compiling. Compile time height used if undefined

smtFileName[N] [?]

Default: ?, ?

sound

local mapinfo = {
   ...
   sound = {
   },
   ...
}

variable [range]

Default: value, text

resources

local mapinfo = {
   ...
   resources = {
   },
   ...
}

variable [range]

Default: value, text

splats

local mapinfo = {
   ...
   splats = {
   },
   ...
}

variable [range]

Default: value, text

atmosphere

local mapinfo = {
   ...
   atmosphere = {
   },
   ...
}

variable [range]

Default: value, text

grass

local mapinfo = {
   ...
   grass = {
   },
   ...
}

variable [range]

Default: value, text

lighting

local mapinfo = {
   ...
   lighting = {
   },
   ...
}

variable [range]

Default: value, text

water

local mapinfo = {
   ...
   water = {
   },
   ...
}

variable [range]

Default: value, text

teams

local mapinfo = {
   ...
   teams = {
   },
   ...
}

variable [range]

Default: value, text

terrainTypes

local mapinfo = {
   ...
   terrainTypes = {
   },
   ...
}

variable [range]

Default: value, text

custom

local mapinfo = {
   ...
   custom = {
   },
   ...
}

variable [range]

Default: value, text