Note: All of these systems send and receive events, which are defined in Events.ts.

• preStart() - defines methods and listeners for player management
• start() - no code
• Includes a set of private functions to manage transitions between states of the game, including the general function transitGameState(), which is called from the other private functions.
• dispose() - when the GameManager is destroyed, the game is reset.

  Tip: Use the dispose() method in your code to safely remove assets from the game and free resources.

• GameState enum in GameUtils.ts contains the available game states:

export enum GameState {
  "ReadyForMatch", // Default, nothing is going on, we can start a match
  "StartingMatch", //A match has been started by players
  "PlayingMatch", //A match is ongoing
  "EndingMatch", //A match is ending
  "CompletedMatch", //A match has just been completed
}

• PlayerGameStatus enum in GameUtils.ts contains the available player states:

export enum PlayerGameStatus {
  "Lobby",
  "Standby",
  "Playing",
}

• playerMap map object contains a unique identifier and a reference to PlayerData object, which includes:
  • A reference to the player
  • A reference to the players PlayerGameStatus
• preStart(): Creates event listeners for the following global events, which are handled locally through private functions:
  • onPlayerEnterWorld and onPlayerExitWorld
  • On change of game state, which sends the fromState and toState to the local handler.
  • On player registering for a match or de-registering for a match
  • On world reset
• start(): a set of functions, including:
  • getPlayerWithStatus(): returns an array of all of the players with the same status. This is key for setting up a match.
  • handleGameStateTransit(): manages game state transitions, including start and finish of the match.
    • Calls transferAllPlayersWithStatus() for setting up matches.
  • teleportPlayersWithStatusToSpawnPoint(): transfers all players with a specified status using the SpawnPoint gizmo, which is less disruptive than moving their location directly.
• dispose(): runs the local reset() function to clear the player map and set the game state to ReadyForMatch.

• handleOnMatchStart() - creates an array of objects of players who are participating in the race.
  • this.raceIntervalUpdateID() - checks and updates status of the race every 500ms(modifiable)
• Handlers for various race states
• initCurve() - creates an array of checkpoints based on Vec3 location.
• updateAllRacerCurveProgress() - updates location along the race path for all participants in the race

• Audio assets are attached as properties to the entity hosting the environment sound manager. These properties must be specified by a designer.
• Creates listeners for the gameplay events defined in Events.ts.
  • When the event is triggered, the background audio stops playing, and the audio for the new gameplay state begins playing.
  • The listener for Events.onGameStartTimeLeft triggers playback of the countdown until game start, while Events.onGameEndTimeLeft triggers another audio countdown until the game ends.

Tip: Move these tools into the gameplay area to take advantage of them.

Tip: The Debug Console gizmo is available for inclusion in any world through the Build > Gizmos menu in the desktop editor.

• Trigger zone
  • Attached script: ToggleTrailTrigger.ts
• Square (visual marker)
• Text label

• Trigger zone
  • Attached script: TeleportToSpawnPointTrigger.ts
• Square (visual marker)
• Text label