Настройка idle актера human

Основные принципы

Список FSM-состояний, из которых возможен запуск idle-анимаций:

• board - актер прилинкован к другому объекту;

• lie_idle - лежит;

• snipe - выглядывает из-за забора;

• squat - сидит;

• idle - стоит и ничем не занят.

Выбор idle-анимации происходит в два этапа:

1

Выбор запроса для Селектора анимаций

Логика выбора запроса описана в файле Селектора запроса \properties\animation_selector\human_idle_selector.set.

Опционально на данном этапе можно:

• переключать состояние и/или задавать время блокировки семафоров ;

• устанавливать новое FSM-состояние.

2

Выбор idle-анимаций

По выбранному на первом шаге запросу выбираются конкретные idle-анимации. Логика выбора описана в файле human_idle.inc, который является частью файла Селектора анимаций \properties\animation_selector\human.set

Для создания цепочек переключения idle-состояний в FSM хранится текущее idle-состояние актера.

Конфигурация Селектора idle-запроса

Синтаксис human_idle_selector.set

{init
	{state "<initial_state>"} ; обязательный параметр
	{semaphore "<name>" <time_from> <time_to>} 
}
{selector
	{if <condition>
		{idle
			{run "<request_name>"} ; имя запроса к Animation Selector
			{state "<new_state>"} ; при необходимости изменить состояние FSM
			{semaphore "<name>" <time_from> <time_to>} ; переопределение семафора
		}
	}
	[...]	
	{idle
		{run ""} ;запуск пустого запроса
	}
}

Компонент	Описание
{init ...}	Блок инициализации, вызывается при старте игры или спавне юнита. Задаёт начальное состояние FSM (state) и устанавливает блокировки семафоров (semaphore).
state "<initial_state>"	Устанавливает FSM-состояние актера сразу после его спавна. Обязательный параметр. Пример: "idle".
semaphore "<name>" <time_from> <time_to>	Блокирует или разблокирует семафор на указанное время (в секундах). Например, semaphore "can_smoke" 10 30 означает запрет курения на случайный срок от 10 до 30 сек.
{selector ...}	Основной блок, в котором происходит логика выбора запросов к Селектору анимаций в зависимости от текущего состояния FSM и условий.
{if <condition> ...}	Условная конструкция. Проверяет состояние FSM (fsm_tags, human_fsm_idle_state), активность семафоров (human_fsm_idle_semaphore), наличие взаимодействия актера с предметами (например, human_stuff holding) и другие параметры. Подробнее про синтаксис условий
{idle ...}	Блок для описания набора действий, исполняемых, если соответствующее условие выполнилось. Внутри блока задается команда run запуска запроса для Селектора анимаций. Опционально может задаваться смена состояния (state) и семафоров (semaphore).
run "<request_name>"	Команда активирует указанный запрос, который в дальнейшем используется в Селекторе анимаций (animation_selector/human.set). Пример: run "stand_smoking_begin". По имени запроса будет подобран соответствующий набор анимаций. Отсутствие указанного имени в команде означает запуск пустого запроса. При этом сохраняется текущая анимация актера.

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

Cостояния idle

В игре Men of War II используются два idle-состояния:

• idle - играет обычные idle анимации;

• smoking - играет анимации курения.

Чтобы добавить возможность выбора idle анимаций в состоянии, где его раньше никогда не было, необходимо добавить в коде состояния поддержку idle .

Семафоры в Селекторе idle-запросов

Семафоры применяются для управления частотой и условиями запуска определённых запросов. Они служат для задания временных ограничений, предотвращающих синхронное анимирование группы юнитов.

Синтаксис семафора

{semaphore "<semaphore_name>" N}

N - время блокировки семафора, в секундах.

Семафор может быть в 2-х состояниях:

• разрешен - N=0;

• заблокирован на указанное в N время.

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

Добавлять новые семафоры можно в блоке init

Семафоры idle-запросов, используемые в игре Men of War II

Имя семафора	Описание
can_smoke	Отвечает за доступность начала цикла курения. Пока семафор заблокирован, юнит не может вызвать запрос на начало курения (stand_smoking_begin). Блокируется после каждой сигареты, разблокируется через случайное время (например, 5–10 или 60–120 секунд).
can_inhale	Контролирует интервал между затяжками в процессе курения. Используется внутри состояния smoking для определения, когда можно вызвать запрос stand_smoking_process. После каждой затяжки блокируется на несколько секунд.
can_action	Разрешает проигрывание активных idle-действий (почёсывание, переминание и т. п.). Пока семафор заблокирован, юнит будет воспроизводить только нейтральные idle, такие как stand_breath, squat_breath, lie_breath. Блокировка регулирует частоту смены анимаций.
stop_smoking	Семафор, ограничивающий возможность завершения курения. Когда активен, запрос stand_smoking_end не будет выполнен. Используется для задания минимального времени нахождения в состоянии smoking, чтобы курение выглядело реалистично.

