Guilds — a complete guild system for Valheim

Join the Northarun Discord — news, help and feedback. The link is also in the top-left corner of the guild window.

Players found guilds, invite friends, give them ranks and share a vault and wards. Members wear the guild emblem and tag next to their name — above their head and in chat. Players outside a guild look exactly as in the normal game.

How to use

Press F9 (configurable) to open the guild window. Esc or F9 closes it.

Without a guild:

In a guild:

Emblems and tags

• Above the heads of members: the full guild name in the guild colour, with the emblem next to it, above the player name.
• In chat: emblem and [TAG] before the name in normal messages and shouts.
• The emblem is the icon of an item from the server list (Emblems) — boss and creature trophies by default. Modded items work too.
• Each player can turn the icons off for themselves (ShowNameplateEmblems, ShowChatEmblems).

Guild buildings

Members whose rank has Guild buildings can build these with the hammer (tab Guild), only inside their guild territory. They are made of vanilla Valheim parts, and the number of each grows with the guild level ([8 - Buildings]).

Furniture is real. Beds, chairs, benches, thrones, fires, hearths, forges, workbenches, cooking stations, cauldrons, chests, armour and item stands, braziers, torches, doors, dummies and targets are spawned as normal vanilla pieces once the server accepts the building: you can sit, sleep, cook, smelt, store and refuel them as usual. The guild functions are on the guild board hanging by each building's entrance (the portcullis on the gate). Removing a building also removes its furniture; furniture removed on its own drops nothing.

Cost = materials. A building costs exactly the vanilla recipes of the parts it is made of (scaled to their size), including its furniture, so it is never cheaper or more expensive than building the same thing by hand. The full cost is shown in the build menu. <building>.CostOverride (e.g. Wood:40,Stone:20) replaces it if you want your own.

Only members with Guild buildings can remove guild buildings. The game's own wear and the Sturdy walls upgrade apply.

Vault: armory and warehouse

The vault has two sections with separate capacity: the Armory (weapons, armour, tools, ammo, trinkets) and the Warehouse (materials, food and everything else). Items go to the right section automatically. Without buildings the guild has GearSlots equipment and VaultSlots material stacks; the armory and warehouse add more, and the Vault upgrade raises both.

Guild bar

Members see a small bar at the bottom centre of the screen, below the stamina bar: guild emblem and tag, level, experience bar and members online / all members. It can be turned off or moved (ShowGuildHud, GuildHudOffsetY).

Guild chat

Type /g message in chat. Only online guild members see it, with the sender's rank. Members also see the message of the day when they log in, and short notices (someone joined, left, was kicked, became leader…).

Guild wards

Hold Shift and press E on a ward you built to bind it to your guild (again to unbind). Members whose rank has Ward access are then treated as permitted on that ward — the game's own check, so it covers building, doors, chests and stations. The binding stops working on its own if the ward's builder leaves the guild; the builder can always unbind it. The hover text of the ward shows the guild.

Guild banner and territory

