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.

Guild banner and territory

Build the Guild banner with the hammer (tab Misc; costs 1 Wood for now, see BannerRecipe). It is a custom Norse banner — spear-tipped pole, crossbar with leather straps and a ragged cloth — painted in the guild colour with the guild emblem 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.

• 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:

Upgrade	Paid with	Effect per level (default)
Territory	guild points	+10 m to the side (50 → 150 m)
Vault	guild points	+10 vault stacks
Members	guild points	+5 members
Regeneration	materials + coins	+5 / 10 / 15 % health, stamina and eitr regeneration — all members, whole map
Comfort	materials + coins	+1 / 2 comfort when resting — all members, whole map
Monster ward	materials + coins	no monster spawns or raids — claim only
Sturdy walls	materials + coins	−20 / 35 / 50 % damage to structures — claim only
Workshops	materials + coins	processing stations built by members +5 / 10 / 15 % faster — whole map
Fertile soil	materials + coins	crops planted by members grow +10 / 20 / 30 % faster — whole map
Respawn at the banner	materials + coins	members can respawn at the banner

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.

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)
Banner and upgrades	Place and remove the guild banner, buy upgrades
Shared map pins	Add and remove shared map pins

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	15	Members of a new guild (raised by the Members upgrade).
2 - Server	MaxRanks	8	Ranks per guild, leader included.
2 - Server	VaultSlots	40	Vault stacks of a new guild (raised by the Vault upgrade).
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.
4 - Progression	LevelXpBase / LevelXpGrowth / MaxLevel	1000 / 1.25 / 30	XP for level 2, growth per level, highest level.
4 - Progression	PointsPerLevel / StartingPoints	1 / 1	Guild points per level and for a new guild.
4 - Progression	ActivityXpMultiplier	1	Multiplier for XP from activity.
4 - Progression	XpBossFirstKill / XpBossKill	1500 / 150	XP for the guild's first kill of a boss / every boss kill.
4 - Progression	XpAchievementBronze/Silver/Gold	300 / 1000 / 3000	XP per achievement tier.
4 - Progression	DonationCoinsPerXp	10	Treasury coins per 1 XP when donating (0 = off).
4 - Progression	BossNames	vanilla bosses	Creatures that count for the first-kill bonus — add ExtendedBosses etc. here.
5 - Territory	TerritoryClaim	true	Outsiders cannot build or use things in a territory.
5 - Territory	TerritoryBaseSize / TerritorySizePerUpgrade	50 / 10	Side of the square at the start / per upgrade level.
5 - Territory	TerritoryGap	20	Minimum gap between territories.
5 - Territory	UpgradeOnlyAtBanner	true	Upgrades can only be bought by interacting with the guild banner.
5 - Territory	VaultSlotsPerUpgrade / MembersPerUpgrade	10 / 5	Effect of the Vault / Members upgrades.
5 - Territory	BannerRecipe	Wood:1	Build cost of the banner (no crafting station needed).
6 - Upgrades	one entry per upgrade	see file	Cost per level: P points, C coins, L level, Prefab:amount items, levels separated by ;.
7 - Map	ShareMemberPositions / MaxGuildPins	true / 100	Members on the map / shared pins per guild.
1 - Client	ShowGuildmatesOnMap	true	Show guild members on your map.

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.