Clear Blackboard Value
BTFunctionLibrary
0
Что это
Exec-функция из библиотеки Behavior Tree, которая сбрасывает значение указанного ключа в Blackboard-компоненте обратно в «не установлено» (unset). Полезна для завершения состояния задачи, когда нужно очистить флаг, цель или ссылку.
Пины
Exec-входы:
- execute (exec) — запуск очистки
Exec-выходы:
- then (exec) — продолжение выполнения после очистки
Входы (данные):
- Target (BehaviorTreeComponent) — компонент Behavior Tree, которому принадлежит Blackboard
- Key (BlackboardKeySelector) — ключ, значение которого нужно очистить (выбор из списка ключей Blackboard)
Выходы (данные):
- нет (void)
Когда используется
- В задачах (Tasks) или сервисах (Services) для сброса временных меток, целей (Object/Vector/Name) или булевых флагов при завершении ветки Behaviour Tree.
- В декораторах для обеспечения идемпотентности: повторная установка/очистка одного и того же ключа без дублирования.
Типичные проблемы
- Ключ не выбран или неверный — если Key не настроен (пустой селектор) или выбран ключ из другого Blackboard, операция игнорируется или вызывает ошибку в рантайме.
- Очистка без последуюей проверки — после очистки IsSet для этого ключа вернёт false, что может сломать логику, если другая нода ожидает установленное значение.
- Забытый Target — при вызове вне собственного Behavior Tree (например, через ссылку на другой компонент) нужно явно подклчачить Target; иначе очистка не произойдёт.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.