User Tools

Site Tools


4rpl:commands:getmcsentries

Index

:!: Available in version 2.4.3 and later.

GetMCSEntries

GetMCSEntries ->listOfEntries

Description

MCS, or Mission Completion Stats, are stored in the mcs.dat file. This file contains records for every played mission. GetMCSEntries will return a list of those entries. Each entry, or row, is also a list that contains 4 elements; “MapNum”, “Title”, “IsComplete”, “MapGUID”. The “MapNum” is the number of the map in colonies. “Title” is the map's title. “IsComplete” is a bool indicating if the map has been completed (all necessary objectives have been completed). “MapGUID” in the internal map unique identifier.

Rows are returned in random/hash order.

The map number and title are determined by looking at the LastMetaData file. This file is populated each time the Colonies are visited. Only Colony maps are in this file. As a consequence, locally created maps, story maps, or other internal maps will not have Map Numbers or Titles in the returned results of this API. The map number will show as -1 and the title as “UNKNOWN TITLE”.

Examples

trace(GetMCSEntries)

Index

4rpl/commands/getmcsentries.txt · Last modified: 2022/08/25 17:38 by virgilw