Other great resources: Overview
Returns an array of structure objects, optionally filtered to a specific player, structure type and looking player.Availability
Warzone 3.1 Beta 1 and above.
Note, however, that there have been several changes to the Structure objects that are returned by this function.
In the early beta releases, bug #3123 prevented scripts from getting lists of scavenger droids and structures. See scavengerPlayer for some ideas as to how to deal with that.
Syntax
var returnValue = enumStruct([player[, structTypeOrID[, viewer]]]);
Parameters
| Parameter | Type | Mandatory | Description | Game version |
|---|---|---|---|---|
| player | Number |  | The ID number of the player who's structures you want to list. Defaults to me. | 3.1 Beta 1 |
structTypeOrID | Constant or String | | The type of structure you want to list, usually specified by it's .stattype constant:
You can alternatively specify a structure type by it's ID as defined in structures.txt If the parameter is not specified, structures of all types will be returned. | 3.1 Beta 1 |
| viewer | Number | | List structures that a specific player can see (eg. on their sensors), with the player specified by their player ID. Defaults to -1 which means "don't filter based on viewer". | 3.1 Beta 1 |
Return value
| Value | Type | Description | Game version |
|---|---|---|---|
| <array> | Array | An array of Structure objects | 3.1 Beta 1 |
| [] | Array | If no matching structures are found, you get an empty array. | 3.1 Beta 1 |
| <error> | Error | If the player/viewer or droid type specified is incorrect, an error is thrown. | 3.1 Beta 1 |
Example
// get a list of all my structures var myStructures = enumStruct();
// build a list of all enemy structures, regardless of whether we can see them or not
var enemyStructs = [];
playerData.forEach(function(player) {
if (!allianceExistsBetween(me,player)) { // enemy player
enemyStructs = enemyStructs.concat(enumStruct(player));
}
});
See also
- Structures – quick reference to all JS API stuff relating to structures
- enumBlips() – get a list of radar detector blips on the map
- enumDroid() – get a list of droids on the map
- enumFeature() – get a list of features on the map
- enumStructOffWorld() – similar to enumStruct(), but gets a list of structures that aren't on the current map (used in campaigns when doing off-world missions)