VALKRYN

Language support: English and Portuguese (PT-BR).
Suporte a idiomas: inglês e português (PT-BR).
In-game: ConfigurationManager → General → Language.

Quality-of-life mod for Valheim. Configurable in-game from the Valkryn Control Panel (Ctrl+F10), or via .cfg / ConfigurationManager (F1).

Version: 1.1.7
Dependencies: BepInEx + Jötunn

Installation

1. Install BepInEx and Jötunn.
2. Place Valkryn.dll in BepInEx/plugins/ (or a subfolder).
3. Launch the game once — the config file is created automatically.
4. Edit BepInEx/config/com.mrkode.valkryn.cfg, use ConfigurationManager (F1), or open the in-game Valkryn Control Panel (Ctrl+F10).

Also available via ThunderStore / r2modman.

Configuration

• Main file: BepInEx/config/com.mrkode.valkryn.cfg
• Each [Section] becomes a category in ConfigurationManager (F1 → VALKRYN).
• Language: set General → Language to English or Portuguese for in-game labels and messages (also available in the Control Panel).
• Optional overlays: clock below the minimap and inventory buttons when the inventory is open.
• Defaults are mostly enabled; disable what you don't want.

Valkryn Control Panel

Ctrl+F10 opens and closes the in-game Valkryn Control Panel. It is a vanilla-styled window (same look as Valheim wood panels and buttons) organized by feature, not a dump of every .cfg key.

The panel lets you:

• browse features by category (Inventory, Farming, Production, World, Player, Interaction, Interface);
• see whether each feature is ON or OFF;
• open Configure for that feature’s real settings;
• change toggles, numbers, dropdowns, and shortcuts.

Changes write to the same ConfigEntry values used by ConfigurationManager and com.mrkode.valkryn.cfg. There is no second config store. Most changes apply immediately. Settings that need a restart or world reload say so in the panel.

Default key: Ctrl+F10 (either Control key). Configurable under Interface → OpenPanelKey or in the panel itself (Interface → Control Panel Key).

Close: Ctrl+F10, ESC, or the Close button. ESC returns to the game and does not open the pause menu while the panel is open. If you are typing in a field, ESC cancels that input first.

The panel does not open while you are typing in chat, the console, or a text prompt, or while the inventory, map, pause menu, store, or portal config popup is open. Only one panel instance exists.

Display: the window stays centered and capped in width, including on 21:9 / ultrawide. It does not stretch across the whole screen.

Compatibility: the panel only reads and writes existing Valkryn settings. It does not move items or change gameplay unless you change the matching option. ConfigurationManager (F1) remains available. If another mod also binds Ctrl+F10, remap OpenPanelKey.

Features

Shortcuts (defaults)

All keys are configurable in the .cfg file.

Config files

Known issues

• None reported in the current version.

Português (PT-BR)

Mod de qualidade de vida para Valheim. Configurável no jogo pelo Valkryn Control Panel (Ctrl+F10), ou via .cfg / ConfigurationManager (F1).

Versão: 1.1.7
Dependências: BepInEx + Jötunn

Instalação

1. Instale BepInEx e Jötunn.
2. Coloque Valkryn.dll em BepInEx/plugins/ (ou em uma subpasta).
3. Inicie o jogo uma vez — o arquivo de configuração é gerado automaticamente.
4. Edite BepInEx/config/com.mrkode.valkryn.cfg, use o ConfigurationManager (F1) ou abra o Valkryn Control Panel no jogo (Ctrl+F10).

Também disponível via ThunderStore / r2modman.

Configuração

• Arquivo principal: BepInEx/config/com.mrkode.valkryn.cfg
• Cada seção [Nome] vira uma categoria no ConfigurationManager (F1 → VALKRYN).
• Idioma: defina General → Language como English ou Portuguese para textos e mensagens no jogo (também disponível no Control Panel).
• Overlays opcionais: relógio abaixo do minimapa e botões de inventário com o inventário aberto.
• Os valores padrão tendem a estar ativos; desative o que não quiser.

Valkryn Control Panel

Ctrl+F10 abre e fecha o Valkryn Control Panel no jogo. É uma janela no estilo vanilla (mesmo visual de painéis e botões do Valheim), organizada por funcionalidade — não uma lista gigante de chaves do .cfg.

O painel permite:

• navegar pelas features por categoria (Inventário, Farming, Produção, Mundo, Jogador, Interação, Interface);
• ver se cada funcionalidade está ON ou OFF;
• abrir Configurar para as opções reais daquela feature;
• alterar toggles, números, listas e atalhos.

