Вызывается каждые 20 секунд простоя криттера.

Для изменения времени вызова события используйте метод Critter::Wait в обработчике.

Сигнатура обработчика:

void _FuncName(Critter& cr)

См. также

Critter::EventIdle

Вызывается при удалении криттера из игры.

Сигнатура обработчика:

void _FuncName(Critter& cr, bool deleted)

Аргументы

deleted

@с true - функция вызвана перед полным удалением криттера, @с false - функция вызвана остановкой сервера.

См. также

Critter::EventFinish

Вызывается при смерти криттера перед глобальным обработчиком смертей critter_dead.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter@ killer)

Аргументы

killer

Если криттер был убит другим криттером, то аргумент содержит указатель на убившего криттера.

См. также

Critter::ToDead Critter::EventDead critter_dead

Вызывается при оживлении криттера после смерти (респауне).

Сигнатура обработчика:

void _FuncName(Critter& cr)

См. также

Critter::ToLife Critter::EventRespawn critter_respawn

Вызывается при уходе криттера в нокаут.

Сигнатура обработчика:

void _FuncName(Critter& cr, bool faceUp, uint lostAp, uint knockDist)

Аргументы

faceUp	Показывает, упал ли криттер лицом вверх (true) или вниз (false).
lostAp	Количество очков действия, необходимых для поднятия с земли.
knockDist	Количество гексов, на которое "отлетел" криттер.

См. также

Critter::ToKnockout Critter::EventKnockout

Вызывается при атаке криттером кого-либо.

Сигнатура обработчика:

bool _FuncName(Critter& cr, Critter& target);

Аргументы

target

Атакуемый криттер.

Возвращает

При возвращенном значении true глобальный обработчик critter_attack не вызывается.

См. также

Critter::EventAttack CRITTER_EVENT_SMTH_ATTACK ITEM_EVENT_ATTACK critter_attack

Вызывается когда данного криттера атаковали.

Сигнатура обработчика:

bool _FuncName(Critter& cr, Critter& attacker);

Аргументы

attacker

Атакующий криттер.

Возвращает

При возвращенном значении true глобальный обработчик critter_attacked не вызывается.

См. также

Critter::EventAttacked CRITTER_EVENT_SMTH_ATTACKED critter_attacked

Вызываетcя при попытке воровства у данного криттера.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& thief, bool success, Item& item, uint count)

Аргументы

thief	Вор.
success	Успешно ли произошло воровство, расчитанное в critter_stealing.
item	Воруемый предмет.
count	Количество воруемых предметов.

См. также

Critter::EventStealing CRITTER_EVENT_SMTH_STEALING critter_stealing

Вызывается когда с NPC начинается или заканчивается бартер.

Сигнатура обработчика:

bool _FuncName(Critter& cr, Critter& player, bool attach, uint barterCount)

Аргументы

player	Игрок, начинающий или заканчивающий бартер.
attach	Показывает, начинается (true) или заканчивается (false) бартер.
barterCount	Всего торгующих, включая новое присоединение/отсоединение.

Возвращает

При возвращении true – бартер начинается; false – бартер не начинается. Актуально при attach == true.

См. также

Critter::EventBarter

Вызывается, когда с NPC начинают или заканчивают разговор.

Сигнатура обработчика:

bool _FuncName(Critter& cr, Critter& player, bool attach, uint talkCount)

Аргументы

player	Игрок, начинающий или заканчивающий разговор.
attach	Показывает, начинается (true) или заканчивается (false) разговор.
talkCount	Всего разговаривающих, включая новое присоединение/отсоединение.

Возвращает

При возвращении true – диалог начинается; false – не начинается. Актуально при attach == true.

См. также

Critter::EventTalk

Вызывается при использовании навыка на что-либо.

Аргументы

skill	Используемый скилл (см. Навыки и Special Skill Values).
onCritter	Если предмет используется на криттере, то аргумент содержит указатель на этого криттера.
onItem	Если предмет используется на другом предмете, то аргумент содержит указатель на этот (другой) предмет.
onScenery	Если предмет используется на сценери, то аргумент содержит указатель на это сценери.

