Craft From Containers

Created by the friendly_neighbor team · Version: 0.1.3

Discord — friendly_neighbor: support, feedback and updates

Version 0.1.3 adds our Discord link. Gameplay behavior is unchanged from 0.1.2.

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.3 was built against Valheim 1.0.15 and BepInEx 5.4.23.5. Gameplay code is unchanged from the tested 0.1.2 release; package versions and Discord links were updated.

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. Containers marked in use by the game, graves and temporary containers that destroy themselves when empty are excluded from crafting sources.
• 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.

Chest access in 0.1.2

Normal chest opening has no custom cooldown and does not require the player to have placed the chest or opened it last. MultiUserChest remains responsible for simultaneous opening; its successful open response is no longer held until ownership transfers. Ordinary interaction takes priority over pending crafting, which can be retried if interrupted. Normal private-chest permissions and wards still apply.

Update the host and every player to the same version and restart the game. The optional compatibility adapter targets MultiUserChest 0.6.2.

Configuration

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.

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.

Русский

Создано командой friendly_neighbor · Версия: 0.1.3

Discord — friendly_neighbor: помощь, отзывы и обновления

В версии 0.1.3 добавлена ссылка на Discord. Игровая логика сохранена от 0.1.2.

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

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

Версия 0.1.3 собрана под Valheim 1.0.15 и BepInEx 5.4.23.5. Игровой код сохранён от проверенной версии 0.1.2; обновлены версия пакета и ссылки на Discord.

Возможности

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

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

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

Доступ к сундукам в 0.1.2

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

Обновите мод у хоста и всех игроков и перезапустите игру. Необязательный адаптер совместимости рассчитан на MultiUserChest 0.6.2.

Параметры

Секция / параметр	По умолчанию	Значение
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, без подмены редкой древесиной. Настройка печей не влияет на их заправку.

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