API Kingdom set_ruler

gm.kingdom.set_ruler

Endpoint: gm.kingdom.set_ruler

Syntax

gm.kingdom.set_ruler <kingdom> <hero>

Parameters

Parameter	Type	Required	Description
kingdom	string	Yes	Kingdom identifier (StringId or partial name match)
hero	string	Yes	New ruler identifier (must be part of the kingdom)

Description

Changes the ruler of a kingdom by setting a new ruling clan. The specified hero becomes both the clan leader (if not already) and the kingdom ruler.

NOTE: The hero must be part of the target kingdom (their clan must be a member). If the hero is not currently their clan's leader, they will be promoted to clan leader as well.

Examples

gm.kingdom.set_ruler empire lord_1_1

Output:

Empire's ruler changed from Previous Ruler to New Ruler.
Ruling clan is now Clan Name.

Make player the ruler:

gm.kingdom.set_ruler vlandia player

Related Commands

• gm.kingdom.add_clan - Add clan to kingdom
• gm.kingdom.remove_clan - Remove clan from kingdom
• gm.hero.set_clan - Change hero's clan

Last Updated: 2025-12-16