Возвращает

При false вызывается глобальный обработчик critter_use_skill При true – выход.

См. также

Critter::EventUseSkill ITEM_EVENT_SKILL

Вызывается при использовании кем-то навыка на данном криттере.

Аргументы

whoUse	Криттер использующий скилл
skill	Используемый скилл (см. Навыки и Special Skill Values).

Возвращает

При false вызывается глобальный обработчик critter_use_skill При true – выход.

Вызывается при использовании данными криттером какого-либо предмета.

Аргументы

item	Используемый предмет.
onCritter	Если предмет используется на криттере, то аргумент содержит указатель на этого криттера.
onItem	Если предмет используется на другом предмете, то аргумент содержит указатель на этот (другой) предмет.
onScenery	Если предмет используется на сценери, то аргумент содержит указатель на это сценери.

Возвращает

При false вызывается глобальный обработчик critter_use_item. При true – выход.

См. также

Critter::EventUseItem ITEM_EVENT_USE critter_use_item

Вызывается при использовании какого-либо предмета на данном криттере.

Аргументы

whoUse	Криттер использовавший предмет.
Item&	Используемый предмет.

Возвращает

При false вызывается глобальный обработчик critter_use_item. При true – выход.

Вызывается при появлении предмета в поле зрения.

Сигнатура обработчика:

void _FuncName(Critter& cr, Item& showItem, bool added, Critter@ dropper)

Аргументы

showItem	Появившийся предмет.
added	true, если предмет появился при смене радиуса обзора криттера; false, если предмет появился в ином случае (например, если был выкинут другим криттером).
dropper	Если предмет был выкинут из инвентаря какого-либо криттера, то аргумент будет содержать указатель на этого криттера. В противном случае, null.

См. также

Critter::EventShowItemOnMap

Вызывается в том случае, если поменялся предмет в поле зрения.

Например, открылась или закрылась дверь (или контейнер).

Сигнатура обработчика:

void _FuncName(Critter& cr, Item& item)

Аргументы

item	Изменившийся предмет.

См. также

Critter::EventChangeItemOnMap

Вызывается при исчезновении предмета из поля зрения.

Сигнатура обработчика:

void _FuncName(Critter& cr, Item& hidedItem, bool removed, Critter@ picker)

Аргументы

hidedItem	Исчезнувший предмет.
removed	true, если предмет исчез при смене радиуса обзора криттера; false, если предмет исчез в рамках радиуса обзора (например, если был подобран другим криттером).
picker	Если предмет был подобран каким-либо криттером, то аргумент будет содержать указатель на этого криттера. В противном случае, null.

См. также

Critter::EventHideItemOnMap

Вызывается при выкидывании криттером предмета из своего инвентаря.

Сигнатура обработчика:

void _FuncName(Critter& cr, Item& item)

Аргументы

item	Выкидиваемый предмет.

См. также

Critter::EventDropItem ITEM_EVENT_DROP

Вызывается при перемещении какого-либо предмета в инвентаре данного криттера.

Сигнатура обработчика:

void _FuncName(Critter& cr, Item& item, uint8 fromSlot)

Аргументы

item	Перемещаемый предмет.
fromSlot	Слот, в котором предмет находился до перемещения (см. Слоты инвентаря).

См. также

Critter::EventMoveItem ITEM_EVENT_MOVE

Вызывается при появлении нового криттера в поле зрения.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& showCr)

Аргументы

showCr

Появившийся в поле зрения криттер.

См. также

Critter::EventShowCritter

Вызывается при появлении нового криттера в поле зрения.

Радиус обнаружения регулируется с помощью поля Critter::ShowCritterDist1.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& showCr)

Аргументы

showCr

Появившийся в поле зрения криттер.

См. также

Critter::EventShowCritter1 Critter::ShowCritterDist1

Вызывается при появлении нового криттера в поле зрения.

