Работа с объективами (или с обжективами – кому как).

nState GetObjectiveState( sObjectiveName, nPlayerID = PLAYER_1 )

Возвращает статус объективы sObjectiveName. Соотв. константы прописаны в /scripts/advmap-startup.lua и бывают такими:

OBJECTIVE_SCENARIO_INFO = 0

OBJECTIVE_UNKNOWN = 1

OBJECTIVE_ACTIVE = 2

OBJECTIVE_COMPLETED = 3

OBJECTIVE_FAILED = 4

void SetObjectiveState( sObjectiveName, nState, nPlayerID = PLAYER_1 )

Устанавливает статус объективы с именем sObjectiveName. Следует понимать, что не у всех объектив статус можно установить вручную – можно или нельзя, определяется дизайном карты. Если таки нельзя, то вызов ни к чему, кроме выдачи ошибки в консоль, не приведет.

Кроме того, то, какой статус можно установить объективе зависит от текущего статуса объективы. Матрица переходов следующая:

OBJECTIVE_SCENARIO_INFO -> none

OBJECTIVE_UNKNOWN -> OBJECTIVE_ACTIVE, OBJECTIVE_FAILED

OBJECTIVE_ACTIVE -> OBJECTIVE_COMPLETED, OBJECTIVE_FAILED

OBJECTIVE_COMPLETED -> OBJECTIVE_ACTIVE, OBJECTIVE_FAILED

OBJECTIVE_FAILED -> none

Если объективе выставляется статус OBJECTIVE_ACTIVE она автоматически становится видимой игроку (см. IsObjectiveVisible/SetObjectiveVisible)

nProgress GetObjectiveProgress( sObjectiveName, nPlayerID = PLAYER_1 )

void SetObjectiveProgress( sObjectiveName, nProgress, nPlayerID = PLAYER_1 )

Возвращает и устанавливает степень прогресса в выполнении объективы sObjectiveName в случае, если дизайн это позволяет. Типичный пример – директива «наберите армию из 1000 лучников».

bool IsObjectiveVisible( sObjectiveName, nPlayerID = PLAYER_1 )

void SetObjectiveVisible( sObjectiveName, bVisible, nPlayerID = PLAYER_1 )

Функции возвращают и устанавливают видимость на интерфейсе объективы с именем sObjectiveName.

Работа с ключами.

Bool HasBorderguardKey( nPlayerID, nKeyID )

Void GiveBorderguardKey( nPlayerID, nKeyID )

Функции проверяют наличие и выдают игроку ключ должного цвета. Соотв. константы для nKeyID прописаны в /scripts/advmap-startup.lua и бывают такими:

RED_KEY = 1

BLUE_KEY = 2

GREEN_KEY = 3

YELLOW_KEY = 4

ORANGE_KEY = 5

TEAL_KEY = 6

PURPLE_KEY = 7

TAN_KEY = 8

Работа с регионами.

void SetRegionBlocked( sRegionName, bEnable, nPlayerID = -1 )

Блокирует/разблокирует регион sRegionName для игрока nPlayerID. Если последний параметр не указан, то данное действие производится для всех игроков.

Bool IsRegionBlocked( sRegionName, nPlayerID )

Возвращает, заблокирован ли регион sRegionName для игрока nPlayerID.

TsObjects GetObjectsInRegion( sRegionName, nObjectsTypeID )

Возвращает массив имен объектов в регионе с именем sRegionName. На настоящий момент второй параметр может быть только OBJECT_HERO = 0, а соотв. массив будет содержать только информацию о героях. На основе данной функции в файле /scripts/advmap-common.lua реализован примитив более высокого уровня –

bool IsPlayerHeroesInRegion( nPlayerID, sRegionName )

NX, nY, nFloorID RegionToPoint( sRegionName )

Возвращает координаты региона в том случае, если регион состоит из одного тайла. Если нет – ничего полезного не вернет, а ошибку таки вызовет.

Bool IsObjectInRegion( sHeroName, sRegionName )

Проверяет, находится ли объект sHeroName внутри региона sRegionName. На настоящий момент функция работает только для объектов одного типа – для героев.

Void OpenRegionFog( nPlayerID, sRegionName )

Открывает для игрока nPlayerID туман войны, скрывающий регион sRegionName.

Работа с AI.

Для не AI игрока перечисленные ниже функции смысла не имеют, и при вызове приводят к ошибке.

Void SetAIPlayerAttractor( sObjectName, nPlayerID, nPriority )

Устанавливает для игрока nPlayerID «точку притяжения» на объекте с именем sObjectName. Герои игрока будут бегать вокруг объекта, периодически к нему возвращаясь и пытаясь им овладеть. (Да-да, Вы правильно подумали, в качестве имени объекта в данной функции может выступать и имя героя). Поведение игрока будет тем агрессивнее, чем больше nPriority. Последний может принимать значения от -1 до 2. Значение nPriority = 0 является выделенным, и используется для того, чтобы убрать данную логику. В официальном руководстве по скрипту имеется предупреждение, что данная функция может некорректно работать для подвижных объектов.