API Clan add_gold

gm.clan.add_gold

Endpoint: gm.clan.add_gold

Syntax

gm.clan.add_gold <clan> <amount>

Parameters

Parameter	Type	Required	Description
clan	string	Yes	Clan identifier (StringId or partial name match)
amount	integer	Yes	Total gold amount to distribute among clan members

Description

Adds gold to a clan by distributing it evenly among all living clan members. The total amount is divided equally, with any remainder distributed one gold at a time until exhausted.

NOTE: Gold is distributed to all living clan members, not just the leader. The Clan.Gold property represents the sum of all member gold.

Example

gm.clan.add_gold clan_empire_south_1 50000

Output:

Added 50000 gold to {Clan Name} (distributed among {member_count} members).
Clan gold changed from {previous_gold} to {new_gold}.

Related Commands

• API-Clan-set_gold - Set total clan gold
• API-Clan-add_gold_leader - Add gold to clan leader only
• API-Clan-give_gold - Give gold to specific clan member
• API-Hero-add_gold - Add gold to individual hero

Last Updated: 2026-02-10

BLGM Version: 1.3.14.3 Bannerlord Version: e1.3.1