API Troop add_basic

add_basic

Endpoint: gm.troops.add_basic

Syntax

gm.troops.add_basic <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 basic tier troops to add (range: 1-10000)

Description

Adds basic 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 Recruits for Vlandia, Imperial Recruits 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_basic derthert 50

Output:

Added 50x Vlandian Recruit to Derthert's party.
Party: Derthert's Army (Total size: 150)

gm.troops.add_basic player 100

Output:

Added 100x Imperial Recruit to Player's party.
Party: Player's Army (Total size: 200)

Using Named Arguments

gm.troops.add_basic partyLeader:derthert count:50
gm.troops.add_basic leader:player count:100

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 BasicTroop property.

TIP: Use this command to quickly bulk up parties with low-tier recruits for training.

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

Related Commands

• gm.troops.add_elite - Add elite 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