Contents

  1. getBuildingLevel
  2. getBuildingByTypeId
  3. getBuildingByPosId
  4. countBuilding
  5. hasBuilding
  6. getTownHallLevel
  7. getWallLevel

See also: Building Objects
See also: Building Types

Usage:

city.getBuildingLevel(BuildingType)

Example:

level = city.getBuildingLevel(23)

This example finds the level of the Market (typeID = 23).

This example cancels all trades if the number of trades is equal to the level of the Market (typeID = 23).

Usage:

city.getBuildingByTypeId(BuildingType)

Example:

city.getBuildingByTypeId(23)

This function returns an object for the building with the highest level of that typeId. For example, to find your highest level barrack (typeID = 2):

Valid parameters for this object are level, name, positionId, startTime, endTime, typeId, and status. For example you can echo city.getBuildingByTypeId(2).name or city.getBuildingByTypeId(2).status.

Usage:

city.getBuildingByPosId(pos)

Example:

city.getBuildingByPosId(2)

This example finds the name of the building at position 2:

You can find the positions with this:

[Image:http://i47.tinypic.com/21c5gro.jpg] [Image:http://i.imgur.com/r1Voz7t.png]

Usage:

city.countBuilding(BuildingType[,MinLevel[,MaxLevel]])

Example:

totalmines = city.countBuilding(6,1,10)

This example gives the total count of all iron mines (typeID = 6) between level 1 and 10:

This example will check if you have at least 3 sawmills (typeID = 4) at level 5 or higher:

The MinLevel and MaxLevel parameters in countBuilding are optional. If you do not specify a minimum level, it defaults to level 1. If you do not specify a maximum level, it defaults to level 10.

Usage:

city.hasBuilding(typeId[,!Minlevel])

Example:

city.hasBuilding(2,10)

This function allows you to check if you have a building of a certain typeId of at least a specified level. The MinLevel is optional. If you do not specify a minimum level, it defaults to level 1.

In the example above, the check would return true if the city had a level 10 barrack in it.

Usage:

city.getTownHallLevel()

Example:

echo city.getTownHallLevel()

This function returns the level of the townhall in the city.

Usage:

city.getWallLevel()

Example:

echo city.getWallLevel()

This function returns the level of the wall in the city.


------------------------------------------------------------------------------

CategoryFunctions