API Troop give_hero_troops

give_hero_troops

Endpoint: gm.troop.give_hero_troops

Syntax

gm.troop.give_hero_troops <hero_query> <troop_query> <count>

Parameters

Parameter	Type	Required	Description
hero_query	string	Yes	Query to find the target hero (e.g., "player", "raganvad")
troop_query	string	Yes	Query to find the troop character (e.g., "imperial_recruit", "battanian")
count	integer	Yes	Number of troops to add (range: 1-10000)

Requirements

• Hero must have a party
• Troop cannot be a hero character
• Party size limits still apply

Examples

gm.troop.give_hero_troops player imperial_recruit 10

Output:

Added 10x Imperial Recruit to Player's party.
Party: Player's Army

gm.troop.give_hero_troops raganvad battanian_highborn_warrior 5

Output:

Added 5x Battanian Highborn Warrior to Raganvad's party.
Party: Raganvad's Army

gm.troop.give_hero_troops lord_1_1 imperial_cavalry 20

Notes

NOTE: Use gm.query.troop to find exact troop IDs before adding them.

NOTE: If the hero is a member of someone else's party (not the leader), troops are still added to that party.

WARNING: Party size limits still apply - command may fail if party is at maximum capacity.

TIP: Build balanced armies by combining infantry, archers, and cavalry units.

Related Commands

• gm.query.troop - Search for troops

Last Updated: 2025-12-16