TitlesMod

The code was generated with AI assistance.

Earn titles as you play Valheim and build your own full title from them, like Moderslayer of the Mistlands or Lumberjack's Adept Runner the Undead. All equipped titles give their bonuses.

Building your title

A full title has five parts: prefix - word - main - word - suffix.

• Any title can go in any of the three spots. Some combinations make more sense than others, but that's up to you.
• A title can only be in one spot at a time, and tiers of the same ladder (like Dead and Lich, or Adept Runner and Master Runner) don't stack: equipping one removes the other.
• Connecting words between them, picked from a dropdown: (space), the, of, of the, from, from the, and, or, to, until, always, never, no, 's, er, ed, est, :, ;, ,, -, or (none), which joins the two into one word: Moder + Slayer = Moderslayer. The endings er, ed and est attach to the title before them: Poison + ed + Girl = Poisoned Girl. Server owners can change the list in the config.

Examples:

• Moderslayer of the Mistlands: Moder + (none) + Slayer + of the + Mistlands
• Lumberjack and Master Miner the Unbroken: Lumberjack + and + Master Miner + the + Unbroken
• Powerpuff Girl: Power + (none) + Puff + (space) + Girl

How to earn titles

Type	Example
Discover a biome	Meadows: enter the Meadows (+5 Bows), Mistlands: enter the Mistlands (+5 Dodge), ...
Metals	The highest metal you've had in your inventory: Copper, Tin, Bronze, Iron, Silver, Black Metal, Flametal: +5 carry weight per tier (Flametal +35)
Learn a recipe	Fisher: learn to craft a fishing rod (+5 Fishing)
Craft arrows	Arrow Maker (100), Arrows (200), Fletcher (300), Master Fletcher (400), Legendary Fletcher (500 arrows): +1 extra arrow per craft per tier (up to +5)
Craft bolts	Bolt Maker (100), Bolts (200), Boltwright (300), Master Boltwright (400), Legendary Boltwright (500 bolts): +1 extra bolt per craft per tier (up to +5)
Gather resources	Lumberjack: gather 500 wood (+5 Wood Cutting)
Build	DIY (10), Handyman/Handywoman (100), Builder (1000), Designer (5000), Architect (10000): +5% chance per tier that a wood or stone piece costs no materials (Architect 25%)
Repair	Fixer (100 hammer repairs): damaged buildings within 2 m repair themselves. Mender (1000): within 10 m
Map exploration	Wanderer (1%), Scout (5%), Explorer (10%), Pathfinder (20%), Trailblazer (30%), Cartographer (50%), Globetrotter (75%), Completionist (90%), Autism (100%): uncover that much of a world's map yourself (map data from a cartography table doesn't count)
World age	Fresh (day 10), Rooted (50), Weathered (100), Venerable (365), Primordial (1000): play in a world that has reached that day (the same for everyone on a server)
First kills	Cosmetic: Fallen and Angel (fallen valkyrie), Chicken and Nuggets (chicken), Dear (deer), Beer (boar), Tail (neck), Goblin and Goblin Mode (fuling), Skeeter and Backstab (deathsquito), Dog and Dawg (wolf), Lizard, Ox and Steak (lox), Grey and Dwarf (greyling), Bridge (troll), Zombie and Brains (draugr), Sucker (leech), Slime (blob), Balloon (gjall), Noodle (serpent), Bunny (hare), Hot (surtling), Bat (bat), Spooky and Scary (skeleton), Ethereal (ghost), Furry (fenring), Chain (wraith), Fun-sized (dvergr), Piranha and Bite (morgen), Magic (drake), Fart (abomination), Aerial and Turkey (volture), Raptor and Mutant (asksvin), Cult and Classic (cultist), Rock and Hard (stone golem), Meese and Mice (moose), Twig (greydwarf), Stump (greydwarf brute), Hippie (greydwarf shaman), Teddy (bear), Grizzly (vile), Howl (ulv), Tock (tick), Bug and Buzz (seeker), Crunchy (seeker soldier), Crispy (charred warrior), Burnt (charred marksman), Ashy (charred warlock), Jaws (bonemaw), Lava and Lamp (lava blob), Sticky (growth), Torch (Brenna), Frozen (Geirrhafa), Bros (Zil & Thungr)
Boss cosmetics	Greenhorn (Eikthyr), Groot (The Elder), Boner (Bonemass), Dragon (Moder), Meteor (Yagluth), Hive (the Queen), Warped, Madness and Pride (Fader)
Hot tub	Cosmetic: Chill, Relax, Jacuzzi and Moist: get into a hot tub for the first time
Embarrassing deaths	Gravity (fall: -10% fall damage), Extra Wet (drown: +5 Swim, -5% swim stamina), Oops (falling tree: +5 armor), Toasty (burn: -10% frost damage taken, +10% fire damage taken), Roadkill (cart: +15 Dodge). Older deaths count too
Days played	Settler (10), Pioneer (50), Old-Timer (100), Ancient (365), Timeless (1000): in-game days you have been online for (every new day counts once, also when you sleep)
Trophies	For every trophy you find, the monster's name: Greydwarf, Troll, Wolf, ... (also modded monsters). 25% chance of double drops from that monster when you kill it. Boss trophies add a 15% chance to the boss name title instead. Charred: find any charred trophy, 10% chance of double drops from every charred creature. Charred and the charred monster titles don't stack: equipping one removes the other
Defeat a boss	The boss name: Eikthyr (+5 Run), Elder (+5 Wood Cutting), Bonemass (+5 Clubs), Moder (+5 Swords), Yagluth (+5 Polearms), Queen (+5 Elemental Magic), Fader (+5 Blood Magic)
Combat	Killer (50), Hunter (100), Breaker (250), Crusher (500), Slayer (1000), Bane (2500), Vanquisher (5000 creatures): +5 max health and +1% damage per tier (Vanquisher +35 health, +7% damage). Pair them with a boss name: Moder + (none) + Slayer = Moderslayer
Fishing	Fish (10), Dolphin (50), Shark (100), Orca (250), Whale (500 fish caught): per tier -2% swim stamina and +2 Fishing (Whale -10%, +10)
Heavy attacks	Power (10), Crasher (100), Wrecker (500), Destroyer (1000), Annihilator (5000 heavy attacks): -2% attack stamina per tier
Eat berries	Cosmetic: eat 10 of a berry for its title: Raspberry, Blueberry, Cloudberry, Puff (jotun puffs), Vineberry
Sailing	Bait (1 km), Deckhand (10), Sailor (20), Navigator (40), Captain (60), Commodore (75), Admiral (100 km sailed at the helm): +1, 3, 5, 7, 9, 12, 15% sailing speed while you steer (the whole ship goes faster). Earlier sailing counts
Running	Marathon: run 42.2 km in total (+25 max stamina)
Dungeons	Cosmetic, earned the first time you enter: Burial, Chamber and Dungeon (burial chambers; pair it with Dragon from Moder: Dungeon + and + Dragon), Smouldering and Tomb (Smouldering Tomb), Sunken and Crypt (sunken crypt), Cave (frost cave), Howling and Cavern (Howling Cavern), Sealed and Tower (Sealed Tower), Infested and Mine (infested mine), Fortress (Charred fortress)
Meditation	Mindful (10 s), Meditator (1 min), Serene (5 min), Zen (30 min), Enlightened (1 h), Sage (24 h sitting while resting, by a fire under a roof): +10% Eitr regen per tier (Enlightened +50%), Sage +100%
Blood magic	Bloody (1), Bloodied (10), Blood (50 blood magic spells cast): +10 max health and +10% health regen per tier (Blood +30, +30%)
Weather	Cold: get cold (or freezing) for the first time (-5% fire damage taken, +5% frost damage taken). Freezing: start freezing for the first time (-10% fire, +10% frost damage taken)
New character	Noob: join a world with a brand new character (+5 max health, +10 max stamina, +15 carry weight). Only characters created while this mod is installed
Overweight	Gym: be over your carry weight limit for the first time (+10 carry weight)
Die	Dead (1), Undead (10), Death (50), Lich (100), Eternal (1000): -10% skill loss on death per tier (Eternal -50%)
Achievements	Every Valheim achievement is also a title, unlocked together with the achievement (account-wide, like the achievements themselves). Achievement: unlock your first achievement. See the note below about achievements and mods
Multiplayer	Friend: play in the same world as another player
Elements	Fire, Frost, Lightning, Poison, Spirit: hit creatures 100 times with that element (+5% damage of that element)
Bosses	Doom: defeat 25 bosses in total (+10% damage against bosses). Valhalla: be killed by a boss (-25% skill loss on death, adds to the death titles)
Weapons	Legendary Warrior: reach level 100 in any weapon skill (+25 to every weapon skill that isn't at 100 yet). Weapon skills: swords, knives, clubs, polearms, spears, axes, bows, crossbows, unarmed
PvP	Murderer (1 player kill), Serial Killer (5), Bloody Prince (10), Bloody King (25), Demon Lord (50), Demon God (75), Evil (100). While one is equipped, your PvP is always on and can't be switched off. After your first kill, kills only count while one of these titles is equipped
Progression	Jack of Some Trades (5 skills above level 20, +25% skill experience), Jack of Most Trades (10 above 20, +50%), Jack of All Trades (15 above 20, +75%), Jacked (15 above 30, +100% = double XP)
Progression	A second ladder: Skilled (3 skills above level 50, +50% skill experience), Skillmaxxing (5 above 50, +100%). Can be worn together with a Jack title
Progression	Unbroken: get 10 skills to level 10 (every skill is kept at its highest threshold on death)
Skill threshold	Adept Runner: reach Run level 50 (Run never drops below 50 on death, -9% run stamina)

With PaladinMod installed there is also Paladin: craft your first consecrated shield (+10% armor), and Holy / Divine: strike foes 100 times with the holy damage a consecrated shield reflects (+5% holy damage). Both unlock together; pick the name you like, only one can be equipped.

Plus a few rewards for finishing a whole set, like Worldwalker (every biome, +20 to all skills) and a hidden title for every boss.

Achievements and mods: by default, Valheim does not give achievements while you play with mods, so the achievement titles will not unlock either. If you want achievements while modding, it is recommended to download a mod that enables achievements.

Identity titles

Cosmetic titles everyone has from the start, without bonuses, so you can show who you are: Straight, Gay, Lesbian, Bi, Pan, Ace, Aro, Demi, Queer, Questioning, Cis, Trans, Nonbinary, Enby, Genderfluid, Genderqueer, Agender, Intersex, Two-Spirit, Man, Woman, Boy, Girl, Ally. They combine freely with each other and with earned titles, e.g. Trans Woman, Bi Ally, Queer Moderslayer.

Pronouns, also always available: He/Him, She/Her, They/Them, He/They, She/They, It/Its, Xe/Xem, Ze/Zir, Any Pronouns.

Other cosmetic titles

Also always available, without bonuses:

• Colours: Red, Blue, Yellow, Pink, Purple, Green, Orange, Crimson, Black, Golden (Silver is a metal title)
• Emotions: Happy, Sad, Depressed, Bubbly, Curious, Angry, Grumpy, Calm, Anxious, Excited, Bored, Brave, Shy, Cheerful, Gloomy, Jolly, Moody, Sleepy, Hungry, Lonely, Proud, Silly, Confused, Loving, Fearless
• Descriptors: Thick, Large, Small, Tiny, Huge, Long, Short, Tall, Big, Little, Giant, Massive, Mini, Slim, Chunky, Round, Wide
• Others: Kill, Seagull
• Every skill name (Swords, Wood Cutting, ...) and every skill title without its rank (Duelist, Runner, Assassin, ...)

Unbroken

While Unbroken is equipped, dying never lowers any skill (modded skills too) below the highest threshold (10, 25, 50, 75, 90, 100) it has reached. A skill at 62 stays at 50 or more, one at 31 stays at 25 or more. Skills below 10 lose levels as usual.

Skill threshold titles

Every vanilla skill has six threshold titles: Novice (10), Apprentice (25), Adept (50), Veteran (75), Master (90) and Legendary (100). While one is equipped, dying never lowers that skill below its level. Other skills still lose levels as usual. Threshold titles never add levels to the skill itself.

Each skill also gives a fitting perk that grows with the tier (Legendary = 6x Novice):

Skill (title)	Perk per tier		Skill (title)	Perk per tier
Swords (Duelist)	+2% stamina regen		Run (Runner)	-3% run stamina, +5 carry weight
Knives (Assassin)	+10% sneak attack damage		Jump (Leaper)	-4% jump stamina, -5% fall damage (Legendary: -40%, -50%)
Clubs (Bonebreaker)	+1 armor		Sneak (Shadow)	-4% sneak stamina
Polearms (Halberdier)	+3 max health		Swim (Swimmer)	-4% swim stamina
Spears (Lancer)	+3 max stamina		Dodge (Evader)	-3% dodge stamina
Axes (Reaver)	+1 armor		Ride (Rider)	+2 max stamina
Bows (Archer)	+2% stamina regen		Fishing (Angler)	+2% stamina regen
Crossbows (Arbalist)	+5% reload speed		Cooking (Cook)	5% chance of an extra cooked item
Unarmed (Brawler)	+10% stagger		Farming (Farmer)	5% chance of extra crops
Blocking (Bulwark)	-3% block stamina		Crafting (Artisan)	+10 carry weight
Elemental Magic (Elementalist)	+3% Eitr regen		Pickaxes (Miner)	+4% mining damage
Blood Magic (Bloodbinder)	-5% spell health cost, +2 max Eitr		Wood Cutting (Woodcutter)	+4% chop damage

The titles window shows the tiers you earned plus only the next one for each skill.

• Press Shift+F9 to open the titles window. Every earned title has Prefix, Main and Suffix buttons. The two dropdowns at the top pick the connecting words, and the Show button switches between all, earned and cosmetic titles. The search box finds titles by name, description or bonus (e.g. "runner", "stamina").
• Other players see your full title under your name, and your chat messages are sent with your title in front: Xav: [Moderslayer of the Mistlands] hello. Everyone sees it, even players without this mod.
• Pick your own title colour with the Colour button in the titles window. Players with this mod see your title in that colour on your name tag, in chat and above your head (players without the mod see it uncoloured).
• Progress is saved on your character, so it follows you to every world and server.
• Gathering counts items you pick up from the world. Picking up items that someone dropped, or that fell out of a broken chest, does not count.
• A kill counts if you hit the creature within 60 seconds before it died, so everyone who helps with a boss gets credit.

For server owners

Server titles: Admin, Owner, Donor, VIP, Super VIP, Mega VIP, Fan, Guest, Visitor can only be given by the server owner or an admin (needs devcommands):

• titles_grant <player name> <title id>: e.g. titles_grant Xav server_vip. Works for any title id, not only these.
• titles_revoke <player name> <title id>: takes it away again.
• titles_grants: lists everything given in this world.

Grants are saved in the world and synced to every player, by character name. Ids: server_admin, server_owner, server_donor, server_vip, server_super_vip, server_mega_vip, server_fan, server_guest, server_visitor.

Synced settings: when the server runs this mod, its BonusMultiplier, KillCreditSeconds and ConnectorWords are used by every player (players can't override them). Install the mod on the dedicated server for this. LoadDefaultTitles and the visual settings (hotkey, name tag and chat format) stay per player.

Console commands (F5)

• titles: list all titles and their ids
• title <id> [prefix|main|suffix]: equip a title you earned. title none removes all, title none prefix (or main, suffix) empties one place.
• title_word <prefix|suffix> <word>: the connecting word after the prefix / before the suffix, e.g. title_word suffix of the. space = just a space, none = joined into one word.
• titles_unlock <id|all>: (needs devcommands) unlock titles for testing
• titles_reset: (needs devcommands) remove all titles and progress from this character

Config

BepInEx/config/com.yourname.titlesmod.cfg: menu shortcut, a multiplier for all skill and stat bonuses (0 = no bonuses, death protection still works), the kill credit time, whether to show titles on name tags, how your title is added to your chat messages, the list of connecting words, and the option to turn off the built-in titles.

Feedback

Bug reports and balance feedback are very welcome!

For mod authors

Any mod can add its own titles, or add bonuses for its own skills to existing titles.

1. Reference TitlesMod.dll in your project (the XML docs ship next to it).
2. Add [BepInDependency("com.yourname.titlesmod")] to your plugin class.
3. Call the API from your plugin's Awake():

using TitlesMod;

// A new title with your own requirement and a bonus for your own skill.
// Skills are named by their vanilla name ("Swords", "Run", "All")
// or by the Jotunn skill identifier you registered.
TitleAPI.RegisterTitle(
    new TitleDefinition("mymod_master_chef", "Master Chef", "Cook 200 meals.")
        .Require(TitleRequirement.Counter("mymod:meals_cooked", 200, "Cook meals"))
        .Bonus("Cooking", 5)
        .Bonus("com.me.mymod.baking", 10));

// Raise your counter whenever it happens in your mod.
TitleAPI.IncrementCounter("mymod:meals_cooked");

// Add a bonus for your skill to a title from this mod (or any other mod).
// This works even if that title is registered after your mod loads.
TitleAPI.AddSkillBonus("boss_eikthyr", "com.me.mymod.baking", 5);
TitleAPI.AddSkillBonus("gather_wood", mySkillType, 5);   // or the SkillType Jotunn gave you

// Skill threshold title for your own skill: unlocked at level 50, and while equipped
// the skill never drops below 50 on death.
TitleAPI.RegisterTitle(TitleDefinition.SkillMilestone("mymod_baker_50", "Master Baker", "com.me.mymod.baking", 50, "Baking"));

// Or protect your skill on an existing title.
TitleAPI.AddSkillFloor("boss_eikthyr", "com.me.mymod.baking", 25);

// Stat bonuses while equipped (keys in TitleStats: HealthRegen, StaminaRegen, EitrRegen, MaxHealth,
// MaxStamina, MaxEitr, Armor, ArmorPercent, Damage, Lifesteal, ChopDamage, MiningDamage, CarryWeight, RunStamina, JumpStamina,
// SwimStamina, SneakStamina, DodgeStamina, AttackStamina, BlockStamina, FallDamage, SkillGain, DeathSkillLoss, FreeBuildChance, RepairAura, SneakAttack, StaggerBonus, ReloadSpeed, SpellHealthCost, ExtraCookChance,
// ExtraHarvestChance).
TitleAPI.AddStatBonus("mymod_baker_50", TitleStats.HealthRegen, 10);

// Your own stat: give it a label, then apply it yourself in your mod.
TitleStats.RegisterLabel("mymod:BakingSpeed", "+{0}% baking speed");
TitleAPI.AddStatBonus("mymod_baker_50", "mymod:BakingSpeed", 15);
float bakingBonus = TitleAPI.GetStatBonus("mymod:BakingSpeed");

// Players can put any title in any of the three spots, so a plain noun name reads best ("Breadmaker").
TitleAPI.RegisterTitle(new TitleDefinition("mymod_bread", "Breadmaker", "Bake 50 breads.")
    .Require(TitleRequirement.Counter("mymod:bread", 50, "Bake bread")));

// A cosmetic title every player has from the start (no unlock message, no bonus needed).
TitleAPI.RegisterTitle(new TitleDefinition("mymod_baker_pride", "Baker", "Cosmetic.").SetAlwaysUnlocked());
TitleDefinition prefix = TitleAPI.GetEquippedTitle(TitleSlot.Prefix);
string full = TitleAPI.GetFullTitle();   // "Breadmaker's Master Baker of the Mistlands"
TitleAPI.AddConnector("for");             // one more connecting word players can pick

// Keep every skill at the highest of these levels it has reached when dying.
new TitleDefinition("mymod_safe", "Steadfast", "...").ProtectAllSkillsAtTiers(20, 40, 60, 80);

// A tier ladder: give titles the same group and register them lowest first.
// The titles window then shows only the earned tiers plus the next one.
TitleAPI.RegisterTitle(TitleDefinition.SkillMilestone("mymod_baker_75", "Grand Baker", "com.me.mymod.baking", 75, "Baking"));

SkillMilestone already puts titles of the same skill in one group ("skill:<name>"). For other ladders use .SetGroup("mymod:fish").

Requirement helpers (prefab names are the same as for the spawn command):

Helper	Meaning
DiscoverBiome(Heightmap.Biome.Plains)	enter a biome
DiscoverItem("Silver")	have ever held the item
KnowRecipe("FishingRod")	know the crafting recipe
Gather("Wood", 500)	pick up this many from the world
Obtain("TrophyWolf")	pick up a specific drop once
Build("piece_workbench", 1) or Build("*", 100)	place pieces
Kill("Eikthyr") or Kill("*", 500)	help kill creatures
Counter(key, amount, label)	your own counter (TitleAPI.IncrementCounter)
SkillLevel("Run", 50)	reach a skill level (real level, without bonuses or buffs)
SkillsAbove(5, 20)	have this many skills (any, including modded) above a level
SkillsAtLeast(10, 10)	same, but the level itself counts too (level 10 or higher)
Craft("ArrowFire", 200)	craft this many items (20 per arrow craft; Valheim's own statistic, so older crafts count)
CraftAmmo(AmmoArrows, 1000, "Craft arrows")	craft any ammo of one type (AmmoArrows, AmmoBolts, or a modded ammo type)
PlayerStat(PlayerStatType.FishCaught, 50, "Catch fish")	any of Valheim's own player statistics (all history counts; distances in meters)
Eat("Raspberry", 10)	eat this many of a food (Valheim's own statistic, so older meals count)
Die(10)	die this many times (Valheim's own death count, so older deaths count)
HasTitle("boss_eikthyr")	another title is already earned
Custom(player => ..., label)	any check you write

You can also subclass TitleRequirement, grant a title directly with TitleAPI.Unlock(id), and listen to TitleAPI.OnTitleUnlocked / TitleAPI.OnTitleEquipped / TitleAPI.OnSlotChanged. TitleAPI.GetSkillBonus(skill) and TitleAPI.GetSkillFloor(skill) return what the equipped titles currently give. TitleAPI.GetEquippedTitle() without a slot returns the title in the middle spot. (TitleKind, AsEpithet() and SetKind() from older versions still compile but no longer limit where a title goes.)

The bonus is applied in Skills.GetSkillLevel, the same method every skill check uses, so your skill gets the bonus without any extra patch on your side.

Optional dependency

If your mod should also work without TitlesMod, use [BepInDependency("com.yourname.titlesmod", BepInDependency.DependencyFlags.SoftDependency)] and keep every TitlesMod call in a separate class, called only when Chainloader.PluginInfos.ContainsKey("com.yourname.titlesmod") is true. That way your mod never loads TitlesMod types when it is missing.