Page Comparison

eventObjectTransfer(object, from)

An event that is run whenever an object is transferred between players, for example due to a Nexus Link weapon. The event is called after the object has been transferred, so the receiving player is in object.player. The event is called for both players.

object = Droid object (most common) or Structure object (i've never seen this happen but apparently it can?!)

...

Overview

Common scenarios for this happening are:

• Unit assimilated by a Nexus Link turret
• Droids transferred between players in a multiplayer game

Availability

Warzone 3.1 Beta 2 and above.

Syntax

function eventObjectTransfer(gameObject,from) {
  // do stuff
}

Parameters

Parameter	Type	Mandatory	Description	Game version
gameObject	Droid object Structure object		The object that was transferred. It's .player property indicates who now owns it.	3.1 Beta 2
from	Number		The ID of the player who lost the object. You can find out more about them in the playerData[] array.	3.1 Beta 2

Return value

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

Example

eventObjectTransfer(gameObject,from) {
  if (gameObject.player == me) { // I gained a new object
    if (allianceExistsBetween(me,from)) { // a gift from an ally
      // do stuff
    } else { // probably Nexus Link assimilated it from an enemy
      // do stuff
    }
  } else { // I lost an object
    if (allianceExistsBetween(gameObject.player,from)) { // I gave a droid to my ally
      // do stuff
    } else { // looks like an enemy Nexus Link assimilated one of my droids :(
      // do stuff
    }
  }
}

See also

• allianceExistsBetween() – determine whether the transfer was with an ally or not
• eventDroidBuilt() – triggered when a new droid is built at your factory (or just unexpectedly appears out of thin air)
• eventStructureBuilt() – triggered when a new structure is built