Craft From Containers

Author: vladislav-savko · Version: 0.1.1

Craft, upgrade items, build, supply smelters and charcoal kilns, and refuel fires and lights with materials from nearby shared chests. Materials in your own inventory are used first; the remaining materials can come directly from accessible containers.

English

Compatibility and validation

Version 0.1.1 was built against Valheim 1.0.15 and BepInEx 5.4.23.5. Compilation, offline automated checks and installed-game API checks passed. The mod has not yet been tested in a running game or a live multiplayer session. No measured FPS improvement is claimed.

Features

• Crafting, item upgrades, building, smelter ore/fuel and charcoal kiln inputs use nearby resources.
• An optional allowed-resource list protects rare wood from charcoal production. It applies to backpack and chest resources, including explicit item use on the kiln.
• Campfires, hearths, torches and lamps using Fireplace can take their native fuel from accessible chests through the usual refuel action. Toggling a light does not consume resources. Cooking stations, fermenters and other arbitrary interfaces are not supported.
• Resource counts are cached by item name, quality and world level. Inventory changes update the affected container; nearby containers and remote changes are refreshed at a configurable interval.
• Recipe checks reuse the cache, without repeated physics searches through the surrounding base. Actual actions select containers holding the required materials.
• Shared chests remain shared. Access is coordinated temporarily when materials are consumed, including concurrent requests from other players.
• Private-container permissions and wards are respected. Open containers, graves and temporary containers that destroy themselves when empty are excluded.
• Recipe requirements can show the required and available amounts. Repair keeps its normal game behavior and reuses the cached resource display.

Installation and co-op

1. Disable other mods that provide overlapping crafting or resource consumption from chests to avoid conflicts.
2. Install this package and its BepInEx dependency with your mod manager. For manual installation, copy BepInEx/plugins/CraftFromContainers/CraftFromContainers.dll into the matching folder of your game or mod profile.
3. The host and every joining player must install the same version. A dedicated server is not required. If you choose to use a dedicated server, install the same version there too. Sessions mixing players with and without this mod are unsupported.
4. Start the game once to generate BepInEx/config/local.craftfromcontainers.cfg. Use the same search radius for all participants.

Settings

Section / setting	Default	Meaning
General / SearchRadius	40	Container search radius in metres; range 1–100
Performance / RefreshInterval	0.5	Seconds between proximity, access and remote-inventory checks; range 0.1–5
Interface / ShowAvailable	true	Show required/available material amounts
Refueling / KilnAllowedResources	*	Allowed inputs for charcoal recipes producing Coal; comma-separated prefab IDs
Diagnostics / Enabled	false	Write cache counters to the BepInEx log every 30 seconds

Remote inventory changes may take up to the refresh interval to appear in the menu. Resources are checked again before consumption. Other crafting/inventory mods and later game versions have not been validated.

Charcoal kiln fuel settings

To use only regular wood in charcoal kilns, set the following in BepInEx/config/local.craftfromcontainers.cfg:

[Refueling]
KilnAllowedResources = Wood

When regular wood runs out, the kiln stops accepting input and leaves fine wood and core wood in your backpack and chests. The filter also blocks using a forbidden wood item directly on the kiln.

Use prefab IDs: Wood (wood), FineWood (fine wood), RoundLog (core wood). Separate multiple IDs with commas, for example Wood, RoundLog. The default * preserves every input the kiln already accepts; an empty value blocks all charcoal inputs. This setting restricts existing recipes and never adds new ones. The filter only affects Smelter conversions producing Coal, leaving other smelting recipes unchanged.

Fires and lights need no separate filter: each Fireplace accepts its native fuel, such as Wood or Resin, without substituting rare wood. The kiln setting does not affect their refueling.

The filter is local and is not synchronized by the server. Set the same value on all clients for consistent restrictions. Restart the game after editing the configuration file manually.

Русский

Автор: vladislav-savko · Версия: 0.1.1

Мод позволяет создавать и улучшать предметы, строить, загружать плавильни и углевыжигательные печи, заправлять костры и светильники из ближайших общих сундуков. Сначала используются материалы в инвентаре игрока, затем — в доступных контейнерах.

Совместимость и проверки

