API Clan Overview

[CLAN] Clan Management Commands

Category: Clan Management Commands: 18 commands API Version: 1.3.14.3 Status: STABLE

---

Overview

Clan management commands provide complete control over clan entities in Mount & Blade II: Bannerlord. These commands enable you to manipulate clan membership, manage clan resources (gold and renown), adjust prestige levels, change leadership, and even eliminate clans from the game world.

Clans are the primary organizational units in Bannerlord, grouping heroes into family units with shared resources, reputation, and political affiliations. Each clan has a leader, tier level based on renown, and can be affiliated with a kingdom or exist as independent entities. The clan management system allows you to create custom political scenarios, balance faction power, and test gameplay mechanics.

All clan commands require campaign mode to be active. Many operations permanently modify game state and affect multiple heroes simultaneously, so careful consideration and save file backups are recommended before executing destructive operations.

---

Command Reference

Quick Reference Table

Command	Description	Category	Status
gm.clan.create_clan	Create new clan with leader	Structure	STABLE
gm.clan.generate_clans	Generate multiple clans	Structure	STABLE
gm.clan.create_minor_clan	Create minor faction clan	Structure	STABLE
gm.clan.add_hero	Add hero to clan	Membership	STABLE
gm.clan.add_gold	Add gold distributed to members	Resources	STABLE
gm.clan.set_gold	Set total clan gold	Resources	STABLE
gm.clan.add_gold_leader	Add gold to leader only	Resources	STABLE
gm.clan.give_gold	Give gold to specific member	Resources	STABLE
gm.clan.set_renown	Set clan renown	Prestige	STABLE
gm.clan.add_renown	Add or subtract renown	Prestige	STABLE
gm.clan.set_tier	Set clan tier level	Prestige	STABLE
gm.clan.set_leader	Change clan leader	Structure	STABLE
gm.clan.rename	Rename clan	Customization	STABLE
gm.clan.set_culture	Change clan culture	Customization	STABLE
gm.clan.edit_banner	Edit clan banner design	Customization	STABLE
gm.clan.sync_kingdom_colors	Sync clan banner colors to kingdom	Customization	STABLE
gm.clan.equip_heroes	Equip all heroes in clan	Equipment	STABLE
gm.clan.destroy	Destroy/eliminate clan	Structure	STABLE

---

Command Categories

Membership Management

Commands for managing clan membership and hero affiliations.

gm.clan.add_hero - Transfers a hero to a specified clan. If the hero is already in another clan, they automatically leave that clan first. This is the primary method for building custom clan compositions.

Resource Management

Commands for managing clan financial resources through various gold distribution methods.

gm.clan.add_gold - Adds gold to a clan by distributing it evenly among all living clan members. The total clan gold is calculated as the sum of all member gold. Use this for balanced clan-wide wealth increases.

gm.clan.set_gold - Sets the clan's total gold by first zeroing all member gold, then distributing the specified amount evenly. This command resets clan wealth to a specific target value.

gm.clan.add_gold_leader - Adds gold directly to the clan leader only, without distributing to other members. Useful for rewarding or empowering clan leadership specifically.

gm.clan.give_gold - Gives gold to a specific clan member rather than distributing to all. The hero must be a member of the specified clan. Enables targeted wealth distribution.

Prestige & Progression

Commands for managing clan prestige, reputation, and tier advancement.

gm.clan.set_renown - Sets clan renown to a specific value. Renown is the primary metric for clan prestige and directly influences tier advancement. Higher renown improves clan reputation and enables tier increases.

gm.clan.add_renown - Adds or subtracts renown from the clan's current amount. Use positive values to increase renown, negative values to decrease. Useful for incremental prestige adjustments.

gm.clan.set_tier - Sets the clan's tier level by adjusting renown to the appropriate threshold. Tier affects party size limits, companion capacity, and workshop limits. Valid tiers are 0-6.

Structure Management

Commands for creating and modifying clan organizational structure.

gm.clan.create_clan - Creates a new clan with the specified name and assigns a hero as its leader. The new clan starts as an independent entity with tier 0 and can be customized with other clan commands. This is the primary method for creating custom political organizations.

gm.clan.set_leader - Changes the clan's leader to a different member. The new leader must already be a member of the clan. This affects clan decision-making and political influence.

gm.clan.destroy - Permanently destroys and eliminates a clan from the game. All clan properties and fiefs are lost, and member heroes lose their clan affiliation. This action is irreversible.

Equipment Management

Commands for managing equipment for all heroes in a clan.

gm.clan.equip_heroes - Equips all heroes in a clan with level-appropriate equipment based on their combat skills. By default only equips BLGM-created heroes to preserve native character appearances. Can optionally equip all heroes including native game characters. Equipment is culturally appropriate and weapon loadouts are derived from individual hero skills.

Customization

Commands for customizing clan appearance and identity.

gm.clan.rename - Changes the displayed name of a clan. Use single quotes for multi-word names. The clan's StringId remains unchanged, ensuring save compatibility.

gm.clan.set_culture - Changes the cultural affiliation of a clan, affecting name pools, equipment preferences, and cultural bonuses. Useful for creating culturally diverse or cross-cultural clans.

gm.clan.edit_banner - Opens the native banner editor for a specified clan, allowing full customization of the clan's banner design. When editing the banner of a ruling clan, the changes also affect the kingdom banner and all vassal clan displays.

