Difference between revisions of "MAPINFO/Map definition"

From ECWolf Wiki
(Created page with "A map definition sets properties for a specific map. == Block syntax == * '''adddefaultmap''' { ''properties'' } * '''defaultmap''' { ''properties'' } :Sets the default set of...")
 
m (→‎Block properties: Qualify deathcam deafult)
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
A map definition sets properties for a specific map.
 
A map definition sets properties for a specific map.
 
== Block syntax ==
 
== Block syntax ==
* '''adddefaultmap''' { ''properties'' }
+
* <tt>defaultmap { ''properties'' }</tt>
* '''defaultmap''' { ''properties'' }
+
:Sets the defaults that will be automatically used for all subsequent map definitions. It resets the default information so anything specified in previous <tt>defaultmap</tt> sections is lost.
:Sets the default set of properties. Note that these properties are copied to future definitions, so changing the default map won't retroactively apply.
+
* <tt>adddefaultmap { ''properties'' }</tt>
* '''map "<maplump>"''' { ''properties'' }
+
:Similar to <tt>defaultmap</tt> but keeps the existing defaultmap information and just adds to it.
* '''map "<maplump>" "<mapname>"''' { ''properties'' }
+
:'''Note:''' these properties are copied to future definitions, so changing the default map won't retroactively apply.
* '''map "<maplump>" lookup "<string>"''' { ''properties'' }
+
 
:Defines a map block. It is recommended that the map be named through MAPINFO, but is not required. The lookup keyword will cause the string to be looked up in [[LANGUAGE]].
+
* <tt>map "<maplump>" { ''properties'' }</tt>
 +
* <tt>map "<maplump>" "<mapname>" { ''properties'' }</tt>
 +
* <tt>map "<maplump>" lookup "<string>" { ''properties'' }</tt>
 +
:Defines a map block. It is recommended that the map be named through <tt>MAPINFO</tt>, but is not required. The lookup keyword will cause the string to be looked up in [[LANGUAGE]].
 +
 
 
== Block properties ==
 
== Block properties ==
* '''bordertexture = "<texture>"'''
+
* <tt>bordertexture = "<texture>"</tt>
 
:Overrides the gameinfo border texture for this map.
 
:Overrides the gameinfo border texture for this map.
* '''cluster = <number>'''
+
:Default: The border flat assigned in [[MAPINFO/Gameinfo definition|<tt>Gameinfo</tt>]].
 +
* <tt>cluster = <positive integer></tt>
 
:Assigns the map to a [[MAPINFO/Cluster definition|cluster]].
 
:Assigns the map to a [[MAPINFO/Cluster definition|cluster]].
* '''completionstring = "<string>"'''
+
:Default: <tt>0</tt>
 +
* <tt>completionstring = "<string>"</tt>
 
:Short message to display on the intermission screen instead of "Floor Completed".
 
:Short message to display on the intermission screen instead of "Floor Completed".
* '''deathcam = <bool>'''
+
:Default: <tt>"Floor Completed"</tt>
 +
* <tt>deathcam = <bool></tt>
 
:Enables the death cam with [[A_BossDeath]].
 
:Enables the death cam with [[A_BossDeath]].
* '''defaultceiling = "<texture>"'''
+
:Default: <tt>false</tt> (Note: The Wolf3D MAPINFO sets this to true in the defaultmap.)
 +
* <tt>defaultceiling = "<texture>"</tt>
 
:Default ceiling texture to use when a map has a blank third plane.
 
:Default ceiling texture to use when a map has a blank third plane.
* '''defaultfloor = "<texture>"'''
+
:Default: Undefined.  Something in the hierarchy should define this, otherwise the unknown texture will be displayed.
 +
* <tt>defaultfloor = "<texture>"</tt>
 
:Default floor texture to use when a map has a blank third plane.
 
