You are viewing a potentially older version of this package. View all versions.
RavenIronStudios-LordsLadies-0.2.0 icon

LordsLadies

Earn your name. Skill titles on every nameplate, fame and karma from every kill, Lord and Lady titles at the top, and blue, grey or red names for the innocent, the criminal and the murderer. Server-authoritative.

Date uploaded a day ago
Version 0.2.0
Download link RavenIronStudios-LordsLadies-0.2.0.zip
Downloads 15
Dependency string RavenIronStudios-LordsLadies-0.2.0

This mod requires the following mods to function

ValheimModding-JsonDotNET-13.0.4 icon
ValheimModding-JsonDotNET

Shared version 13.0.3 of Json.NET from Newtonsoft, net45 package for use in Valheim mods. Maintained by the ValheimModding team.

Preferred version: 13.0.4
denikson-BepInExPack_Valheim-5.4.2360 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2360

README

πŸ‘‘ Lords & Ladies

LORDS & LADIES VERSION BOTH SIDES

The skald at the long table does not ask your name. He looks at the hands that swung the hammer a thousand times, at the trolls you brought down and the travellers you left bleeding on the road, and then he tells the hall who you are. Sometimes they cheer. Sometimes they reach for their axes.

Every name in the hall tells a story, and you write yours with every swing.

Your best skill becomes your title, or any other you have earned, on your nameplate for everyone to read: Master Blacksmith, Grand Master Swordsman. Every creature you bring down earns fame and karma, and enough of both crowns you: The Glorious Lord, The Noble Lady.

Turn on the innocent and the whole world sees it. Your name goes grey while the blood is fresh, and red once your victims have named you a murderer often enough. The server keeps the ledger, so nobody can talk their way out of it.


NEW IN 0.2.0

Wear the name you are proudest of. Open your inventory, then the Compendium, and the new Titles page shows your nameplate exactly as everyone else sees it. Change it there and watch it change.

You… Lords & Ladies
pick a skill title wears it instead of your highest: Automatic, any title you have earned, or Hidden
pick how much of your standing shows in full (The Glorious Lord), the word only (The Glorious), the rank only (Lord), or nothing
click a skill at 30 or more in the Skills panel wears its title; click it again to go back to automatic. β˜… marks the one you wear
press Shift+F8 steps through your titles, one press at a time
sink into bad karma an infamous standing always shows in full: you can hide your glory, never your shame

πŸ”Ή Kept in the character: each character keeps its own choice, on any machine Β· πŸ”Ή title does it all from the console Β· πŸ”Ή F8 still hides or shows your skill title


BEFORE YOU INSTALL

If… Then…
πŸ›‘ you install it on one side only install it on the server and every client. The server keeps the ledger; the clients report kills and blows, and draw the plates.
β›” you run VALtimaOnline do not add this: VALtimaOnline already has these systems, and the two refuse to load together.
⚠️ your server has PvP off for everyone titles, fame and karma all work; the grey and red names just never come up.
πŸ” you want titles nobody can fake fame, karma and name colour are the server's. Skill titles are worked out on each player's own game, so a modified client could claim one.

I

Your best skill, on your nameplate.

πŸ”¨ The rank Neophyte Β· Novice Β· Apprentice Β· Journeyman Β· Expert Β· Adept Β· Master Β· Grand Master at 100
βš”οΈ The trade from the skill itself: Swords makes a Swordsman, Pickaxes a Miner, Blood Magic a Necromancer
🧩 Skill mods Smoothbrain's skills count too: Blacksmithing, Cooking, Farming, Sailing and the rest
πŸ‘© Her title a female character is a Swordswoman, an Axewoman, a Fisherwoman
πŸŽ–οΈ Your choice wear your highest, or any title you have earned: from the Compendium's Titles page, the Skills panel, Shift+F8 or title
πŸ™ˆ F8 hides your title, or shows it again. You keep it either way
πŸ“– Read the saga β€” how the title is picked and shared