Радиус обнаружения регулируется с помощью поля Critter::ShowCritterDist2.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& showCr)

Аргументы

showCr

Появившийся в поле зрения криттер.

См. также

Critter::EventShowCritter2 Critter::ShowCritterDist2

Вызывается при появлении нового криттера в поле зрения.

Радиус обнаружения регулируется с помощью поля Critter::ShowCritterDist3.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& showCr)

Аргументы

showCr

Появившийся в поле зрения криттер.

См. также

Critter::EventShowCritter3 Critter::ShowCritterDist3

Вызывается при пропаже криттера из поля зрения.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& hideCr)

Аргументы

hideCr

Исчезнувший из поля зрения криттера.

См. также

Critter::EventHideCritter

Вызывается при пропаже криттера из поля зрения.

Радиус поля зрения определяется полем Critter::ShowCritterDist1.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& hideCr)

Аргументы

hideCr

Исчезнувший из поля зрения криттера.

См. также

Critter::EventHideCritter1 Critter::ShowCritterDist1

Вызывается при пропаже криттера из поля зрения.

Радиус поля зрения определяется полем Critter::ShowCritterDist2.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& hideCr)

Аргументы

hideCr

Исчезнувший из поля зрения криттера.

См. также

Critter::EventHideCritter2 Critter::ShowCritterDist2

Вызывается при пропаже криттера из поля зрения.

Радиус поля зрения определяется полем Critter::ShowCritterDist1.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& hideCr)

Аргументы

hideCr

Исчезнувший из поля зрения криттера.

См. также

Critter::EventHideCritter3 Critter::ShowCritterDist3

Вызывается, когда приходит сообщение, отправленное с помощью метода Critter::SendMessage.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& fromCr, int message, int value)

Аргументы

fromCr	Криттер, отправивший сообщение.
message	Номер сообщения.
value	Переданное значение.

См. также

Critter::SendMessage Critter::EventMessage

Вызывается, когда криттер в области видимости умирает.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& fromCr, Critter@ killer)

Аргументы

fromCr	Умерший криттер.
killer	Если криттер был убит другим криттером, то аргумент содержит указатель на убившего криттера.

См. также

Critter::EventSmthDead CRITTER_EVENT_DEAD

Вызывается, когда какой-либо криттер в области видимости подвергся краже.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& fromCr, Critter& thief, bool success, Item& item, uint count)

Аргументы

fromCr	Криттер, подвергшийся воровству.
thief	Криттер, совершивший воровство.
success	Успешно ли произошло воровство.
item	Сворованный предмет.
count	Количество сворованных предметов.

См. также

Critter::EventSmthStealing CRITTER_EVENT_STEALING

Вызывается, когда какой-либо криттер в области видимости атакует кого-либо.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& fromCr, Critter& target)

Аргументы

fromCr	Атаковавший криттер.
target	Атакованный криттер.

См. также

Critter::EventSmthAttack CRITTER_EVENT_ATTACK

Вызывается, когда какой-либо криттер в области видимости атакован.

См. CRITTER_EVENT_ATTACKED.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& fromCr, Critter& attacker)

Аргументы

fromCr	Атакованный криттер.
attacker	Атаковаший криттер.

См. также

Critter::EventSmthAttacked CRITTER_EVENT_ATTACKED

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

См. CRITTER_EVENT_USE_ITEM.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& fromCr, Item& item, Critter@ onCritter, Item@ onItem, Scenery@ onScenery)

Аргументы

fromCr	Криттер использующий предмет.
item	Используемый предмет.
onCritter	Если предмет используется на криттере, то аргумент содержит указатель на этого криттера.
onItem	Если предмет используется на другом предмете, то аргумент содержит указатель на этот (другой) предмет.
onScenery	Если предмет используется на сценери, то аргумент содержит указатель на это сценери.

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

См. CRITTER_EVENT_USE_SKILL.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& fromCr, int skill, Critter@ onCritter, Item@ onItem, Scenery@ onScenery)

Аргументы