:Default floor texture to use when a map has a blank third plane.
* '''ensureinventory = "<item>", ...'''
+
:Default: Undefined.  Something in the hierarchy should define this, otherwise the unknown texture will be displayed.
:Checks the players inventory and gies that item if they are lacking.
+
* <tt>ensureinventory = "<item>", ...</tt>
* '''exitfade = <time>'''
+
:Checks the players inventory and gives these items if they are lacking.
 +
:Default: No items are given to the player.
 +
* <tt>exitfade = <positive integer></tt>
 
:Duration in Doom tics of the exit fade.
 
:Duration in Doom tics of the exit fade.
* '''floornumber = <number>'''
+
:Default: <tt>30</tt>
 +
* <tt>floornumber = <positive integer></tt>
 
:The floor number to show on the status bar.
 
:The floor number to show on the status bar.
* '''highscoresgraphic = "<picture>"'''
+
:Default: <tt>1</tt>
 +
* <tt>highscoresgraphic = "<picture>"</tt>
 
:Small icon to display instead of the floor number on the high scores table.
 
:Small icon to display instead of the floor number on the high scores table.
* '''levelbonus = <value>'''
+
:Default: The floor number
 +
* <tt>levelbonus = <positive integer></tt>
 
:Number of points to give for completing this level.
 
:Number of points to give for completing this level.
* '''levelnum = <number>'''
+
:Default: <tt>0</tt>
 +
* <tt>levelnum = <positive integer></tt>
 
:The level number which is used for warping. For MAPxy labels this number is automatically assigned.
 
:The level number which is used for warping. For MAPxy labels this number is automatically assigned.
* '''music = "<lump>"'''
+
:Default: <tt>0</tt>
 +
* <tt>music = "<lump>"</tt>
 
:The music to play for this level.
 
:The music to play for this level.
* '''secretdeathsouds = <bool>'''
+
:Default: '''Undefined?'''
 +
* <tt>spawnwithweaponraised</tt>
 +
:Starts the level with the weapon already raised.
 +
:Default: <tt>false</tt>
 +
* <tt>secretdeathsounds = <bool></tt>
 
:Swaps all deathsounds for their secretdeathsounds.
 