Every couple of seconds your game looks at each skill on the title list and takes the highest. Below 30 a skill earns nothing; at a tie the skill listed first wins. When the title changes it is sent to everyone at once, and again every minute, so a player who joins late learns every title in the hall within a minute.

Choose a title and you wear that one instead, even after another skill overtakes it. If the one you chose stops counting (the skill is taken off the list, say), you wear your highest until it counts again. The choice lives in the character itself, so it follows that character to any machine, and your other characters keep their own.

The list of skills and trades is a setting. Rename a trade, add a skill from another mod, or take one off: anything that registers a skill by its English name can have a title.


II

What you kill decides what you are.

πŸ† Fame 0 to 15,000. Every worthy kill adds to it
☯️ Karma -15,000 to +15,000. Monsters raise it; harming the good lowers it
πŸ— 163 creatures each with its own worth; one from another mod is valued by its health
⭐ Starred creatures are worth more, star by star
πŸ›‘οΈ Parties a kill is shared among the party members close enough to have been in the fight
πŸ“‰ Diminishing returns the higher you climb, the less each kill adds; the further you fall, the faster you fall
πŸ’€ Dying costs a tenth of your fame
πŸ‘‘ The crown at 10,000 fame you are a Lord or a Lady
🎭 How much shows your choice: the full title, the word only, Lord or Lady only, or nothing in front of your name
βš–οΈ No hiding shame an infamous standing (The Rude, The Notorious, The Dread Lord…) always shows in full, and your name's colour always shows
Fame and karma make…
a newcomer no title at all
a decent hunter The Notable, The Upstanding
a feared raider with bad karma The Infamous, The Villainous
a hero of the realm The Glorious Lord, The Illustrious Lady
a tyrant with all the fame and none of the virtue The Dread Lord, The Evil Lady
πŸ“– Read the saga β€” why a troll is worth more than a boar

Every creature in the game has a fame and a karma value: a greydwarf is a small step, a troll a big one, a boss a landmark. A kill is worth a hundredth of each. Monsters carry bad karma, so killing them is a good deed; peaceful animals carry none, so hunting them earns fame and nothing else. A creature from another mod, one the table has never heard of, is valued by its health instead.

Your own standing pushes back. A gain is cut by a hundredth of what you already have, so the last thousand fame takes far longer than the first. A loss is deepened the same way, so a hero who goes bad falls hard.

A modest Lord can drop the fanfare and go by Lord alone, or by nothing at all. A tyrant cannot: once your karma sinks into the bad words, the whole title shows whatever you chose, and your choice comes back the moment your karma climbs out. Blue, grey and red are never hidden either; they are how the hall knows who to trust.


III

Everyone can see what you have done.

Name Means How
πŸ”΅ Blue innocent everyone starts here
βšͺ Grey criminal you struck an innocent. It lasts two minutes after your last blow
πŸ”΄ Red murderer five of your victims named you their killer
πŸ—‘οΈ Self-defence striking someone who struck you first is no crime; nor is striking a grey or a red
πŸ“œ The question a few seconds after a player dies, they are asked about each criminal who helped kill them: report them or let it go
⏳ Counts wear off short-term counts with 8 hours of play, long-term ones with 40. The clock only runs while you are online
☯️ The price a reported murder sinks the killer's karma, deeper with every count
πŸ›οΈ Safe havens inside one, a blow is never a crime
πŸ“– Read the saga β€” why the victim decides

Not every death is a murder. A duel, a brawl both sides wanted, a friend's misjudged swing: the victim knows which it was, so the victim decides. Only a killer whose blows were crimes can be reported, and one victim can name the same killer at most once every ten minutes.

A red stays red for as long as they keep their long-term counts, and every new murder starts the clocks again. A murderer who never stops never sees a count fall.


THE TOOLBOX

First ten minutes: install on the server and in the modpack β†’ join β†’ hit a skill past 30 and watch your plate β†’ kill something β†’ type sins β†’ open the Compendium's Titles page and choose how you are known.