gm.clan.sync_kingdom_colors - Syncs an individual clan's banner colors back to match the kingdom's colors. Useful when a single clan's banner was edited and you want to restore it to the kingdom colors without affecting other clans. Cannot be used on the ruling clan (the ruling clan defines the kingdom colors). WARNING: This will overwrite the specified clan's banner colors.

---

Common Parameters

Clan Identifier

Most commands accept flexible clan identification:

• StringId - Exact game identifier (e.g., clan_empire_south_1, clan_battania_1)
• Partial Name - Substring match in clan name (e.g., empire, battania, aserai)

Hero Identifier

Commands involving heroes accept:

• StringId - Exact hero identifier (e.g., lord_1_1, wanderer_empire_1)
• Partial Name - Substring match in hero name
• Special Keywords - player for the player character

Value Ranges

• Gold - Any integer value (minimum: 0 for set_gold)
• Renown - Any float value (minimum: 0)
• Tier - 0 to 6 (integer, can only increase, never decrease)

---

Usage Examples

Example 1: Building a Custom Clan

Create a powerful clan by adding heroes and resources:

gm.clan.add_hero clan_empire_south_1 wanderer_empire_1
gm.clan.add_hero clan_empire_south_1 wanderer_empire_2
gm.clan.set_gold clan_empire_south_1 100000
gm.clan.set_tier clan_empire_south_1 5

Result: Custom clan with multiple members, substantial wealth, and high tier level.

Example 2: Economic Rebalancing

Distribute wealth across clan members with different approaches:

gm.clan.add_gold clan_battania_1 50000
gm.clan.add_gold_leader clan_vlandia_1 25000
gm.clan.give_gold clan_aserai_1 lord_3_1 10000

Result: Different clans receive wealth through various distribution methods.

Example 3: Clan Prestige Management

Adjust clan prestige and tier progression:

gm.clan.set_renown clan_empire_south_1 500
gm.clan.add_renown clan_battania_1 100
gm.clan.set_tier clan_vlandia_1 4

Result: Clans have adjusted prestige levels and tier rankings.

Example 4: Leadership Transfer

Change clan leadership to a different member:

gm.clan.set_leader clan_empire_south_1 lord_1_2

Result: New hero becomes leader, affecting clan decision-making and representation.

Example 5: Clan Elimination Workflow

Systematically eliminate a troublesome clan:

gm.query.clan rebel
gm.clan.destroy clan_rebel_1

Result: Clan is permanently eliminated from the game world.

---

Best Practices

TIP: Gold Distribution Strategy

Understand the different gold commands:

• Use add_gold for clan-wide wealth increases (distributed evenly)
• Use add_gold_leader to empower clan leadership specifically
• Use give_gold to reward individual clan members
• Use set_gold to reset clan wealth to a target value

TIP: Tier Progression Limitation

Clan tiers can ONLY be increased, never decreased. This is a game engine limitation. Plan tier increases carefully as they are permanent.

gm.clan.set_tier my_clan 5  // Works
gm.clan.set_tier my_clan 3  // ERROR - Cannot decrease tier

TIP: Query Before Destroy

Always query clan information before destruction:

gm.query.clan_info clan_target
gm.clan.destroy clan_target

This confirms clan identity and shows affected heroes.

TIP: Leadership Requirements

When setting a new clan leader:

• Hero must already be a clan member
• Transfer heroes to clan first if needed
• Cannot set non-members as leaders

TIP: Renown Thresholds

Clan tier advancement follows specific renown thresholds defined by the game's ClanTierModel. Setting renown automatically adjusts tier if thresholds are crossed. Use set_tier for direct tier control.

---

Notes & Warnings

WARNING: Clan Destruction is Permanent

The gm.clan.destroy command permanently eliminates clans and cannot be undone:

• All clan fiefs are transferred to other factions
• Member heroes lose clan affiliation
• Clan becomes marked as "eliminated"
• Player clan cannot be destroyed (safety restriction)

Always backup save files before clan destruction operations.

WARNING: Tier Increase Only

Due to Bannerlord's clan tier system design, clan tiers can only be increased, never decreased. Attempting to lower a tier will result in an error. This is an intentional game engine limitation.

NOTE: Gold Distribution Mechanics

Understanding clan gold:

• Clan.Gold property represents the sum of all member gold
• Adding gold to a clan distributes evenly among all living members
• Dead heroes are excluded from gold distribution
• Remainder gold (from uneven division) is distributed one at a time

NOTE: Ruling Clan Protection

Ruling clans of kingdoms have special restrictions:

• Cannot be destroyed while ruling a kingdom
• Cannot be removed from their kingdom
• Must change kingdom ruler first before structural changes

NOTE: Tier Benefits

Higher clan tiers provide:

• Increased party size limits
• Greater companion capacity
• More workshop slots
• Improved recruitment options
• Enhanced political influence

Tier 0-6 progression significantly impacts gameplay capabilities.

---

Related Documentation

Command Groups

• Hero Management Commands - Manage individual clan members
• Kingdom Management Commands - Manage clan kingdom affiliations
• Query Commands - Search and find clans

Reference Materials

• Factions Reference - Political factions and kingdoms
• Cultures Reference - Cultural backgrounds for clans

User Guides

• Quick Start Guide - Getting started with GameMaster commands
• Best Practices - Recommended usage patterns
• Troubleshooting - Common issues and solutions

---

Last Updated: 2026-02-10 API Version: 1.3.14.3

Return to API Reference | Home