Random Bool With Weight
KismetMathLibrary
0
Что это
Pure-функция, возвращающая случайное булево значение (true или false) с заданной вероятностью. Параметр Weight определяет шанс получить true: 0.0 — всегда false, 1.0 — всегда true. Промежуточные значения задают линейную вероятность. Не имеет exec-пинов (pure).
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Weight (Float) — вероятность возврата
trueв диапазоне [0.0, 1.0]. Значения вне этого диапазона не гарантируют корректной работы (движок не выполняет автоматический clamp).
Выходы (данные):
- ReturnValue (Boolean) — случайное значение, полученное по заданному весу.
Когда используется
- Генерация случайных событий с контролируемой вероятностью (например, шанс выпадения предмета, успех действия, включение/выключение механики).
- Замена конструкции
RandomFloat < Thresholdв более читаемом виде.
Типичные проблемы
- Неправильный диапазон веса: передача процентов (0–100) вместо доли (0–1). Например,
Weight = 50дастtrueпочти всегда, так как 50.0 > 1.0. Решение: делить проценты на 100. - Путаница с RandomBool:
RandomBool(без веса) всегда даёт 50/50. Если нужна другая вероятность, необходимо использовать именноRandomBoolWithWeight. - Отрицательный вес: функция не проверяет знак, поэтому отрицательное значение может привести к неожиданному поведению (обычно интерпретируется как 0, но полагаться на это не стоит).
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.