Append Gameplay Tag Containers
BlueprintGameplayTagLibraryЧто это
Статическая exec-функция класса BlueprintGameplayTagLibrary. Добавляет все теги из исходного контейнера (Source) в целевой контейнер (Target). Изменяет Target напрямую (по ссылке). Аналог «добавить один контейнер в другой», но через модификацию существующего, а не через создание нового.
Пины
Exec-входы:
- execute (exec) — запуск операции
Exec-выходы:
- then (exec) — выполнение после завершения
Входы (данные):
- Target (GameplayTagContainer [by ref]) — контейнер, в который будут добавлены теги; изменяется на месте
- Source (GameplayTagContainer) — контейнер-источник с тегами для добавления
Выходы (данные):
- нет (void)
Когда используется
Типичный сценарий — накопление тегов на одном акторе или объекте в процессе выполнения (например, при сборе предметов с тегами, при применении нескольких статусных эффектов, чьи теги нужно объединить без создания лишних копий).
Типичные проблемы
- Изменение по ссылке (by ref): новички часто подключают к
Targetрезультат геттера (например, Get Gameplay Tag Container), который возвращает копию. В этом случае изменения не сохраняются в исходный объект — нужно использовать переменную, хранящую контейнер, или подключать пин как «by ref» через ссылку. - Путаница с Add: функция
Addвозвращает новый контейнер и не меняет исходники.Appendже работает «in-place» — ожидай модификации, а не копии. - Случайная потеря данных: если
Targetуже содержал теги, они не затираются — теги добавляются (внутри используется объединение множеств). Но порядок и дубликаты не гарантируются, так какGameplayTagContainerработает как множество.