Valheim
Install with App

Details

Latest version
0.1.5
Last Updated
First Uploaded
Downloads
495
Likes
0
Size
90KB
Dependants

Categories

ADDatHost Valheim hosting
30% off

Odin's Weapon Memories

Work in progress. This mod is new and still being tested, especially in multiplayer. Names, thresholds and wording may change between versions, and the memories already on your weapons are kept when they do. Found a problem? Type weaponmemory in the F5 console (or /weaponmemory in chat) while holding the weapon, and include what it prints when you report it in Odin's Tavern.

A blade that has felled forty trolls is not the same blade it was at the forge. Odin knows it. Now your weapons do too.

Every weapon remembers what it has done: what it killed and where, how often it struck true, the trees it felled, the blows it turned aside, and the times its bearer fell holding it. From all of that, it earns a name.

Legend names

A weapon's name is built from four parts, each earned in its own way:

[Renown or trait] [Element] [Weapon] [of the ...]

  • Storied Frost Greataxe of the Troll's Bane
  • Unerring Shadow Longbow of the Hunt
  • Unblooded Hewer of the Woodpile
  • Ill-fated Mire Seax of Many Graves
  • Legendary Ember Staff of Moder's Fall
Part Earned from
Renown Total kills: Blooded (5), Seasoned (25), Storied (75), Fabled (200), Legendary (500). A weapon used but never blooded is Unblooded.
Trait How it was used. It replaces renown until Fabled. Unerring or Wayward (accuracy), Silent (kills on creatures that never saw you), Merciless (single-blow kills), Defiant (kills at death's door), Moonlit (night kills), Proven (starred foes), Steadfast and Unyielding (blocks and perfect parries), Ill-fated (bearers who died holding it).
Element The weapon's own fire, frost, lightning, poison or spirit damage (Ember, Frost, Storm, Venom, Hallowed). A plain weapon, and every shield, takes the land it was crafted in: Verdant, Shadow, Mire, Rime, Sunscorched, Mist, Ashen, Glacial, Tidal. It never changes, however far the weapon wanders.
Weapon A plain word for its kind (Blade, Hewer, Maul, Seax, Longbow, Arbalest, Sceptre...), always the same word for the same weapon.
Suffix The proudest thing it has done: a boss it felled (of Moder's Fall), its trade (of the Woodpile, of the Quarry), the hunt (of the Hunt for deer, boar and the like), its favourite foe (of Troll-Felling, of the Troll's Bane, of the Troll-Scourge at 10/50/150 kills), or a feat (of the Far Mark for a 60 m kill shot).

A new weapon keeps its ordinary name until it has earned a renown, trait or suffix. Being born in the Swamp is not, in itself, an achievement, so the land word only turns up once there is a name to put it in. A message in the middle of the screen marks each new name.

Names that stay put

A name, once earned, is kept. Odin does not rename a sword because it had a quiet evening.

  • Earned words stay until something strictly better comes along. A Silent blade stays Silent if you start charging in loudly; it is never demoted because a share dipped below a line.
  • The front word is only reconsidered at milestones: the renown thresholds (5, 25, 75, 200 and 500 kills; 10, 50, 150, 400 and 1000 blocks for shields), and every 50 kills or blocks besides (MilestoneStep). Between milestones it is left alone.
  • What counts as better. For the front word, a higher renown beats a lower one, and a trait beats the plain renown it was earned at, but not the next renown up: a Silent Seasoned blade becomes Storied at 75 kills, unless it is still Silent then, in which case it simply stays Silent. From Fabled on, fame outweighs habits, as before. Unblooded is the one word that leaves without a better one, at the first kill, since it has stopped being true. For the suffix, a felled boss beats everything (another boss only with more kills of it); otherwise the higher tier wins (Bane beats Felling, the Long Hunt beats the Hunt), and on equal tiers the trade beats the hunt, the hunt beats a favourite foe, and a foe beats a feat. The suffix may move up whenever it is earned; it never moves down.
  • Weapons you already have keep the name they show the first time you look at them after updating, and carry on from there.

The kept words are stored on the weapon, next to its memories, so everyone with the mod sees the same name. Prefer the old way, where the name follows the numbers wherever they go? Set NameChanges = Live.

Prefer the plain style? Set NameStyle = Epithet for "Iron Sword, Troll-Feller".

Shields

Shields remember the blows they turned aside instead of kills: how many, from whom, where, and how many were perfect parries. Their names follow the same pattern:

  • Battered Shadow Linden-board of the Greydwarf-Ward (60 blocks, mostly Greydwarfs)
  • Unyielding Mire Linden-board of the Draugr-Wall (30 perfect parries)
  • Storied Mire Wall of the Bonemass-Ward (a tower shield that held against Bonemass)
  • Legendary Tidal Targe of the Skeleton's Despair (1200 blocks)

Renown for shields: Dented (10 blocks), Battered (50), Storied (150), Fabled (400), Legendary (1000).

The maker's engraving

Every weapon carries its maker's name for good: the character who crafted it, engraved the moment it leaves the workbench. (A weapon that was found rather than crafted takes the name of the first character to wield it.) The tooltip shows it as a faint engraving or a strange inscription.

The engraving never changes, however many hands the weapon passes through. Anyone with the mod sees the same name. That stays true after someone else upgrades the weapon, even though vanilla's own "Crafted by" line switches to the upgrader. The engraving travels unseen through players without the mod, too (except through their upgrades; see below).

When a weapon changes hands

The name belongs to the weapon's namer, the first bearer to earn it one (usually its maker).

  • By default (LaterBearers = KeepNamersName) the name stays as its namer left it. New bearers' kills are still counted and shown ("Kills since it left Ragnar's hands: 12"), but the legend is the namer's.
  • Or (LaterBearers = EvolveWithNewBearer) every bearer's deeds keep shaping the name, and the tooltip remembers what it was once called.

The tooltip

Hover over the weapon to see its story:

  • its name, and what it was forged as (the real item)
  • total kills and how often it struck true
  • its top foes
  • its deeds: bosses felled, unseen kills, longest shot, parries, axe-strokes on wood, bearers fallen...
  • the maker's engraving, and who named it

What counts

  • Only the killing blow. The weapon that dealt the final hit gets the kill. If a friend finishes off your troll, it's their kill, not yours.
  • Bows, crossbows and staffs count. Arrows, bolts, fireballs and their splash damage are traced back to the weapon that fired them. Every shot and swing counts towards accuracy.
  • Burning and poison count when they finish a creature off: the kill goes to the last weapon you hit it with.
  • Every kind of creature counts, modded ones included. Players don't. Starred creatures count as their kind ("Troll", whatever the stars).
  • Trees, logs and rock count as work for the weapon that struck them.
  • Which weapons remember is up to you, kind by kind (see [Weapons] below). By default: swords, axes, clubs and maces, spears, polearms, knives, shields, bows, crossbows, and elemental and blood magic staffs. Pickaxes, fist weapons, torches and other mods' oddities are off until you turn them on. Tools and thrown spears never count (see Things to know).

Cosmetic, client-side, and it stays with the weapon

Client-side only. The mod never adds items, prefabs, network messages or world data. It works in single player and on any server, and nobody else needs it. Everything happens on your own computer.

The memories live on the weapon itself, in the item's own custom data field that Valheim saves with every item. Drop it, store it in a chest, hand it to a friend, repair it or log out, and the memories go with it.

The weapon's real name is never changed. Its legend name is worked out each time the tooltip or hover text is drawn, from the memories and the words it has kept. Underneath, the item is a perfectly ordinary Iron Sword.

Cosmetic by default. There is an optional, small damage bonus (see below). It is off unless you turn it on.

Trading and sharing weapons

Both players have the mod: hand the weapon over (drop it or put it in a chest) and the new owner sees its name, engraving and full story. From then on it counts their deeds on top of the old ones. Whether those deeds change the name is up to LaterBearers (see above).

The other player doesn't have the mod: they get a perfectly normal weapon. Same name, same stats, same tooltip as any other. The memories ride along unseen in the item's data, and Valheim keeps them through their drops, chests, repairs and saves. Give the weapon back, or install the mod, and its name and engraving are there again.

One catch: upgrading at a workbench without the mod erases the memories. Vanilla upgrades by swapping in a brand-new item, which leaves the custom data behind. With the mod installed, the memories are carried over to the upgraded weapon.

Configuration

Settings live in BepInEx/config/hevyh2o.valheim.odinsweaponmemories.cfg. If you have a Configuration Manager mod installed, you can also change them in game (usually F1); this mod doesn't need one.

Setting Default Controls
Enabled true Turn the mod on or off. When off, nothing is counted or shown, but memories already on weapons are kept.
AnnounceEpithets true Message on screen when a weapon earns a new name or epithet.
TopFoes 3 How many kinds of creature the tooltip lists.
NameStyle Legend Legend: a whole name earned from use. Epithet: the item's name plus one epithet ("Iron Sword, Troll-Feller").
LaterBearers KeepNamersName KeepNamersName: the name stays as its namer left it. EvolveWithNewBearer: every bearer keeps shaping it.
ShowEngraving true Show the maker's name as an engraving in the tooltip.
NameChanges Sticky Sticky: earned words stay until something better replaces them, and the front word is only reconsidered at milestones (see Names that stay put). Live: the name is rebuilt from the counts every time and can change back and forth, as it did before.
MilestoneStep 50 Sticky only. Besides the renown thresholds, the front word is reconsidered every this many kills (blocks for shields). 0: only at the renown thresholds.
LandWord CraftedBiome CraftedBiome: the land part is the biome the weapon was crafted in, for good. MostKills: the land where at least LandShare of its kills happened (the old way; with Sticky it is reconsidered at milestones and only gives way to a land with more kills). Weapons with their own element keep it either way.
[Renown] BloodedKills, SeasonedKills, StoriedKills, FabledKills, LegendaryKills 5 / 25 / 75 / 200 / 500 Total kills for each renown. From Fabled on, renown beats traits.
[Renown] DentedBlocks, BatteredBlocks, StoriedBlocks, FabledBlocks, LegendaryBlocks 10 / 50 / 150 / 400 / 1000 The same for shields, in blows turned aside.
[Traits] TraitMinKills 20 Kills before Silent, Merciless, Moonlit or Proven can be earned.
[Traits] SilentShare, MercilessShare, MoonlitShare, ProvenShare 25 / 25 / 60 / 50 Percent of kills that were unseen, single-blow, at night, or on starred foes.
[Traits] AccuracyMinAttacks, UnerringAccuracy, WaywardAccuracy 50 / 85 / 35 Swings and shots before accuracy counts; Unerring at this percent of hits or better, Wayward below this one. Staffs are spared both.
[Traits] IllFatedDeaths, IllFatedKillsPerDeath, ShieldIllFatedBlocksPerDeath 3 / 5 / 20 Ill-fated: at least this many bearers fallen, and no more than this many kills (blocks, for shields) per fallen bearer.
[Traits] DefiantKills, UnyieldingParries, ShieldUnyieldingBlocksPerParry, SteadfastBlocks 5 / 25 / 3 / 50 Defiant kills at death's door, Unyielding perfect parries (shields: no more than this many blocks per parry), Steadfast blocks with a weapon.
[Land and Hunt] LandShare, LandMinKills, ShieldLandMinBlocks 50 / 10 / 25 LandWord = MostKills only: the share of kills (blocks) one land needs, and how many it needs at least.
[Land and Hunt] HuntShare 60 of the Hunt: percent of kills that must be deer, boar and the like (and at least Tier1Kills of them).
Tier1Kills / Tier1Title 10 / {0}-Feller Kills of one kind for the first tier (legend suffix of X-Felling). The title is used in Epithet style; {0} is the creature's name. 0 kills turns a tier off.
Tier2Kills / Tier2Title 50 / Bane of the {0} Second tier (of the X's Bane).
Tier3Kills / Tier3Title 150 / Scourge of the {0} Third tier (of the X-Scourge).
[Weapons] Swords, Axes, Clubs, Spears, Polearms, Knives, Shields, Bows, Crossbows, ElementalMagic, BloodMagic true Which kinds of weapon remember their deeds and earn names. Clubs covers maces and sledges.
[Weapons] Pickaxes, Unarmed, Torches, Other false Off by default. Unarmed is fist weapons (knuckles, claws); Other is any weapon training a skill not listed, e.g. from other mods.
DamageBonus false Optional. When on, a weapon deals a little more damage to kinds of creature it has an epithet for.
DamageBonusPerTier 2 Extra damage in percent per epithet tier (so +2% / +4% / +6%). Capped at 5% per tier.
LogKills false Write every remembered kill to the BepInEx log. For testing.

Changing the style, titles or (with NameChanges = Live) thresholds renames every weapon at once. With Sticky, new thresholds apply from each weapon's next milestone; words already kept stay kept. The counts themselves are never touched, so you can switch back and forth.

Things to know

  • Thrown spears don't count when thrown. A thrown spear leaves your inventory, and the one you pick up is a new copy. Stabbing kills count as normal.
  • On servers, two kinds of kill. When your game is in charge of a creature (always in single player, usually when you hunt alone), the mod sees the exact killing blow. When another player's game is in charge of it, the mod counts a kill when your hit was strong enough to finish it and the creature died right after. Very rarely, a kill-steal in the same moment could go either way.
  • Weapons from before you installed the mod start with a clean slate. Their maker's engraving is the crafter the game already knows.
  • Weapons crafted before the land was recorded, or found rather than crafted, keep the land word they have the first time you look at them after updating. If they had none, they stay without one; Odin does not guess where a sword was born.
  • Everyone with the mod sees the same name. It's worked out the same way on every machine, unless someone has changed their naming settings.
  • Turning the damage bonus on is your call. It's off by default so the mod stays fair on any server.
  • Found a bug or have an idea? Tell Odin in Odin's Tavern. The ravens read every note; your BepInEx\LogOutput.log helps them read faster.

Also from Odin's tavern

Odin's Stagger Home

Odin's Stagger Home: too many meads to find the way? Press \ and Odin walks you home to your bed, round water and over logs. Your sword remembers the fights. It won't remember the walk home. Neither will you.

Odin's Long Drop

Odin's Long Drop: at a ledge or mid-fall, the drop and the damage the landing will do, beside your crosshair. Your axe remembers its kills. It would rather not remember the fall.

Odin's Thread

Odin's Thread: a faint trail on your map and minimap of every step you took, fading with age, with your deaths and portal hops marked. The weapon remembers what it did; the thread remembers where.

Odin's Nudge

Odin's Nudge: alt-tabbed while something eats you? Odin flashes the taskbar and knocks when you're hurt, an enemy closes in, a raid starts or chat says your name. Odin knocks when something comes close, so the axe gets its fight while you're here to see it.

Odin's Latch

Odin's Latch: Odin shuts the doors you opened when it matters: an enemy close, nightfall or a raid at your base. The door stays shut, the sword stays sheathed. Not every memory needs a troll in it.

Odin's Second Hand

Odin's Second Hand: when an enemy gets close, Odin swaps your bow for your best melee weapon against it, and hands the bow back once it's gone. Every swing it hands you is remembered too, so your mace may earn its name before your bow does.

Odin's Free Refills

Odin's Free Refills: no stamina costs while the coast is clear. Walk home from the hunt without stopping for breath.

Odin's Wanted Posters

Odin's Wanted Posters: look at a creature and press E to see its health, weaknesses and drops. The poster tells you what it is; the weapon remembers how many you've put down.

Odin's Almanac

Odin's Almanac: press K for a forecast of the next weather changes in your biome. Pick a clear night for the troll hunt.

Odin's Saga

Odin's Saga: sleep or log out and Odin reads you the saga of your day; press J for a lifetime of deeds. The saga remembers what you did; the weapon remembers what it did.

Odin's Hearth

Odin's Hearth: press N at home to see your comfort level, what's counting, and the cheapest piece to build next. Somewhere to hang the Troll-Feller.

Odin's Pantry

Odin's Pantry: press P to see your foods, what you could cook right now, and Odin's best three- food pick for your biome. Eat well before you earn the next epithet.

Odin's Raven Returns

Odin's Raven Returns: after you die, a raven guards your grave; press H to see where it is, what killed you and what's still waiting there. Your Troll-Feller is probably in that grave.

Odin's Drunk Cam

Odin's Drunk Cam: drink a mead and the world sways; the more meads, the more it sways. Purely visual, with an intensity slider and an off key. For toasting the Troll-Feller.

Odin's Stone Whispers

Odin's Stone Whispers: Odin whispers when a Rock or Mysterious Rock is near; press 9 and he turns your gaze to it. Rocks don't remember anything. Your sword remembers everything.

Odin's Dusk Horn

Odin's Dusk Horn: a low horn before nightfall, and press Home for the time to dark and the way to your bed. Caught out after dark? At least your axe will remember the night.

Odin's Knot

Odin's Knot: log out and Odin asks what you were doing; log back in and he reads it back. Press ' to retie it. Your sword remembers what it did; the knot remembers what you meant to do next.

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.