GungnirStaff

Gungnir Staff

A Valheim mod that adds Gungnir, Odin's spear — a Mistlands-tier weapon that carries other magic staffs inside itself and becomes whichever one you select.

Built on BepInEx 5.4.23.3 + Jötunn 2.29.2, targeting net462 (the framework Jötunn and Valheim's Unity Mono runtime use).

Source: <https://github.com/Dasone/Valheim-mod-Gungnir-staff>

---

What the mod does

Gungnir is craftable at an upgraded Galdr Table and behaves as a spear in the hand — full vanilla attacks, throwing, animations and colliders, because the item is a runtime clone of a vanilla spear with its own model, damage and flavour text applied on top.

Its own trick is the staff rack: a one-row inventory that lives inside the item. Drop a magic staff into the rack, select the slot, and Gungnir turns into that staff — its attack, eitr cost, projectile, skill XP, icon and held model all become the staff's. Holster, and it is a spear again. A new Gungnir has four rack slots and each upgrade adds two (4 → 6 → 8), so the item's quality is what governs how many staffs it carries.

The crystal in the butt of the spear is colour-coded per staff, with a matching light and a shoal of motes around it, so you can see which staff is loaded at a glance.

---

Layout

GungnirStaff.sln
Directory.Build.props          # all machine paths live here
Environment.props.example      # copy -> Environment.props to override paths
GungnirStaff/
  GungnirStaff.csproj          # references, embedded bundle, deploy targets
  Plugin.cs                    # BepInEx entry point, Harmony patch/unpatch
  ModConfig.cs                 # every user-facing setting
  Inputs.cs                    # rebindable KeyboardShortcuts
  Localizations.cs             # $token translations
  Alive.cs                     # "is the mod alive?" status reporting
  Commands.cs                  # `gungnir` dev console command
  Blueprint.cs                 # one-shot dump of a vanilla prefab's components
  GungnirItem.cs               # the item prefab, cloned from a vanilla spear
  GungnirStandalone.cs         # the same prefab built from nothing, no clone
  GungnirRecipe.cs             # recipe + three upgrade levels
  GungnirVisual.cs             # swaps the custom model in from the AssetBundle
  StaffRegistry.cs             # what counts as a staff
  StaffContainer.cs            # the rack inventory, persisted in m_customData
  StaffSwitcher.cs             # the m_shared projection, plus durability write-back
  GungnirBar.cs                # the rack UI, cloned from vanilla's InventoryGrid
  CrystalColors.cs             # per-staff crystal colour config
  CrystalGlow.cs               # tints the crystal material and casts a light
  CrystalParticles.cs          # code-built motes and sparks around the crystal
  Patches/PlayerPatches.cs         # spawn hook, hotbar suppression
  Patches/InventoryGuiPatches.cs   # Ctrl+click a staff into the rack
  Patches/RecipePatches.cs         # exact per-level upgrade costs
  Assets/gungnir               # the AssetBundle (embedded into the DLL)
art/                           # Blender source, FBX export, icon sources
tools/                         # Dump-GameType.ps1, Verify-Patches.ps1
Thunderstore/manifest.json     # packaging metadata

---

Crafting

Made at the Galdr Table, level 2 — an upgraded table, unlike the basic staffs.

| Material | Craft | Lv 2 | Lv 3 | | --- | --- | --- | --- | | Yggdrasil wood | 30 | 15 | 25 | | Refined eitr | 30 | 20 | 30 | | Thunder stone | 3 | 2 | 4 | | Black core | 2 | 1 | 2 | | Rack slots | 4 | 6 | 8 |

Three levels rather than four, because the levels exist to buy rack slots and the rack is full at level 3. The 8-slot ceiling is itself pinned by the Alt+1…Alt+8 shortcuts, so a fourth upgrade could only have cost materials and granted nothing.

Black cores gate it behind actually delving the Infested Mines rather than gathering on the surface.

Vanilla computes an upgrade requirement as m_amount at level 1 and (level - 1) * m_amountPerLevel above it, a curve that cannot produce the thunder stone progression 1, 2, 3, 4 at any setting. RecipePatches.cs substitutes the exact numbers, keyed on the requirement instance, so no other recipe in the game is touched.

Material names are resolved against ObjectDB rather than assumed — Valheim's asset manifest carries both ThunderStone and Thunderstone, and only one of them is the item.

---

Controls

Defaults — every binding is rebindable in Configuration Manager (F1).

| Input | Action | | --- | --- | | Alt + 1…8 | Select that staff (pressing the active one again holsters) | | Alt + 0 | Holster — Gungnir goes back to being a plain spear | | Right-click a rack slot | Wield that staff | | Left-click a rack slot | Pick up / drag, exactly like any inventory | | Ctrl + left-click a staff in your inventory | Quick-move it into the rack | | Middle-drag a rack slot (inventory open) | Move the bar to a new place on screen |

Alt, not Ctrl, because Ctrl is Valheim's crouch — Ctrl+3 also made the character sneak. Alt is free: vanilla's inventory only reads Shift (split) and Ctrl (quick-move) as click modifiers. While a slot shortcut fires, the vanilla hotbar is suppressed, so Alt+3 selects a staff instead of doing both things.

Vanilla's Modifier.Move only knows two destinations — the open container, or the player — and with no container open it falls through to dropping the item on the ground. InventoryGuiPatches.cs claims that case when a rack is available, which is what makes Ctrl+click into the rack work.

---

Configuration

Everything lands in BepInEx/config/dev.samspel.gungnirstaff.cfg and is live-editable in Configuration Manager (F1) under Gungnir Staff.

| Section | What's in it | | --- | --- |