:Swaps all deathsounds for their secretdeathsounds.
* '''[secret]next = "<map>"'''
+
:Default: <tt>false</tt>
* '''[secret]next = EndSequence, "<sequence>"'''
+
* <tt>[secret|victory]next = "<map>"</tt>
:Specifies which map to go to when the exit is activated. EndSequence will instead go to a [[MAPINFO/Intermission definition|intermission]] sequence. Secretnext is the same as next only applies to the secret exit.
+
* <tt>[secret|victory]next = EndSequence, "<sequence>"</tt>
* '''specialaction = "<actorclass>", "<special>"[, <arg0>[, <arg1>[, <arg2>[, <arg3>[, <arg4>]]]]]
+
:Specifies which map to go to when the exit is activated. <tt>EndSequence</tt> will instead go to a [[MAPINFO/Intermission definition|intermission]] sequence. <tt>secretnext</tt> is the same as next only applies to the secret exit.  <tt>victorynext</tt> is likewise the same but is usually triggered by bosses which call the [[Action specials|<tt>Exit_Victory</tt>]] special.
 +
:Default: '''Undefined?'''
 +
* <tt>specialaction = "<actorclass>", "<special>"[, <arg0>[, <arg1>[, <arg2>[, <arg3>[, <arg4>]]]]]</tt>
 
:Gives a special action to be called by [[A_BossDeath]] when all of the specified type are dead.
 
:Gives a special action to be called by [[A_BossDeath]] when all of the specified type are dead.
* '''nointermission'''
+
:Default: No special action.
 +
:'''NOTE:''' Multiple special actions can be defined.
 +
* <tt>nointermission</tt>
 
:Disables the normal intermission screen and goes to the next level immediately.
 
:Disables the normal intermission screen and goes to the next level immediately.
* '''par = <time>'''
+
:Default: <tt>false</tt> (display normal intermission)
 +
* <tt>par = <positive integer></tt>
 
:The par time of the level in seconds.
 
:The par time of the level in seconds.
* '''translator = "<lump>"'''
+
:Default: <tt>0</tt>
 +
* <tt>translator = "<lump>"</tt>
 
:Name of map translation lump.
 
:Name of map translation lump.
 +
:Default: Whatever translator is defined in [[MAPINFO/Gameinfo definition|<tt>Gameinfo</tt>]]

Revision as of 22:23, 21 August 2020

A map definition sets properties for a specific map.

Block syntax

  • defaultmap { properties }
Sets the defaults that will be automatically used for all subsequent map definitions. It resets the default information so anything specified in previous defaultmap sections is lost.
  • adddefaultmap { properties }
Similar to defaultmap but keeps the existing defaultmap information and just adds to it.
Note: these properties are copied to future definitions, so changing the default map won't retroactively apply.
  • map "<maplump>" { properties }
  • map "<maplump>" "<mapname>" { properties }
  • map "<maplump>" lookup "<string>" { properties }
Defines a map block. It is recommended that the map be named through MAPINFO, but is not required. The lookup keyword will cause the string to be looked up in LANGUAGE.

Block properties

  • bordertexture = "<texture>"
Overrides the gameinfo border texture for this map.
Default: The border flat assigned in Gameinfo.
  • cluster = <positive integer>
Assigns the map to a cluster.
Default: 0
  • completionstring = "<string>"
Short message to display on the intermission screen instead of "Floor Completed".
Default: "Floor Completed"
  • deathcam = <bool>
Enables the death cam with A_BossDeath.
Default: false (Note: The Wolf3D MAPINFO sets this to true in the defaultmap.)
  • defaultceiling = "<texture>"
Default ceiling texture to use when a map has a blank third plane.
Default: Undefined. Something in the hierarchy should define this, otherwise the unknown texture will be displayed.
  • defaultfloor = "<texture>"
Default floor texture to use when a map has a blank third plane.
Default: Undefined. Something in the hierarchy should define this, otherwise the unknown texture will be displayed.
  • ensureinventory = "<item>", ...
Checks the players inventory and gives these items if they are lacking.
Default: No items are given to the player.
  • exitfade = <positive integer>
Duration in Doom tics of the exit fade.
Default: 30
  • floornumber = <positive integer>
The floor number to show on the status bar.
Default: 1
  • highscoresgraphic = "<picture>"
Small icon to display instead of the floor number on the high scores table.
Default: The floor number
  • levelbonus = <positive integer>
Number of points to give for completing this level.
Default: 0
  • levelnum = <positive integer>
The level number which is used for warping. For MAPxy labels this number is automatically assigned.
Default: 0
  • music = "<lump>"
The music to play for this level.
Default: Undefined?
  • spawnwithweaponraised
Starts the level with the weapon already raised.
Default: false
  • secretdeathsounds = <bool>
Swaps all deathsounds for their secretdeathsounds.
Default: false
  • [secret|victory]next = "<map>"
  • [secret|victory]next = EndSequence, "<sequence>"
Specifies which map to go to when the exit is activated. EndSequence will instead go to a intermission sequence. secretnext is the same as next only applies to the secret exit. victorynext is likewise the same but is usually triggered by bosses which call the Exit_Victory special.
Default: Undefined?
  • specialaction = "<actorclass>", "<special>"[, <arg0>[, <arg1>[, <arg2>[, <arg3>[, <arg4>]]]]]
Gives a special action to be called by A_BossDeath when all of the specified type are dead.
Default: No special action.
NOTE: Multiple special actions can be defined.
  • nointermission
Disables the normal intermission screen and goes to the next level immediately.
Default: false (display normal intermission)
  • par = <positive integer>
The par time of the level in seconds.
Default: 0
  • translator = "<lump>"
Name of map translation lump.
Default: Whatever translator is defined in Gameinfo