(info) Other great resources: Official JS API docs, Scripting Forum

extraPowerTime()

Owned by Aubergine
Last updated: Dec 15, 2012Version comment
1 min read
Increase the player's power reserve as if they'd played the game for an additional number of seconds...

 

Syntax

extraPowerTime(time, player);

Parameters

ParameterTypeMandatoryNotesGame Version
timeNumber(tick)

The extra time, in seconds, the player is granted.

3.2

playerNumber(error)

The ID of the player who will get the power boost.

Default: me

3.2

Return value

ValueTypeNotesGame Version
undefinedUndefinedIf the timer is set, nothing is returned.3.1 Beta 1
<error>ErrorInvalid parameters.3.1 Beta 1

Notes

This function is most commonly used in campaign and challenge games to reward players for finishing a level or mission with time to spare.

You can optionally boost the power using setPowerModifier() prior to giving the player extra power, to increase the incentive for finishing a mission quickly.

Examples

Give 'me' 20 seconds-worth of extra power
extraPowerTime( 20 );
Give me extra power as if I'd waited until the mission timer ran out...
var bonusTime = getMissionTime();
 
if (bonusTime > 0) {
	setPowerModifier(125); // 25% bonus for completing mission quickly
	extraPowerTime(bonusTime);
	setPowerModifier(100);
}
This function should only be used in single player games, otherwise it will cause a desynch.
Availability 3.2+

Requires:

  • Warzone 3.2 and above
Contents

Jump to:

See also

Related articles:

  • getMissionTime() – if a player completes a mission early, you can find out how much time they have left and give them power equivalent to that amount of time
  • setPowerModifier() – optionally increase or decrease the rate of power income before applying the extra power bonus

Â