White Knuckle Item Tooltips

Bilingual English / Russian item tooltips for White Knuckle. Readable item cards, known runtime effects, spoiler-safe/full information, and one-click EN/RU switching in the main menu.

English

What this mod does

White Knuckle Item Tooltips adds a dedicated dark tooltip card for items you inspect in the world or inventory.

• Item names, categories, descriptions, and known effects.
• English and Russian databases for the same canonical item set.
• Runtime stats are read from the game when available instead of inventing exact numbers.
• Long descriptions wrap cleanly inside the custom tooltip card.
• X switches between spoiler-safe and full descriptions.
• A prominent clickable LANGUAGE: EN / LANGUAGE: RU button appears in the upper-right of the main menu.
• The selected language and safe/full-information choice are saved between launches.

Installation with Thunderstore Mod Manager

1. Click Install in Thunderstore / r2modman / a compatible Thunderstore manager.
2. The required BepInExPack dependency is installed automatically.
3. Launch White Knuckle and play.

No BepInEx.cfg edit is required in v0.3.0+. The mod owns a hidden persistent runtime host and works with the normal/default BepInEx manager visibility as well as HideManagerGameObject = true if you already use it.

Manual installation

1. Install BepInExPack for White Knuckle.
2. Either extract the package into the game root folder, or copy the mod folder into BepInEx/plugins.
3. Launch the game and play. No BepInEx config edit is required.

Normal complete layout:

BepInEx/plugins/WhiteKnuckleItemTooltipsRU/
  WhiteKnuckleItemTooltips.dll
  items_en.json
  items_ru.json

A DLL-only manual install is also supported: WhiteKnuckleItemTooltips.dll may be placed directly in BepInEx/plugins or in its own subfolder. EN/RU databases are embedded in the DLL as a fallback. Valid external items_en.json / items_ru.json beside the DLL override the embedded copies, so advanced users can still edit them.

Language button

The main menu contains an intentionally prominent clickable button:

LANGUAGE: EN / LANGUAGE: RU

• Switching language changes Item Tooltips and, when WKLoc is installed, the full game UI.
• A successful switch is saved first, then Main-Menu reloads immediately.
• X is independent from language selection and continues to control safe/full item information.

English Item Tooltips: WKLoc is NOT required.

Russian full-game UI + Russian Item Tooltips through the LANGUAGE button: WKLoc is required.

If you click RU without a compatible loaded WKLoc, the mod stays in English, does not reload, and shows exactly:

Russian localization requires WKLoc

On first run, the mod defaults to Russian if compatible WKLoc is already loaded; otherwise it defaults to English. A manual language choice is persisted afterwards.

Safe / full information (X)

Press X while playing to toggle:

• Safe mode — shorter descriptions intended to avoid unnecessary spoilers.
• Full mode — more direct mechanical or spoiler-bearing information when the database contains it.

Configuration

Important generated settings:

[General]
Enabled = true

[Language]
Language = English

[Information]
FullInformation = false
ToggleFullInformationKey = X

[UI]
UseCustomTooltipCard = true
WorldTooltipEnabled = true
InventoryTooltipEnabled = true
TooltipMaxWidth = 620

Language is normally changed through the main-menu button. Supported persisted values are English and Russian.

UseCustomTooltipCard = false restores White Knuckle's native description field as a troubleshooting fallback.

Compatibility / troubleshooting

• Verified target: White Knuckle v0.60h.
• BepInEx is required; WKLoc is optional and is not bundled.
• English mode works with this mod + BepInEx only.
• Russian full-game localization requires compatible WKLoc.
• WKLoc integration is reflection-only: this package neither contains nor compiles against WKLoc.dll.
• No BepInEx.cfg edit is required. If an older Item Tooltips version made you set HideManagerGameObject = true, you may leave it enabled or restore the default; v0.3.0 is designed to work either way.
• If an external locale JSON is missing or broken, the mod falls back to its embedded database automatically.
• If custom tooltip UI has a compatibility problem, set UseCustomTooltipCard = false to use the native text field while diagnosing it.

Creator / Twitch

Item Tooltips Mod by KoshGamer
Twitch: https://www.twitch.tv/koshgamer

The same creator/Twitch credit is shown in the upper-right of the main menu.

Русский

Что делает мод

White Knuckle Item Tooltips добавляет отдельную тёмную карточку с информацией о предметах, на которые ты смотришь в мире или наводишься в инвентаре.

