Void setATB( sUnitName, n1 )

 

Функция позволяет управлять положением юнита на ATB. Значения второго параметра большие нуля приводят к сдвигу юнита по ATB в начало шкалы, прочие – в конец. Вероятно, существует какая-то количественная интерпретация параметра, но я ее не уловил. Следует вызывать только из хуков, т.к. в противном случае можно получить рассинхронизацию ATB с действительным порядком ходов.

Информационные и прочие функции.

TsUnits GetUnits(nSideID, nType)

 

Возвращает таблицу имен юнитов типа nType для стороны nSideID. Константы nType прописаны в /scripts/combat-startup.lua и могут быть

HERO = 0

CREATURE = 1

WAR_MACHINE = 2

BUILDING = 3

С использованием данной функции в файле /scripts/combat-startup.lua реализованы примитивы более высокого уровня:

sHeroName GetHero(nSideID)

tsUnits GetCreatures(nSideID)

tsUnits GetWarMachines(nSideID)

tsUnits GetBuildings(nSideID)

sHeroName GetAttackerHero()

sHeroName GetDefenderHero()

tsUnits GetAttackerCreatures()

tsUnits GetDefenderCreatures()

tsUnits GetAttackerWarMachines()

tsUnits GetDefenderWarMachines()

tsUnits GetAttackerBuildings()

tsUnits GetDefenderBuildings()

NCreatureID GetCreatureType(sCreatureName)

 

Возвращает тип существ в стеке с именем sCreatureName.

NX, nY pos(sUnitName)

 

Возвращает координаты юнита с именем sCreatureName. Функция имеет алиас с именем GetCombatPosition.

Bool combatStarted()

 

Возвращает false до тех пор, пока не началась былинная битва. Имеет смысл использовать только вне хуков.

SHeroName GetHeroName(sUnitName)

 

Возвращает «стратегическое» имя героя sUnitName. Если передано не имя героя – вызов приведет к ошибке.

Number GetCreatureNumber(sUnitName)

 

Возвращает количество существ в стеке с именем sUnitName.

NX, nY GetUnitPosition(sUnitName)

 

Аналог функции pos.

Bool exist(sUnitName)

 

Возвращает, а жив ли еще юнит с именем sUnitName. Функция имеет алиас с именем IsCombatUnit.

NHostType GetHost(nSideID)

 

Возвращает, под чьим управлением находится сторона nSideID – человека или AI.

Возвращаемые константы прописаны в /scripts/common.lua и могут быть

HUMAN = 0

COMPUTER = 1

С использованием данной функции в файле /scripts/combat-startup.lua реализованы примитивы более высокого уровня:

bool IsHuman(nSideID)

bool IsComputer(nSideID)

NSideID GetUnitSide(sUnitName)

 

Возвращает, к какой стороне относится юнит с именем sUnitName.

Возвращаемые константы прописаны в /scripts/combat-startup.lua и могут быть

ATTACKER = 0

DEFENDER = 1

С использованием данной функции в файле /scripts/combat-startup.lua реализованы примитивы более высокого уровня:

bool IsAttacker(sUnitName)

bool IsDefender(sUnitName)

Number GetUnitType(sUnitName)

 

Возвращает тип юнита с именем sUnitName. Возвращаемые константы прописаны в /scripts/combat-startup.lua и могут быть

HERO = 0

CREATURE = 1

WAR_MACHINE = 2

BUILDING = 3

С использованием данной функции в файле /scripts/combat-startup.lua реализованы примитивы более высокого уровня:

bool IsHero(sUnitName)

bool IsCreature(sUnitName)

bool IsWarMachine(sUnitName)

bool IsBuilding(sUnitName)

Number GetWarMachineType(sUnitName)

 

Возвращает тип машины с именем sUnitName. Возвращаемые константы прописаны в /scripts/common.lua и могут быть

WAR_MACHINE_BALLISTA = 1

WAR_MACHINE_CATAPULT = 2

WAR_MACHINE_FIRST_AID_TENT = 3

WAR_MACHINE_AMMO_CART = 4

С использованием данной функции в файле /scripts/combat-startup.lua реализованы примитивы более высокого уровня:

sUnitName GetWarMachine(nSideID, nWarMachineTypeID)

sUnitName GetAttackerWarMachine(nWarMachineTypeID)

sUnitName GetDefenderWarMachine(nWarMachineTypeID)

Number GetBuildingType(sUnitName)

 

Возвращает тип здания с именем sUnitName. Возвращаемые константы прописаны в /scripts/combat-startup.lua и могут быть

BUILDING_WALL = 1

BUILDING_GATE = 2

BUILDING_LEFT_TOWER = 3

BUILDING_BIG_TOWER = 4

BUILDING_MOAT = 5

BUILDING_RIGHT_TOWER = 6

BUILDING_MAGIC_WALL = 7

С использованием данной функции в файле /scripts/combat-startup.lua реализованы примитивы более высокого уровня:

sUnitName GetBuilding(nSideID, nBuildingID)

sUnitName GetAttackerBuilding(nBuildingID)

sUnitName GetDefenderBuilding(nBuildingID)