As alterações gravam nas mesmas ConfigEntry usadas pelo ConfigurationManager e pelo com.mrkode.valkryn.cfg. Não existe um segundo arquivo de configuração. A maioria das mudanças vale na hora. Opções que exigem reinício ou reload do mundo aparecem sinalizadas no painel.

Tecla padrão: Ctrl+F10 (qualquer Control). Configurável em Interface → OpenPanelKey ou no próprio painel (Interface → Tecla do Painel).

Fechar: Ctrl+F10, ESC ou o botão Fechar. O ESC volta ao jogo e não abre o menu de pausa enquanto o painel estiver aberto. Se você estiver digitando num campo, o ESC cancela esse campo primeiro.

O painel não abre enquanto você digita no chat, no console ou num campo de texto, nem com inventário, mapa, menu de pausa, loja ou popup de portal abertos. Só existe uma instância.

Tela: a janela fica centralizada e com largura limitada, inclusive em 21:9 / ultrawide. Não estica a tela inteira.

Compatibilidade: o painel só lê e altera as configurações já existentes do Valkryn. Não move itens nem muda gameplay a menos que você mude a opção correspondente. O ConfigurationManager (F1) continua disponível. Se outro mod também usar Ctrl+F10, remapeie OpenPanelKey.

Funcionalidades

Atalhos (padrão)

Todas as teclas são configuráveis no .cfg.

Arquivos de configuração

Problemas conhecidos

• Nenhum reportado na versão atual.

Changelog

All notable changes to Valkryn will be documented in this file.

[1.2.2] - 2026-09-25

Added

• Trash panel: clicking the trash icon in the inventory opens a list where you tick several items and destroy them all at once (equipped, hotbar and favorite items are not listed). Dragging a single item onto the trash still works as before.

Changed

• The single "Resource Multiplier" is now three independent settings, each with its own toggle: World Drop Multiplier (trees, ore, plants, fish), Mob Drop Multiplier (creature kill loot), and Chest/Dungeon Drop Multiplier (loot generated inside chests and containers). If you had ResourceMultiplier configured before, that value carries over automatically to World Drop Multiplier; Mob and Chest/Dungeon Drop Multiplier are new and start at vanilla (1x) until raised.

Removed

• The Farming module (grid/single planting, seed selector, planting preview, biome rules, auto-replant, seed storage from chests, farm profiles) has been removed entirely due to persistent placement and consumption bugs. The Shift+E contextual replant action is gone as well. Vanilla planting is unaffected.

[1.2.1] - 2026-09-20

Added

• After a character kills a boss, later summons of that same boss at the altar cost no tribute. A character that has never killed that boss still pays the vanilla offering. Toggle in Player → Free Boss Summon After Kill.
• Resource multiplier drops spawn as one stacked pickup per item type (stone stack + copper stack) instead of many single items. Toggle in World → Resource Multiplier → Stack Resource Drops.
• Optional toggle to remove world distance fog and Mistlands particle mist. Client visual only. Toggle in World → Remove Fog.

Fixed

• Organizing a chest no longer leaves ghost stacks shown as 0/max after merging matching items.
• Copper veins and other MineRock drops now stack into one pickup per item type (copper + stone), including when Extra Mining breaks the whole vein in one hit.

[1.2.0] - 2026-09-20

Fixed

• Item weight reduction now removes the configured percent of vanilla item weight (50% = half weight, 100% = weightless) instead of making items heavier.

[1.1.9] - 2026-09-19

Fixed

• Smelters, blast furnaces, and charcoal kilns light and process with any fuel amount above zero (one coal is enough). They no longer stay visually off when filled to capacity.
• Smelter capacity no longer forces a fuel tank on stations that do not use fuel (charcoal kiln), which left them unlit and idle.
• Bulk and area refuel now apply ore and fuel through the vanilla owner RPCs, so the ore smelter and blast furnace start instead of only updating the hover count.

[1.1.8] - 2026-09-19

Added

• Portal network discovers portals already placed in the world save, including distant ones, so they appear as destinations without visiting them first.

[1.1.7] - 2026-09-19

Changed

• Control Panel default shortcut is Ctrl+F10 (was Ctrl+P). Existing installs still on the factory Ctrl+P bind are migrated; custom remaps are kept. Remap in Interface → Control Panel Key, ConfigurationManager (F1), or [Interface] OpenPanelKey.
• Store Existing / Smart Deposit no longer hide automatically when AzuAutoStore is installed. Use DisableWhenAzuAutoStore (off by default) if both mods should not store items.