fromCr	Криттер использующий навык.
skill	Используемый скил. (см. Навыки и Special Skill Values).
onCritter	Если предмет используется на криттере, то аргумент содержит указатель на этого криттера.
onItem	Если предмет используется на другом предмете, то аргумент содержит указатель на этот (другой) предмет.
onScenery	Если предмет используется на сценери, то аргумент содержит указатель на это сценери.

Вызывается, когда криттер в области видимости выкидывает предмет.

См. CRITTER_EVENT_DROP_ITEM.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& fromCr, Item& item)

Аргументы

fromCr	Криттер выкинувший итем
item	Выкидиваемый предмет.

Вызывается, когда криттер в области видимости меняет местоположение предмета.

См. CRITTER_EVENT_MOVE_ITEM.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& fromCr, Item& item, uint8 fromSlot)

Аргументы

fromCr	Криттер поменявший у итема место
item	Перемещаемый предмет.
fromSlot	Слот, в котором предмет находился до перемещения (см. Слоты инвентаря).

Вызывается, когда криттер в области видимости уходит в нокаут.

См. CRITTER_EVENT_KNOCKOUT.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& fromCr, bool faceUp, uint lostAp, uint knockDist)

Аргументы

fromCr	Ушедший в нокаут криттер.
faceUp	Показывает, упал ли криттер лицом вверх (true) или вниз (false).
lostAp	Количество очков действия, необходимых для поднятия с земли.
knockDist	Количество гексов, на которое "отлетел" криттер.

Вызывается перед добавлением плана (которого еще нет в списках у NPC).

Сигнатура обработчика:

int _FuncName(Critter& cr, NpcPlane& plane, uint childIndex, int reason, Critter@ someCr, Item@ someItem)

Аргументы

plane	План.
childIndex	Номер плана в качестве наследника, если 0, значит план базовый.
reason	Указывает причину начала плана (см. Plane begin reasons).
someCr	В некоторых случаях хранит указатель на персонажа (см. Работа с планами ).
someItem	В некоторых случаях хранит указатель на предмет (см. Работа с планами ).

Возвращает

PLANE_RUN_GLOBAL - вызвать глобальный обработчик, который определит сохранить или удалить план; PLANE_KEEP - сохранить план, без вызова глобального обработчика; PLANE_DISCARD - удалить план, без вызова глобального обработчика.

Вызывается перед удалением плана (который ещё присутствует в списках планов).

Сигнатура обработчика:

int _FuncName(Critter& cr, NpcPlane& plane, uint childIndex, int reason, Critter@ someCr, Item@ someItem)

Аргументы

plane	План.
childIndex	Номер плана в качестве наследника, если 0, значит план базовый.
reason	Указывает причину завершения плана (см. Plane end reasons).
someCr	В некоторых случаях хранит указатель на персонажа (см. Работа с планами ).
someItem	В некоторых случаях хранит указатель на предмет (см. Работа с планами ).

Возвращает

PLANE_RUN_GLOBAL - вызвать глобальный обработчик, который определит сохранить или удалить план; PLANE_KEEP - сохранить план, без вызова глобального обработчика; PLANE_DISCARD - удалить план, без вызова глобального обработчика.

Вызывается во время выполнения некоторых планов.

Сигнатура обработчика:

int _FuncName(Critter& cr, NpcPlane& plane, uint childIndex, int reason, uint& r0, uint& r1, uint& r2)

Аргументы

plane	План, для которого вызвано событие.
childIndex	Номер плана в цепочке наследников.
reason	Причина, по которой было вызвано событие. От неё зависит интерпретация остальных аргументов.

Возвращает

PLANE_RUN_GLOBAL - вызвать глобальный обработчик, который определит сохранить или удалить план; PLANE_KEEP - сохранить план, без вызова глобального обработчика; PLANE_DISCARD - удалить план, без вызова глобального обработчика.

На данный момент событие вызываются для обработки следующих действий:

• REASON_ATTACK_WEAPON. Выбор оружия атакующим криттером.

  Аргументы

  [in]	r0	Идентификатор криттера-цели.
  [in]	r1,r2	Не используются.
  [out]	r0	Идентификатор выбранного для атаки предмета-оружия.
  [out]	r1	Номер, обозначающий способ использования оружия (см. ProtoItem::Weapon_SetUse).
  [out]	r2	Идентификатор тмпа рукопашной атаки (учитывается, если r0 == 0) (?).

• REASON_ATTACK_DISTANTION. Выбор дистанции атаки. (?)

  Аргументы

  [in]	r0	Идентификатор криттера-цели.
  [in]	r1	NPC не может двигаться при r1 != 0.
  [in]	r2	Минимальное количество HP (из AI.TXT).
  [out]	r0	Лучшая дистанция.
  [out]	r1	Минимальная дистанция.
  [out]	r2	Максимальная дистанция. Если r2 == 0, то это означает, что нужно убегать.

• REASON_ATTACK_USE_AIM. Прицеливание.

  Аргументы

  [in]	r0	Идентификатор криттера-цели..
  [in]	r1	Не используется.
  [in]	r2	Не используется.
  [out]	r0	Номер, обозначающий способ использования оружия (см. ProtoItem::Weapon_SetUse).
  [out]	r1	Цель (см. Hit Locations).
  [out]	r2	Время (в мс), на которое нужно сделать паузу при атаке.

Вызывается при событиях на глобальной карте.

Позволяет обрабатывать события от глобальной карты индивидуально для любого криттера.

Сигнатура обработчика:

bool _FuncName(Critter& cr, int type, Critter@[]& group, Item@ car, uint& x, uint& y, uint& toX, uint& toY, uint& speed, uint& encounterDescriptor, bool& waitForAnswer)

Аргументы

type	Тип события (см. Global Map Events);
group	Указатели на криттеров в группе, если она сформирована;
car	Указатель на машину, если она имеется;
x	Текущая координата X группы на глобальной карте;
y	Текущая координата Y группы на глобальной карте;
toX	Координата X конечной точки движения;
toY	Координата Y конечной точки движения;
speed	Скорость движения в данной точке (зависит от маски глобальной карты);
encounterDescriptor	Уникальный идентификатор энкаунтера;
waitForAnswer	Ожидание ответа лидера группы.

Прим.

Аргументы передающиеся по ссылке (кроме cr и group) можно переназначать.

Возвращает

true - глобальный обработчик global_process не запускается; false - запуск глобального обработчика.

См. также

global_process

Вызывается при переходе на карту на глобальной карте мира.

Сигнатура обработчика:

bool _FuncName(Critter& cr, Critter@[]& group, Item@ car, uint encounterDescriptor, int combatMode, uint& mapId, uint16& hexX, uint16& hexY, uint8& dir)

Аргументы

group	указатели на криттеров в группе, если она сформирована;
car	указатель на машину, если она имеется;
encounterDescriptor	уникальный идентификатор энкаунтера;
combatMode	режим боя (COMBAT_MODE_ANY, COMBAT_MODE_REAL_TIME или COMBAT_MODE_TURN_BASED);
mapId	идентификатор карты;
hexX	начальные координата X для появления группы;
hexY	начальные координата Y для появления группы;
dir	направление криттера по умолчанию.

Возвращает

true - глобальный обработчик global_invite не запускается; false - запуск глобального обработчика.

См. также

global_invite

Вызывается в начале и в конце хода криттера.

Сигнатура обработчика:

void _FuncName(Critter& cr, Map& map, bool beginTurn)

Аргументы

map	карта на которой зафиксировано событие;
beginTurn	true - функция вызвана в начале хода, false - функция вызвана в конце хода.

Вызывается в начале и конце хода какого-либо криттера в области видимости.

Сигнатура обработчика:

void _FuncName(Critter& cr, Critter& fromCr, Map& map, bool beginTurn)

Аргументы

map	карта на которой зафиксировано событие;
beginTurn	true - функция вызвана в начале хода, false - функция вызвана в конце хода.