Other great resources: Official JS API docs, Scripting Forum
donatePower()
Transfer some power to another player...
Hopefully this function will be renamed transferPower() and be given an associated event.
Syntax
var success = donatePower(amount, to);
Parameters
| Parameter | Type | Mandatory | Notes | Game Version |
|---|---|---|---|---|
| amount | Number |  | The amount of oil to transfer. You must ensure you have enough power available first! | 3.2 |
| to | Number | | The ID of the player who you want to transfer the object to. | 3.2 |
Return value
| Value | Type | Notes | Game Version |
|---|---|---|---|
true | Boolean | The power was successfully transferred. | 3.2 |
false | Boolean | You do not have enough power to transfer the desired amount. | 3.2 |
| <error> | Error | Invalid parameters or player not found. | 3.2 |
Notes
You can determine the amount of power a player has using playerPower().
Example
Transfer ¼ of my power to player 3...
var myPower = playerPower(me); donatePower( Math.floor(myPower/4), 3 );
Availability 3.2+
Requires:
- Warzone 3.2 or above
Contents
Jump to:
See also
Related articles:
- donateObject() – transfer an object to another player
- playerPower() – determine how much power a player currently has
- powerType – determine the base income per derrick per minute
- setPower() – set the power reserves for a player
- setPowerModifier() – boost or reduce the power modifier