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 you can place pieces 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.

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.

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

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

Примечания

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

Changelog

1.0.1

• Build collision toggle now applies to every piece, including crafting stations and station upgrades
• Station upgrades can be placed right next to each other
• New synced option ForceValidWhenCollisionOff
• Placement status is written to the BepInEx log for easier troubleshooting
• Config descriptions are now in Russian (setting names stay in English)

1.0.0

• Initial release
• Hotkey to toggle build collision
• Station upgrades can be placed close together
• Configurable station upgrade range
• Server-synced config with live updates