VBDiving

VBDiving — это мод, который полностью перерабатывает механику плавания в Valheim, добавляя возможность полноценного ныряния под воду, улучшая поведение мобов в воде и добавляя визуальные/аудио эффекты погружения.

Мод делает подводный мир более живым, опасным и красивым. Теперь вы не просто плывете по поверхности — вы можете исследовать глубины, но будьте осторожны: кислород ограничен, а мобы могут преследовать вас даже под водой!

Основные возможности

Для Игрока

• Полноценное ныряние: Нажмите Ctrl (или используйте старое управление), чтобы переключить режим погружения. Используйте взгляд вверх/вниз + движение вперед (W), чтобы контролировать глубину.
• Система дыхания: Под водой расходуется кислород. Если он закончится, начнет тратиться выносливость, что может привести к утоплению. На поверхности кислород восстанавливается.
• Визуальные эффекты: При погружении меняется освещение, цвета окружающей среды становятся более мрачными и подводными, появляется эффект искажения воды (Heat Distortion) и приглушается звук (Low Pass Filter).
• HUD Кислорода: Красивый индикатор с пузырьками, показывающий текущий запас воздуха. Количество пузырьков зависит от вашего навыка плавания.
• Улучшенная камера: Камера корректно ведет себя под водой, не застревая в текстурах поверхности.
• Использование предметов в воде: Возможность использовать определенные инструменты и оружие (например, ножи, копья, кирки) прямо под водой. Список можно настроить в конфиге.

Для Мобов (AI)

• Умные водные мобы: Мобы, настроенные через конфигурационные файлы, теперь умеют правильно плавать, нырять и всплывать.
• Преследование под водой: Агрессивные мобы (например, Змеи или Левиатаны, если они настроены) будут преследовать игрока под водой, используя трехмерную навигацию.
• Синхронизация конфигов: Настройки поведения мобов автоматически синхронизируются между сервером и клиентами. Сервер является источником истины.

Управление

По умолчанию используется новое управление:

1. Начать/Закончить ныряние: Нажмите Ctrl (Crouch).
2. Погружение: Смотрите вниз и идите вперед (W).
3. Всплытие: Смотрите вверх и идите вперед (W).
4. Отмена: Если вы находитесь близко к поверхности или выходите из воды, режим ныряния отключается автоматически.

Опционально: В настройках можно включить Legacy Controls (старое управление):

• Зажать Ctrl — погружаться.
• Зажать Space — всплывать.

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

Все настройки находятся в файле VitByr.VBDiving.cfg.

Основные настройки (00 - Main)

• EnableMod: Включить/выключить мод.
• SyncMonsterConfigs: Синхронизировать конфиги мобов с сервера (рекомендуется true для мультиплеера).
• UseServerMonsterConfigsOnly: Использовать ТОЛЬКО конфиги с сервера, игнорируя локальные файлы клиентов.

Управление (01 - Control)

• UseLegacyDiveControls: Если true, используется старое управление (зажатие клавиш). Если false — новое (переключение режима).

Дыхание (02 - Breath)

• MaxBreathSeconds: Базовое время нахождения под водой (при нулевом навыке).
• MaxBreathBonusAtSkill100: Дополнительное время при максимальном навыке плавания (100).
• BreathRecoveryPerSecond: Скорость восстановления кислорода на поверхности.

Интерфейс (03 - BreathHud)

• OffsetX/Y: Смещение индикатора кислорода по горизонтали и вертикали.
• Scale: Размер индикатора.
• ShowLabels: Показывать ли цифровое значение секунд рядом с пузырьками.

Плавание (04 - Swimming)

• SprintSwimMultiplier: Множитель скорости при спринте в воде.
• BaseUnderwaterStaminaRegenPerSecond: Скорость восстановления стамины, когда вы стоите на месте у поверхности (не двигаясь).

Предметы в воде (06 - EquipInWater)

• EiW_Custom: Список префабов предметов, которые можно использовать под водой (через запятую). По умолчанию включены ножи, копья, кирки и молот.

Настройка поведения мобов (Для админов серверов)

Мод использует YAML-конфиги для настройки того, как мобы ведут себя в воде. Файлы лежат в папке: BepInEx/config/VitByr/VBDiving/.

Если файлов нет, мод создаст пример Vanilla.yaml. Вы можете создавать свои .yaml файлы.

Пример структуры конфига:

deep_hunters: # Название группы
  min_depth: 1          # Минимальная глубина (у поверхности)
  center_depth: 5       # Предпочтительная глубина в спокойствии
  max_passive_depth: 20 # Макс. глубина, если моб спокоен
  max_agro_depth: 50    # Макс. глубина, если моб атакует
  depth_adjust_speed: 5 # Скорость изменения глубины
  use_breath: true      # Нужно ли мобу дышать?
  max_breath_seconds: 120 # Запас воздуха
  breath_recovery_speed: 1.5 # Скорость восстановления
  surface_time: 5       # Время, которое моб проводит на поверхности для дыхания
  surface_threshold_percent: 0.25 # При каком % воздуха моб начинает всплывать
  prefabs:              # Список префабов мобов
    - Serpent
    - BonemawSerpent

Важно:

• Изменения в конфигах на сервере применяются автоматически и рассылаются клиентам.
• Клиенты могут иметь свои локальные конфиги, но если включена синхронизация, приоритет будет у серверных настроек.

Несовместимые моды

• DiveIn
• BetterDiving
• SwimmingReworked
• VikingsDoSwim
• ImprovedSwimming

Обратная связь

• Личные сообщения у меня открыты Дискорд
• Либо через пинг VitByr на одном из серверов: Valheim Modding, Odin Plus, Valheim

