Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

Excerpt

This event is triggered once at the start of the game before the map is ready.

 

Overview

This event is only called when a game first starts, it is not called when a game is loaded.

When the event is fired, all your scripts have been loaded and basic game initialisation is complete:

  • You can

...

  • retrieve basic information about the game, such as playerData and use most if not all of the enum functions (such as enumDroid() and enumStruct()
  • Do not issue any commands (such as production, research or droid orders) because the game hasn't properly started yet.
  • Avoid setTimer()queue() or bind() calls linked to functions that issue commands, because they might get triggered before the game properly starts.

To issue initial commands or set timers, etc., it's much safer to use eventStartLevel() instead.

Availability

Warzone 3.1 Beta 1 and above.

Syntax

Code Block
theme

...

RDark
languagejavascript
linenumberstrue
function eventGameInit() {
  // do stuff
}

Parameters

This event has no parameters.

Return value

Warzone does not process your event handler's return value.

Example

Code Block
theme

...

RDark
languagejavascript
titleChoose a research path based on AI difficulty
linenumberstrue
var insaneResearchPath = [ /* research items here */ ];
var hardResearchPath = [ /* research items here */ ];
var mediumResearchPath = [ /* research items here */ ];
var easyResearchPath = [ /* research items here */ ];


function eventGameInit() {
  switch (difficulty) {
    case INSANE: {
      global.researchPath = insaneResearchPath;
      break;
    }
    case HARD: {
      global.researchPath = hardResearchPath;
      break;
    }
    case MEDIUM: {
      global.researchPath = mediumResearchPath;
      break;
    }
    case EASY: {
      global.researchPath = easyResearchPath;
      break;
    }
  }
}
Div
classbox

Availability

Requires:

  • Warzone 3.1 Beta 1 and above.
Div

See also

Related articles:

  • eventStartLevel() – triggered once the map has been initialised, you can now issue commands and set timers, etc.
  • Events – documentation for all other events in the JS API