API Hero set_relation

Hero set_relation

Endpoint: gm.hero.set_relation

Syntax

gm.hero.set_relation <hero1> <hero2> <value>

Parameters

Parameter	Type	Required	Description
hero1	string	Yes	First hero identifier (StringId or partial name match)
hero2	string	Yes	Second hero identifier (StringId or partial name match)
value	integer	Yes	Relationship value (range: -100 to 100)

Example

gm.hero.set_relation lord_1_1 lord_2_1 50

Output:

Relation between {Hero1 Name} and {Hero2 Name} changed from {old_relation} to 50.

Set two heroes as enemies:

gm.hero.set_relation lord_1_1 lord_3_1 -75

Set neutral relation:

gm.hero.set_relation wanderer_1 notable_1 0

NOTE: Relationship values affect diplomacy, marriage eligibility, and hero interactions. Values below -10 indicate dislike, while values above 10 indicate friendship.

Related Commands

• API-Hero-Overview - Hero command overview

Last Updated: 2025-12-16