Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3
Excerpt

Set limits on how many structures of a specific type a player can build.

 

Syntax

(warning) You must wrap this function call with hackNetOff() and hackNetOn() functions.

Code Block
themeRDark
languagejavascript
linenumberstrue
hackNetOff();
setStructureLimits(structure,limit[,player]);
applyLimitSet(); // need to call this to apply the limits
hackNetOn();

Parameters

ParameterTypeMandatoryDescriptionGame version
structureIdString(tick)The ID of the structure, taken from structures.txt3.1 Beta 1
limitNumber(tick)The maximum number of the structure the player can build.3.1 Beta 1
playerNumber(error)

The player ID to apply the limits to.

Defaults to me.

3.1 Beta 1

Return value

ValueTypeDescriptionGame version
undefinedUndefinedThe function always returns undefined3.1 Beta 1
<error>ErrorInvalid structure or the limit value was too high (too many buildings)3.1 Beta 1

Example

Code Block
themeRDark
languagejavascript
linenumberstrue
hackNetOff();
for (var playnum=0; playnum<maxPlayers; playnum++) {
  setStructureLimits("A0LightFactory", 5, playnum);
  setStructureLimits("A0PowerGenerator", 8, playnum);
  setStructureLimits("A0ResearchFacility", 5, playnum);
  setStructureLimits("A0CommandCentre", 1, playnum);
  setStructureLimits("A0ComDroidControl", 1, playnum);
  setStructureLimits("A0CyborgFactory", 5, playnum);
  setStructureLimits("A0VTolFactory1", 5, playnum);
}
applyLimitSet();
hackNetOn();
Div
classnotice box ping

You must wrap this function with hackNetOff() and hackNetOn() functions. 

Div
classbox suggest

The setStructureLimits() function is primarily used when applying
Player Initialisation Rules.

Include PageWikiGuide:ContentsWikiGuide:Contents

Div
classbox
Availability This function is compatible with
Status
colourGreen
title3.1 b1+

Requires:

  • Warzone 3.1 Beta 1 and above
Div
classbox
Contents

Jump to:

Table of Contents
maxLevel5

Div
classbox

See also

The following JS API features relate to this functionRelated articles: