A game restart may be required after updating.

Add to PlayerCpInfo:

• int2 RaceProgression: used as <Points, Time> for Royal Time Attack
• int[] RaceProgressionHistory: tracks RaceProgression values where Points is the index into this array (max 20 records)
• bool get_RoyalTA_HasFinished() const: returns true if RaceProgression.x >= 5
• uint SpawnCount: a counter of the number of times the player has gone from Spawning to Spawned

• Add .RequestsSpectate on player
• Add .WarmupActive and .WarmupEndTime on RaceData

add to Player class:

• uint[]@ NbRespawnsByCp a count of respawns by CP
• uint[]@ RespawnTimes array of the players respawn times
• bool PlayerIsRacing if the player is spawned and has not finished
• bool Eliminated if the player is not spawned and has not finished (indicates a DNF on teams, KO, etc)

• Fix lap detection when a map has LapCount = 0 set (hides Lap 1/1 when using a multilap in a map; affects TOTD 2023-12-10)

• Support next game version (change of script location)
• Fix rare race condition that can occur when joining a server and a player leaves shortly after.

• Fix bug with LapsNb & CPsToFinish on a server after playing a map with > 1 lap.

• Add accurate number of laps (informed by game mode): .LapCount_Accurate
• Refactor .CPsToFinish to account for proper number of laps
• Add .IsFinished getter to player object -- it is just .CpCount == RaceData.CPsToFinish
• Add .Rules_GameTime, .Rules_StartTime, and .Rules_EndTime to race data for convenience

• Fix COTD quali data in race data v4
• Add COTD quali data to demo UI

Add COTD Qualification data. New properties in RaceData_V4:

// Qualification time known locally
int COTDQ_LocalRaceTime;
// Qualification time according to the API
int COTDQ_APIRaceTime;
// Qualification Rank, updated regularly (3-7s)
int COTDQ_Rank;
// Time you joined the server
int COTDQ_QualificationsJoinTime;
// Stage that qualification is in;
QualificationStage COTDQ_QualificationsProgress;
// true when you load into a server before it has gotten your record from the API
bool COTDQ_IsSynchronizingRecord;
// Incremented each time any COTDQ thing is updated
int COTDQ_UpdateNonce;

• Ensure BestRaceTimes is never null and update comment

• Fix possible rare script exception when Player.Score is null

• Comment out code that optimistically updated BestTime and BestRaceTimes based on CurrentRaceTimes data (may fix an RMT bug).
• Check if the map changed each frame, rather than once every 60 frames.

Fix misuse of #elif preprocessor statement.

This update improves ghost data with info about currently loaded ghosts.

• Additions to GhostData:
  • .SortedGhosts -- an array of all ghosts loaded this session, sorted fastest to slowest
  • .LoadedGhosts -- an array of currently loaded ghosts only, sorted fastest to slowest
  • .NbLoadedGhosts -- the number of ghosts in .LoadedGhosts
• Addition to GhostInfo_V2:
  • .IsLoaded -- true initially and changed to false when the ghost is unloaded

Additionally, a setting has been added to allow viewing the demo windows when running outside of developer mode. (Defaults to true in dev mode, and false otherwise.)

Matchmaking Support

Expose MM info:

• Clan (Team) Scores, current MVP, Players Finished, Points Limit, Points Repartition, Ranking mode, Round Number, Round Winning Clan, Start of round indicators, Team Populations, Teams Unbalanced flag, Warm Up flag
• ComputePoints function to calculate player scores and team scores at the end of a round, using current data, given an order that players finish.

Add PlayerCpInfo V4:

• Added properties: int RoundPoints, int Points, int TeamNum, bool IsMVP, uint CurrentLap, string WebServicesUserId, string Login

Race Data v3

• add .BestLapTimes to PlayerCpInfo_v3
• populate current CP times and best lap times after joining a new server. This means a players CP times will always be accurate, unlike previously where CPs taken prior to joining the server would have a time of 0.

• Fix for rare crash on map load where player score data is accessed too early.

Fix path not returning value.

0.4

• Update access interface to race data and ghost data
• Add respawn data for all players (number of respawns, last respawn time & cp, time lost to respawn (overall and by cp), theoretical time (i.e., no-respawn time)
• Other updates to PlayerCpInfo via PlayerCpInfo_V2
• Add new sort method to race data: Race_Respawns -- it's like the Race method but immediately updates to account for time lost to respawns
• Improve Race Feed Demo UI
• Add some properties to GhostInfo

Upgrade guide: https://github.com/XertroV/tm-mlfeed-race-data/blob/master/UPGRADE_v0.4.md

Full Docs: https://github.com/XertroV/tm-mlfeed-race-data/blob/master/MLFeed.autodoc.md

Added MLFeed::GetPlayersBestTimes(const string &in playerName) to get the best times set by a player since map load. (It's what the server shows CP splits against)

• 0.3.6: Added Ghost Data (thx for the request, @Orange)
• 0.3.7: Fix bug with player rankings (.taRank and .raceRank) where they would be off by 1 for a short while when a player left.

• Add field LastRecordTime to race data. When the player sets a new personal best, this is set to that time. Reset to -1 at the start of each map.
• Update readme / docs

• fix sorting race order when in non-race modes (i.e., player's don't spawn at the same time)