Fixed

• Organize chest sits in the inventory action column, below the trash slot, when a chest is open.
• Store Existing stays visible with AzuAutoStore unless the new compatibility toggle is enabled.

[1.1.6] - 2026-09-19

Added

• Smart Crafting: vanilla station recipes can use materials from the player inventory and valid nearby chests inside a configurable radius, without replacing Valheim's craft, consume, or result flow.
• Material reservation moves only the missing quantity from chests into the inventory, then rolls back if vanilla crafting does not consume the resources.
• Favorites, equipped items, and hotbar stacks can be ignored for crafting using the existing favorites file. Nearby-chest discovery reuses the same access rules as Smart Deposit.
• Configuration Manager section [SmartCrafting], including an option to disable the feature when AzuCraftyBoxes is installed (on by default).
• Hammer hover shows piece cost over total available materials (2/350) from inventory plus nearby chests, and placing a piece can pull the missing amount from those chests.

[1.1.5] - 2026-09-19

Added

• Optional player carry capacity (off by default): 300–3000, replacing vanilla weight including Megingjord.
• Optional item weight reduction (off by default): 0–100% less item weight, without changing ObjectDB originals.

Fixed

• Resource multiplier now applies original amount × configured multiplier once per drop event, without compounding vanilla Game.ScaleDrops / world resource rate on creatures and drop tables.
• Drops already changed by another loot mod are preserved instead of being multiplied again.
• The same Valkryn pass cannot scale the same drop twice.
• Tree, mining, and destroy-loot paths that use DropTable.GetDropList now receive the resource multiplier (wood, ore, DropOnDestroyed).
• Pickable harvest windows open only on the object owner so clients do not also scale drops.
• PickableItem ground drops are included in the same multiplier rules.

[1.1.4] - 2026-09-19

Added

• Inventory UI buttons: organize player inventory, organize open chest, store items in nearby chests that already contain them, and a trash slot to destroy dragged items (favorites, hotbar, and equipped items stay protected).
• Draggable inventory action column: right-click and drag to reposition; position saved in .cfg.

Changed

• Re-enabled Inventory → Enable Sort Inventory (now controls the organize buttons in the inventory UI).
• Inventory action column uses a single Valheim-style wood panel: Organize → Store Existing → Trash (bottom slot, trash can icon with transparent background).
• Default inventory action panel position: OffsetX=420.5, OffsetY=5.5.

Fixed

• Inventory UI buttons appear in a vertical column to the right of the full inventory panel (outside the armor/weight column), without overlapping item slots.
• Player inventory organize leaves the hotbar row untouched and only sorts items below it.
• Inventory action panel drag (right-click + drag) works reliably on the unified wood panel.
• Trash slot shows trash can icon with transparent background (loaded via Jotunn AssetUtils).

[1.1.3] - 2026-09-19

Added

• Skip the startup intro cinematic by default and go straight to the main menu. Disable Player → Skip Intro Video to restore the vanilla video.

[1.1.2] - 2026-09-19

Fixed

• Farming grid preview missing for multi-plant and misaligned to the look direction: each cell snaps to terrain height using the placement ghost yaw.
• Farming grid jumped away from the cursor to the farm edge; preview now stays on the aim point, snapped to the local plant grid.
• Cells that cannot be planted (occupied, invalid, or no remaining seed) show red in the preview; only green cells are planted.
• Grid snap no longer treats an existing plant on the same cell as empty, so it cannot plant on top of another crop.
• 2×2 grid snapped onto a plant center and left a large gap; the four cells now land on the existing farm lattice.

Changed

• Planting is now Single (1) or a fixed 2×2 grid (4). Line mode is removed. ; toggles between 1 and 4.
• Farming preview shows only the seed ghost with vanilla placement colors (normal if valid, red if it cannot be planted).
• Grid cells closer than the configured spacing to an existing plant are treated as occupied.
• Grid/line planting uses whatever seeds are in the inventory and nearby chests instead of aborting when the full preview cannot be filled.
• Farming preview and planting snap to nearby existing plants so new rows stay on the same grid.

[1.0.1] - 2026-09-19

Fixed

