Mark Property Dirty
NetPushModelHelpersЧто это
Exec-функция, которая помечает указанное свойство (property) объекта как «грязное» (dirty) для системы репликации с моделью Push (Net Push Model). Используется для принудительной отправки изменённого свойства всем клиентам, подключённым к серверу, без необходимости вызывать ForceNetUpdate на всём Actor’е.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (Object) — объект, на котором нужно пометить свойство как dirty
- Property Name (Name) — имя свойства (в нотации Blueprint), которое нужно пометить
Выходы (данные):
- нет (void)
Когда используется
- В многопользовательских проектах на UE5, где используется Net Push Model для репликации свойств (например, в Character, ActorComponent, GameState).
- Когда нужно вручную инициировать отправку изменения свойства клиентам, не дожидаясь автоматического вызова
OnRepили изменения черезReplicated-сеттер.
Типичные проблемы
- Неправильное имя свойства:
Property Nameдолжно точно совпадать с именем переменной в Blueprint (с учётом регистра). Ошибка в имени приведёт к тому, что свойство не будет помечено как dirty, и изменение не отправится клиентам. - Вызов на нереплицируемом объекте: Функция работает только на объектах, у которых включена репликация (
bReplicates = true). Вызов на локальном или нереплицируемом объекте не имеет эффекта. - Вызов на клиенте:
MarkPropertyDirtyдолжна вызываться только на сервере. Если вызвать её на клиенте, изменение не будет отправлено другим клиентам (и может вызвать предупреждение в логе).