API Troop add_elite

add_elite

Endpoint: gm.troops.add_elite

Syntax

gm.troops.add_elite <partyLeader> <count>

Parameters

Parameter	Type	Required	Description
partyLeader	string	Yes	Query to find the party leader hero (e.g., "player", "derthert"). Also accepts alias: "leader"
count	integer	Yes	Number of elite tier troops to add (range: 1-10000)

Description

Adds elite tier troops from the party leader's culture to their party. The specific troop type is determined by the leader's culture (e.g., Vlandian Sharpshooter or Knight for Vlandia, Legionary for Empire).

Requirements

• Hero must have a party
• Hero must be the party leader (not just a member)
• Troops added are based on the hero's culture

Examples

gm.troops.add_elite derthert 30

Output:

Added 30x Vlandian Knight to Derthert's party.
Party: Derthert's Army (Total size: 180)

gm.troops.add_elite player 50

Output:

Added 50x Imperial Legionary to Player's party.
Party: Player's Army (Total size: 150)

Using Named Arguments

gm.troops.add_elite partyLeader:derthert count:30
gm.troops.add_elite leader:player count:50

Notes

NOTE: Only works for party leaders. If the hero is not a party leader, the command will fail with an error message.

NOTE: The troop type added depends on the hero's culture's EliteBasicTroop property.

TIP: Elite troops are more expensive to maintain but significantly more powerful in battle.

TIP: Use this command to create elite armies for challenging battles or sieges.

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

Related Commands

• gm.troops.add_basic - Add basic tier troops
• gm.troops.add_mercenary - Add mercenary troops
• gm.troops.add_mixed - Add mixed tier troops
• gm.troops.give_hero_troops - Add specific troop types

Last Updated: 2025-12-22