VeiledRecipes
VeiledRecipes changes how Valheim presents unknown recipes and build pieces. Instead of keeping every undiscovered recipe completely invisible, it can show configurable masked previews: the player learns that something exists, while names, icons, descriptions, hidden materials, and hidden station requirements stay secret until the real unlock conditions are met.
The mod does not grant recipes early. Unknown previews cannot be crafted or placed.
Veiled recipes would be unlocked only when all the materials and station requirements were met.
The stations are unlocked only when the player interacts with them by default.
By default, veiled recipes are grouped below known recipes.
By default, even veiled recipes are not shown when crafting station level is not met.
InventorySlots mod is compatible with VeiledRecipes. Check it out!
https://thunderstore.io/c/valheim/p/sighsorry/InventorySlots/
Piece recipes are also veiled.
By default, players don't have to interact with the crafting station to unlock the piece recipes.
Strengths
- Shows discovery progress without spoiling full recipes.
- Keeps Valheim's actual recipe and piece unlock rules intact.
- Masks crafting recipes, build pieces, item icons, descriptions, requirements, station levels, tooltips, and pinned tooltip content where supported.
- Reveals known materials and station information gradually.
- Blocks crafting and placement for entries that are only previews.
- Supports strict station discovery rules for recipe unlocks.
- Provides server-synced blacklist controls for item outputs, build pieces, and requirement ingredients.
- Offers client-side options for recipe grouping and noisy notifications.
- Exposes a compatibility API for custom crafting UI mods.
Crafting Recipe Previews
When a crafting recipe is visible only as an unknown preview:
- The recipe list icon is rendered as a black silhouette.
- The recipe name is replaced by
Unknown Name Text.
- The selected recipe icon is rendered as a black silhouette.
- The recipe description is replaced by
Unknown Description Text.
- Unknown requirement names and amounts are replaced by
Unknown Requirement Text.
- Unknown station level text is replaced by
Unknown Requirement Text.
- Requirements the player already knows are shown normally.
- The craft button is disabled and crafting is blocked.
Recipe previews can be grouped below actually unlocked recipes so normal crafting remains easy to scan.
Build Piece Previews
Unknown build pieces can appear in hammer/build-piece tables as masked entries.
Until the piece is actually unlocked:
- The piece icon is rendered as a black silhouette.
- The piece name and description are hidden.
- Unknown requirements are masked.
- The placement ghost is blocked.
- Placement is denied with Valheim's missing requirement message.
Once Valheim considers the piece known, VeiledRecipes stops masking it.
Station Discovery
Valheim normally discovers crafting stations when the player walks close enough to them. That station awareness can affect recipe and piece unlocks.
VeiledRecipes separates two concepts:
Require Station Interaction For Recipe Unlock controls whether station-gated crafting recipes require direct interaction with the required station level before the recipe can truly unlock.Enable Station Proximity Discovery controls whether walking near a crafting station discovers it through Valheim's normal proximity behavior.
Build pieces use Valheim's normal station awareness. If proximity discovery is enabled, walking near a station can help piece unlocks. If proximity discovery is disabled, interacting with the station is required before that station is known.
Server-Synced Config
These options are synced through ServerSync when configuration locking is enabled.
-
Lock Configuration
Locks synced config so only the server/admin config controls gameplay behavior.
-
Show Unknown Crafting Recipes
Enables masked crafting recipe previews at relevant crafting stations.
Default: On
-
Show Unknown Build Pieces
Enables masked build-piece previews in build-piece tables.
Default: On
-
Require Station Level For Unknown Crafting Recipes
If enabled, unknown crafting recipe previews only appear when the current crafting station meets the required station level. A forge level 2 recipe will not appear at a forge level 1 unless it is already truly unlocked.
Default: On
-
Require Station Interaction For Recipe Unlock
If enabled, station-gated crafting recipes unlock only after the player has interacted with the required crafting station level. If disabled, recipe station knowledge follows Valheim's normal known station behavior.
Default: On
-
Enable Station Proximity Discovery
If enabled, walking near a crafting station discovers it normally. If disabled, proximity discovery is blocked and station knowledge requires interaction.
Default: On
-
Recipe Preview Prefab Blacklist
Item prefab names whose unknown crafting recipe previews should never appear. This affects preview visibility only; unlocked recipes still appear normally.
Default: empty
-
Piece Preview Prefab Blacklist
Piece prefab names whose unknown build-piece previews should never appear. This affects preview visibility only; unlocked pieces still appear normally.
Default: empty
-
Requirement Preview Prefab Blacklist
Ingredient/resource prefab names that prevent unknown previews from appearing for any recipe or piece that requires them. This is useful for cheat, admin, or hidden resource prefabs.
Default: SwordCheat, SledgeCheat
-
Unknown Name Text
Text shown when a recipe, piece, material, or station name is hidden.
Default: ???
-
Unknown Description Text
Text shown when a recipe or piece description is hidden.
Default: Not enough info
-
Unknown Requirement Text
Text shown when an amount or station level is hidden.
Default: ?
Client-Side Config
These options are not synced. Each player can choose their own client behavior.
-
Enable Admin Bypass
Lets a verified host or server admin bypass recipe and build-piece masking, crafting restrictions, and placement restrictions on this client. Enabling it as a non-admin has no effect.
Default: false
-
Group Unknown Recipe Previews Below Known Recipes
Groups masked crafting recipe previews below actually unlocked recipes in crafting station recipe lists.
Default: true
-
Show Recipe Unlock Notifications
Shows or hides Valheim's recipe unlock popup.
Default: true
-
Show Piece Unlock Notifications
Shows or hides Valheim's build piece and dish unlock popup.
Default: false
-
Show Skill Level Up Notification/Effect
Shows or hides skill level-up messages and VFX/SFX, including the first time a skill reaches level 1.
Default: true
Blacklist Format
All prefab blacklist entries are case-insensitive. Whitespace is trimmed, and a trailing (Clone) suffix is ignored.
Entries can be separated by commas, semicolons, pipes, or line breaks.
Output blacklists match the item or piece being previewed:
ArmorIronLegs, SwordIron
piece_workbench_ext1
piece_chest
The requirement blacklist matches ingredient/resource prefabs used by the recipe or piece:
SwordCheat, SledgeCheat
Compatibility API
VeiledRecipes patches Valheim's vanilla crafting and build-piece UI. Mods that draw their own recipe UI may need to call the public API and mask their own controls.
API type:
VeiledRecipes.VeiledRecipesCompat
Useful members include:
PluginGuidPluginNamePluginVersionAuthorUnknownNameTextUnknownDescriptionTextUnknownRequirementTextGroupUnknownRecipePreviewsBelowKnownRecipesIsAdminBypassActiveGetRecipeVisibilityState(recipe)GetRecipeVisibilityState(player, recipe)IsUnknownRecipePreview(recipe)IsUnknownRecipePreview(player, recipe)ShouldMaskRecipe(recipe)ShouldMaskRecipe(player, recipe)ShouldMaskRecipePair(pair)ShouldMaskRecipePair(player, pair)IsRecipeActuallyKnown(player, recipe)ShouldMaskPiece(piece)ShouldMaskPiece(player, piece)IsPieceActuallyKnown(player, piece)IsMaterialKnown(requirement)IsMaterialKnown(player, requirement)KnowsRecipeStationRequirement(recipe, quality)KnowsRecipeStationRequirement(player, recipe, quality)KnowsPieceStationRequirement(piece)KnowsPieceStationRequirement(player, piece)RegisterKnownPieceOverride(predicate) / UnregisterKnownPieceOverride(predicate)RegisterKnownPiecePrefabOverride(prefabName) / UnregisterKnownPiecePrefabOverride(prefabName)RegisterKnownPieceTypeOverride(typeName) / UnregisterKnownPieceTypeOverride(typeName)
Soft dependency GUID:
sighsorry.VeiledRecipes
Git
https://github.com/sighsorry1029/VeiledRecipes
Building
Normal Debug and Release builds do not copy the DLL into the live Valheim installation. To opt into local deployment, pass the DeployToGame MSBuild property:
dotnet build .\VeiledRecipes.csproj -c Debug -p:DeployToGame=true
Release builds still create the Thunderstore and Nexus zip packages normally.