Key Command
F8 hide or show your title title your titles, which one you wear, and your nameplate as others see it
Shift+F8 wear the next of your titles sins your fame, karma, counts and how long until they fall
llrep help admins: show and set fame, karma, counts and criminal time
πŸ› οΈ Choosing your title
  • The Compendium (open your inventory, then the Compendium, then Titles): a skill-title list (Automatic, each title you have earned, Hidden) and a fame-and-karma list (Full, Word only, Rank only, Hidden), with your nameplate under How others see you, and your fame, karma and notoriety beside it.
  • The Skills panel: click a skill at 30 or more to wear its title; click it again for automatic. β˜… marks the one you wear.
  • Shift+F8: automatic, then each of your titles in turn, then automatic again.
  • The console (F5):
Command Does
title lists your titles, numbered, and shows your nameplate as others see it
title <number> Β· title <part of a skill or title> wear that one (title 2, title smith)
title auto wear your highest
title hide Β· title show hide or show your skill title (the same as F8)
title style full Β· word Β· rank Β· hidden how much of your fame and karma title shows
πŸ› οΈ Making a safe haven
  1. In the world's save folder (worlds_local/<world>/ on the server), create lordsladies-havens.json.
  2. List each haven as a rectangle with PvP forced off: { "territories": [ { "name": "Home", "shape": "Rectangle", "x": 0, "z": 0, "halfX": 50, "halfZ": 50, "yaw": 0, "pvp": "ForcedOff" } ] }
  3. Restart the world. The server's log says how many havens it read.

A TerroritySmellatory territories file is the same format and can be copied in as it is.

πŸ› οΈ Admin commands

From the in-game console (F5) as an admin, or the server's own console. A player is me, #<player id>, or enough of a name to be unique.

Command Does
llrep list everyone in the ledger
llrep status <player> one player's fame, karma, counts and name colour
llrep fame <player> <0-15000> Β· llrep karma <player> <-15000-15000> set outright
llrep award fame <player> <amount> Β· llrep award karma <player> <amount> give it the normal way, with diminishing returns
llrep counts <player> <short> <long> set murder counts
llrep criminal <player> [seconds] Β· llrep pardon <player> make grey, or clear it
llrep save write the ledger now

MULTIPLAYER

On the server In every player's game Single player / hosting
fame, karma, crimes, reports, counts and the ledger reports kills and blows; draws titles and name colours everything runs in your own game

⚠️ Versions must match. Update the server and the modpack together. The server's settings reach every player as they join. A player who has not updated yet still sees every skill title, chosen ones included, but shows everyone's fame and karma title in full.


COMPATIBILITY

Mod
β›” VALtimaOnline Do not combine. It carries these same systems.
Smoothbrain skill mods Their skills earn titles.
Group / party mods A party share is ready for one; another mod sets who is in your party. Without one, each damager earns alone.
TerroritySmellatory Its territories file works as a safe-haven file.
Nameplate mods The title is added under the name, after other mods have had their say; creature plates are never touched.

SETTINGS

All safe to leave alone. BepInEx/config/wubarrk.lordsladies.cfg; the server's values win while you are connected.

πŸ”’ Server-synced β€” set on the server, locked to admins
Section Setting What it does
01 Titles Skill Nouns which skills give a title, and the trade each one names
01 Titles Title Heartbeat Seconds how often each title is sent again for late joiners
02 Reputation Enabled fame, karma and name colours on or off
02 Reputation Show On Plates show the fame and karma title and the name colour on plates
02 Reputation Short Term Murder Hours Β· Long Term Murder Hours play time before a count falls
02 Reputation Red At Counts long-term counts that make a murderer
02 Reputation Criminal Seconds how long a blow keeps you grey
02 Reputation Karma Per Murder Count the karma a reported murder costs, per count
02 Reputation Kill Credit Radius how close a party member must be to share a kill
02 Reputation Max Awards Per Minute a cap on kill awards per player
02 Reputation Death Costs Fame dying costs a tenth of your fame
πŸ–₯️ Local to your game
Section Settings
01 Titles Show My Title Β· Toggle Title Key Β· Cycle Title Key
02 Reputation Log Events