• Названия, категории, описания и известные эффекты предметов.
• Английская и русская базы для одного и того же набора игровых ID.
• Характеристики по возможности читаются прямо из игры — мод не придумывает точные цифры, которых не знает.
• Длинные описания нормально переносятся внутри собственной карточки.
• X переключает краткое безопасное и полное описание.
• В правом верхнем углу главного меню есть заметная кликабельная кнопка LANGUAGE: EN / LANGUAGE: RU.
• Выбранный язык и режим краткой/полной информации сохраняются между запусками.

Установка через Thunderstore Mod Manager

1. Нажми Install в Thunderstore / r2modman / совместимом менеджере Thunderstore.
2. Обязательный BepInExPack установится автоматически как зависимость.
3. Запусти White Knuckle и играй.

Редактировать BepInEx.cfg не требуется в v0.3.0+. Мод создаёт собственный скрытый постоянный runtime-host и работает как с обычной настройкой видимости менеджера BepInEx, так и с HideManagerGameObject = true, если она у тебя уже включена.

Ручная установка

1. Установи BepInExPack для White Knuckle.
2. Либо распакуй пакет в корневую папку игры, либо скопируй папку мода в BepInEx/plugins.
3. Запусти игру и играй. Ничего менять в конфиге BepInEx не нужно.

Обычная полная структура:

BepInEx/plugins/WhiteKnuckleItemTooltipsRU/
  WhiteKnuckleItemTooltips.dll
  items_en.json
  items_ru.json

Поддерживается и ручная установка только DLL: WhiteKnuckleItemTooltips.dll можно положить прямо в BepInEx/plugins или в отдельную подпапку. Базы EN/RU встроены внутрь DLL как запасной вариант. Если рядом с DLL лежат исправные внешние items_en.json / items_ru.json, они имеют приоритет — их можно редактировать вручную.

Кнопка языка

В главном меню находится специально заметная кликабельная кнопка:

LANGUAGE: EN / LANGUAGE: RU

• Переключение меняет язык Item Tooltips и, при наличии WKLoc, язык интерфейса всей игры.
• При успешном переключении новый язык сначала сохраняется, после чего Main-Menu сразу перезагружается.
• X не связан с языком и продолжает отвечать только за краткую/полную информацию о предметах.

Английские подсказки предметов: WKLoc НЕ требуется.

Русский интерфейс всей игры + русские подсказки через кнопку LANGUAGE: требуется WKLoc.

Если нажать RU без совместимого загруженного WKLoc, мод останется на английском, меню не перезагрузится и появится точное сообщение:

Russian localization requires WKLoc

При первом запуске мод по умолчанию выберет русский, если совместимый WKLoc уже загружен; иначе выберет английский. После ручного выбора язык сохраняется.

Краткая / полная информация (X)

Нажимай X во время игры, чтобы переключать:

• Краткий режим — более осторожное описание без лишних спойлеров.
• Полный режим — более прямое описание механики или спойлерная информация, если она есть в базе.

Конфигурация

Основные создаваемые настройки:

[General]
Enabled = true

[Language]
Language = Russian

[Information]
FullInformation = false
ToggleFullInformationKey = X

[UI]
UseCustomTooltipCard = true
WorldTooltipEnabled = true
InventoryTooltipEnabled = true
TooltipMaxWidth = 620

Обычно Language меняется кнопкой в главном меню. Поддерживаемые сохранённые значения: English и Russian.

UseCustomTooltipCard = false возвращает вывод через штатное поле описания White Knuckle — это полезно для диагностики.

Совместимость / диагностика

• Проверенная версия игры: White Knuckle v0.60h.
• BepInEx обязателен; WKLoc необязателен и не входит в пакет.
• Английский режим работает только с этим модом и BepInEx.
• Для русского интерфейса всей игры требуется совместимый WKLoc.
• Интеграция с WKLoc сделана через reflection: пакет не содержит и не компилируется с WKLoc.dll.
• Редактировать BepInEx.cfg не требуется. Если старая версия Item Tooltips заставляла включать HideManagerGameObject = true, можешь оставить его включённым или вернуть стандартное значение — v0.3.0 рассчитан на оба варианта.
• Если внешний JSON языка отсутствует или повреждён, мод автоматически использует встроенную базу.
• Если собственная карточка конфликтует с другим UI-модом, поставь UseCustomTooltipCard = false, чтобы временно использовать штатное поле текста для диагностики.

Автор / Twitch

Item Tooltips Mod by KoshGamer
Twitch: https://www.twitch.tv/koshgamer

Та же подпись автора и Twitch показывается в правом верхнем углу главного меню.