BuildTweaks

English below / Русская версия ниже

---

English

Small building quality-of-life tweaks for Valheim, with a config that is synced from the server to every player.

Features

• Build collision toggle - press a hotkey (default F7, rebindable) to turn build collision off and on. While it is off, every piece (including crafting stations and their upgrades) can be placed overlapping other pieces, for example a furnace halfway inside another furnace.
• Crafting station upgrades can be placed close together - removes the "needs more space" restriction for station extensions, so upgrades can sit right next to each other.
• Extension range - set how far (in metres) a station upgrade may be from its crafting station. 0 keeps the vanilla distance.
• Identical upgrades do not give extra station levels. Only placement and range are changed.

Installation

Install with a mod manager (r2modman / Thunderstore Mod Manager), or put BuildTweaks.dll into BepInEx/plugins. Requires BepInExPack Valheim.

Configuration

The config file is created on first launch: BepInEx/config/local.buildtweaks.cfg.

Setting	Default	Synced	Description
Hotkeys / ToggleBuildCollision	F7	no	Key that toggles build collision
Synced / AllowCollisionToggle	true	yes	Allow players to use the collision hotkey
Synced / ExtensionsIgnoreCollision	true	yes	Station upgrades ignore the placement-space check
Synced / ExtensionRange	0	yes	Max distance between station and upgrade in metres, 0 = vanilla
Synced / ForceValidWhenCollisionOff	true	yes	While collision is off, any placement the game marks as invalid becomes valid (wards and no-build zones are still respected)
Debug / LogPlacementStatus	true	no	Writes the placement status of blocked pieces to the BepInEx log

Multiplayer / servers

Install the mod on the server and on every player. Settings in the Synced section are taken from the server when a player joins, and overwrite the player's local values. If the server admin edits and saves the config file, the new values are pushed to everyone who is online - no restart needed. Players without the mod are not affected, but they will not get the synced behaviour. The server and the clients must run the same mod version.

Notes

• Parts of this mod were written with the help of AI tools.
• Placement behaviour depends on the game's own checks. If a Valheim update renames them, the mod prints a warning to the BepInEx log and skips that feature instead of crashing.

---

Русский

Небольшие улучшения строительства в Valheim. Настройки хранятся на сервере и автоматически передаются всем игрокам.

Возможности

• Отключение коллизии построек. По горячей клавише (по умолчанию F7, клавишу можно поменять) коллизия при строительстве включается и выключается. Пока она выключена, любые постройки (в том числе крафт-станции и их улучшения) можно ставить друг в друга, например печку наполовину в другую печку.
• Улучшения крафт-станций можно ставить вплотную. Мод убирает ограничение «нужно больше места» для улучшений станций, так что они могут стоять рядом друг с другом.
• Дальность улучшений. Настраивается расстояние в метрах, на котором улучшение работает от своей станции. Значение 0 оставляет ванильную дальность.
• Одинаковые улучшения не дают дополнительных уровней станции. Меняются только условия установки и дальность.

Установка

Через менеджер модов (r2modman или Thunderstore Mod Manager) или вручную: положи BuildTweaks.dll в папку BepInEx/plugins. Нужен BepInExPack Valheim.

Настройка

Файл конфига создаётся при первом запуске игры: BepInEx/config/local.buildtweaks.cfg.

Параметр	По умолчанию	Синхронизируется	Описание
Hotkeys / ToggleBuildCollision	F7	нет	Кнопка отключения и включения коллизии построек
Synced / AllowCollisionToggle	true	да	Разрешить игрокам пользоваться этой кнопкой
Synced / ExtensionsIgnoreCollision	true	да	Улучшения станций игнорируют проверку свободного места
Synced / ExtensionRange	0	да	Максимальное расстояние от станции до улучшения в метрах, 0 = как в оригинале
Synced / ForceValidWhenCollisionOff	true	да	Пока коллизия выключена, любая установка, которую игра считает недопустимой, становится допустимой (вард и зоны запрета строительства по-прежнему работают)
Debug / LogPlacementStatus	true	нет	Пишет в лог BepInEx причину, по которой постройку нельзя поставить

Сервер и мультиплеер

Мод нужно поставить на сервер и каждому игроку. Параметры из секции Synced берутся с сервера, когда игрок заходит, и заменяют его локальные значения. Если админ изменит и сохранит файл конфига на сервере, новые значения сразу придут всем, кто сейчас онлайн, перезапуск не нужен. Игроки без мода не пострадают, но синхронизацию они не получат. Версия мода на сервере и у игроков должна совпадать.

Примечания

• Часть кода мода написана с помощью ИИ.
• Мод опирается на внутренние проверки игры. Если после обновления Valheim какая-то из них переименуется, мод запишет предупреждение в лог BepInEx и пропустит эту функцию, а не вылетит.