CREDITS

Needs: BepInExPack Valheim Β· JsonDotNET

  • Wu'barrk: design, and the VALtimaOnline systems this grew out of.
  • Support Raven Iron. Every Raven Iron mod is free, and stays free: all of it, always. Nothing is held back for patrons, and nothing ever will be. To help cover server hosting and test hardware: the website Β· Patreon Β· Discord, a channel per mod and where the testing happens.

A Raven Iron mod. License: MIT. Use it, fork it, repackage it, ship it in a modpack; keep the copyright notice with it. The full text is in LICENSE.md.

CHANGELOG

Changelog

0.2.0

Choose the title you wear, and how much of your fame and karma title shows. Still one mod, on the server and on every client.

Added

  • Choosing a skill title. Any title the player has earned can be worn, not only the highest. Automatic (the highest, as before) stays the default. A chosen skill that stops counting (below 30, or taken off Skill Nouns) falls back to the highest and comes back when it counts again.
  • Choosing the fame and karma style. Full ("The Glorious Lord"), Word only ("The Glorious"), Rank only ("Lord" or "Lady") or Hidden. An infamous standing, karma -625 or below (Rude, Disreputable, Notorious, Infamous, Dishonored and every word under them), always shows in full whatever was chosen: a player can hide their glory, never their shame. The name's colour (blue, grey, red) always shows.
  • Kept in the character. Both choices are saved in Player.m_customData (wubarrk.lordsladies.title_skill, wubarrk.lordsladies.rep_style), so each character keeps its own on any machine. Show My Title (F8) stays a setting of the machine.
  • Titles page in the Compendium (inventory, then Compendium, then Titles): a live preview of the player's own plate ("How others see you"), a skill-title drop-down (Automatic, each earned title, Hidden), a fame-and-karma drop-down (Full, Word only, Rank only, Hidden), and the player's fame, karma and notoriety.
  • Skills panel. Click a skill at 30 or above to wear its title; click it again for automatic. β˜… marks the one worn.
  • title command (client, the player's own): title lists the earned titles numbered, marks the worn one and whether it is automatic, and prints the plate as others see it; title <n> or title <part of a skill or title> wears one (an ambiguous or unknown name says so); title auto; title hide / title show; title style full|word|rank|hidden (says when infamy overrides it, or there is no standing yet); title help.
  • Cycle Title Key (Shift+F8, local): automatic, then each earned title highest first, then automatic again, with a message top left ("Title: Master Blacksmith", "Title: automatic (Master Blacksmith)", "No titles earned yet"). F8 does not also fire with Shift held.
  • For other mods: LordsTitles.LocalReputationTitle and ReputationTitleFor now give the title as the player chose to show it, and Changed is also raised when a player changes their style.

Fixed

  • Joining a second world in the same run sent your title only at the next heartbeat, so for up to a minute nobody there saw it. It is sent as soon as the new session starts.

Compatibility

  • The style travels on a routed RPC of its own (wubarrk.lordsladies.rep_style), sent with the title on every change and heartbeat. A 0.1.0 client ignores it: it still sees every skill title, chosen ones included, and shows everyone's fame and karma title in full. A 0.1.0 player never sends a style, so they show in full to everyone.

Tested

  • 416 off-game checks (47 new): every earned title in order (highest first, ties in list order, below 30 left out), the chosen title and its fallbacks, each style for a Lord, a Lady, below Lord and the plain cells, the infamy lock at karma -625 against -624, and a style read from the wire.

Known limits

  • Like the skill title, the style is declared by the player's own client. A modified client could hide another player's glory, but not their shame: infamy always shows in full.

0.1.0

First release. Skill titles, fame, karma and notoriety for Valheim, as one server-authoritative mod. Runs on the server and on every client.

Added

  • Skill titles. Each client works out its own title from its highest skill: a level word (Neophyte 30, Novice 40, Apprentice 50, Journeyman 60, Expert 70, Adept 80, Master 90, Grand Master 100, Elder 110, Legendary 120) and the profession noun for that skill, e.g. "Master Blacksmith". Below 30 there is no title. A tie goes to the earlier skill in the list. The female player model gets the female noun ("Swordswoman"). Titles are broadcast with a routed RPC, sent again on change and every Title Heartbeat Seconds (60), and drawn on their own line under the name. Toggle Title Key (F8) hides or shows yours; the title stays earned.
  • Skill nouns (Skill Nouns): 34 pairs by default, covering Valheim's skills and the Smoothbrain skills (Blacksmithing, Mining, Cooking, ...). A Smoothbrain skill is read by the hash of its English name; a skill that is not installed counts as level 0 and never adds an entry to the character's skills (so it cannot break a character save).
  • Fame and karma, decided on the server. Fame runs 0 to 15,000, karma -15,000 to +15,000. A creature kill is worth its fame / 100 and -karma / 100 from creature-reputation.json (163 creatures, beside the DLL), times a star multiplier. A creature not in the table takes a fallback by base health (hostile: bad karma; passive: 0). A gain is cut by the player's own value / 100 and a loss deepened by it. Each damager's award is divided across their party (LordsReputation.PartyOf, default no party); only players online and within Kill Credit Radius (100 m) share. Max Awards Per Minute (120) caps what a lying creature owner could credit.
  • The fame and karma title in front of the name: "The Glorious Lord Rohan". 5 fame rows by 11 karma columns; Lord or Lady from fame 10,000. Shown to everyone.
  • Notoriety. Blue (innocent), grey (criminal), red (murderer), in the name's colour. Striking a blue player outside a safe haven makes the attacker grey for Criminal Seconds (120); self-defence and striking a grey or a red are no crime. A player killed by a criminal is asked whether to report each one (4 s after death); a report adds a short-term and a long-term murder count and sets the killer's karma to counts x Karma Per Murder Count (-1000). Red at Red At Counts (5) long-term counts. Counts fall with play time: short-term per Short Term Murder Hours (8), long-term per Long Term Murder Hours (40). A victim cannot report the same killer twice in 10 minutes.
  • Death. Death Costs Fame (on): a tenth of the player's fame, deepened like any loss (5,000 becomes 4,450). Killing a player gives those who fought them in the last 30 seconds the victim's fame / 100.
  • Safe havens (optional): lordsladies-havens.json in the world's save folder, the TerroritySmellatory territories format; only rectangles with "pvp": "ForcedOff" count. No file: no havens.
  • The store: worlds_local/<world>.lordsladies-reputation.json, keyed by platform id and player id, written with a safe swap and a .bak, saved every 60 s and on world save. A bad file is recovered from the backup; a file from a newer version is opened read-only. A self-check proves the writer, the reader and the swap before the first write.
  • Commands: sins (your counts, fame and karma) and llrep for admins (list, status, fame, karma, counts, award, criminal, pardon, save, unlock), run on the server and answered in the admin's console.
  • Settings sync (ServerSync): every gameplay setting is the server's, locked to admins; Show My Title, Toggle Title Key and Log Events stay on each machine. An edit to the server's cfg is read at once and reaches every player.
  • For other mods: LordsLadies.LordsTitles (titles, fame and karma title, notoriety colour, Changed event) and LordsLadies.LordsReputation (fame, karma, notoriety, Crime and Died events, AwardFame / AwardKarma, PartyOf).

Safety

  • Every message the server takes is checked against the connection it came on (a client cannot speak for another player). Hooks are bound one class at a time, so a game update that breaks one costs that feature only.

Tested

  • 369 off-game checks on the rules: awards, diminishing returns, death, parties, title tables, skill titles, murder counts, fights and reports, the creature table (including the shipped one), the store and its recovery, safe havens, crimes, and the engine end to end.

Known limits

  • A skill title is worked out on the player's own client, so a modified client can claim any title. Fame, karma and notoriety are the server's.
  • Not for use alongside VALtimaOnline, which carries these same systems (declared incompatible).