API Clan add_renown

gm.clan.add_renown

Endpoint: gm.clan.add_renown

Syntax

gm.clan.add_renown <clan> <amount>

Parameters

Parameter	Type	Required	Description
clan	string	Yes	Clan identifier (StringId or partial name match)
amount	float	Yes	Amount to add (positive) or subtract (negative)

Description

Adds renown to a clan's current amount. Use negative values to subtract renown. Renown affects clan tier progression and overall reputation.

Example

Add 100 renown:

gm.clan.add_renown clan_empire_south_1 100

Output:

{Clan Name}'s renown changed from {old_renown} to {new_renown} (+100).

Subtract 50 renown:

gm.clan.add_renown rebel_clan -50

Output:

{Clan Name}'s renown changed from {old_renown} to {new_renown} (-50).

Related Commands

• API-Clan-set_renown - Set clan renown to specific value
• API-Clan-set_tier - Set clan tier (affects renown)
• API-Clan-Overview - Clan management overview

Last Updated: 2026-02-10

BLGM Version: 1.3.14.3 Bannerlord Version: e1.3.1