• Resource multiplier inflated inventory counts from duplicate pickup (e.g. 1 carrot with multiplier 2 giving 6 instead of 2). The same ItemDrop could be consumed several times before its deferred destroy landed, because vanilla only guards with Inventory.ContainsItem and that check fails whenever the stack merges into an existing one.
• Pickup guard regression that zeroed inventory stacks (0/1000) by mutating ItemDrop.m_itemData after pickup when Inventory.AddItem kept the same reference.
• Pickup guard now blocks re-entry optimistically in Humanoid.Pickup (before AddItem) to prevent same-frame duplicate adds.
• Harvest drop count no longer compounds vanilla Game.ScaleDrops with the mod multiplier; pickables use base amount × mod multiplier only.
• Harmony patch on Game.ScaleDrops failed at startup due to mismatched parameter name (prefab vs drop).
• Extra drops from harvested pickables were scaled twice (once in DropTable.GetDropListItems, once in Pickable.Drop).
• Portal configuration popup layout: labels, inputs, dropdown, toggle, and buttons no longer overlap (two-column layout with left/right pivots).
• Portal config popup: removed Mark button; label column no longer clips "Name"/"Destination" text.
• Removed duplicate per-seed Allow Any Biome toggles in ConfigurationManager; biome planting is controlled globally via Biome Restriction Mode and Allow List Seeds.
• Thunderstore upload rejection caused by UTF-8 BOM in package README.
• Release build packaging pipeline (manifest source path, Package output folder, ZIP generation, and post-build script resolution).

Added

• In-game portal configuration UI: hover shows name and destination, E opens a popup to set name, destination, favorite, and default portal (JSON remains the persistence layer).

Changed

• AutoLoot and AutoPickup temporarily disabled due to pickup bugs; config toggles remain visible but have no effect until re-enabled in a future update.

• README layout: full English section first, Portuguese (PT-BR) second, with bilingual support notice at the top.

• Official manifest.json source file at repository root (Package/ is build output only).

[1.0.0] - 2026-09-19

Added

Core

• Initial public release of Valkryn, a config-driven Valheim QoL mod for BepInEx and Jötunn.
• All features configurable via BepInEx/config/com.mrkode.valkryn.cfg and ConfigurationManager.

Resources

• Configurable multiplier for new resource drops from drop tables, pickables, and enemy loot generation.

Production

• Faster processing for smelter-based stations (smelters, kilns, and forges).
• Increased ore and fuel queue capacity on smelter-based stations.
• Faster fermenter production.
• Faster passive production from beehives and sap collectors.
• Faster cooking while food is still uncooked, preserving vanilla burn timing afterward.

Refueling

• Shift+E bulk ore or fuel deposit on smelters.
• Configurable area refuel key for nearby smelters and fireplaces.

World

• Faster growth for planted crops and trees.

Inventory

• Configurable stack size multiplier for items that already stack.
• Smart Deposit: deposit matching items to nearby compatible chests (K), or all unprotected items (Shift+K).
• Favorite items via Alt+right-click, persisted to com.mrkode.valkryn.favorites.txt and protected from Smart Deposit.
• Automatic Smart Deposit disable when AzuAutoStore is detected.

Tools

• Building hammer no longer loses durability.
• Optional protection for hoe and cultivator durability.

Player

• Actions consume half stamina.
• Optional death behavior that skips tombstone creation.

Loot

• Instant enemy loot on death without waiting for body despawn.
• Auto-loot and auto-pickup within a configurable radius and interval.
• Pickup filters for resources, food, trophies, coins, and equipment.
• Optional weight limit and inventory space checks.
• Option to exclude player-dropped items from auto-pickup.

Repairs

• Automatic repair of damaged items when opening a compatible crafting station.

Mining

• Chain mining: one hit can damage other parts of the same rock formation.
• Configurable damage percentage (25%, 50%, or 100%) and optional extra durability cost.

Clock

• Optional world day/time and local PC time display below the minimap.
• 12-hour or 24-hour time format.

Farming

• Advanced planting with single, line, and grid modes.
• Valid/invalid placement preview.
• Seed cycling and planting mode hotkeys.
• Save and replant farm profiles.
• Auto-replant on harvest for saved farm positions.
• Optional seed sourcing from nearby chests.
• Configurable biome rules: vanilla, allow list, or any biome, with per-seed overrides.
• PlantEverything compatibility for biome placement checks.

Building

• Building actions cost no stamina.

Portals

• Portal network managed through com.mrkode.valkryn.portals.json.
• Multiple destinations per portal with favorite-aware destination ordering.
• Item transport modes: vanilla, any item, or custom restricted list.
• Optional bidirectional portal links.

Quick Interaction

• Shift+E contextual actions: deposit to chest, replant saved farm profile, and portal configuration reminder.