Jewelcraft

Jewelcraft

Equipment refinement for Valheim · Version 0.8.6 · By Enoq

Refine weapons, shields, and armor up to +9 with Jewel of Bless and Jewel of Soul. Each level adds power and a progressive surface glow. Each armor set has an assigned palette, and weapons and shields have their own colors.

Requirements and installation

• BepInExPack Valheim 5.4.2350 or later.
• Jötunn 2.30.2 or later.
• Windows client build. Visuals have been tested with Direct3D 11; Vulkan shader variants are included but have not been verified in live gameplay.
• Install the same Jewelcraft version on every client and the server.

Install Jewelcraft by Enoq through Thunderstore Mod Manager or r2modman; the manager installs its dependencies automatically. For manual installation, install the dependencies first and copy the ZIP's BepInEx folder into your Valheim directory. Keep Jewelcraft.dll and jewelcraft-glow-windows together. Remove duplicate installations before starting the game.

When updating, close Valheim and your mod manager. Existing gem identifiers and refinement data remain compatible. Configuration values are preserved.

Refining equipment

1. Obtain gems from wild monsters and keep them in your inventory. Gems cannot be crafted.
2. Use a sheltered Workbench, open Upgrade, and select Gems above the equipment list.
3. Select an eligible item and review its current refinement, next level, bonus, required gem, and success chance.
4. Press Refine and wait for the crafting progress bar. Each completed attempt consumes one gem.

The Quality option retains normal Valheim upgrades. Gems uses the native equipment list, material icons, crafting button, progress bar, and workbench effects. A level 1 workbench can refine compatible equipment from any crafting station, including items at maximum normal quality. Quality and refinement are separate; standard quality upgrades preserve existing refinement.

Canceling, closing the inventory, changing selection, leaving the workbench, or losing access to the item or required gem cancels an unfinished attempt without spending a gem. Roof and distance requirements apply. F8 is an optional shortcut to Upgrade > Gems while already using a workbench.

With a controller, focus the crafting panel and use the displayed confirm-button hint to switch Quality/Gems. Equipment selection, refine/cancel, repair, and Craft/Upgrade tabs retain their native controls.

| Gem | Refinement range | Default refinement success chance | | --- | --- | --- | | Jewel of Bless | +0 to +1 through +5 to +6 | 100% | | Jewel of Soul | +6 to +7 | 80% | | Jewel of Soul | +7 to +8 | 65% | | Jewel of Soul | +8 to +9 | 50% |

A failed attempt consumes the gem and preserves the item and its current refinement level. Refinement is separate from the normal crafting quality. The default additive bonus is 4% per level to applicable damage, armor, and block power: +9 gives a 36% bonus. Server administrators can change chances and bonuses.

Bless is a translucent coral-red crystal; Soul is an ice-blue crystal. Both use faceted models, pixel textures, matching inventory icons, and subtle colored light. Enlarged world models and native dropped-item sparkles make them easier to find on the ground.

Both gems can be displayed on the native wooden wall and horizontal item stands. Put a gem on the hotbar, aim at an empty stand, and use its slot key. The stand holds one gem; hold the interaction key to retrieve it. Displaying a gem does not refine equipment or use it up. Armor stands remain reserved for equipment.

Monster drops

| Gem | Default chance per eligible monster death | Quantity on success | | --- | --- | --- | | Jewel of Bless | 11% | 1 | | Jewel of Soul | 8% | 1 |

The rolls are independent: a monster can drop neither gem, one gem, or one of each. Bosses use the same gem chances and do not guarantee gems. Star level, player count, and world resource multipliers do not increase gem quantities or chances.

Eligible creatures use monster combat behavior and belong to a monster or boss faction. Tamed creatures, passive wildlife, players, neutral NPCs, and friendly summons are excluded. Gems join the native loot, including loot released by a corpse after a delay, and existing monster drops stay unchanged. Monsters already spawned in the world are supported.

There are no gem crafting recipes. Gems obtained in earlier versions remain usable. Administrators can change Drops.BlessChance and Drops.SoulChance from 0 to 100; 0 disables a gem drop and 100 guarantees it for eligible deaths. The server synchronizes these settings to clients.

Version 0.8.5 lowers the defaults to 11% Bless and 8% Soul. Existing configuration files retain their saved values; to use the new rates in an existing profile or server, set BlessChance = 11 and SoulChance = 8 in the [Drops] section.

Equipment appearance

| Equipment tier | Effects on refined items | | --- | --- | | Basic | Surface glow | | Intermediate | Surface glow and contrasting glints | | Advanced | Surface glow, contrasting glints, and colored wisps |

The recipe determines the tier; the refinement level controls intensity. Unrefined items do not emit these effects. Rags, leather, bronze, and troll armor are basic. Iron, root, wolf/silver, and Fenris equipment are intermediate. Padded, carapace, mage, and later equipment are advanced.

In Auto mode, native equipment uses fixed palettes. Pieces from the same armor set match; mixed sets retain their own colors. For example, an Ask chest remains gold while a carapace helmet remains pearl. Each piece retains its own refinement intensity and effects tier. Weapons and shields have independent assigned palettes.