Отладка анимаций в редакторе

В отладочной версии Gem RTS предусмотрены инструменты для анализа состояния FSM, анимаций и параметров анимируемых объектов. Это позволяет быстро диагностировать ошибки и проверить корректность логики поведения юнита.

Включение режима отладки

1. Запустите редактор и нажмите F10 для настройки режима отладки.

2. В списке Render Layer List Window отметьте галочками:

   • entity

   • fsm

   • animation

3. Выделите рамкой тестируемого юнита.

4. Слева от объекта появятся отладочные поля FSM.

Отладочный режим редактора для тестирования анимаций и FSM актера human

Секция fsm (Finite State Machine)

Параметры, отображаемые для выбранного юнита:

Параметр	Описание
subset	Текущее подмножество FSM
state	Текущее FSM-состояние юнита.
currentStuff	Тип объекта, находящегося в руках.
pickingStuff	Тип объекта, который юнит поднимает с земли.
mountingStuff	Тип объекта, который юнит берёт в руки.
counter.*	Состояния внутренних счётчиков FSM.
idleState	Текущее выбранное состояние в блоке idle.
idleSemaphore	Состояние семафоров, влияющих на выбор idle-анимаций.
pose* aimer* fire*	Анимации, выбранные для текущей позы юнита (в т.ч. прицеливания и стрельбы).

Секция animation

В этой секции отображается информация о текущих и последних анимациях юнита.

Параметр	Описание
Список анимаций	Названия проигрываемых анимаций. Анимации, которые уже проиграны, отмечены *.
frame	Текущий кадр анимации.
of	Общее количество кадров в анимации.
speed	Скорость воспроизведения анимации.
smoothFrames	Количество кадров, на которые выполнялся blend-переход между анимациями.

В отладочной версии игры в game.log выводятся ошибки, связанные с отсутствием нужных анимаций. Такие строки помечаются тегом [ANM]. Работает только для юнитов типа human.

Секция entity

Параметр	Описание
kill_flags	Флаги, определяющие способ убийства юнита.
last_dying_animation	Анимация смерти, сохранённая движком. Используется для корректной позы после загрузки.

---

Дополнительные инструменты отладки анимаций

Отображение костей скелета

• Включить отображение костей скелета - консольная команда v_bones 1

• Быстрое включение/выключение - комбинация клавиш ALT + S.

• Цветовая маркировка осей:

  • X — красный

  • Y — зелёный

  • Z — синий

Фильтрация костей по имени

Для отображения только части костей по имени используется консольная команда v_bonesNames "<name>"

Пример использования консольной команды v_bonesNames

v_bonesNames "body"
v_bones 1

Отобразятся только кости c именем body (туловища\корпуса)

Отображение точек привязки на модели

Для отображения именованных точек привязки (например, для FX или объектов в руках), используется консольная команда v_boarder 1