API Clan add_hero

gm.clan.add_hero

Endpoint: gm.clan.add_hero

Syntax

gm.clan.add_hero <clan> <hero>

Parameters

Parameter	Type	Required	Description
clan	string	Yes	Clan identifier (StringId or partial name match)
hero	string	Yes	Hero identifier to add (StringId or partial name match)

Description

Adds a hero to a specified clan, transferring them from their current clan (if any). This command reassigns clan membership and updates all related clan relationships.

Example

gm.clan.add_hero clan_empire_south_1 lord_1_1

Output:

{Hero Name} transferred from '{Previous Clan}' to '{Clan Name}'.

Transfer wanderer to clan:

gm.clan.add_hero battania wanderer_empire_1

Related Commands

• API-Clan-Overview - Clan management overview
• API-Hero-set_clan - Set hero's clan (Hero command equivalent)
• API-Clan-set_leader - Change clan leadership

Last Updated: 2026-02-10

BLGM Version: 1.3.14.3 Bannerlord Version: e1.3.1