Guilds — a complete guild system for Valheim

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:

Tab	What it does
GUILD LIST	All guilds on the server with leader, member count and description. Apply to join sends an application.
INVITATIONS	Invitations you received and your applications. Accept, decline or withdraw.
FOUND A GUILD	Name, tag (2–4 letters/digits), colour and emblem, with a live preview. Costs coins (see CreateCost).

In a guild:

Tab	What it does
OVERVIEW	Message of the day, description and statistics. Ranks with Edit guild info change the message, description, colour and emblem; the leader also renames the guild. Leave or disband the guild here.
MEMBERS	Members by rank, online status and last seen. Invite online players by character name, accept applications, promote, demote, kick, hand over leadership.
VAULT	Shared item storage (stacks), a view of your inventory to store items from, and the coin treasury. Coins can also move to/from your Marketplace bank.
RANKS	Rename ranks, add new ones, change their permissions and daily coin limits, move them up or down, remove them.
LOG	The last 200 events: joins, leaves, promotions, rank changes and every vault movement.

Emblems and tags

• Above the heads of members: the emblem icon and [TAG] in the guild colour before the 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 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.

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.

Permission	Allows
Invite / accept	Invite players, accept and decline applications
Kick	Remove members of lower rank
Promote / demote	Change the rank of lower members (up to one below your own)
Edit guild info	Message of the day, description, colour, emblem
Manage ranks	Edit lower ranks
View the log	See the guild log and coin history
Vault: deposit	Store items and deposit coins
Vault: take items	Take items from the vault
Vault: take coins	Withdraw coins, up to the rank's daily limit (0 = no limit)
Ward access	Act as permitted on guild wards
Bind wards	Bind own wards to the guild
Guild chat	Write in guild chat (everyone can read)

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

Section	Setting	Default	Description
1 - Client	Hotkey	F9	Opens the guild window. (F7 is Marketplace, F8 and F10 are used by PlantEasily.)
1 - Client	Language	English	English or Polish. On the server it also names the default ranks of new guilds.
1 - Client	ShowNameplateEmblems	true	Emblem and tag above heads.
1 - Client	ShowChatEmblems	true	Emblem and tag in chat.
2 - Server	CreateCost	1000	Coins to found a guild (bank first, then inventory). They leave the economy.
2 - Server	MaxMembers	30	Members per guild.
2 - Server	MaxRanks	8	Ranks per guild, leader included.
2 - Server	VaultSlots	60	Stacks in the vault.
2 - Server	InviteExpireHours	48	Unanswered invitations and applications disappear after this time.
2 - Server	RejoinCooldownHours	12	After leaving or being kicked, no joining or founding for this long (stops vault hopping).
2 - Server	AllowApplications	true	Players can apply from the guild list.
2 - Server	BlockedVaultItems	(empty)	Prefabs that cannot go in a vault, e.g. DragonEgg,Wishbone.
2 - Server	Emblems	trophies…	Prefab names whose icons can be emblems.
3 - Integrations	GuildWards	true	Guild wards on/off.
3 - Integrations	GuildChat	true	/g guild chat on/off.
3 - Integrations	SharedProgression	false	World Advancement Progression: share boss keys within the guild.
3 - Integrations	SharedProgressionKeys	defeated_	Keys (or prefixes) that are shared.
3 - Integrations	SharedProgressionMinHours	24	Hours in the guild before a member receives shared keys.

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. Note that this BetrValheim option already lets crafting use other players' ward-protected chests — guild wards do not change that.
• 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

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.