setDesign()

Enable or disable the design tool...

Syntax

setDesign(enable);

Parameters

Parameter	Type	Mandatory	Description	Game version

Parameter

Type

Mandatory

Description

Game version

enable

Boolean

Should the design tool be enabled?

true – yes, enable the design tool
false – no, disable the design tool

Default: false

3.1 Beta 1

Return value

Value	Type	Description	Game version

Value	Type	Description	Game version
`undefined`	Undefined	The function always returns `undefined`	3.1 Beta 1

Notes

This function only affects the user interface for the localhost human player, it does not affect AIs in any way. That being said, AIs should avoid using new droid templates if they don't have a HQ if possible.

Enabling or disabling the design tool automatically shows or hides (as applicable) the DESIGN reticule button:

Example

Enable or disable design tool based on presence of HQ...

function eventStructureBuilt(structure) {
  if (structure.stattype == HQ) setDesign(true);
}
function eventDestroyed(gameObj) {
  if (gameObj.type==STRUCTURE && gameObj.stattype==HQ) setDesign(false);
}