Jump to content

GetMapRotationInfo: Difference between revisions

no edit summary
(3.1 is released, so Devfeature templates have been removed)
No edit summary
Tag: Source edit
Line 3: Line 3:
int '''GetMapRotationInfo''' (int ''position'', int ''info'')
int '''GetMapRotationInfo''' (int ''position'', int ''info'')


==Usage==
== Usage ==
Retrieves information on a particular entry in the map rotation.


Retrieves information on a particular entry in the map rotation, indicated by the ''position'' parameter. Use 0 to get information on the current map (printed in green when the <tt>maplist</tt> [[Console Commands|console command]] is used). The ''info'' parameter can be one of the following:
=== Parameters ===
* ''position'': The index into the map rotation. This can be 0 to return the current map (printed in green when the <tt>maplist</tt> [[Console Commands|console command]] is used); otherwise it must be between 1 and the value returned by [[GetMapRotationSize]].
* ''info'': One of:
:*'''MAPROTATION_Name''' = 0
::The name of the map (e.g. "Entryway").
:*'''MAPROTATION_LumpName''' = 1
::The lump name of the map (e.g. "MAP01").
:*'''MAPROTATION_Used''' = 2
::Whether or not this map has already been played. Used maps are printed in red when the <tt>maplist</tt> [[Console Commands|console command]] is used.
:*'''MAPROTATION_MinPlayers''' = 3
::The minimum number of players required to load this level. If this is 0, then there's no minimum limit.
:*'''MAPROTATION_MaxPlayers''' = 4
::The maximum number of players allowed to load this level. If this is 64, then there's no maximum limit.


*'''MAPROTATION_Name''' = 0
=== Return value ===
The name of the map (e.g. "Entryway").
Returns the value of the given property of the specified map rotation entry.
*'''MAPROTATION_LumpName''' = 1
The lump name of the map (e.g. "MAP01").
*'''MAPROTATION_Used''' = 2
Whether or not this map has already been played. Used maps are printed in red when the <tt>maplist</tt> [[Console Commands|console command]] is used.
*'''MAPROTATION_MinPlayers''' = 3
The minimum number of players required to load this level. If this is 0, then there's no minimum limit.
*'''MAPROTATION_MaxPlayers''' = 4
The maximum number of players allowed to load this level. If this is 64, then there's no maximum limit.


[[category:ACS Functions]]
== Examples ==
{{noexamples}}
 
== See also ==
* [[GetMapRotationSize]]
 
[[category:ACS functions]]