Changes by Version

Overview

 Ready made specific version detection: version.js.

Key:  Removed/Missing,  Added,  Buggy,  Deprecated but present,  Updated

Trivia: Per first announced the JS API back in April 2011!

Warzone 3.1

Warzone 3.1 brings some major improvements over earlier releases, in particular a fully functional JS API.

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.

Constants	Events	Functions	Globals	Objects
DORDER_DISEMBARK  DORDER_EMBARK DROID_CYBORG_CONSTRUCT DROID_CYBORG_REPAIR DROID_CYBORG_SUPER DROID_DEFAULT LASSAT	eventDestroyed() eventLaunchTransporter() eventMissionTimeout() eventReinforcementsArrived() eventStructureReady() eventVideoDone()	activateStructure() droidFromId() orderDroidBuild() orderDroidStatsLoc() pickStructLocation() structureIdle()	version	not investigated yet

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.

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.

Constants	Events	Functions	Globals	Objects
OPTIONS	No changes	debug() enumStructOffWorld()  structureIdle()	version	not investigated yet

Realising the API was going to undergo more changes in the future, the Backport project was started.

3.1 Beta 5

Beta 5 fixed a long-term issue with save games, but introduced a new bug in multiplayer games.

Just one small change, but it does mean that we can now properly differentiate between the two types of transporter. Prior to Beta 5, I recommend avoiding doing anything with transports.

Also in Beta 5, 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.

3.1 Beta 6

Beta 6 was released a day after Beta 5, in order to fix a serious multiplayer bug.

There were no other changes between Beta 5 and 6. Nothing at all changed in the JS API!

In version.js, Beta 5 is reported as Beta 6 (there's no way to differentiate between them so might as well assume the later version).

3.1 Beta 7-9

Changes for these versions haven't yet been determined, sorry.

3.1 Beta 10

Note: Changes listed here might have happened in Beta 7-9.

The BEING_DEMOLISHED constant was removed. It's an issue because it's now harder to circumvent a bug in structureIdle().

The enableTemplate() function was added, allowing production of DROID_CONSTRUCT prior to building a HQ.

3.1 Beta 11

Two new constants were added: PLAYER_DATA and RESEARCH_DATA.

3.1 RC 2

Note: 3.1 RC 1 was skipped due to some major bugs.

The getDroidLimit() function was added.