Версия 0.1.1 собрана под Valheim 1.0.15 и BepInEx 5.4.23.5. Сборка, автономные автоматические проверки и проверка API установленной игры прошли. Запуск в игре и настоящий мультиплеер ещё не проверены. Измеренного прироста FPS пока нет.

Возможности

• Крафт, улучшение предметов, строительство, загрузка плавилен и углевыжигательных печей используют ресурсы поблизости.
• Настраиваемый список разрешённого сырья защищает редкую древесину от переработки в уголь. Он действует для рюкзака и сундуков, в том числе при использовании конкретного предмета на печи.
• Костры, очаги, факелы и лампы на Fireplace берут штатное топливо из доступных сундуков при обычном действии заправки. Включение и выключение светильника не расходует ресурсы. Стойки для готовки, бродильные бочки и остальные произвольные интерфейсы не поддерживаются.
• Количества ресурсов кэшируются с учётом качества предметов и уровня мира. Изменение инвентаря обновляет данные затронутого сундука; окружение и сетевые изменения проверяются с заданным интервалом.
• Проверки рецептов используют общий кэш без повторного физического поиска по постройкам. Для самого действия выбираются сундуки с нужными материалами.
• Сундуки остаются общими. При списании ресурсов мод временно согласует доступ между игроками, включая одновременные запросы.
• Учитываются права частных сундуков и обереги. Открытые сундуки, могилы и временные контейнеры, исчезающие после опустошения, исключены.
• Интерфейс может показывать нужное и доступное количество материалов. Ремонт сохраняет обычное поведение игры; обновление списка ресурсов использует тот же кэш.

Установка и совместная игра

1. Отключите другие моды с пересекающимся крафтом или списанием ресурсов из сундуков, чтобы избежать конфликтов.
2. Установите пакет и зависимость BepInEx через менеджер модов. При ручной установке скопируйте BepInEx/plugins/CraftFromContainers/CraftFromContainers.dll в соответствующую папку игры или профиля.
3. Хост и все подключающиеся игроки должны установить одинаковую версию. Выделенный сервер не нужен. Если вы всё же используете выделенный сервер, установите на него ту же версию. Смешанная игра с участниками без мода не поддерживается.
4. После первого запуска появится BepInEx/config/local.craftfromcontainers.cfg. Задайте одинаковый радиус поиска у всех участников.

Настройки

Секция / параметр	По умолчанию	Значение
General / SearchRadius	40	Радиус поиска контейнеров в метрах; диапазон 1–100
Performance / RefreshInterval	0.5	Интервал проверки окружения, доступа и сетевых изменений; 0.1–5 секунд
Interface / ShowAvailable	true	Показывать нужное/доступное количество материалов
Refueling / KilnAllowedResources	*	Разрешённое сырьё для рецептов угля с результатом Coal; prefab ID через запятую
Diagnostics / Enabled	false	Записывать счётчики кэша в журнал BepInEx раз в 30 секунд

Изменения, сделанные другим игроком, могут отображаться в меню с задержкой до интервала проверки. Перед списанием ресурсы проверяются заново. Совместимость с другими модами крафта/инвентаря и следующими версиями игры не проверена.

Топливо для углевыжигательной печи

Чтобы углевыжигательные печи брали только обычную древесину, задайте в BepInEx/config/local.craftfromcontainers.cfg:

[Refueling]
KilnAllowedResources = Wood

Когда обычная древесина закончится, загрузка печи остановится: качественная и цельная древесина останутся в рюкзаке и сундуках. Фильтр также блокирует использование запрещённой древесины напрямую на печи.

Указывайте prefab ID: Wood — обычная древесина, FineWood — качественная, RoundLog — цельная. Несколько ID разделяются запятыми, например Wood, RoundLog. Значение * по умолчанию сохраняет всё сырьё, которое печь уже принимает; пустое значение запрещает загрузку сырья для угля. Настройка только ограничивает существующие рецепты и не добавляет новые. Фильтр затрагивает лишь преобразования Smelter с результатом Coal; остальные рецепты плавки не меняются.

Для костров и светильников отдельный фильтр не нужен: каждый Fireplace принимает свой штатный вид топлива, например Wood или Resin, без подмены редкой древесиной. Настройка печей не влияет на их заправку.

Настройка фильтра локальная и не синхронизируется сервером. Для одинаковых ограничений задайте одинаковое значение у всех игроков. После ручного редактирования конфигурации перезапустите игру.