Build the Guild banner with the hammer (tab Guild; costs 20 Wood, 8 Leather scraps, 4 Deer hide, 4 Resin — BannerRecipe). It is a custom Norse banner — spear-tipped pole, crossbar with leather straps and a ragged black cloth whose ornaments take the guild colour, with the guild emblem (white outline) in the rune medallion. It claims a square territory around itself — 50×50 m at the start. Inside the territory only guild members whose rank has Ward access can build, remove pieces, open doors and use containers (the game's own access check, like a ward). The borders are drawn on the ground while you are in build mode or looking at the banner, and wooden posts with caps in the guild colour mark the corners.

• One banner per guild. Placing needs the Banner and upgrades permission; territories of different guilds keep a gap (TerritoryGap).
• The banner cannot be damaged. Only members with the Banner permission can remove it. If it is removed, the guild loses its territory until a new banner is raised — bought upgrades are kept.
• E on the banner opens the BANNER tab — the only place where upgrades are bought; Shift + E toggles respawning at the banner (after the upgrade).

Guild levels, points and upgrades

The guild gains experience (XP) from its members' activity (kills, bosses, crafting, felling trees, mining, farming, fishing, building, taming, travel), from the first kill of every boss, from achievements and from coin donations from the treasury. Every level gives guild points.

Upgrades are bought at the guild banner: press E on it to open the BANNER tab with the purchase buttons. The tab can be viewed from the guild window anywhere, but buying needs the banner interaction:

The claim is the land for guild buildings: outsiders cannot build or use things there and the structure upgrades protect it. The other perks are deliberately small and work for members everywhere while the guild has a banner (if the banner is destroyed they pause until a new one is raised).

Materials come from the guild vault (Meadows/Black Forest → Swamp/Mountain → Plains/Mistlands), coins from the treasury, some levels also need a minimum guild level. Every cost is configurable in [6 - Upgrades].

Achievements

17 guild achievements in 6 categories (combat, crafting, gathering, building, exploration, other), each with bronze, silver and gold tiers. Every member's activity counts towards the guild total; each tier gives XP and is announced in guild chat. The counts come from the game's own player statistics; statistics the game marks as cheated (devcommands) are ignored, and the server caps how much one player can report per 30 seconds.

Map

• Online guild members appear on your map in the guild colour, also when they hide their position.
• A map pin whose name starts with ! (e.g. !Copper) is shared with the whole guild (needs the Shared map pins permission). Removing it removes it for everyone.

Ranks and permissions

The first rank is the leader's and has every permission. New members join with the lowest rank. A member may only manage ranks and members below their own rank, and may only grant permissions they have themselves.

Default ranks of a new guild: Leader, Officer (most permissions, 5000 coins a day), Member (vault without coins, wards, log, chat), Recruit (deposit and chat).

Installation

The mod must be installed on the server and on every client. Jotunn rejects players without it.

Requirements: BepInExPack_Valheim, Jotunn 2.29.0 or newer. Optional: Marketplace 1.3.0+, World Advancement Progression.

1. Copy the Northarun-Guilds folder to BepInEx/plugins/.
2. On a dedicated server, copy the same folder to the server's BepInEx/plugins/.
3. Start the server once — the config file BepInEx/config/adrian.valheim.guilds.cfg is created.

Configuration

Server and Integrations settings are taken from the server's config file; clients receive what they need.

Integrations with the Northarun mod pack

• Marketplace (1.3.0+): the founding fee is paid from the bank first; the treasury has Deposit from bank / Withdraw to bank. The bank history shows guild payments. Without Marketplace everything works with inventory coins.
• World Advancement Progression (private keys): with SharedProgression = true, a boss key earned by a member becomes guild knowledge and is sent to every member who has been in the guild at least SharedProgressionMinHours, through WAP's own key RPC (WAP stores it like any other key). Keys stay with a player who leaves.
• EpicLoot, Adventure Backpacks and other item mods: the vault keeps quality, variant, durability, crafter and all m_customData, so magic items and backpacks with their contents survive storage. Equipped items cannot be stored.
• BetrValheim: the guild vault is server-side, so BetrValheim's "Use foreign private containers" crafting cannot pull from it. That option also lets crafting use chests behind wards and inside guild territories — set it to false if territories should be fully private. The banner respawn works next to BetrValheim's portal picker.
• PlantEverything / PlantEasily: Fertile soil multiplies whatever grow time these mods set.
• World Advancement Progression: building the banner and paying upgrades follow WAP's normal item locks (e.g. Bronze needs the matching boss key).
• Server devcommands / admins: the console command guildadmin (server admins only):
  • guildadmin list
  • guildadmin disband <TAG> — vault contents go to the admin
  • guildadmin leader <TAG> <player>
  • guildadmin kick <TAG> <player>
  • guildadmin rename <TAG> <NEWTAG> <new name>

Data and security

• The server keeps guilds, invitations and cooldowns in BepInEx/config/Guilds/<world name>.dat, saves after every change and keeps the previous version as .dat.bak.
• Every operation is appended to BepInEx/config/Guilds/<world name>.log (founding, joins, kicks, rank changes, every vault movement with amounts).
• Only the server changes guilds and the vault. Players are identified by the character ID of their in-world object, not by what the client claims. Every rejected operation returns the item or coins.
• Ward bindings are stored on the ward itself and written by the ward's owner after checking the sender against the guild list.
• As everywhere in Valheim, the inventory belongs to the client. A modified client could fake a deposit, so an anti-cheat (e.g. AzuAntiCheat) is recommended.

Building from source

The banner model lives in art\banner_v3 (source GLB and texture). tools\banner\build_banner.ps1 turns it into assets\banner.mesh, assets\banner_cloth.png and assets\banner_icon.png, which build.ps1 embeds in the DLL — no Unity or AssetBundle needed. The tool fixes the pole parts, cuts the cloth along the painted silhouette, removes the raven from the medallion (the guild emblem goes there) and stores the red paint as a mask for the guild colour.

powershell -ExecutionPolicy Bypass -File build.ps1

Languages

English by default; Polish with Language = Polish. Each player picks their own language; server messages are translated on the client.