Пример использования семафоров в Селекторе idle-запросов

{init
	{state "idle"}
	{semaphore "can_smoke" 10 30} ; don't smoke right away
	{semaphore "can_inhale" 3 5}
	{semaphore "can_action" 5 15} ; start from breathing
}
{selector
	[...]
	{idle
		{run "stand_smoking_begin"} ; animations request string from human_idle.inc
		{state "smoking"} ; set new state
		{semaphore "stop_smoking" 20 40} ; disable semaphore for seconds in range
		{semaphore "can_inhale" 3 5} 
	}
	[...]
}

Пояснения

Блок init

• {state "idle"} Устанавливает стартовое состояние FSM юнита после спауна — idle (покой).

• {semaphore "can_smoke" 10 30} Блокирует возможность начать курение сразу. Юнит сможет курить только через 10–30 секунд.

• {semaphore "can_inhale" 3 5} Устанавливает интервал перед первой возможной затяжкой. Имеет значение, если юнит начнёт курить вскоре после появления.

• {semaphore "can_action" 5 15} Задаёт паузу перед тем, как юнит сможет выполнять более активные idle-анимации, чем дыхание. Пока семафор заблокирован — проигрываются только idle-анимации дыхания.

Блок idle

• {run "stand_smoking_begin"} Запускается запрос с именем stand_smoking_begin. Этот запрос будет передан в animation_selector/human.set, где будет выбран подходящий набор анимаций начала курения.

• {state "smoking"} FSM-состояние юнита обновляется на "smoking" — это влияет на дальнейший выбор запросов и условий.

• {semaphore "stop_smoking" 20 40} Устанавливает блокировку семафора stop_smoking на 20–40 секунд. Пока он активен, юнит не сможет завершить курение (вызов stand_smoking_end не сработает).

• {semaphore "can_inhale" 3 5} Устанавливает паузу перед следующей затяжкой (например, для запуска stand_smoking_process в следующем цикле).

Условия

Составные условия в Селекторе idle-запроса записываются с помощью логических операторов and , or и not

Условия, которые используются в первую очередь:

• {if human_fsm_idle_semaphore "can_smoke"

• {if human_fsm_idle_state "smoking_begin"

• {if fsm_tags "board"

Примеры условий в Селекторе idle-запроса ( human_idle_selector.set)

Условие	Значение
fsm_tags "board"	Проверка, есть ли у FSM-состояния тэг "board".
human_fsm_counter "forced_smoke" once	Проверка счетчика FSM "forced_smoke". Подробнее про проверку счетчиков
human_stuff holding "nothing"	Проверка, что у актера в руках ничего нет.
human_fsm_idle_state "idle"	Проверка текущего FSM -состояния при простое.
human_fsm_idle_semaphore "can_smoke"	Проверка, разрешен ли указанный семафор.
able "attention"	Проверка доступности способности attention.
not able "attention"	Обратная проверка — attention недоступен.

Пример вложенного составного условия в Селекторе idle-запросов

{if fsm_tags "up" 
    {if human_fsm_counter "forced_smoke" once and human_stuff holding "nothing" and human_fsm_idle_state "idle"
        {idle [...]}
    }
}

Используется двойное вложенное условие, где каждая часть должна быть выполнена, чтобы сработал соответствующий блок idle.

Проверка первого уровня: {if fsm_tags "up"} Этот блок обрабатывается только если FSM-состояние юнита помечено тегом "up" — например, стоит, находится вне укрытия и готов к действиям.

Проверка второго уровня:

Все три условия должны быть выполнены:

1. human_fsm_counter "forced_smoke" once Проверяет значение счётчика forced_smoke:

   • если > 0, возвращает true и сбрасывает счётчик в 0;

   • если 0, возвращает false.

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

2. human_stuff holding "nothing" Проверяет, что в руках у юнита ничего нет (ни оружия, ни предметов).

   Если юнит держит что-то, то условие не выполнится.

3. human_fsm_idle_state "idle" Проверяет, что текущее внутреннее состояние FSM в блоке idle — "idle".

   Это исключает конфликты с другими процессами (например, если юнит уже курит, то не запускать запрос повторно)

Варианты запроса для выбора idle-анимаций

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

Для запросов *_idle предполагается какая-то серьёзная активность Для запросов *_breath - ожидаются анимации дыхания или небольшого шевеления

Запрос	Описание
stand_idle stand_breath	Стоит
squat_idle squat_breath	Сидит
snipe_breath	Смотрит из-за горизонтального укрытия (окопы, заборы по пояс)
lie_idle lie_breath	Лежит
stand_smoking_begin	Поджигает сигарету
stand_smoking_process	Делает затяжку
stand_smoking_end	Тушит сигарету

Можно добавлять свои запросы на анимации и прописывать соответствующую выборку анимаций в файле human_idle.inc.