Random Hand Cosmetics

English | Русский

English

This mod randomizes your hand cosmetics at the start of every run and can also change them dynamically every N seconds (configurable).
It respects unlock status, allows excluding specific cosmetic IDs, and uses a history system to avoid frequent repeats.

Features

Random cosmetics at run start.
Optional dynamic change with a configurable interval (seconds).
Exclude unwanted cosmetics by ID (e.g., climber).
History system prevents repeating the same cosmetics too often.

Installation

Install BepInEx for White Knuckle.
Place RandomHandCosmetics.dll into BepInEx/plugins/.
Launch the game once to generate the config file (BepInEx/config/com.yourname.RandomHandCosmetics.cfg).
Adjust settings as desired.

Configuration

ExcludedCosmeticIds – Comma‑separated list of cosmetic IDs to never select (e.g., climber).
SameCosmeticForBothHands – true = both hands get the same cosmetic, false = each hand gets a random one.
ChangeInterval – Seconds between dynamic changes. Set to 0 to disable dynamic switching.

Available Cosmetics IDs (for ExcludedCosmeticIds)

climber_bloodied experienced climber-glove-holiday climber-glove-leather climber-glove-maintenance climber-glove-maintenance-worn inverted-climber climber-outline climber_starry climber_sunrise climber-streaked-01 Prisoner Tattoo climber-wraps denizen Infested Marionette Roach scribble BloodandStone Xray

Known Issues

Default hand may appear occasionally – In some cases, the default hand may appear instead of the selected cosmetic. This is due to the game's internal rendering system and does not break the mod. Simply restarting the run or re-entering the game usually resolves it. I am working on a fix for future updates.
Compatibility with ResourcefulHands – This mod is not tested with ResourcefulHands. It may conflict or work unexpectedly. Use with caution.

Support

If you encounter any bugs or have suggestions, please contact me on Discord: decotmuf

Русский

Этот мод рандомизирует косметику рук при старте каждого забега и может дополнительно менять её каждые N секунд (настраивается).
Учитывает статус разблокировки, позволяет исключать определённые ID косметики и использует систему истории, чтобы избегать частых повторов.

Возможности

Случайная косметика при старте забега.
Опциональная динамическая смена с настраиваемым интервалом (секунды).
Исключение нежелательных косметик по ID (например, climber).
Система истории предотвращает слишком частые повторы.

Установка

Установите BepInEx для White Knuckle.
Поместите RandomHandCosmetics.dll в папку BepInEx/plugins/.
Запустите игру один раз, чтобы создался конфиг-файл (BepInEx/config/com.yourname.RandomHandCosmetics.cfg).
Настройте параметры по желанию.

Настройка

ExcludedCosmeticIds – список ID косметики через запятую, которые никогда не выбирать (например, climber).
SameCosmeticForBothHands – true = обе руки получают одинаковую косметику, false = каждая руку получает случайную.
ChangeInterval – секунды между динамическими сменами. Установите 0, чтобы отключить динамическое переключение.

Доступные ID косметики (для ExcludedCosmeticIds)

Известные проблемы

Иногда появляется стандартная рука – В некоторых случаях вместо выбранной косметики может появиться стандартная рука. Это связано с внутренней системой рендеринга игры и не ломает мод. Обычно помогает перезапуск забега или перезаход в игру. Я работаю над исправлением в будущих обновлениях.
Совместимость с ResourcefulHands – Мод не тестировался с ResourcefulHands. Возможны конфликты или неожиданное поведение. Используйте с осторожностью.

Поддержка

Если вы нашли баг или есть предложения, свяжитесь со мной в Discord: decotmuf