Справочная карта по действиям аур — исполняемым блокам, которые вызываются из lifecycle-списков, скриптов, узлов behavior tree, макросов и пользовательских сценариев.
- Actions выполняют работу.
- Actions — это сущности аур, зарегистрированные через
IAuraRegistrator.
- В основе actions лежат сохраняемые свойства и, при необходимости, редакторы/метаданные.
- Логика выполнения обычно находится рядом с
ExecuteInternal.
- В lifecycle-списках ауры actions чаще всего запускаются при входе, пока аура активна и при выходе.
AuraActionBase<TProperties> — базовый класс для actions.ExecuteInternal — основной метод, где обычно находится логика action.CsharpScriptAction — сущность script action.CsharpScriptActionExecutor — базовый класс для script action в object-style.IAuraAccessor.Execute / ExecuteAsync — запуск ауры из скриптов.
-
Найти встроенный action:
- найдите регистрацию модуля через
Register<SomeAction>;
- проверьте свойства и метаданные action, если важны настройки в UI;
- откройте runtime-класс и
ExecuteInternal.
-
Добавить action:
- определите properties;
- определите runtime-модель;
- при необходимости добавьте editor/metadata;
- зарегистрируйте через
IAuraRegistrator.
- Для runtime-логики обычно используйте
ExecuteInternal.
- Для поиска пользовательских actions начинайте с регистраций в модуле.
- Для запуска аур из скриптов используйте
IAuraAccessor.
- Не используйте actions как state watchers; для состояния активации нужны triggers.
- Не создавайте action-модели напрямую из сохранённых метаданных.
AuraActionBase, ExecuteInternal, CsharpScriptAction,
CsharpScriptActionExecutor, IAuraAccessor, IAuraRegistrator,
SendInputAction, DelayAction, PlaySoundAction.
- action
- aura action
- execute action
- lifecycle action
- on enter
- while active
- on exit
- script action
auras/entities.mdauras/triggers.mdauras/overlays.mdscripting/runtime.md