Other great resources: Official JS API docs, Scripting Forum
Change log
A summary of the main changes in the JS API from Warzone 3.1 Beta 1 to present day...
Warzone 3.1
Warzone 3.1 brings some major improvements over earlier releases, in particular a fully functional JS API.
You can find a full list of Warzone releases, since the game was first released to present day, here: Warzone Versions
3.1 Alpha releases
The JS API started getting used by developers during the MASTER snapshot releases in late 2011 and early January 2012.
There were a significant number of changes in the alpha releases. It's recommended that you base your scripts on Warzone 3.1 Beta 1 and above to avoid adding lots of cruft to your code.
3.1 Beta 1
This was the first major release in which the JS API gained popularity. In particular a large number of events were added, and API features relating to cyborgs were significantly changed.
A bug in pickStructLocation(), relating to positions returned for cyborg factories, was fixed.
The enumDroid() and buildDroid() functions have issues in relation to Combat Engineers and Cyborg Mechanics which persist until 3.2 branch.
The addDroid() function is broken and unusable - a problem that persists up to and including 3.1.0.
The version global was very unreliable on Mac OS X builds, up to 3.1 Beta 4.
Constants | Events | Functions | Globals |
|---|---|---|---|
DROID_CYBORG_CONSTRUCT DROID_CYBORG_REPAIR DROID_CYBORG_SUPER DROID_DEFAULT LASSAT |
The effects of these changes were so profound that Javascript AIs (namely NoQ's NullBot) became more effective than the existing WZScript AIs such as Nexus and Semperfi.
3.1 Beta 2
Beta 2 made the JS API much more robust by fixing some bugs, adding some new stuff and deprecating some badly named old stuff.
Constants | Events | Functions | Globals | Objects |
|---|---|---|---|---|
No changes | not investigated yet |
This website was started and the major project of writing detailed documentation for the JS API began.
3.1 Beta 4
Beta 3 was not released due to some serious bugs, so we skipped to Beta 4.
The version global was standardised across platforms, it's value being fixed to 3.1. Previously, on Mac OS X version returned "TRUNK".
Constants | Events | Functions | Globals | Objects |
|---|---|---|---|---|
No changes | not investigated yet |
3.1 Beta 5
Beta 5 fixed a long-term issue with save games, but introduced a new bug in multiplayer games.
A new DROID_SUPERTRANSPORTER constant was added, allowing easy differentiation between cyborg and tank transports. Prior to 3.1 Beta 5, it's recommended to avoid using transporters.
The DORDER_RECOVER code was fixed so AI players are now able to pick up oil barrels and artefacts when specifically instructed to do so.
Constants | Events | Functions | Globals | Objects |
|---|---|---|---|---|
DORDER_RECOVER fixed | No changes | No changes | No changes | No changes |