API Clan set_leader

gm.clan.set_leader

Endpoint: gm.clan.set_leader

Syntax

gm.clan.set_leader <clan> <hero>

Parameters

Parameter	Type	Required	Description
clan	string	Yes	Clan identifier (StringId or partial name match)
hero	string	Yes	New leader identifier (must be a clan member)

Description

Changes the clan's leader to a different member of the clan. The new leader must already be a member of the specified clan.

NOTE: The hero must already be a member of the specified clan. Returns an error if the hero is not in the clan.

Example

gm.clan.set_leader clan_empire_south_1 lord_1_1

Output:

{Clan Name}'s leader changed from {Previous Leader} to {New Leader}.

Related Commands

• API-Clan-add_hero - Add hero to clan
• API-Clan-add_gold_leader - Add gold to clan leader
• API-Clan-Overview - Clan management overview

Last Updated: 2026-02-10

BLGM Version: 1.3.14.3 Bannerlord Version: e1.3.1