От себя

• Вдохновлено такими модами как BetterDiving, DiveIn, SwimmingReworked.
• Особая благодарность Dzk автору мода SwimmingReworked, что позволил взять за основу свой мод и переработать на моё усмотрение.
• Также буду рад помощи по замене\ дополнении шейдера воды для полноценного вида под водой и на пересечении плоскости камеры - как в таких играх как Subnaftica (где полноценно можно видеть подводный мир и надводный, когда поверхность воды находится где-то по середине камеры)

VBDiving is a mod that completely overhauls the swimming mechanics in Valheim, adding full underwater diving capabilities, improving mob behavior in water, and introducing immersive visual and audio effects for submersion.

The mod makes the underwater world more alive, dangerous, and beautiful. Now you don't just swim on the surface—you can explore the depths. But be careful: oxygen is limited, and mobs can chase you even underwater!

Key Features

For the Player

• Full Diving: Press Ctrl (or use legacy controls) to toggle dive mode. Use look direction (up/down) + forward movement (W) to control depth.
• Breathing System: Oxygen depletes while underwater. If it runs out, stamina will start draining, potentially leading to drowning. Oxygen regenerates on the surface.
• Visual Effects: When submerged, lighting changes, environment colors become darker and more "underwater-like," heat distortion effects appear, and audio is muffled (Low Pass Filter).
• Oxygen HUD: A stylish bubble indicator shows your current air supply. The number of bubbles depends on your Swimming skill level.
• Improved Camera: The camera behaves correctly underwater, avoiding clipping through the water surface texture.
• Underwater Item Usage: Ability to use specific tools and weapons (e.g., knives, spears, pickaxes) directly underwater. The list is configurable via config files.

For Mobs (AI)

• Smart Aquatic Mobs: Mobs configured via config files now know how to properly swim, dive, and surface.
• Underwater Pursuit: Aggressive mobs (e.g., Serpents or Leviathans, if configured) will chase the player underwater using 3D navigation.
• Config Synchronization: Mob behavior settings are automatically synchronized between the server and clients. The server is the source of truth.

##️ Controls

By default, New Controls are used:

1. Start/Stop Diving: Press Ctrl (Crouch).
2. Dive Down: Look down and move forward (W).
3. Surface Up: Look up and move forward (W).
4. Cancel: Dive mode automatically disables if you are near the surface or exit the water.

Optional: You can enable Legacy Controls in the settings:

• Hold Ctrl — Dive down.
• Hold Space — Surface up.

Configuration

All settings are located in the file VitByr.VBDiving.cfg.

Main Settings (00 - Main)

• EnableMod: Enable/disable the mod.
• SyncMonsterConfigs: Sync mob configs from the server (recommended true for multiplayer).
• UseServerMonsterConfigsOnly: Use ONLY server configs, ignoring local client files.

Controls (01 - Control)

• UseLegacyDiveControls: If true, uses old hold-to-dive controls. If false, uses new toggle-based controls.

Breathing (02 - Breath)

• MaxBreathSeconds: Base time underwater (at 0 Swimming skill).
• MaxBreathBonusAtSkill100: Additional time at max Swimming skill (100).
• BreathRecoveryPerSecond: Oxygen regeneration rate on the surface.

Interface (03 - BreathHud)

• OffsetX/Y: Horizontal and vertical offset of the oxygen indicator.
• Scale: Size of the indicator.
• ShowLabels: Show numerical seconds value next to the bubbles.

Swimming (04 - Swimming)

• SprintSwimMultiplier: Speed multiplier when sprinting in water.
• BaseUnderwaterStaminaRegenPerSecond: Stamina regeneration rate when standing still at the surface (not moving).

Items in Water (06 - EquipInWater)

• EiW_Custom: List of item prefabs allowed underwater (comma-separated). Defaults include knives, spears, pickaxes, and hammers.

Mob Behavior Configuration (For Server Admins)

The mod uses YAML configs to define how mobs behave in water. Files are located in: BepInEx/config/VitByr/VBDiving/.

If no files exist, the mod creates an example Vanilla.yaml. You can create your own .yaml files.

Example Config Structure:

deep_hunters: # Group name
  min_depth: 1          # Min depth (near surface)
  center_depth: 5       # Preferred depth when passive
  max_passive_depth: 20 # Max depth when passive
  max_agro_depth: 50    # Max depth when aggressive
  depth_adjust_speed: 5 # Depth change speed
  use_breath: true      # Does the mob need to breathe?
  max_breath_seconds: 120 # Air supply
  breath_recovery_speed: 1.5 # Recovery speed
  surface_time: 5       # Time spent at surface breathing
  surface_threshold_percent: 0.25 # % air remaining before surfacing
  prefabs:              # List of mob prefabs
    - Serpent
    - BonemawSerpent

Important:

• Changes to configs on the server are applied automatically and sent to clients.
• Clients may have local configs, but if sync is enabled, server settings take priority.

Incompatible mods:

• DiveIn
• BetterDiving
• SwimmingReworked
• VikingsDoSwim
• ImprovedSwimming

Feedback

• Direct messages are open on Discord
• Or via ping @VitByr on one of the servers: Valheim Modding, Odin Plus, Valheim

From myself

• Inspired by mods like BetterDiving, DiveIn, and SwimmingReworked.
• Special thanks to Dzk, author of SwimmingReworked, for allowing me to use their mod as a base and rework it to my liking.
• I will also be glad to help you replace / add the water shader for a full view underwater and at the intersection of the camera plane - as in games like Subnaftica (where you can fully see the underwater world and the surface world when the water surface is somewhere in the middle of the camera)